加载中
加载中

文本编辑器工具是 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 想要使用文本编辑器时,它会发回带有特定命令的工具使用请求:

处理 str_replace_editor 命令“view”“str_replace”“create”“insert”和“undo_edit”的 run_tool Notebook 单元格。

您的实现需要处理所有四种命令: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 “编写一个函数,在 main.py 中计算圆周率到小数点后第 5 位,然后创建一个 test.py 文件来测试它”。Claude 会读取现有文件、添加新函数、创建测试文件并编写全面的测试——这一切都自动使用文本编辑器命令完成。

这使得构建类似于现代集成 AI 功能的代码编辑器的 AI 驱动开发工具成为可能,您可以请求代码更改,并让这些更改直接在您的文件系统中实现。