Claude Code 学习站

Claude Code Agent View:一屏管理多个后台会话

用 claude agents 打开 agent view,在一屏里 dispatch、监控、切换、回复多个后台 Claude Code 会话。本文讲启动、派发任务、peek/attach/detach、状态图标与快捷键。

本页目录5
要点速览
  • claude agents 打开 agent view(研究预览,需 v2.1.139+);后台会话无需终端常开也持续运行(由 supervisor 进程托管)。
  • 派发:在底部输入框敲提示 + Enter 起一个后台会话;--cwd 可只看某项目(v2.1.141+)。
  • Space=peek 看最新输出/待答问题并就地回复;Enter 或 → = attach 进完整会话;← = detach/后台化返回表格。
  • 把当前会话转后台:会话内 /bg,或空提示按 ← 一步完成;停止用 /stop(会话内)、Ctrl+X 或 claude stop。
  • 状态:Working(动画)/Needs input(黄)/Completed(绿)/Stopped(灰);需输入的置顶,Ctrl+S 改按目录分组。

本文是对官方 Manage multiple agents with agent view 的中文要点整理,命令与快捷键以原文为准(研究预览,需 Claude Code v2.1.139+,界面可能变化)。

它是什么

claude agents 打开 agent view —— 一屏看你所有后台会话:谁在跑、谁等你、谁完成了。每个后台会话都是完整的 Claude Code 对话,无需终端常开也持续运行(由独立的 supervisor 进程托管),你可以随时打开、回复、再离开。

适合:有几个 Claude 能独立推进、不用你盯每步的任务——派一个修 bug、一个审 PR、一个查 flaky 测试,在别处继续工作,某行需要你或出结果时再回来。

核心循环:派发 → 监控 → peek → attach

claude agents          # 打开 agent view;Esc 随时回 shell,会话继续在后台跑
claude agents --cwd ~/projects/my-app   # 只看某项目(v2.1.141+)
  • 派发(Dispatch):在底部输入框敲任务描述 + Enter,起一个后台会话成为一行;用 header 显示的模型与该目录的权限模式。
  • peek:方向键选行,Space 打开 peek 面板看最近输出或它在等的问题;直接打字 + Enter 回复,不离开 agent view。多选题可按数字键选;Tab 填入建议回复;前缀 ! 发 Bash 命令。
  • attach / detach:在行上按 Enter attach 进完整交互会话;空提示按 detach 回表格(Ctrl+Z 立即 detach)。detach 永不停止后台会话(/Ctrl+Z//exit/双 Ctrl+C 都只是离开)。
  • 把当前会话转后台:会话内跑 /bg,或空提示按 一步把当前会话后台化并打开 agent view。
  • 停止:会话内 /stop;或 Ctrl+X / claude stop

在任意会话(不限于从 agent view attach 的)都能把当前会话后台化并打开 agent view,便于快速切换。可在 /configleftArrowOpensAgents 关掉。

读懂状态

状态颜色含义
Working动画正在跑工具/生成回应
Needs input在等你回答某问题或权限决定
Completed绿任务成功完成
StoppedCtrl+Xclaude stop 停止

需输入的会话置顶(Ready for review / Needs inputWorking/Completed 之上)。Ctrl+S 改为按目录分组(选择会持久化)。agent view 打开时,终端标签页标题显示待输入数,如 2 awaiting input · claude agents

attach 后的行为

attached 会话与普通会话一致:所有命令、快捷键、功能都可用。后台会话始终全屏渲染(无论 tui 设置),用 PgUp/PgDn/滚轮滚动,Ctrl+O 进 transcript 模式。

注意

每个后台会话独立占用你的订阅配额,一次派发很多前先看官方"Limitations"。可用 disableAgentView 设置关闭后台 agents 与 agent view。