Claude Code 要发挥最好，Prompt 得提前给它四件事：范围明确的任务、先读哪些文件、好坏标准、什么绝对不能动。少其中一件，结果就是过度热心的重构、突如其来的 schema 变更、需要回滚的 PR。下面 12 个 Prompt 都带齐这四个部分，并在出错代价高的地方加上明确的批准闸口。
它们还会用到 Claude Code 里两个专为此而生的功能。Plan Mode（连按两下 Shift+Tab，或输入 /plan，或用 claude --permission-mode plan 启动）是只读的：Claude 会读你的仓库、起草计划，但在你批准前不能改文件、不能跑命令。**Checkpoint（检查点）**让你能回退：你每发一条 Prompt 就生成一个，用 /rewind（或在空输入框按两下 Esc）可把代码、对话、或两者一起还原。这里好几个 Prompt 都要求”先给计划”，正是为了在写任何代码之前先花掉那个便宜的检查点。（截至 2026 年 6 月，Claude Code 只跑 Anthropic 自家模型——默认主力是 Sonnet 4.6，最难的智能体任务上用 Opus 4.7，用 /model 命令切换。用 Codex 的也可以套用同样的 Prompt 结构。）
合并前请配合代码审查 Prompt一起用。
一句话总结
- 每个 Prompt 都点明：先读哪些文件、可以改哪些、绝不能动哪些、以及”做完”的标准。这个四段式就是全部关键。
- 高风险的 Prompt（迁移、重构、依赖升级）都先要计划或 commit 地图，然后等批准——在出 diff 之前先花掉检查点。
- 风险高的活在 Plan Mode 里跑，让 Claude 在你点头前根本写不了；它真动手以后，留着
/rewind兜底。 - 默认用 Sonnet 4.6；只在多文件重构、棘手调试这类靠推理深度回本的场景，才用
/model切到 Opus 4.7。
这套 Prompt 适合用在哪
- 在已有代码库里实现特性
- 最小 diff 的外科手术式 bug 修复
- 多步迁移，带回滚
- 3 阶段重构，每段都可独立部署
- TDD 风格实现和性能优化
- 起 spike 代码验证思路
1. 范围明确的特性实现
在 {repo} 实现 {feature}。
先读：{清单}
可改：{清单}
绝不许改：{清单}
好坏标准：
- 测试过
- 不动 schema
- 新代码沿用 {file} 已有模式
- diff 可审，<300 行
先用要点形式给计划。我批准前别动代码。把这条放在 Plan Mode 里跑（连按两下 Shift+Tab），这样在你批准计划前，Claude 物理上就改不了文件。
2. 外科手术式 bug 修复
修：{描述}。
复现：{步骤}。
预期 vs 实际：{应该 / 当前}。
约束：
- 最小 diff，不许重构
- 加 1 个修复前会失败的回归测试
- 可能涉及：{清单}
先给 diff 再 apply。3. 带回滚路径的迁移
在 {area} 把 {from} 迁到 {to}。
约束：
- 每个 commit 独立可部署
- 过渡期新旧并存
- 回滚 = 逐 commit revert，不做手工清理
先给 commit 计划：每个 commit 的标题 + diff 范围。我批准后再执行。迁移时，commit 地图就是你的安全网：后面某个 commit 出了问题，你干净地 revert 它就行，而不是靠 /rewind——后者并不能撤销 bash 命令造成的文件改动（mv、rm、生成的文件都不行）。
4. 3 阶段重构
重构 {component}。三阶段，每段可独立合并：
阶段 1：与旧并存引入新抽象（不动调用方）
阶段 2：逐个迁调用方，旧实现仍可用
阶段 3：删旧，不留兼容层
先只给阶段 1 的 diff。暂不动调用方。5. 按 spec 起新模块
按 spec 起 {name}：{粘贴}。
仓库约定：{1 段——目录结构、命名、错误处理、测试风格}。
镜像参考：{file}。
先给文件结构 + 公开接口（不要实现）。我批准后再填实现。6. TDD 实现
TDD 实现 {feature}。
1. 为这些行为写失败测试：{清单}
2. 给我测试，等我批准
3. 写让测试通过的最小代码
4. 全绿后再重构
不要为我没列出的行为加测试。7. Spike 验证思路
我要验证 {feature} 的思路。请用 50 LOC spike 展示核心。
- 不必考虑 edge case 和错误路径
- 配置类直接硬编码
- 每个偷工的地方标 `// TODO: 真实实现需处理 X`
目的：我读完 spike 就能判断思路是否正确，再决定要不要正式做。8. 性能修复带量化
性能问题：{描述}。怀疑原因：{假设或 "未知"}。
步骤：
1. 加一个能复现慢路径的 benchmark
2. 跑基线，报数
3. 迭代修；每次修后给出 benchmark 相对基线的差值
4. 当差值 <5% 改进或达到 {目标 X}，停
任何代码改动前，先给我 benchmark。9. 只读调查
在 {repo} 调查 {问题或现象}。本轮不要改任何文件。
步骤：
1. 读这些入口：{清单}
2. 跟踪相关调用链
3. 输出一份简短分析：(a) 现象是什么；(b) 为什么；(c) 2-3 个候选修法按风险排序
我挑修法，再走单独一轮编辑。这正是 Plan Mode 的用武之地。你也可以让 Claude 拉起它只读的 Explore 子代理去跟踪调用链，这样不会在主会话里烧掉上下文。
10. 合并前 diff 审查
下面是 {branch} 的完整 diff。审查：
- 与原工单一致性：{粘贴工单}
- 在 {经常顺带出错的兄弟模块} 是否引入回归
- 新行为是否缺测试
- 命名 / 结构是否偏离 {file} 的约定
输出结构化评论列表：行号 + 关切 + 建议改动。
{粘贴 diff}11. CI 失败调试
{branch} 的 CI 红了。失败 job：{job name}。日志节选：{粘贴关键段，不要整份}。
诊断：
1. 测试在断言什么？
2. 为什么现在挂？最近 {area} 有改动？
3. 最小修法：改测试、改代码、还是 revert {commit}？
先讲推理再给修法。12. 依赖升级 + 风险地图
在 {repo} 把 {dep} 从 {old} 升到 {new}。
先输出风险地图：
- changelog 里碰到我们用法的破坏性改动
- 我们代码里命中的相关文件
- 应该加 / 扩的测试
- 回滚计划
然后给出最小的第一个 PR。不要把这次升级和无关改动绑在一起。哪个 Prompt 配哪个模型
Claude Code 只跑 Anthropic 模型。用 /model 切换；下面是一份合理的默认分工（截至 2026 年 6 月）。
| Prompt 类型 | 模型 | 为什么 |
|---|---|---|
| 外科手术式修复、单文件改动、spike | Sonnet 4.6 | 快、便宜，对范围明确的活够聪明；大多数会话的默认 |
| 多文件重构、迁移规划、依赖风险地图 | Opus 4.7 | 跨文件推理更深；SWE-bench Verified 87.6%，对比 Gemini 3.1 Pro 80.6% |
| 大仓库里的长时只读调查 | Sonnet 4.6（或用 /model 第 4 项的 Opus Plan） | 两者都是 1M token 上下文；让 Explore 子代理去读 |
| 合并前的 diff 审查 | Sonnet 4.6 | 出一份结构化评论，很少需要 Opus 级推理 |
一个常见的省钱法是 “Opus Plan” 模式：Opus 4.7 起草计划，再由 Sonnet 4.6 执行，这样只在真正需要的那一段为顶配推理付费。
容易踩的坑
- “改进这段代码” 没 scope——Claude Code 直接重写半个文件。永远点明它可以动哪些文件、绝不能动哪些。
- 跳过 read-first 清单——Claude 按训练数据猜模式而不按你的仓库，diff 就偏离了你的约定。
- 没”不要动”约束——周边文件被顺手改，把 PR 撑大。
- 先要代码而不先要计划——丢掉了最便宜的复核点。用 Plan Mode 逼它过这道闸。
- 重构和特性混在同一 PR——两半都没法独立审，审出问题就只能全量回滚。
- 以为
/rewind能撤销一切——它只追踪 Claude 自己的文件编辑，不管rm、mv这类 bash 命令的改动。让 Claude 跑有破坏性的 shell 步骤之前，先 commit。
常见问题
这些 Prompt 用在 Codex 或 Cursor 上也行吗？
那个四段式（先读 / 可改 / 绝不能动 / 完成标准）和工具无关，所以行。Claude Code 专属的是那套配套机制：Plan Mode、/rewind 检查点、/model 切换。在 Cursor 里你会改用它自己的 plan 和 agent 模式；在 Codex CLI 里你得显式加一句”先给计划、等我批准”，因为工具本身没有强制的只读闸口。
怎么确保 Claude 真的先读文件再规划？ 在”先读”里列出确切路径，并在 Plan Mode 里跑。Plan Mode 是只读的，会读你的仓库，但要注意 Explore 和 Plan 子代理为了保持轻快会跳过你的 CLAUDE.md——当某条约定必须左右计划时，把它直接写进 Prompt，而不要只放在 CLAUDE.md 里。
日常写代码用 Sonnet 4.6 还是 Opus 4.7？
默认 Sonnet 4.6——它能又快又省地搞定绝大多数范围明确的任务。碰到多文件重构、迁移、需要更深推理的调试，再用 /model 切到 Opus 4.7。API 价格（截至 2026 年 6 月）：Sonnet 4.6 是每百万 token 输入 $3 / 输出 $15；Opus 4.7 是 $5 / $25。
如果 Claude 已经改完了才发现计划有问题怎么办？
跑 /rewind（或在空输入框按两下 Esc），把对话、代码、或两者一起还原到任意早先的检查点。检查点跨会话保留，30 天后自动清理。别忘了上面提到的 bash 命令那条注意事项。
为什么要 50 行的 spike，而不是直接写真实实现？ spike 是个用完就扔的探针，用来在你正式投入之前验证思路。读 50 行，比审一个 600 行、可能还得推倒重来的”成品”PR，能快得多地判断设计是否成立。