会话

会话是一次 Claude Code 或 Codex 对话。ServerCC 自动发现和索引每个工作区的所有历史会话,让你可以随时恢复之前的任何对话。

会话选择器

点击工作区时,会话选择器会打开,列出按最后修改日期排序的所有历史 Claude Code/Codex 会话(最新在前)。

会话信息

列表中每个会话显示:

  • 首条提示 — 你在该会话中发送给 Claude 的第一条消息
  • 摘要 — AI 生成的对话摘要
  • 消息数量 — 交换的消息总数
  • 最后修改 — 会话最后活跃的时间
  • Git 分支 — 会话期间检出的分支(用于 Git 工作区)

bg 会话

通过 Claude Code 的 Agent View(或 claude --bg)启动的会话也会出现在历史中,带有按状态着色的 bg 徽章 — working、done 或 failed。点击并选择恢复 bg 会话即可重新接入仍在运行的实例。详见 Agent View 与 bg 会话

提示

会话每页加载 12 条。滚动到底部并点击加载更多查看更早的会话。

创建新会话

点击会话选择器顶部的新建会话按钮。这将通过在工作区目录中运行 claude 启动全新的 Claude Code 会话。你将直接进入终端。

恢复会话

点击列表中的任何已有会话即可恢复。ServerCC 运行 claude --resume <sessionId> 来恢复对话上下文。Claude 会记住之前的消息,从你上次中断的地方继续。

注意

在服务器重新连接后恢复会话可能会丢失部分上下文,因为 Claude Code 的 -c 标志在恢复上下文量方面有限制。

删除会话

在列表中向左滑动任何会话显示删除按钮。这会从服务器的 ~/.claude/projects/ 目录中移除会话数据。

会话存储方式

Claude Code 将会话存储在服务器的 ~/.claude/projects/ 中,按工作区路径组织。ServerCC 通过三层方式发现会话:

  1. 会话索引 — 通过 sessions-index.json 快速查找(主要方式)
  2. 目录扫描 — 如果索引缺失则扫描项目目录(备选方式)
  3. JSONL 重建 — 从单个 .jsonl 文件重建会话列表(最后手段)

这意味着桌面端或其他客户端的 Claude Code 创建的会话在 ServerCC 中也可见,反之亦然。

终端中的会话

在终端中,你无需离开视图就可以切换会话 — 点击底部工具栏的会话按钮以面板形式打开会话选择器。

另见:后台与并行运行了解离开终端后会话如何持续运行。