核心用法
claude-session 是 Claude Code 生态的会话治理中枢，覆盖会话全生命周期管理。核心能力分为六大维度：
信息查询：id 快速获取当前会话 UUID（支持 hook 注入、路径扫描、marker 回退三级策略）；list 枚举当前项目会话（含 mtime/size）；summarize 跨会话内容摘要；url 生成 claude-sessions 网页链接。
搜索与分类：search 关键词搜索附结果验证门（解决动词歧义、路径错位、任务孤立问题）；classify 智能标记会话为 delete/keep/extract，支持 RAG MCP 自动检测（Qdrant/Chroma/Weaviate/Pinecone 等），深度模式可识别跨会话主题边界。
迁移与归档：archive 将会话移至 ~/.claude/projects/.bak/ 扁平目录；migrate 主仓→worktree 智能迁移（先分类再移动 CODE 会话）；move 指定 ID 跨项目迁移并更新 cwd 引用。
修复与维护：repair 修复断链、孤儿 tool_result、重复 UUID；purge 清理死会话（≤10 行且无 assistant 响应）；split 基于主题边界推荐会话分割点。
压缩与流转：compress 通过 UTCP/code-mode AI 压缩会话；import 向其他 agent/skill 管道化投递数据。
基础设施：install 注册 session-id-inject hook；destroy 删除当前会话并重启 IDE；rename 自定义会话标题。
显著优点
- 原子化设计：每个 topic 独立文档，可组合调用
- RAG 原生集成：自动检测向量存储 MCP，无配置即插即用
- 防御性验证：search/classify 内置结果校验，避免"假阳性"任务匹配
- 跨平台兼容：move/migrate 支持 Windows/macOS/Linux
- 非破坏性默认：purge/archive 默认 dry-run，执行需显式确认
潜在局限
- 依赖链较重：需 claude-sessions-mcp，analyze --sync 另需 Serena MCP
- 学习曲线陡峭：20+ 子命令，新手难以快速定位最佳实践
- hook 预配置：id 快速路径依赖 session-id-inject.sh 预先安装
- RAG 检测局限：仅检测已注册 MCP，未配置时静默降级
适合人群
- 高频使用 Claude Code 的专业开发者（日均 5+ 会话）
- 多项目/多 worktree 并行工作的工程团队
- 需要会话审计、合规归档的企业场景
- 构建自定义 agent pipeline 的高级用户
常规风险
- 误删风险：purge --all 与 destroy 为不可逆操作，建议始终先 dry-run
- 路径泄露：session 元数据含 cwd 绝对路径，归档时注意敏感信息
- MCP 版本锁定：claude-sessions-mcp 与 skill 版本需兼容，升级需同步
- 压缩语义损失：UTCP 压缩可能丢失细粒度 tool 调用细节