Claude Code 会话保存在哪里？路径、结构与保留策略

更新于 2026-10-19 · CCViewer 帮助中心 · 适用于 Claude Code 2.x

本地 Claude Code 会话的默认路径为 ~/.claude/projects/<项目>/<会话ID>.jsonl。自定义配置目录会改变基础路径。这个本地存储结构不代表所有 Claude Code 界面或模型请求都只在本机运行。

区分会话、提示词历史和配置

Windows 默认基础目录为 %USERPROFILE%\.claude。不同环境与版本的细节以官方目录文档为准。

JSONL 每行保存一个 JSON 值。CCViewer 识别用户和助手消息、工具调用与结果，以及部分系统和费用记录。文件中可能包含 timestamp、sessionId、cwd、message.usage 等字段。日志是持续变化的实现格式，不能保证每条记录都含所有字段。

会话文件不能当作永久备份。Claude Code 有保留设置，也有关闭持久化的运行方式。清理行为可能随版本、界面和设置变化，请核对官方应用数据文档。压缩与缺失记录也会限制可还原的内容。

迁移或清理前，把需要保留的会话复制到受访问控制的备份位置。文件可能包含源码、路径和命令输出。导入浏览器会话库后也应保留原件，因为清理浏览器数据会影响本地副本。

CCViewer 在本地读取文件，但线上版本仍加载 Clarity 统计和交互录制。本地有会话文件，不等于线上查看器或 Claude Code 模型请求完全不联网。

用 CCViewer 图形化回放你的 Claude Code 会话
会话文件在浏览器中本地解析和渲染。线上网站会自动加载 Microsoft Clarity，记录页面交互；离线版本不加载统计。

history.jsonl 就是完整对话吗？

不是。提示词历史和项目会话记录用途不同。

本地保存意味着 Claude Code 离线吗？

不是。本地会话存储与模型请求、云端或远程功能是不同的事情。