使用 Claude Code 管理会话

Claude Code 会话管理指南（CLI）

用于在 Claude Code 中管理会话：恢复、命名、分支、切换与导出。

一、什么是会话（Session）

在 Claude Code 中：

  • 会话 = 与某个项目目录绑定的对话记录
  • 自动保存到本地
  • 可恢复、可分支、可命名
  • 支持跨终端继续工作

二、恢复会话（Resume）

会话支持多种恢复方式：

1. 常用命令

命令作用
claude --continue 恢复当前目录最近会话
claude --resume 打开会话选择器
claude --resume <name> 按名称恢复会话
/resume 在会话内切换其他对话
claude --from-pr <number> 从 PR 恢复会话

2. 会话 ID 恢复

 
claude --resume <session-id>
 

适用于：

  • CLI / SDK 创建的会话
  • 需要精确定位历史记录

⚠️ 注意：必须在原项目目录或 git worktree 中执行。

三、会话选择器（Session Picker）

运行：

 
claude --resume
 

或在会话内：

 
/resume
 

进入交互式选择界面。

快捷键

按键功能
↑ / ↓ 切换会话
Enter 进入会话
Space 预览内容
Ctrl+R 重命名
/ 搜索
Ctrl+A 查看所有项目
Ctrl+W 查看所有 worktree
Ctrl+B 按 git 分支过滤
Esc 退出

四、命名会话（非常重要）

用于区分多个任务并行开发。

1. 创建时命名

 
claude -n auth-refactor
 

2. 会话中重命名

 
/rename auth-refactor
 

3. 选择器中重命名

 
Ctrl + R
 

4. Plan Mode 自动命名

在计划模式下：

  • 接受计划后自动生成会话名（除非手动指定）

使用方式

 
claude --resume auth-refactor
 

或

 
/resume auth-refactor
 

五、分支会话（Branch / Fork）

用于：

  • 尝试不同实现方案
  • 不破坏原对话
  • 并行探索思路

1. 在会话中分支

 
/branch try-streaming-approach
 

2. CLI 分支

 
claude --continue --fork-session
 

或

 
claude --resume --fork-session
 

特点

  • 原会话保留
  • 新会话继承上下文
  • 权限不继承
  • 会话选择器中分组显示

六、会话管理（上下文控制）

1. 清空上下文

 
/clear
 

作用：

  • 清空当前上下文
  • 历史记录仍然保留

2. 压缩上下文

 
/compact
 

或

 
/compact focus on API refactor
 

作用：

  • 用摘要替代历史内容
  • 保留关键信息

3. 查看上下文使用情况

 
/context
 

七、导出会话（Export）

1. 导出当前会话

 
/export
 

或指定文件：

 
/export session.txt
 

2. 存储位置（JSONL）

默认路径：

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

每一行是：

  • message
  • tool call
  • metadata

3. 生命周期

  • 默认保留：30 天
  • 可配置清理策略

4. 禁用历史记录

 
CLAUDE_CODE_SKIP_PROMPT_HISTORY=1
 

或：

 
--no-session-persistence
 

八、会话存储结构

 
~/.claude/
 └── projects/
     └── my-project/
         └── session-id.jsonl
 

九、多会话并行能力

Claude Code 支持：

  • 多终端同时打开
  • 不同 worktree 并行开发
  • PR 级会话恢复
  • 分支式实验开发

十、使用建议（实践经验）

1. 强烈建议命名会话

否则后期很难找

2. 每个功能一个 session

例如：

  • auth-login
  • api-refactor
  • bugfix-null-pointer

3. 实验用 branch

不要污染主会话：

 
/branch experiment-x
 

4. 定期 compact

避免上下文爆炸：

 
/compact
 

十一、相关功能

  • Worktrees（多分支隔离）
  • Checkpoint（代码回滚）
  • Context Window（上下文机制）
  • Headless mode（非交互模式）

总结

Claude Code 的会话系统本质是：

“Git 思维 + 对话历史 + 分支实验环境”

掌握三个核心就够了：

  • resume（恢复）
  • rename（管理）
  • branch（实验）
posted @ 2026-06-22 15:11  曲琦  阅读(118)  评论(0)    收藏  举报