Use Plan Mode for safe code analysis
使用计划模式进行安全的代码分析
Plan Mode instructs Claude to create a plan by analyzing the codebase with read-only operations, perfect for exploring codebases, planning complex changes, or reviewing code safely.
In Plan Mode, Claude uses AskUserQuestion to gather requirements and clarify your goals before proposing a plan.
计划模式指示 Claude 通过只读操作分析代码库来创建计划，非常适合探索代码库、规划复杂变更或安全地审查代码。
在计划模式下，Claude 先使用 AskUserQuestion 工具来收集需求并澄清您的目标，然后再提出计划。
一，When to use Plan Mode
何时使用计划模式
Multi-step implementation: When your feature requires making edits to many files
多步实现：当您的功能需要修改多个文件时
Code exploration: When you want to research the codebase thoroughly before changing anything
代码探索：在更改任何内容之前，您想要彻底研究代码库
Interactive development: When you want to iterate on the direction with Claude
交互式开发：当你想与 Claude 一起迭代开发时
二，How to use Plan Mode
如何使用计划模式
1，Turn on Plan Mode during a session
在会话期间开启计划模式
You can switch into Plan Mode during a session using Shift+Tab to cycle through permission modes.
可以使用 Shift+Tab 在会话期间切换到计划模式，并循环浏览各种模式。
If you are in Normal Mode, Shift+Tab first switches into Auto-Accept Mode, indicated by ⏵⏵accept edits on at the bottom of the terminal.
A subsequent Shift+Tab will switch into Plan Mode, indicated by ⏸ plan mode on.
如果你处于普通模式，Shift+Tab 首先会切换到自动接受模式，终端底部会显示 ⏵⏵ accept edits on 。
随后的 Shift+Tab 会切换到计划模式，显示 ⏸ plan mode on 。
记住这个快捷键。
2，Start a new session in Plan Mode
在计划模式下启动新会话
To start a new session in Plan Mode, use the --permission-mode plan flag:
要在计划模式下启动新会话，使用 --permission-mode plan 标志：
claude --permission-mode plan
3，Run "headless" queries in Plan Mode
在计划模式下运行"无头"查询
You can also run a query in Plan Mode directly with -p (that is, in "headless mode"):
您也可以直接使用 -p 在计划模式下运行查询（即在"无头模式"下）：
claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"
分析认证系统并提出改进建议
现在用一个示例来演示下：
三，示例：Planning a complex refactor
规划一个复杂的重构
claude --permission-mode plan
> I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
我需要使用OAuth2重构身份验证系统。请创建一份详细的迁移计划。
Claude analyzes the current implementation and create a comprehensive plan. Refine with follow-ups:
Claude 分析当前实现并创建一个全面的计划。通过后续跟进进行细化：
> What about backward compatibility? //向后兼容性怎么样？
> How should we handle database migration? //应该如何处理数据库迁移？
四，Configure Plan Mode as default
将计划模式设为默认
// .claude/settings.json
{
"permissions": {
"defaultMode": "plan"
}
}