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"
  }
}