文件编辑与图像处理
文件编辑与图像处理
Claude Code 的文件操作工具
Claude Code 通过三个内置工具操作文件：
| 工具 | 功能 | 权限需求 |
|---|---|---|
| Read | 读取文件内容 | 无需确认（官方内置工具默认放行） |
| Write | 创建或覆盖文件 | 需要权限 |
| Edit | 精确替换文件中的代码片段（Search/Replace 模式） | 需要权限 |
Claude 可以自主决定使用哪个工具，也可以组合使用多个工具完成复杂操作。
Read 工具
Read 让 Claude 浏览你的代码库。Claude 会智能地选择读取哪些文件和多少内容，而非一次性加载整个项目。
使用方式
在对话中自然提及：
请看看 src/auth/login.ts 的实现
帮我理解 pnpm-workspace.yaml 的项目结构Claude 会自己调用 Read 工具读取相关文件并将关键信息带回对话。
Write 工具
Write 用于创建新文件或完全覆盖已有文件。Claude 会在执行前展示内容摘要，你需要确认。
受保护路径
以下路径的 Write/Edit 始终需要额外确认（bypassPermissions 除外）：
.git/、.vscode/、.idea/、.husky/等.claude/整体（唯一例外：.claude/worktrees/）
Edit 工具
Edit 是 Claude Code 最常用的编辑方式——它使用 Search/Replace 语义精确替换代码片段，而非整文件覆盖。
工作原理
- Claude 分析需要修改的代码
- 找到目标代码的精确匹配片段（
old_str） - 用新代码（
new_str）替换 - 展示 diff 供你确认
Diff 确认
每次 Edit 操作后，Claude 展示修改前后的对比差异，你可以：
- 接受修改
- 拒绝修改
- 查看完整上下文
在 VS Code / JetBrains / Desktop App 中，diff 以可视化方式呈现。终端中则以 ANSI 颜色高亮展示。
图像处理
粘贴图片（Ctrl+V）
Claude Code 支持将截图直接粘贴到对话中（iTerm2 原生支持，其他终端需要配置）：
- 截取屏幕区域
- 在 Claude Code 终端中按
Ctrl+V - Claude 会读取图片内容（代码截图、错误信息、UI 设计稿等）
粘贴时底部会显示 "Pasting..." 提示。
自动缩放
超过 2000px 的图片会被自动降采样，防止会话被过大的图片数据阻塞。
历史图片处理
如果历史记录中存在超大图片导致请求失败，Claude Code 会自动移除过大的图片并重试请求。
非交互模式的文件操作
在 -p（print）模式下，Claude 同样可以读写文件，前提是权限允许：
# 批量修改文件
claude -p "将 src/ 下所有 .ts 文件的 console.log 替换为 logger.debug"最佳实践
描述目标，不指定方法：说"把认证逻辑从 login.ts 抽到独立模块"，而不说"新建 auth.ts 然后把 login.ts 的 50-80 行移过去"。Claude 自己决定最佳的编辑方式。
批量相关修改：一次 prompt 中描述多个相关的修改，让 Claude 一次性完成，减少来回确认。
利用 Diff 确认作为质量检查：即使使用 Auto Mode 或 acceptEdits 模式，也应该在关键改动后看一眼 Diff 是否符合预期。
受保护文件要显式允许：如果需要修改
.vscode/settings.json等受保护文件，需要显式确认。