10. 计划与审查模式

两个维度：先想清楚，再查仔细

写代码最怕两种情况：一上来就乱改，改完才发现方向错了；改完不检查，上线后才发现 bug。Claude Code 针对这两个痛点分别提供了解决方案：

• 计划模式（Plan Mode）：让 Claude 先想清楚怎么改，给你看方案，你批准了再动手。
• 代码审查（Code Review）：让 Claude 帮你检查改好的代码，找出 bug 和安全隐患。

两者都有本地版和云端增强版。本地版在终端里跑，速度快、不花钱；云端版（Ultraplan / Ultrareview）在 Anthropic 的云基础设施上跑，更深入但有限额和费用。

本地计划模式（Plan Mode）

什么是 Plan Mode

Plan Mode 告诉 Claude：先研究代码库，提出修改方案，但不要真的动手改。Claude 可以读文件、跑探索性命令、写计划，但不会编辑你的源代码。

你可以把它想象成装修前的设计方案：设计师先量房、出图、跟你确认，你点头了才开工。不会一上来就砸墙。

怎么进入 Plan Mode

三种方式：

方式一：快捷键切换。 在交互模式中按 Shift+Tab 循环切换模式，切到 Plan Mode 时状态栏会显示。再按一次 Shift+Tab 可以退出。

方式二：斜杠命令。 在提示前加 /plan：

/plan 重构认证模块并补充测试

也可以只加 /plan 不带描述，进入 Plan Mode 后再输入任务。

方式三：启动时指定。

claude --permission-mode plan

审查和批准计划

当 Claude 研究完代码库，会呈现一份计划，问你怎么办。你有几个选择：

• 批准并在自动模式中启动（自动执行，带安全检查）
• 批准并接受编辑（自动编辑文件，不需逐个确认）
• 批准并手动审查每个编辑（每个操作都要你确认）
• 继续规划并提供反馈（让 Claude 修改方案）
• 使用 Ultraplan 进行基于浏览器的审查

批准计划后，Claude 会自动退出 Plan Mode，切换到对应的权限模式开始执行。如果你想再次规划，按 Shift+Tab 切回，或在下一条消息前加 /plan。

设为默认模式

如果你希望每次都先规划再执行，可以在 settings.json 中设置：

{
  "permissions": {
    "defaultMode": "plan"
  }
}

云端计划：Ultraplan

什么是 Ultraplan

Ultraplan 是 Plan Mode 的云端增强版。它把规划任务交给 Claude Code 网络版（Claude Code on the web）的会话，Claude 在云端草拟计划，你可以继续在终端里干别的事。计划准备好后，在浏览器里审查、评论，最后选择在哪里执行。

三种启动方式

方式一：斜杠命令。

/ultraplan migrate the auth service from sessions to JWTs

方式二：关键词。 在普通提示中包含 ultraplan 这个词：

帮我规划一下迁移认证服务的方案，用 ultraplan

方式三：从本地计划升级。 当 Claude 完成本地计划并显示批准对话框时，选择「No, refine with Ultraplan on Claude Code on the web」，把草稿发到云端进一步迭代。

状态指示器

云会话启动后，终端会显示状态：

状态	含义
◇ ultraplan	Claude 正在研究代码库并草拟计划
◇ ultraplan needs your input	Claude 有澄清问题，打开链接回答
◆ ultraplan ready	计划已准备好，在浏览器中审查

运行 /tasks 可以查看 ultraplan 的详细视图，包含会话链接和「Stop ultraplan」操作。

在浏览器中审查

状态变成 ◆ ultraplan ready 后，打开会话链接，在 claude.ai 上查看计划。审查界面提供：

• 内联评论：选中任意段落留评论，让 Claude 修改
• 表情反应：对部分点赞或标记关注，不用写完整评论
• 大纲侧边栏：在计划的各部分之间快速跳转

你可以反复迭代，直到满意为止。

选择执行位置

计划确认后，有两个选择：

在云端执行： 选择「Approve Claude’s plan and start coding」，Claude 在同一云会话中实现。完成后在网页上审查差异并创建 PR。终端会被释放。

发回终端执行： 选择「Approve plan and teleport back to terminal」，计划发回本地终端执行。终端会弹出对话框，三个选项：

• Implement here：注入当前对话继续
• Start new session：清空对话，以计划为唯一上下文重新开始
• Cancel：保存计划到文件，稍后再处理

本地代码审查

Claude Code 提供了几个本地审查命令，在终端里直接跑，速度快，不额外花钱。

/code-review

最基本的代码审查命令，检查当前差异中的正确性错误和清理机会：

/code-review

默认审查你分支相对于上游的提交加上工作树中未提交的更改。可以传参数控制范围和深度：

/code-review high              # 更高工作量，覆盖更广
/code-review --fix              # 审查后自动应用修复
/code-review --comment          # 作为内联 PR 评论发布
/code-review 1234               # 审查指定 PR
/code-review main...my-feature  # 审查指定范围

工作量级别从低到高：low、medium、high、xhigh、max。低级别返回少但置信度高的发现，高级别覆盖更广但可能有不确定的结果。

/simplify

专门做代码清理，不找 bug，只找可简化的地方：

/simplify
/simplify src/utils/

四个审查代理并行运行，检查：现有工具函数的复用、代码简化、效率优化、抽象层级是否合适。找到后直接应用修复。

/security-review

安全专项审查，检查当前分支的待处理更改中的安全漏洞：

/security-review

检查内容包括 SQL 注入、XSS、命令注入、身份验证问题、敏感信息泄露等。上线前建议必跑一次。

/review

针对 GitHub PR 的快速单遍只读审查：

/review           # 列出开放 PR 供选择
/review 1234      # 审查指定 PR

云端审查：Ultrareview

什么是 Ultrareview

Ultrareview 是代码审查的云端增强版。运行 /code-review ultra 时，Claude Code 在远程沙箱中启动一队审查代理，并行查找你分支或 PR 中的 bug。

和本地审查相比，Ultrareview 的优势：

• 更高的信号质量：每个发现都经过独立复现和验证，结果专注于真实错误而非风格建议
• 更广的覆盖范围：多个审查代理并行探索，发现本地审查可能遗漏的问题
• 不占本地资源：审查完全在远程沙箱中运行，终端保持空闲

怎么运行

交互式：

/code-review ultra
/code-review ultra 1234

不带参数审查当前分支与默认分支的差异。带 PR 号审查指定的 Pull Request。

非交互式（CI/脚本）：

claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main

非交互模式会阻塞等待审查完成，发现打印到 stdout，成功退出码 0，失败退出码 1。加 --json 获取原始数据，--timeout 设置超时。

费用和免费额度

Ultrareview 是高级功能，按额外使用量计费：

计划	免费运行	免费用完后
Pro	3 次	按额外使用量计费（约 $5-$20/次）
Max	3 次	按额外使用量计费（约 $5-$20/次）
Team / Enterprise	无	按额外使用量计费

3 次免费运行是每个账户的一次性配额，不会刷新。费用根据更改大小变化，通常在 $5 到 $20 之间。

跟踪审查进度

审查通常需要 5-10 分钟，作为后台任务运行。你可以继续工作、运行其他命令，甚至关闭终端。

用 /tasks 查看运行中和已完成的审查。审查完成后，验证过的发现在会话中显示为通知，每个发现包含文件位置和问题解释，你可以直接让 Claude 修复。

三种审查方式对比

	/code-review	/review <pr>	/code-review ultra
目标	你的工作差异	GitHub PR	工作差异或 PR
运行位置	本地会话	本地会话	云沙箱
深度	随工作量参数扩展	单次审查	多代理并行+独立验证
耗时	几秒到几分钟	几秒到几分钟	约 5-10 分钟
费用	计入正常使用量	计入正常使用量	免费额度后 $5-$20/次
最适合	迭代时快速反馈	审查队友的 PR	合并重大更改前的信心检查

什么时候用什么

这里我给一些经验建议：

日常开发迭代。 用本地 /code-review，快、免费、够用。改完一波就跑一次，及时发现问题。

简单任务直接干。 不需要每次都进 Plan Mode。只有改动范围大、涉及多个模块、或者你对代码库不太熟的时候，才值得先规划。

复杂改动前先规划。 比如重构认证系统、迁移数据库、大规模框架升级。本地 Plan Mode 够用时就用本地，如果需要更丰富的审查界面（段落级评论、大纲导航），用 Ultraplan。

上线前必查安全。 /security-review 跑一遍，特别是涉及用户输入、认证、权限的改动。

合并重大 PR 前。 用 Ultrareview 做一次深度审查。虽然要花钱，但一个线上 bug 的代价远高于 $20 的审查费。