重要提示:所有模型版本的工具版本字串都可以在這裡找到:https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool(在新分頁中開啟)
Claude 內建了一個您不需要從頭開始建立的工具:文字編輯工具。此工具讓 Claude 能夠像您在標準文字編輯器中一樣,處理檔案和目錄。
文字編輯工具可以做什麼
文字編輯工具為 Claude 提供了一整套全面的檔案操作能力:
- 檢視檔案或目錄內容
- 檢視檔案中特定範圍的行
- 替換檔案中的文字
- 建立新檔案
- 在檔案的特定行插入文字

這大幅擴展了 Claude 的能力,本質上賦予了它開箱即用的軟體工程師的能力。
了解實作需求
這裡有個稍微令人困惑的地方:雖然工具結構描述內建於 Claude 中,但您仍需要提供實際的實作。可以這樣理解——Claude 知道如何請求檔案操作,但您需要撰寫實際執行這些操作的程式碼。

當您使用其他工具時,您需要同時撰寫 JSON 結構描述和函式實作。而使用文字編輯工具時,Claude 提供結構描述的知識,但您必須撰寫函式來處理 Claude 建立檔案、讀取目錄、替換文字等請求。
結構描述版本
雖然主要的結構描述內建於 Claude 中,但在發出請求時,您仍需要包含一個小型結構描述存根。確切的結構描述取決於您使用的是哪個 Claude 模型:
def get_text_edit_schema(model):
if model.startswith("claude-3"):
return {
"type": "text_editor_20250124",
"name": "str_replace_editor",
}
else:
return {
"type": "text_editor_20250728",
"name": "str_replace_based_edit_tool",
}
Claude 會看到這個小型結構描述,並在幕後自動將其擴展為完整的文字編輯工具規格。
實際範例
讓我們看看文字編輯工具的實際運作情況。當您要求 Claude 處理檔案時,它會使用此工具來視需要讀取、修改和建立檔案。
例如,如果您要求 Claude「開啟 ./main.py 檔案並總結其內容」,Claude 將會:
- 使用文字編輯工具檢視檔案
- 讀取內容
- 為您提供摘要
您可以進一步要求 Claude 修改檔案。例如:「開啟 ./main.py 檔案,並撰寫一個函式來計算圓周率到小數點第 5 位。然後建立一個 ./test.py 檔案來測試您的實作。」
Claude 將會:
- 檢視現有的 main.py 檔案
- 將其內容替換為包含圓周率計算函式的新實作
- 建立一個新的 test.py 檔案,並附上適當的單元測試
為什麼要使用文字編輯工具?
您可能會好奇,既然現代程式碼編輯器已經內建了 AI 助理,為什麼還需要這個工具。在以下情境中,文字編輯工具會變得很有價值:
- 您正在建立需要以程式化方式編輯檔案的應用程式
- 您在沒有完整功能程式碼編輯器可用的環境中工作
- 您希望將檔案編輯功能直接整合到您以 Claude 驅動的應用程式中
本質上,文字編輯工具讓您能夠在自己的應用程式中複製大部分花俏的 AI 驅動程式碼編輯器的功能,讓您能夠精細控制 Claude 與您的檔案系統互動的方式。