它到底是什么

/branch 在当前对话的当前节点创建一份完整副本，并立即切换进新副本——原始会话保持原样、不受任何影响。它是 Claude Code 的会话分叉原语，让你在同一任务下探索多条不同路径，而不必担心污染或丢失原来的上下文。

/branch 与 /fork 的关系已变:/fork 不再是 /branch 的别名。从 v2.1.161 起 /fork 是独立命令——派生一个继承完整对话的后台 forked subagent 替你干指令、完成后把结果回传,而你留在主会话;而 /branch 是让你自己切进对话的一份副本去试不同方向。只有早于 v2.1.161(且设了环境变量 CLAUDE_CODE_FORK_SUBAGENT)时,/fork 才等价于 /branch。简记:想"自己换条线"用 /branch,想"把活甩给后台、自己不动"用 /fork。

怎么触发 / 怎么使用

1. 会话内触发

/branch [name]

name 是可选的，省略时系统自动分配 session ID。建议命名，方便后续 /resume 直接定位。

/branch try-streaming-approach

触发后，终端会打印两个 session ID——新分支与原会话各一个（官方称 confirmation 会 "prints two session IDs: the new branch you are now in and the original"，具体行文以实际版本为准）：

Branched into: <new-branch-session-id>
Original session: <original-session-id>

你现在身处新分支；原会话原封不动地保留在会话列表里。

2. 命令行（CLI）触发

在新终端里从外部分叉一个已有会话：

# 分叉最近一次会话
claude --continue --fork-session

# 分叉指定会话
claude --resume <session-id> --fork-session

保存 / 配置 / 集成

分支会话与普通会话同样以 JSONL 格式落盘：

~/.claude/projects/<project>/<session-id>.jsonl

如需修改存储根目录，设置环境变量 CLAUDE_CONFIG_DIR。会话文件默认 30 天后自动清理，可通过 cleanupPeriodDays 配置项调整。

会话选择器（session picker）中的分支展示：在 /resume 选择器里，所有通过 /branch、/rewind 或 --fork-session 派生出的子会话，会以折叠树形式归属于根会话下方；按 → 展开分支列表。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 探索两种架构方案：在设计阶段分支出两个会话，分别走"方案 A"和"方案 B"，最后比对结果再决定合并哪条。
• 安全地尝试危险操作：在执行不可逆操作（如大规模重构、删除）前先 /branch，出问题可立即 /resume 回到原始状态。
• 多终端并行调试：用 CLI --fork-session 在两个终端同时对不同假设进行验证，两侧独立互不干扰。

常见坑

1. 把 /fork 当成 /branch 的别名:在 v2.1.161+ 这是错的——/fork 是独立命令(后台 forked subagent、结果回传、你不切走),/branch 才是你自己切进对话副本。只有早于 v2.1.161 且设了 CLAUDE_CODE_FORK_SUBAGENT 时二者才等价。要"自己换条线"明确用 /branch。详见 /fork。
2. 不分支就在两个终端 resume 同一会话：两侧的消息会交织写入同一 transcript，导致对话历史混乱。正确做法是先 /branch 再在另一终端开新分支。
3. session 权限需要重新审批：分支后所有"allow for this session"的工具权限都会重置，在新分支里再次执行敏感操作时会重新弹出确认提示。

关闭 / 退出 / 卸载

从分支返回原会话有三种方式：

# 方式 1：用 /resume 加原始 session ID（触发 /branch 时终端会打印）
/resume <original-session-id>

# 方式 2：用原始会话的名称
/resume auth-refactor

# 方式 3：打开会话选择器，手动选取
/resume

在选择器里，分支会话以树形折叠在根会话下，按 → 展开后按 Enter 跳转。

来源

• Manage sessions — Claude Code Docs
• Commands — Claude Code Docs