用 Claude Code 完成第一次小修改

在测试项目中明确选择 Manual 模式，先理解文件，再批准一处文案修改，检查 diff 和构建结果；不要假定新会话一定逐项询问。

内容更新 2026-09-05

先看结论

第一次只跑通「只读分析、批准一处编辑、查看 diff、运行验证、保存 Git 记录」这条最小闭环。

操作步骤

  1. 登录后先开一个测试仓库，避免改到正式项目
  2. 在测试目录运行 claude --permission-mode default 明确选择 Manual；检查已有允许规则，先不要授权整个会话的编辑或命令执行
  3. 要求它只解释当前目录、目标文件和构建命令，不修改文件、不联网、不安装依赖；如果出现额外动作请求，先拒绝并缩小范围
  4. 确认方案后只批准一处文案编辑，例如把测试页按钮的“发送”改为“提交咨询”；不要改接口、地址、依赖或其他文件
  5. 查看 git diff，确认只有目标文案变化；再批准项目已有的本地 build / test。验证通过后由你决定是否提交，不自动推送或部署
  6. 熟悉批准范围并确认 Git 回滚点后再考虑 acceptEdits；先假设工作区内的删除、移动、复制和批量替换可能自动获批，涉及配置、密钥、部署或大范围修改时回到更严格模式

命令与示例

# 在已备份的测试项目目录执行；不安装、不升级
claude --version
git status --short --branch
claude --permission-mode default

小白先准备什么

  1. 先复制一份项目或确认项目已经有 Git 记录，避免第一次练手改坏原文件。
  2. 准备项目的启动命令、构建命令和你能看懂的验收目标，例如“首页能打开、按钮能跳转”。
  3. 第一次打开 Claude Code 后先让它只读分析，不要马上让它大改。
  4. 用 Shift+Tab 核对当前模式，第一次明确选择 Manual（配置值 default）；自然语言说“只读”不能替代权限控制。
  5. 把账号登录、网络代理、终端权限这些基础问题先解决，再进入项目。

验收标准

  • claude --version 能正常输出版本，项目目录里能启动 Claude Code。
  • Claude Code 能说清项目技术栈、入口文件、构建命令和主要页面。
  • 第一次修改只改 1-2 个文件，并且你能用浏览器看到变化。
  • 你能区分 Manual/default、plan、acceptEdits 和 auto；知道计划模式仍可能运行命令，自动模式不是逐项人工审核。
  • 每次改完都跑 build 或项目自带检查，失败就先修失败原因。

可复制提示词

请先只读分析这个测试项目，不修改文件、不联网、不安装依赖。
不要读取凭据文件、客户数据或原始日志，不提交、不推送、不部署。

请用中文告诉我：
1. 技术栈、入口文件和现有构建命令。
2. 测试页按钮的“发送”文案在哪个文件。
3. 只把它改成“提交咨询”需要改哪一处。
4. 应如何验证没有改变按钮行为。
先汇报方案，等我明确批准再编辑。

常见误区和不适合场景

  • 不要把其他工具的长任务命令照搬过来；先用 /help 核对本机支持情况和当前语义，第一次练习不需要长任务模式。
  • 不要第一次就说“全面优化整个项目”，先让它分析，再分批改首页、文章、组件、样式。
  • 不要跳过构建。看起来能打开不代表线上能部署。
  • 不适合：没有任何备份、没有启动命令、也不知道最终要验收什么的项目。

参考链接

适合谁看

  • 刚装上 Claude Code 不知道先做什么
  • 想弄清 default、plan、acceptEdits 这些 permission mode 分别做什么
  • 想跑通最小修改 → 提交流程

需要解决的问题

  • 面板打开了但不敢改东西
  • 登录之后不知道下一步
  • 改完没保存或者保存了不知道怎么回滚

先理解这些

  • 当前官方界面把逐项审核的模式称为 Manual，配置值仍为 default；部分套餐的交互会话会从 auto 开始，用户设置和组织策略也会影响启动模式，不能只看“默认”两个字
  • plan 会探索项目、运行命令和写计划，通常不修改业务源码；它不是文件系统绝对只读。启用 auto 的计划阶段可能由分类器批准命令，bypass 权限也会改变边界。第一次练习优先明确使用 Manual，并写清不修改、不联网、不安装的范围
  • acceptEdits 可能自动批准工作区内编辑、删除、移动和复制；auto 由分类器审查而非逐项交给你，不适合把权限边界不清的正式项目直接交给它
  • sandbox 是 Bash 命令的额外操作系统级隔离，不等同于默认文件编辑机制
  • Git 只能恢复已经记录的内容，不能找回从未提交或备份的旧文件；第一次操作前先保留备份或已确认的提交

遇到困难时

  • 改坏了先看 git diff，只恢复你确认不要的改动；已有提交时可用新提交回退，避免覆盖未保存的工作
  • Agent 总是改错文件就把目标缩到单文件 / 单函数