Plan Mode

Plan Mode

安全地探索和分析代码，无需进行任何修改。

什么是 Plan Mode？

Plan Mode 是一种只读权限模式，Claude 可以探索你的代码库、分析代码并提出计划——但无法写入文件、运行命令或进行任何修改。这是获取 Claude 分析的最安全方式。

如何激活

三种进入 Plan Mode 的方式：

  • Shift + Tab — 循环切换模式：default → acceptEdits → plan
  • 直接启动：claude --permission-mode plan
  • 在提示词前加 /plan 让单轮对话进入 plan 模式，结束后自动退出

探索 → 计划 → 编码 模式

使用 Claude Code 处理非简单任务的最有效方式：

1. 探索（Plan Mode）

在动手之前先理解代码库：

text
/plan 我需要为 API 添加限流。
探索 @src/api/ 和 @src/middleware/。
已经使用了哪些模式？限流应该放在哪里？

2. 计划（仍在 Plan Mode）

让 Claude 生成详细的实现计划：

text
根据你的发现，创建一个分步计划：
- 需要创建/修改哪些文件
- 需要编写哪些测试
- 实现的先后顺序
先不要实现。

3. 编码（default / acceptEdits）

批准计划，或用 Shift + Tab 切回 default / acceptEdits 后执行：

text
实现上面的限流计划。
每完成一个步骤就提交。

何时使用 Plan Mode

  • 入职上手 — 探索你刚加入的新代码库
  • Bug 诊断 — 追踪问题而不会意外修改代码
  • 架构评审 — 分析模式、依赖关系和技术债务
  • 安全审计 — 扫描漏洞而不修改任何内容
  • 代码审查 — 深度分析 PR

技巧

  • 在 Plan Mode 中使用 @ 文件引用——Claude 可以读取你指向的任何文件
  • 对于复杂的架构问题，明确说明需要分析的内容
  • 批准计划后，Claude 会自动切到你选的权限模式（auto / acceptEdits / 手动逐项）开始改代码
  • 在批准之前按 Ctrl + G 可在编辑器中打开并修改 plan
  • 只想单轮进 plan 模式时，在提示词前加 /plan 即可，不必切换模式

为什么「先计划再编码」如此有效？

探索 → 计划 → 执行循环是所有自主智能体背后的基本模式。理解这种架构有助于你更有效地使用任何 AI 编程工具。

学习 Agent 基础知识

延伸阅读

  • 工作流 — 查看 Plan Mode 在完整工作流中的实际应用
  • Cloud Workflows — 把大型计划移到 Ultraplan 中 review
  • Dynamic Workflows — 把广泛计划变成 multi-agent workflow scripts
  • 调试 — 使用 Plan Mode 进行安全的 Bug 诊断
  • Hooks — 在计划完成后自动化执行操作

继续实践

Plan Mode 的核心概念已经读完

如果你想把理解变成可复用的能力，可以到 AgentWay 继续练习

进入练习