Claude Code 计划模式工作流（Plan Mode）

方法定义

让 Claude Code 在写代码之前先输出实施计划的工作流。橙皮书（claude-code-orange-book（Claude Code 橙皮书仓库））把它定位为"先描述目标和验收结果，再让 Agent 规划"的核心实践，与 CLAUDE.md 项目级指令文件（Claude Code 项目宪法） 配合使用：Agent 先读 CLAUDE.md，再进入计划模式输出可被人工审核的实施步骤。

适合哪些情况

• 任务范围较大、改动可能跨越多个文件
• 团队成员需要先就方案达成一致再让 Agent 动代码
• 经验不充足的使用者想避免 Agent 直接大改项目
• 任务涉及外部资源（API、数据库、第三方平台），需要先确认依赖和顺序

常见做法

1. 在提示中明确"目标 + 验收标准 + 约束"，而不是只说"帮我做 X"
2. 让 Agent 进入 Plan Mode，输出步骤化的实施计划而不是直接动代码
3. 对计划逐条审阅：是否有缺失文件、是否触碰禁区、是否需要拆分给 Subagents
4. 通过后再让 Agent 按小步骤实施，并在每一步后验证
5. 把通过的方案沉淀到 CLAUDE.md 或项目文档，避免下次重复解释

限制和检查点

• 计划本身不能保证正确，仍需依赖 CLAUDE.md 中的约束与人工审阅
• 不要把"先出计划"变成"先出很长的报告"——目标是可执行步骤，而不是文档
• 在多 Agent 场景中，每个 Subagent 也应遵守同一份主计划，避免各自为政
• 计划模式并不能替代测试与构建，命令执行结果仍是最终判断依据

来源

• claude-code-orange-book（Claude Code 橙皮书仓库）
• HuaShu（花叔）
• HuaShu《Claude Code 橙皮书》教程摘要
• sources/25-08-development-automation--35-src-dev-002-claude-code-orange-book--1m81cqu