主题
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: true或CLAUDE_CODE_DISABLE_AGENT_VIEW。