查找 Claude Code JSONL 文件:macOS、Linux、Windows
先检查 ~/.claude/projects/;如果设置了 CLAUDE_CONFIG_DIR,则检查该目录中的 projects。递归搜索比猜项目目录名更可靠。以下步骤适用于实际运行本地会话的机器。
macOS / Linux:列出会话文件
session_root="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/projects"
find "$session_root" -type f -name '*.jsonl'
# 将 SESSION_ID 替换为已知的会话标识。
find "$session_root" -type f -name 'SESSION_ID.jsonl'
macOS 访达可按 Command–Shift–G,输入 ~/.claude/projects/。使用自定义配置目录时替换为实际路径。
按记得的内容反查
find "$session_root" -type f -name '*.jsonl' \
-exec grep -lF -- '修复登录页' {} +
命令输出匹配的文件名,支持路径空格,按字面文本匹配。编码后的文本、图片或已经不存在的记录不一定能匹配到。
Windows PowerShell:列出最近文件
$sessionRoot = if ($env:CLAUDE_CONFIG_DIR) {
Join-Path $env:CLAUDE_CONFIG_DIR 'projects'
} else {
Join-Path $env:USERPROFILE '.claude/projects'
}
Get-ChildItem -LiteralPath $sessionRoot -Filter *.jsonl -Recurse -File |
Sort-Object LastWriteTime -Descending |
Select-Object -First 10 FullName, LastWriteTime
在 WSL 中运行的会话应检查对应 Linux 环境的主目录,不能默认认为它位于 Windows 用户目录。
找不到文件时检查什么
- 确认运行会话的账号、机器、容器或远程环境。
- 检查自定义配置目录、隐藏文件和访问权限。
- 检查是否关闭了持久化,或者保留策略已清理记录。查看器不能通过导入文件夹恢复不存在的文件。
定位后用 CCViewer 打开。提示词历史与完整会话文件的区别见下方存储指南。
参考来源与核验依据
用 CCViewer 图形化回放你的 Claude Code 会话
会话文件在浏览器中本地解析和渲染。线上网站会自动加载 Microsoft Clarity,记录页面交互;离线版本不加载统计。
会话文件在浏览器中本地解析和渲染。线上网站会自动加载 Microsoft Clarity,记录页面交互;离线版本不加载统计。
常见问题
默认目录为空怎么办?
检查实际运行环境、自定义配置目录、持久化设置与保留策略。会话可能位于另一台机器上。
可以直接导入文件夹吗?
可以。CCViewer 将 JSONL 文件导入本地浏览器会话库,并按项目分组。