创建与编辑

Claude Code 通过两种内置工具修改文件：Write（完整写入）和 Edit（精确替换）。所有修改在执行前展示 diff，确认后才写入磁盘。

一、最简上手

用自然语言描述你要修改的内容，Claude Code 自动选择合适的工具执行。

二、两种编辑工具

Claude Code 根据任务自动选择 Write 或 Edit。两种工具的核心区别：

Write 工具

Write 接收文件路径和完整内容，创建新文件或覆盖已有文件的全部内容。典型触发场景：

• "创建一个 README.md"
• "重写这个配置文件"
• "按照模板生成一个新组件"

Edit 工具

Edit 通过精确字符串匹配定位要修改的文本，然后替换为新内容。这不是基于行号的操作，而是基于文本内容本身的匹配。

• "把变量名 name 改成 userName"
• "删除第二段的注释"
• "在 import 语句后面加一行"

三、参数与配置

Edit 工具参数

Edit 工具的核心是三个参数的配合：

old_string 的唯一性约束是 Edit 工具的关键设计：