Skip to content

Background Agents(后台代理 / agent view)

claude agents 一块屏幕管理多个完整的后台会话:派任务、看状态、需要你时再介入;不依赖终端、由 supervisor 进程托管。

你的真实情况

研究预览功能(claude agents)。对你很对口:你有一堆耗时技能(/qa/cso/investigate/health)和 ralph-loop,正适合丢后台跑、回头看结果。

去真实体验

想干什么这样做
打开后台总览屏claude agents
从 shell 直接派一个后台任务claude --bg "用 /qa 测前端登录页并修明显 bug"
把当前会话转后台会话里 /bg
管理claude attach <id> / claude logs <id> / claude stop <id>

对你的实际意义

  • 文件隔离:后台会话改文件前自动进 .claude/worktrees/(见 Worktrees 节),多个并行任务各写各的,不互相覆盖——你同时跑前端和 SpringBlade 任务很安全。
  • 配额:每个后台会话独立烧你的订阅额度,并行 5 个 ≈ 5 倍速度耗额度。
  • 和 subagent/团队的区别:这是"很多互不通信的独立会话并行";团队才互相通信。

官方文档要点

以下为按官方文档整理的系统性参考。

是什么

Background agents(agent view,用 claude agents 打开)是一块屏幕管理你所有后台会话的地方:什么在跑、什么需要你输入、什么已完成。每个后台会话都是完整的 Claude Code 对话,由一个 per-user supervisor 进程托管、不依赖终端——关掉窗口它还在跑。和团队的区别:这是『很多互不通信的独立会话并行』(派一个修 bug、一个评审 PR、一个查 flaky 测试,回头看结果),团队是『会话互相通信协作』。研究预览阶段。

怎么工作

  • 在输入框敲任务回车 = 起一个后台会话;每条 prompt 都起新会话(不是给上一个发后续)。
  • 行状态:Working / Needs input / Idle / Completed / Failed / Stopped;图标形状表示进程是否还活着。
  • Space 偷看(peek)并回复,Enter/→ attach 进入完整会话,←/Ctrl+Z detach 回列表(detach 不停会话)。
  • supervisor 进程独立托管后台会话:活跃/等待输入/被 pin 的保持进程;闲置约 1 小时后停进程(transcript 保留,再 attach 时从断点重启)。
  • 文件隔离:编辑前自动把会话移进 .claude/worktrees/ 下的 git worktree,多会话各写各的。
  • PR 状态、行摘要(Haiku 生成)、按目录/状态分组、过滤等都在这一屏。

怎么配置 / 用法

打开:claude agents(可加 --cwd <path> 只看某目录、--model/--permission-mode/--effort 设默认)。 从 shell 直接派:claude --bg "任务"(加 --agent code-reviewer 用某 subagent 当主 agent、--name 命名)。 会话内 /bg(或 /background)把当前会话转后台;空输入按 一步背景化并打开 agent view。 shell 管理:claude attach <id> / claude logs <id> / claude stop <id> / claude respawn <id> / claude rm <id> / claude daemon status。 关闭整功能:设置 disableAgentView: true 或环境变量 CLAUDE_CODE_DISABLE_AGENT_VIEW

什么时候用

  • 几个互不依赖的任务想异步跑、回头收结果(修 bug / 评审 PR / 查 flaky 测试)。
  • 想让长任务脱离终端继续跑(关窗口也不停)。
  • claude agents 当主入口:所有任务从这里派,需要时 attach。

限制 / 坑

  • 研究预览(需 v2.1.139+),界面与快捷键可能变。
  • 每个后台会话独立消耗订阅配额,并行 10 个 ≈ 10 倍速烧额度。
  • 会话在本机跑,睡眠可保留、关机会停(再 attach 从断点重启)。
  • 在 agent view 里删除会话会连带删除 Claude 给它建的 worktree(含未提交改动)——先 push/commit。
  • subagent 和团队队友不作为独立行显示在这里。

硬事实速查(7 条)

  • 打开:claude agents(研究预览,需 Claude Code v2.1.139+)。
  • 派后台会话:输入框回车 / claude --bg "..." / 会话内 /bg(别名 /background) / 空输入按
  • 管理命令:attach / logs / stop / respawn / respawn --all / rm / daemon status;claude agents --json 输出列表。
  • 状态:Working/Needs input/Idle/Completed/Failed/Stopped;✻/✽=进程活、=已退出可重启、=/loop 睡眠中。
  • 文件隔离:编辑前自动进 .claude/worktrees/;可用 worktree.bgIsolation: "none" 关闭。
  • supervisor 托管,闲置约 1 小时停进程;状态存 ~/.claude/jobs/<id>/state.json~/.claude/daemon/roster.json
  • 关闭:disableAgentView: trueCLAUDE_CODE_DISABLE_AGENT_VIEW

官方出处:https://code.claude.com/docs/en/agent-view