載入中
載入中

文字編輯器工具是 Claude 內建的能力,讓它具備檔案系統存取和文字編輯能力。與其他您需要同時撰寫結構描述(schema)和實作的工具不同,Claude 已經知道如何請求文字編輯器操作——您只需要處理這些請求即可。

文字編輯器工具的功能

這個工具讓 Claude 能夠像軟體工程師一樣處理檔案和目錄:

  • 檢視檔案或目錄內容
  • 檢視檔案中特定範圍的行
  • 替換檔案中的文字
  • 建立新檔案
  • 在特定行號插入文字

運作方式

文字編輯器工具與自訂工具不同,因為只有 JSON 結構描述內建於 Claude 中。您仍然需要提供實際的實作。

每個自訂工具將一個 JSON 結構描述與一個函式配對:add_duration_to_datetime、get_current_datetime、set_reminder。

當您建立自訂工具時,您需要撰寫兩個部分——告訴 Claude 關於此工具的結構描述,以及實際執行工作的函式。使用文字編輯器工具時,Claude 已經擁有結構描述,但您必須撰寫函式來處理 Claude 檢視、編輯或建立檔案的請求。

設定工具

若要使用文字編輯器工具,您需要提供與您的模型相符的工具版本:

python
# 適用於 Claude 4 及更新版本的模型
text_editor = "text_editor_20250728"

# 適用於較早期的 Claude 模型
text_editor = "text_editor_20250124"

本課程其餘部分使用 Claude 4 及以後版本;使用 text_editor_20250124 時,工具名稱改為 str_replace_editor,並且還存在 undo_edit 命令。

您還需要修改您的聊天函式,以接受文字編輯器參數並將其納入模型設定中。

工具命令

當 Claude 想要使用文字編輯器時,它會傳回帶有特定命令的工具使用請求:

Notebook 儲存格中,run_tool 處理 str_replace_editor 的命令「view」、「str_replace」、「create」、「insert」和「undo_edit」。

您的實作需要處理所有四個命令:view、str_replace、create 和 insert。以下是處理這些請求的基本結構:

python
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 檔案中的程式碼」時,會發生以下情況:

ToolUse、ToolResult 和 Text 部分:Claude 取得一個列印「hi there」的 hello 函式,並回覆說它印出一個問候語。

Claude 傳送一個帶有 {"command": "view", "path": "./main.py"} 的工具使用請求。您的伺服器使用 TextEditorTool 類別讀取檔案並傳回內容。然後 Claude 根據它讀取的程式碼提供其分析。

實際應用

文字編輯器工具本質上將 Claude 轉變為一個程式碼助理,可以:

  • 讀取現有程式碼並提供分析
  • 建立新檔案和函式
  • 修改現有程式碼
  • 設定測試檔案
  • 跨多個檔案重構程式碼

舉例來說,您可以要求 Claude「撰寫一個函式來計算圓周率到小數點後第 5 位,放在 main.py 中,然後建立一個 test.py 檔案來測試它」。Claude 將會讀取現有檔案、新增新的函式、建立測試檔案,並撰寫全面的測試——所有這些都會自動使用文字編輯器命令完成。

這使得打造類似現代具備整合式 AI 功能的程式碼編輯器的 AI 驅動開發工具成為可能,讓您可以要求變更程式碼,並直接在您的檔案系統中實作這些變更。