加载中

重要说明:所有模型版本的工具版本字符串均可在此处找到:https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool

加载中

Claude自带一个无需从零开始创建的内置工具:文本编辑工具。该工具赋予Claude像使用标准文本编辑器一样处理文件和目录的能力。

文本编辑工具能做什么

文本编辑工具为Claude提供了一套全面的文件操作能力:

  • 查看文件或目录内容
  • 查看文件中特定范围的行
  • 替换文件中的文本
  • 创建新文件
  • 在文件的特定行插入文本

文本编辑工具内置于Claude中,但仅限于其模式(schema),因此您需要提供实际工具的实现。

这极大地扩展了Claude的能力,基本上赋予了它开箱即用地充当软件工程师的能力。

理解实现要求

这里有个容易让人困惑的地方:虽然工具模式内置于Claude中,但您仍然需要提供实际的实现。可以这样理解——Claude知道如何请求文件操作,但您需要编写实际执行这些操作的代码。

text_editor_tool_schema JSON模式,以及一个显示三个问号的"Function"方框,代表您必须编写的函数。

当您使用其他工具时,您需要同时编写JSON模式和函数实现。而使用文本编辑工具时,Claude提供模式相关的知识,但您必须编写函数来处理Claude发出的创建文件、读取目录、替换文本等请求。

模式版本

虽然主要模式内置于Claude中,但在发出请求时,您仍需要包含一个小的模式存根(schema stub)。具体的模式取决于您使用的Claude模型:

python
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",
        }

代码编辑器中打开了main.py,其唯一内容是函数头"def greeting"和第2行的空行。

Claude看到这个小模式后,会在幕后自动将其扩展为完整的文本编辑工具规范。

实际示例

让我们来看看文本编辑工具的实际运作。当您要求Claude处理文件时,它会根据需要使用该工具来读取、修改和创建文件。

例如,如果您要求Claude"打开./main.py文件并总结其内容",Claude将会:

  1. 使用文本编辑工具查看文件
  2. 读取内容
  3. 为您提供摘要

您还可以更进一步,要求Claude修改文件。例如:"打开./main.py文件,并编写一个函数来计算圆周率到小数点后第5位。然后创建一个./test.py文件来测试你的实现。"

Claude将会:

  1. 查看现有的main.py文件
  2. 用包含圆周率计算函数的新实现替换其内容
  3. 创建一个新的test.py文件,包含适当的单元测试

为什么要使用文本编辑工具?

您可能会好奇,既然现代代码编辑器已经内置了AI助手,为什么还需要这个工具。在以下场景中,文本编辑工具会变得很有价值:

  • 您正在构建需要以编程方式编辑文件的应用程序
  • 您的工作环境无法访问功能齐全的代码编辑器
  • 您希望将文件编辑能力直接集成到由Claude驱动的应用程序中

本质上,文本编辑工具让您能够在自己的应用程序中复刻许多高级AI代码编辑器的功能,使您能够对Claude与文件系统的交互方式进行精细控制。