Agent View 与 bg 会话

Agent View 是 Claude Code 内置的面板,可在同一个项目上并行运行多个 Claude Code 实例。主机上的 supervisor 进程托管每一个实例 — 类似 tmux — 因此即使你关闭 ServerCC、断开 Wi-Fi 或切换 App,它们也会继续工作。ServerCC 支持打开 Agent View 面板,并从会话历史随时重新进入这些 bg 会话

前提条件

Agent View 需要服务器上安装 Claude Code 2.1.141 及以上版本 — 版本过旧时入口按钮会被禁用并显示提示。该功能仅适用于 Claude Code(Codex 没有对应功能)。

打开 Agent View

在工作区首页点击打开 Agent View (Beta)。ServerCC 会启动限定于该工作区的面板(claude agents),在这里你可以:

  • 启动并行实例 — 在一个工作区上按需启动任意数量的 Claude Code 会话
  • 自动 worktree 隔离 — 实例开始写入时会自动创建专属 Git worktree,每个实例编辑自己的副本,会话之间互不干扰
  • 用快捷键行操作 — 键盘上方的专用按键行提供 Space(预览光标处的 agent)、(打开)、Close(关闭)和 Pin(置顶)

首次打开 Agent View 时,ServerCC 会显示一个简短的应用内指南 — 之后随时可以通过工具栏的 ? 按钮再次打开。

历史中的 bg 会话

每个 Agent View 实例都会作为普通行出现在工作区的 Claude Code 会话历史中,并带有小写的 bg 徽章。徽章颜色反映 supervisor 眼中的会话状态:

  • bg · working — 实例正在工作
  • bg · done — 任务已完成
  • bg · failed — 实例遇到错误

点击 bg 行并选择恢复 bg 会话即可重新进入 — ServerCC 会连接到仍在运行的实例(claude attach),对话完整保留在离开时的状态。移入自动创建 worktree 的会话会以 worktree 名称作为其分支显示。

与 tmux 持久会话的关系

bg 会话独立于 tmux。持久会话通过在 tmux 中运行来保活;bg 会话则由 Claude Code 自己的 supervisor 守护进程托管。两者都能在关闭 App 后存活 — 在运行中列表里它们带有不同的标签(tmuxbg / agent view),SSH 重连后 ServerCC 会自动重新接入 bg 会话。

提示

要查看每个并行实例改了什么,打开 Git 差异 — 它的 worktree 选择器可以在各个 Agent View worktree 的 diff 之间切换。

另见:持久会话了解基于 tmux 的保活方式,后台与并行了解 App 内后台运行,Worktree 了解手动分支隔离。