跳到主要内容

规划模式

入门
What you'll learn
  • 解释规划模式做什么，以及它为什么是只读的
  • 判断何时该先规划、何时可以跳过
  • 走一遍调查—提案—批准—执行的循环
  • 区分规划模式与权限，并把两者配合使用

核心理念​

想象一下，是把房子钥匙直接交给承包商，还是先请他走一遍并写下他打算改动什么。规划模式就是这趟走查。

规划模式让 Claude Code 变为只读：它可以浏览你的代码库、运行搜索、进行推理——但它不会编辑文件或运行改变状态的命令。相反，它产出一份方案并等待你的批准。

Pro tip
  • 只读意味着 Claude 只思考、不动手——在你说开始之前，不编辑文件、不运行改变状态的命令。

为什么它是最安全的起步方式​

对于任何大型、有风险或不熟悉的事情，你都会想在 Claude 触碰你的仓库之前看清它打算做什么。规划模式把思考和动手分开：

回报是：你能在错误的假设变成错误的代码之前就抓住它们。

何时使用​

Pro tip
  • 对于大型或跨多文件的改动、迁移或重构，总是使用
  • 当你在一个尚未完全熟悉的代码库里工作时
  • 当你想要一份可审阅的方案、好与队友分享时

对于细小、显而易见的编辑，你可以跳过它——但拿不准时，先规划。

实践中如何工作​

跟着这个循环走。每一步都为下一步铺路——只有在你批准之后，Claude 才会切换到编辑。

Guided walkthrough1 of 4
  1. 切换到只读模式，然后描述你想达成什么。

自己动手试试​

把下面这段复制到一个真实的规划会话里，看着这个循环跑起来：

启动一次规划会话

I want to migrate our auth from sessions to JWT. Stay in Plan Mode: investigate the current setup, ask anything you need, then propose a step-by-step plan with files to change and how to verify — don't edit anything yet.

:::tip 与 CLAUDE.md 搭配 一份好的 CLAUDE.md 能让方案更精准——Claude 在规划时就已把你的约定和护栏考虑在内。 :::

规划模式 vs 权限​

一个经典的混淆点。它们解决不同的问题，且协同工作：

  • 规划模式 = "先调查并提方案，暂不动手。"（本页内容。）
  • 权限 = 一旦动手，哪些操作可以不经询问就执行。

可以这样想：现在是否要动手（规划模式）对比一旦动手哪些操作被允许（权限）。

按 Enter 或空格键翻转卡片。使用左右方向键在卡片之间切换。已显示术语。
1 / 4
Key takeaways
  • 规划模式是只读的：Claude 浏览并提方案，但在你批准之前绝不编辑文件或运行改变状态的命令
  • 对于大型、有风险或不熟悉的工作默认使用它；只有细小显而易见的编辑才跳过
  • 循环是调查到提案到批准/改进到执行
  • 规划模式管的是现在是否要动手；权限管的是一旦动手哪些操作被允许

自测一下

0/4
  1. 在规划模式下 Claude Code 能做什么？
  2. 什么时候该用规划模式？
  3. 规划模式循环的正确顺序是什么？
  4. 规划模式和权限有何不同？

下一步​