文字編輯器工具是 Claude 內建的能力,讓它具備檔案系統存取和文字編輯能力。與其他您需要同時撰寫結構描述(schema)和實作的工具不同,Claude 已經知道如何請求文字編輯器操作——您只需要處理這些請求即可。
文字編輯器工具的功能
這個工具讓 Claude 能夠像軟體工程師一樣處理檔案和目錄:
- 檢視檔案或目錄內容
- 檢視檔案中特定範圍的行
- 替換檔案中的文字
- 建立新檔案
- 在特定行號插入文字
運作方式
文字編輯器工具與自訂工具不同,因為只有 JSON 結構描述內建於 Claude 中。您仍然需要提供實際的實作。

當您建立自訂工具時,您需要撰寫兩個部分——告訴 Claude 關於此工具的結構描述,以及實際執行工作的函式。使用文字編輯器工具時,Claude 已經擁有結構描述,但您必須撰寫函式來處理 Claude 檢視、編輯或建立檔案的請求。
設定工具
若要使用文字編輯器工具,您需要提供與您的模型相符的工具版本:
# 適用於 Claude 4 及更新版本的模型
text_editor = "text_editor_20250728"
# 適用於較早期的 Claude 模型
text_editor = "text_editor_20250124"本課程其餘部分使用 Claude 4 及以後版本;使用 text_editor_20250124 時,工具名稱改為 str_replace_editor,並且還存在 undo_edit 命令。
您還需要修改您的聊天函式,以接受文字編輯器參數並將其納入模型設定中。
工具命令
當 Claude 想要使用文字編輯器時,它會傳回帶有特定命令的工具使用請求:

您的實作需要處理所有四個命令:view、str_replace、create 和 insert。以下是處理這些請求的基本結構:
def run_tool(tool_name, tool_input):
if tool_name == "str_replace_based_edit_tool":
command = tool_input.get("command", "")
if command == "view":
path = tool_input.get("path", "")
return text_editor_tool.view(path)
elif command == "str_replace":
path = tool_input.get("path", "")
old_str = tool_input.get("old_str", "")
new_str = tool_input.get("new_str", "")
return text_editor_tool.str_replace(path, old_str, new_str)
# …處理其他命令範例:檔案分析
以下是此工具在實務中的運作方式。當您要求 Claude「用一句話描述 ./main.py 檔案中的程式碼」時,會發生以下情況:

Claude 傳送一個帶有 {"command": "view", "path": "./main.py"} 的工具使用請求。您的伺服器使用 TextEditorTool 類別讀取檔案並傳回內容。然後 Claude 根據它讀取的程式碼提供其分析。
實際應用
文字編輯器工具本質上將 Claude 轉變為一個程式碼助理,可以:
- 讀取現有程式碼並提供分析
- 建立新檔案和函式
- 修改現有程式碼
- 設定測試檔案
- 跨多個檔案重構程式碼
舉例來說,您可以要求 Claude「撰寫一個函式來計算圓周率到小數點後第 5 位,放在 main.py 中,然後建立一個 test.py 檔案來測試它」。Claude 將會讀取現有檔案、新增新的函式、建立測試檔案,並撰寫全面的測試——所有這些都會自動使用文字編輯器命令完成。
這使得打造類似現代具備整合式 AI 功能的程式碼編輯器的 AI 驅動開發工具成為可能,讓您可以要求變更程式碼,並直接在您的檔案系統中實作這些變更。