用途:诊断并恢复 Claude Code 的会话问题,包括运行 claude -r 时出现“No conversations found to resume”、新会话不生成会话文件、会话出现在错误位置(如 /tmp/ 而非 ~/.claude/projects/)、环境变更后会话历史丢失、IDE/终端设置影响会话创建,以及迁移或恢复 600+ 旧会话。
主要能力:定位会话存储位置与格式。官方标准位置为 ~/.claude/projects/,目录按编码后的绝对路径命名,文件为每行一个 JSON 事件的 JSONL,文件名基于 UUID。技能重点排查 HOME 环境变量问题:Claude Code 依据 $HOME 决定会话存储位置,$HOME 不正确会导致会话写入错误目录或消失。
使用方式:先做诊断,检查当前 HOME、系统预期 HOME,并查找 Claude 实际写入位置。资料给出的诊断命令为: /usr/bin/env bash << 'PREFLIGHT_EOF' echo "Current HOME: $HOME" echo "Expected HOME: $(getent passwd $(whoami) | cut -d: -f6)" find /tmp -name ".jsonl" -path "/.claude/projects/*" 2>/dev/null PREFLIGHT_EOF
常见问题与处理:提示“No conversations found”多为 HOME 变量错误,需核对 $HOME 与预期用户目录;会话出现在 /tmp/ 说明 HOME 设置错误,应在 shell 配置中修正 HOME 并重启终端;会话文件缺失需检查 ~/.claude/projects/ 权限与磁盘;显示错误项目会话为路径编码不匹配,需核对编码路径与当前工作目录;会话不持久需确认对 ~/.claude/projects/ 的写权限;IDE 会话分离因不同环境 HOME 不一致,应统一终端与 IDE 的 HOME;旧会话不可见多为迁移未完成;UUID 文件名损坏可能因写入不完整,需检查并删除损坏的 .jsonl 文件。
限制:资料未提供具体迁移步骤、支持平台、版本要求或收费信息,相关细节暂未提供。该技能为自进化型,若指令有误、参数漂移或需要变通,应据实且可复现的问题立即更新文件。