一句话结论
第一次只跑通「只读分析、批准一处编辑、查看 diff、运行验证、保存 Git 记录」这条最小闭环。
适用场景
- 刚装上 Claude Code 不知道先做什么
- 想弄清 default、plan、acceptEdits 这些 permission mode 分别做什么
- 想跑通最小修改 → 提交流程
常见现象
- 面板打开了但不敢改东西
- 登录之后不知道下一步
- 改完没保存或者保存了不知道怎么回滚
原因解释
- Claude Code 是否在修改文件前询问，取决于 permission mode；默认模式会在工具首次需要文件修改权限时提示，可只批准本次或批准到会话结束
- plan 模式用于只读分析和提出方案；acceptEdits 不只自动批准编辑工具，还会自动批准工作区内一组文件操作命令，例如 `rm`、`rmdir`、`mv`、`cp`、`sed` 和 PowerShell `Remove-Item`，删除、移动或覆盖可能不再逐次弹窗，不适合小白第一次就开启
- sandbox 是 Bash 命令的额外操作系统级隔离，不等同于默认文件编辑机制
- 没做版本控制时，回滚得靠 git
解决步骤
- 登录后先开一个测试仓库，避免改到正式项目
- 先切到 plan 模式，或明确要求「只读分析，不修改文件」，让它解释当前目录和构建命令
- 确认方案后回到 default 模式，让它只改一处不重要的文案；首次提示时选择合适的批准范围，并在每次改动后检查 diff，高风险动作另行确认
- 查看 git diff，运行项目的 build / test，再提交确认无误的改动，留下回滚锚点
- 熟悉批准范围并确认 Git 回滚点后再考虑 acceptEdits；先假设工作区内的删除、移动、复制和批量替换可能自动获批，涉及配置、密钥、部署或大范围修改时回到更严格模式
仍然不行怎么办
- 改坏了先看 git diff，只恢复你确认不要的改动；已有提交时可用新提交回退，避免覆盖未保存的工作
- Agent 总是改错文件就把目标缩到单文件 / 单函数
小白先准备什么
- 先复制一份项目或确认项目已经有 Git 记录，避免第一次练手改坏原文件。
- 准备项目的启动命令、构建命令和你能看懂的验收目标，例如“首页能打开、按钮能跳转”。
- 第一次打开 Claude Code 后先让它只读分析，不要马上让它大改。
- 用 Shift+Tab 查看并切换 permission mode；第一次优先 plan 或 default，不开 acceptEdits。
- 把账号登录、网络代理、终端权限这些基础问题先解决，再进入项目。
验收标准
- `claude --version` 能正常输出版本，项目目录里能启动 Claude Code。
- Claude Code 能说清项目技术栈、入口文件、构建命令和主要页面。
- 第一次修改只改 1-2 个文件，并且你能用浏览器看到变化。
- 你能说清当前是 default、plan 还是 acceptEdits，并知道 acceptEdits 可能自动批准工作区内的删除、移动、复制和批量替换。
- 每次改完都跑 build 或项目自带检查，失败就先修失败原因。
可复制提示词
请先只读分析这个项目，不要修改文件。
我是不懂代码的小白，请用中文告诉我：
1. 这个项目是什么技术栈。
2. 首页、路由、数据分别在哪些文件。
3. 本地启动和构建命令是什么。
4. 如果我要改首页文案，最少需要改哪些地方。
5. 你建议先做哪一个最小改动来验证流程。
常见误区和不适合场景
- 不要把 Codex 的长任务命令照搬到 Claude Code；Claude Code 2.1.139 已加入自己的 `/goal`，先用 `/help` 核对本机支持情况和当前语义。
- 不要第一次就说“全面优化整个项目”，先让它分析，再分批改首页、文章、组件、样式。
- 不要跳过构建。看起来能打开不代表线上能部署。
- 不适合：没有任何备份、没有启动命令、也不知道最终要验收什么的项目。
还卡着？
仅把删除凭证、客户数据和环境变量值后的必要截图、日志片段、需求说明或当前页面链接发到 zhemuy@gmail.com。