Claude Code 的高级功能通过规划模式、扩展思考、Auto Mode 和精细的权限控制系统,实现了从意图审查到自主执行的全流程管理。规划模式支持本地和云端(Ultraplan)两种计划制定方式;扩展思考通过 Alt+T/Option+T 切换和多级 effort 控制推理深度;Auto Mode 结合后台分类器自动评估操作安全性;六大权限模式则为不同场景提供从完全只读到完全跳过检查的灵活控制。本文将结合 config-examples.json 中的配置示例,详解这些功能的启用、配置与实战应用。

Claude Code 高级功能全览:规划模式、Auto Mode、扩展思考与权限系统

Claude Code 提供了一套强大的高级功能,让开发者能够精细控制 AI 的推理、规划和执行过程,从而构建更安全、高效的工作流。这些功能覆盖了从构思到落地的完整链路。

1. 规划模式:结构化实施

规划模式(Planning Mode)将任务执行分为两个阶段:先制定详细计划供您审查批准,再按计划实施。这适用于复杂的多文件重构、新功能开发或架构变更。

激活与使用

  • 斜杠命令:在 REPL 中输入 /plan <你的任务描述>
  • CLI 标志claude --permission-mode plan
  • 键盘快捷键:使用 Shift+TabAlt+M 在不同权限模式间切换至 plan

核心流程

  1. 您发出 /plan 指令。
  2. Claude 分析任务,生成分阶段的详细实施计划。
  3. 您可选择“yes”批准、“modify plan”修改或“no”拒绝。
  4. 批准后,Claude 按计划逐步实施。

重要更新 (v2.1.136):计划模式下的文件写入阻断现在是无条件的。即使您的 permissions.allow 规则中存在匹配的 Edit(...) 条款,写入操作也会被阻止。如果旧工作流依赖此特性,需要在编辑前退出计划模式。

高级别名:使用 opusplan 模型别名,可以让 Claude 使用 Opus 模型进行规划,而用 Sonnet 模型执行,平衡质量与成本:

claude --model opusplan "design and implement the new API"

您还可以按 Ctrl+G 将当前计划在外部编辑器中打开进行精细调整。

2. Ultraplan 云端规划

Ultraplan 是规划模式的云端增强版(研究预览)。它将规划任务委托给运行在 claude.ai/code 云环境中的 Claude Code 实例,您的终端可以同时进行其他工作。

适用场景

  • 需要更丰富的评审界面(行内评论、表情回应、大纲侧边栏)。
  • 希望在本地编码时,让云端实例自动研究代码库并起草计划。
  • 计划需要利益相关者在 Web 上共同审查。

三种启动方式

/ultraplan migrate the auth service from sessions to JWTs

或在普通提示中包含“ultraplan”关键词,或在本地计划完成后选择“No, refine with Ultraplan on Claude Code on the web”。

计划就绪后,您可以在浏览器中审批,并选择在云端执行或“传送”回本地终端执行。详细操作流程和实战场景可参考 规划模式 5 大实战场景

3. 扩展思考:深度推理

扩展思考(Extended Thinking)让 Claude 在提供解决方案前,进行更长时间的逐步推理。

激活与控制

  • 切换Option+T (macOS) 或 Alt+T (Windows/Linux)。
  • 查看推理Ctrl+O 进入详细模式。
  • 设置努力等级:使用 /effort 命令或 --effort CLI 标志。

努力等级:对于 Opus 4.7,支持 low (○)、medium (◐)、high (●)、xhigh (Opus 4.7 专属,自 2026-04-16 起在 Claude Code 中默认启用) 和 max。在提示中使用关键词“ultrathink”也能激活深度推理。

环境变量配置

export CLAUDE_CODE_EFFORT_LEVEL=xhigh   # 设置默认努力等级
export MAX_THINKING_TOKENS=16000        # 设置思考 token 预算

Pro/Max 订阅用户使用 Opus 4.6/Sonnet 4.6 时,v2.1.117 已将默认努力等级从 medium 提升至 high

4. Auto Mode:自主安全执行

Auto Mode(研究预览)利用后台安全分类器在每次操作执行前进行评估,允许 Claude 自主工作,同时自动阻断危险操作。

要求与启用

  • 计划:团队、企业版或 API(Pro/Max 计划不可用)。
  • 模型:Claude Sonnet 4.6 或 Opus 4.7。
  • 提供商:仅限 Anthropic API。
  • 启用claude --permission-mode auto 或在 REPL 中按 Shift+Tab 切换。v2.1.112 起,Max 订阅者可直接在 Opus 4.7 上使用。

分类器决策流程

  1. 检查显式允许/拒绝规则。
  2. 自动批准只读和文件编辑操作。
  3. 由后台分类器(基于 Sonnet 4.6)审查该操作。
  4. 若分类器连续拒绝 3 次或累计拒绝 20 次,则回退到提示用户。

默认操作表

  • 默认阻止curl | bash、发送敏感数据、生产部署、rm -rf 大量目录、IAM 变更、强制推送到 main
  • 默认允许:本地文件操作、从清单文件安装依赖、只读 HTTP 请求、推送到当前分支。

关键配置更新

  • $defaults 令牌 (v2.1.118+):在 autoMode.allowautoMode.soft_denyautoMode.environment 中使用 "$defaults",可以在内置规则基础上追加您自己的规则,而不是替换它们。
  • hard_deny 规则 (v2.1.136+)autoMode.hard_deny 数组中的规则会无条件阻止相应操作,无论分类器如何推断用户意图。适用于必须绝对禁止的操作。
// 扩展默认规则示例 (v2.1.118+)
{
  "autoMode": {
    "allow": ["$defaults", "Bash(gh pr list:*)"],
    "soft_deny": ["$defaults", "Bash(kubectl delete:*)"],
    "hard_deny": ["Bash(rm -rf /:*)", "Bash(git push --force*)"],
    "environment": ["$defaults", "trusted-ci.internal"]
  }
}

如果您没有团队计划,但仍想获得类似的保守权限基准,可以使用仓库中的脚本 09-advanced-features/setup-auto-mode-permissions.py。它从只读规则开始,逐步允许编辑、测试、本地 Git 写入等,并明确排除危险操作。

5. 六大权限模式

权限模式控制 Claude 无需明确批准即可执行哪些操作。可通过 Shift+Tab 循环切换。

模式 行为 典型场景
default 仅读取文件;其他所有操作都需提示 结对编程、初步探索
acceptEdits 自动接受文件读写;命令执行仍需提示 批量代码修复、重构
plan 仅读取文件(研究模式,无写入) 代码审查、方案设计
auto 后台分类器检查所有操作(研究预览) 有限自治任务、监控
dontAsk 仅执行预先批准的工具;其他全部拒绝 严格管控的 CI/CD
bypassPermissions 跳过所有权限检查(危险) 一次性沙盒实验

设置默认模式:

claude --permission-mode auto
# 或在配置中
{
  "permissions": {
    "defaultMode": "auto"
  }
}

v2.1.121/v2.1.126 扩展了 --dangerously-skip-permissions 标志覆盖的路径,使其绕过对 .claude/.git/ 等目录的写入提示,但 rm -rf / 等灾难性命令仍会提示。

6. 其他关键功能

  • 打印模式 (Headless Mode)claude -p "任务描述" 以非交互模式运行,适用于 CI/CD 和脚本。支持 --max-turns--output-format json 等标志。
  • 会话管理:使用 /resume/rename/fork 管理会话,claude -c 继续上次会话,claude -r "名称" 恢复指定会话。
  • 后台任务:在对话中启动长时间任务(如测试、构建),使用 /task 系列命令管理。
  • 交互功能Ctrl+O 切换详细输出,Ctrl+T 切换任务列表视图,Ctrl+R 搜索历史记录(v2.1.129+ 默认搜索所有项目历史)。

7. 场景化配置模板

config-examples.json 提供了多个配置模板,展示如何组合上述功能。例如:

  • 开发环境:启用规划(autoEnter: true)和后台任务,使用钩子在写入后格式化代码。
  • 代码审查:使用 plan 权限模式,启用扩展思考以显示推理过程。
  • CI/CD 流水线:使用非交互模式(headless),权限设为 unrestricted,规划功能关闭。
  • 大型重构:使用 opus 模型,强制规划且需审批,启用检查点,并在编辑后自动运行相关测试。

选择配置时,应根据任务对自主性、安全性和推理深度的需求来决定。更完整的 CLI 用法和脚本集成方案,请参考 Claude Code CLI 参考手册

FAQ

Q: 如何选择合适的权限模式? A: 从最严格的 plan(只读审查)或 default(逐步确认)开始。对批量文件修改使用 acceptEdits。仅在高度信任的自动化场景中考虑 autobypassPermissions

Q: Auto Mode 有哪些主要限制? A: 1) 仅适用于团队、企业版或 API 计划;2) 仅在 Anthropic API 上可用;3) 后台分类器会消耗额外 token;4) 分类器可能不确定,导致回退到用户提示。

Q: 扩展思考的“努力等级”如何影响输出? A: 等级越高,Claude 用于推理的 token 预算和时间通常越多,适用于更复杂的问题。xhigh 是 Opus 4.7 的默认等级,在深度和成本间取得了良好平衡。可在对话中用 /effort 动态调整。