重要提示:所有模型版本的工具版本字符串均可在此处查看:https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool(在新标签页中打开)
Claude 内置了一个无需从零开始创建的工具:文本编辑工具。这个工具使 Claude 能够像您在标准文本编辑器中一样处理文件和目录。
文本编辑工具能做什么
文本编辑工具为 Claude 提供了一整套全面的文件操作能力:
- 查看文件或目录内容
- 查看文件中特定范围的行
- 替换文件中的文本
- 创建新文件
- 在文件的特定行插入文本

这极大地扩展了 Claude 的能力,本质上赋予了它开箱即用地扮演软件工程师的能力。
了解实现要求
这里有一点可能会让人困惑:虽然工具模式(schema)内置于 Claude 中,但您仍然需要提供实际的实现。可以这样理解——Claude 知道如何请求文件操作,但您需要编写实际执行这些操作的代码。

当您使用自定义工具时,通常需要同时编写 JSON 模式和函数实现。而对于文本编辑工具,Claude 提供了模式相关的知识,但您必须编写函数来处理 Claude 发出的创建文件、读取目录、替换文本等请求。
模式版本
使用文本编辑工具时,您确实需要包含一个小的模式存根(schema stub),具体的模式取决于您使用的是哪个 Claude 模型:
def get_text_edit_schema(model):
if model.startswith("claude-haiku-4-5"):
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 真正的编码助手能力,使其能够在您的文件系统上读取、写入和修改文件。