核心用法
claude-session 是一套面向 Claude Code 的本地会话管理技能，通过命令行接口实现会话的全生命周期管理。核心功能包括：
信息查询类：id 获取当前会话 UUID 或按关键词搜索历史会话；summarize 查看并总结指定会话内容；analyze 统计工具使用模式与优化建议。
组织优化类：classify 按 CODE/INFRA/TINY/READ 四象限分类项目会话；split 基于主题边界推荐会话拆分点；compress 通过 UTCP/code-mode 压缩会话体积。
迁移维护类：migrate 将代码会话从主仓库迁移至 worktree；move 按 ID 精确迁移会话并更新 cwd 路径；repair 修复断链、孤儿 tool_result、重复 UUID 等结构问题。
生命周期类：rename 为会话设置自定义标题；destroy 删除当前会话并重启 IDE；purge 清理无响应的死会话（≤10 行且无 assistant 输出）。
集成扩展类：import 将会话数据管道至其他 agent/skill；url 生成 claude-sessions 网页访问链接。
显著优点
- 功能覆盖完整：14 项子功能覆盖会话管理全流程，从查询、分析到压缩、修复、迁移形成闭环
- 本地优先设计：依赖 shell 脚本与本地 JSONL 文件，无需云端同步，隐私可控
- 自动化程度高：支持
--execute、--dry-run、--check-only等模式，批量操作与预览兼顾 - 跨平台兼容：move 等命令明确支持 Windows + macOS/Linux
- MCP 扩展性：通过 claude-sessions-mcp 与 Serena 集成，可接入外部记忆系统
潜在缺点与局限
- 环境依赖较重：需安装 claude-sessions-mcp，部分功能还需 Serena MCP，配置门槛较高
- 无图形界面：纯 CLI 交互，对非技术用户不友好
- 破坏性操作风险：
destroy、purge --delete、migrate等操作不可逆，误执行代价高 - 路径转换规则特殊：项目名需手动将
/替换为-，跨项目操作时易出错 - 分类深度敏感：
classify --depth=fast仅读取最后 3 条消息，可能漏判多主题会话
适合人群
- 高频使用 Claude Code 的专业开发者，需管理数十至上百个历史会话
- 在 monorepo/worktree 架构下工作的工程师，需要跨项目迁移会话上下文
- 对隐私敏感、偏好本地数据管理的用户
- 具备 shell 脚本阅读能力的 DevOps/SRE 人员
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 数据丢失 | `purge --delete`、`destroy` 永久删除会话 | 执行前务必使用 `--dry-run` 或 `--check-only` 预览 |
| 路径错乱 | `move` 后 cwd 更新不完全导致工具执行路径错误 | 优先使用 `--cwd-mode all` 全面更新 |
| MCP 依赖失效 | claude-sessions-mcp 未启动时压缩、同步功能失效 | 使用前检查 MCP 服务状态 |
| 误分类 | `classify --depth=fast` 漏检早期主题 | 分割会话前强制使用 `--depth=medium` |
| 会话污染 | `import --hookify` 向外部 agent 泄露敏感对话 | 确认目标 agent 可信度后再执行管道传输 |