阶段 2 · 工作流与会话控制——把"会用"变成"高效且可控"

阶段一：探索（Explore）#

切换到 Plan Mode，只读不改。

1
# 在 Plan Mode 下发送：
2
read @src/auth and understand how we handle sessions and login.
3
also look at how we manage environment variables for secrets.

为什么要先进 Plan Mode？ Plan Mode 下 Claude 读文件、跑只读命令，但不碰你的源码。探索阶段的目的是建立对代码库的理解，而不是让 Claude 凭感觉直接开写。

阶段二：规划（Plan）#

仍在 Plan Mode，要求 Claude 输出详细实现计划。

1
I want to add Google OAuth. What files need to change?
2
What's the session flow? Create a plan.

收到计划后，按 Ctrl+G 在系统默认文本编辑器中打开计划直接编辑，改完保存后 Claude 继续基于修订后的计划推进。

判断是否需要规划的标准： 如果你能用一句话描述整个 diff，就跳过规划直接做。规划最有价值的场景是：改动横跨多个文件、你对被改代码不熟、实现方案有分叉。

阶段三：实现（Implement）#

退出 Plan Mode，切回正常模式（再按一次 Shift+Tab），给 Claude 验证手段。

1
implement the OAuth flow from your plan. write tests for the
2
callback handler, run the test suite and fix any failures.

关键：给 Claude 一个可以运行的验证检查。 测试、构建命令、截图比对——任何能返回”通过/失败”信号的东西都行。没有验证手段，Claude 以”看起来完成了”为准，你就成了唯一的验证循环。

阶段四：提交（Commit）#

1
commit with a descriptive message and open a PR

Claude 会自动汇总改动、生成 PR 描述。用 gh pr create 创建的 PR 会自动关联当前会话，之后可用 claude --from-pr <number> 恢复到该 PR 的会话上下文。

2.1 Context 是最贵的资源，主动管理它#

自定义状态行（/statusline）可实时显示 context 占用百分比，建议开启。

2.2 验证闭环：三个层次#

1. 单次提示级 — 在提示里直接要求 Claude 运行测试并迭代直到通过；
2. /goal 级 — 设置完成条件，独立评估器在每个回合后检查，Claude 自动继续；
3. Stop hook 级 — 在 .claude/settings.json 里注册脚本，每次回合结束自动运行，可阻断回合。

2.3 两次改正失败就重开#

在一个会话里对同一问题改正 Claude 超过两次，context 已经被失败方案污染了。正确做法：/clear 然后用更精准的提示重新开始，把你从失败尝试中学到的约束条件直接写进新提示。

2.4 提示精度决定结果质量#

启用方式#

审查与批准计划#

计划呈现后，你有多个选项：

• 批准并在 auto mode 中启动 — 让 Claude 自主执行计划，后台有安全分类器
• 批准并接受编辑 — 切换到 acceptEdits 模式执行
• 批准并手动审查每步编辑 — 切换到默认模式，每次文件修改都询问
• 继续规划并提供反馈 — 保持 Plan Mode，对计划提出修改意见
• Ctrl+G — 在文本编辑器中直接编辑计划内容

计划被接受时，会话名称会自动根据计划内容命名（除非你已用 --name 或 /rename 手动命名过）。

退出 Plan Mode#

再次按 Shift+Tab 即可退出，不会批准当前计划。

切换方式#

会话中实时切换：

1
# 在终端会话内按 Shift+Tab 循环切换
2
# 当前模式显示在状态栏

启动时指定：

1
claude --permission-mode acceptEdits
2
claude --permission-mode plan
3
claude --permission-mode auto

设为持久默认（写入 settings.json）：

1
{
2
  "permissions": {
3
    "defaultMode": "acceptEdits"
4
  }
5
}

Auto Mode 重点说明#

Auto Mode（v2.1.83+）是进阶用户最值得掌握的模式。其核心机制：一个独立的分类器模型在每个命令运行前审查，阻止超出请求范围的操作、涉及未知基础设施的操作、或被恶意内容诱导的操作。

默认阻止的操作类型：

• curl | bash 式下载执行
• 向外部端点发送敏感数据
• 生产环境部署和迁移
• 强制推送或直接推送到 main
• 不可逆删除会话开始前已存在的文件

默认允许的操作类型：

• 工作目录内的本地文件操作
• 安装 lockfile/manifest 中已声明的依赖
• 向 .env 中匹配的 API 发送凭证
• 只读 HTTP 请求
• 推送到当前分支或 Claude 新建的分支

Auto Mode 回退机制： 分类器连续阻止 3 次或总共阻止 20 次时，自动暂停并恢复询问模式。批准一次后恢复 auto。在 -p 非交互模式下，重复阻止会直接终止会话。

重要限制： defaultMode: "auto" 只能写在用户级设置 ~/.claude/settings.json 中，项目级 .claude/settings.json 中的该设置会被忽略（防止仓库自授权）。

bypassPermissions 使用边界#

此模式跳过所有提示和安全检查。在 Linux/macOS 上以 root 运行时会拒绝启动。针对文件系统根目录或主目录的删除操作（rm -rf /、rm -rf ~）仍保留断路器提示。

1
# 正确用法：只在隔离容器内
2
claude --permission-mode bypassPermissions
3
# 等效写法：
4
claude --dangerously-skip-permissions

受保护路径#

在除 bypassPermissions 之外的所有模式中，以下目录的写入操作永远不会自动批准：

.git、.vscode、.idea、.husky、.cargo、.devcontainer、.yarn、.mvn、.claude（除 .claude/commands、.claude/agents、.claude/skills、.claude/worktrees）

以及 .gitconfig、.bashrc、.zshrc、.npmrc 等敏感配置文件。

规则优先级：deny > ask > allow#

第一个匹配的规则获胜。任何层级的 deny 规则都无法被其他层级的 allow 规则覆盖。

基本语法#

1
{
2
  "permissions": {
3
    "allow": [
4
      "Bash(npm run *)",
5
      "Bash(git commit *)",
6
      "Bash(git status)",
7
      "WebFetch(domain:docs.anthropic.com)"
8
    ],
9
    "ask": [
10
      "Bash(git push *)"
11
    ],
12
    "deny": [
13
      "Bash(rm -rf *)",
14
      "Bash(git push --force *)"
15
    ]
16
  }
17
}

Bash 规则通配符语法#

1
"Bash(npm run *)"          // 匹配所有 npm run 命令（注意 * 前的空格）
2
"Bash(npm*)"               // 匹配 npm、npmci 等（无边界约束）
3
"Bash(git * main)"         // 匹配 git checkout main、git merge main 等
4
"Bash(* --version)"        // 匹配任意工具的 --version 调用
5
"Bash(*)"                  // 等同于 Bash，匹配所有

复合命令处理： Claude Code 理解 &&、||、;、| 等分隔符，规则必须独立匹配每个子命令。批准 git status && npm test 会分别保存两条规则。

只读命令豁免： ls、cat、echo、grep、find、git log、git status、git diff 等只读命令在所有模式下无需权限提示。

PowerShell 规则（Windows）#

1
{
2
  "permissions": {
3
    "allow": [
4
      "PowerShell(Get-ChildItem *)",
5
      "PowerShell(git commit *)"
6
    ],
7
    "deny": [
8
      "PowerShell(Remove-Item *)"
9
    ]
10
  }
11
}

PowerShell 规则匹配不区分大小写，常见别名（gci、ls、dir）在匹配前被规范化为 cmdlet 名称。

文件读写规则#

1
{
2
  "permissions": {
3
    "deny": [
4
      "Read(**/.env)",
5
      "Read(~/.ssh/**)",
6
      "Edit(/migrations/**)"
7
    ],
8
    "allow": [
9
      "Edit(/src/**)",
10
      "Read(~/project-docs/**)"
11
    ]
12
  }
13
}

路径锚点规则：

Windows 路径规范化： 路径在匹配前统一转换为 POSIX 形式，C:\Users\alice 变为 /c/Users/alice，使用 //c/**/.env 匹配 C 盘下的 .env 文件，//**/.env 匹配所有盘。

WebFetch 和 MCP 规则#

1
{
2
  "permissions": {
3
    "allow": [
4
      "WebFetch(domain:github.com)",
5
      "WebFetch(domain:npmjs.com)",
6
      "mcp__github",
7
      "mcp__github__create_issue"
8
    ],
9
    "deny": [
10
      "mcp__puppeteer"
11
    ]
12
  }
13
}

查看与管理权限#

1
/permissions    # 打开权限管理 UI，查看所有规则来源

工作原理#

每次你发送提示，Claude Code 都自动为当前文件状态创建一个检查点。检查点跨会话持久化（默认保留 30 天），即使关掉终端再用 --resume 恢复，检查点依然可用。

重要限制： 检查点只跟踪 Claude 的文件编辑工具（Edit/Write）所做的改动，不跟踪 Bash 命令的副作用（rm、mv 等）。检查点是会话级撤销，不替代 Git。

打开回滚菜单#

1
# 方法一：运行命令
2
/rewind
3

4
# 方法二：提示输入为空时连按两次 Esc
5
# （提示框有内容时，双 Esc 是清空输入，不会打开菜单）

回滚操作选项#

选中某个检查点后，可以执行：

恢复 vs 总结的选择逻辑#

• 想撤销代码改动 → 选「恢复代码」或「恢复代码和对话」
• 想尝试不同方向但保留代码 → 选「恢复对话」，再给新指令
• 调试会话太长，想压缩前半段 → 找到调试开始的检查点，选「到此处总结」
• 想放弃某个分支探索但保留之前的积累 → 选「从此处总结」，指定压缩范围

检查点与 Git 的关系#

检查点覆盖的是「会话内撤销」的场景：试验性改动失败了，快速回退。Git 承担「永久版本历史」职责。两者互补，不要用检查点替代 git commit。

恢复上次会话#

1
# 恢复当前目录最近的会话（无对话则报错退出）
2
claude --continue
3

4
# 打开会话选择器，从列表中选择
5
claude --resume
6

7
# 直接按名称恢复
8
claude --resume oauth-migration
9

10
# 恢复关联到某个 PR 的会话
11
claude --from-pr 1234

命名会话#

1
# 启动时命名
2
claude -n oauth-migration
3

4
# 会话中重命名
5
/rename oauth-migration

命名后可按名称恢复，也可在会话选择器中按 Ctrl+R 重命名。在 Plan Mode 接受计划时，若未手动命名，会自动根据计划内容生成名称。

会话选择器快捷键#

在 claude --resume 打开的选择器中：

分支会话：同一起点，两个方向#

1
# 在会话内创建分支
2
/branch try-streaming-approach
3

4
# 命令行分支启动
5
claude --continue --fork-session

分支创建当前会话的完整副本，原始会话不受影响，两个会话在选择器中以树形分组。分支间的权限批准不共享。

适用场景： 不确定两种实现哪个更好时，在当前状态开分支，分别实验，比较结果后合入主分支或丢弃。

会话数据位置#

会话以 JSONL 格式存储于：

1
~\.claude\projects\<project>\<session-id>.jsonl

默认 30 天后自动清理，可在 settings.json 中用 cleanupPeriodDays 修改。

导出当前会话：

1
/export                    # 复制到剪贴板
2
/export session-2024.txt   # 保存为文件

基本使用#

1
# 设置目标
2
/goal all tests in test/auth pass and the lint step is clean
3

4
# 查看当前状态（回合数、Token 消耗、评估器最新判断）
5
/goal
6

7
# 提前终止
8
/goal clear

目标激活后，状态栏显示 ◎ /goal active 及运行时长。

编写有效的完成条件#

评估器不能独立执行命令，它只看 Claude 在对话中呈现的内容。因此条件要写成「Claude 的输出可以证明的事情」：

1
# 好的条件写法
2
/goal npm test exits 0 with no failing tests in the auth module
3

4
/goal git status is clean after running the migration and all existing tests pass
5

6
/goal CHANGELOG.md has an entry for every PR merged this week, verified by listing merged PRs with gh

1
# 弱的条件写法（评估器无法判断）
2
/goal the code is correct         # "正确"如何验证？
3
/goal the feature is implemented  # 缺少可验证的终态指标

限制运行轮数： 在条件中加上回合上限——

1
/goal all lint errors are fixed, or stop after 20 turns

/goal vs /loop vs Stop Hook#

/goal 和 auto mode 是互补关系：auto mode 消除回合内的每个工具提示，/goal 消除回合间的人工触发。两者组合实现完全自主运行。

非交互式使用#

1
claude -p "/goal CHANGELOG.md has an entry for every PR merged this week"

此命令会一直运行到条件满足或手动 Ctrl+C 中断。

恢复时的目标状态#

用 --resume 或 --continue 恢复会话时，仍活跃的目标会自动恢复，但回合计数、计时器和 Token 基线重置。已清除或已达成的目标不会恢复。