智能体视图（Agent view）

用 claude agents 在一个屏幕里调度和管理多个后台会话：状态、查看与回复、快捷键、shell 命令、supervisor 与限制（研究预览）。

智能体视图通过 claude agents 打开，是你所有后台会话的统一屏幕：哪些在运行、哪些需要你输入、哪些已完成。你可以调度新会话，一眼看清它们的状态而不必翻转录，只在某个会话需要你时介入。适合有多个相互独立、Claude 可以自己推进的任务：比如把一个 bug 修复、一次 PR 评审和一次不稳定测试的排查分成三行，在别的窗口继续工作，等某行显示需要你或有结果时再回来。想更直接地参与某个智能体，附着（attach）到那一行即可进入完整对话。

与子智能体、智能体团队、worktree 的对比见「并行运行智能体」页。智能体视图在你本机运行会话，由你逐个调度；想让 Claude 在云端启动并跟踪并行会话，参见 Projects。

智能体视图处于研究预览阶段，界面和快捷键可能变化。

快速开始

打开：在 shell 里运行 claude agents。若该目录还没接受过工作区信任对话框，会先显示它；拒绝则退出。界面底部是输入框，上方的表格会随会话启动逐渐填充。Esc 返回 shell；如果你是用 ← 把会话放入后台才打开的，Esc 会回到那个对话。会话在你离开期间继续运行。
调度会话：输入描述任务的提示词，按 Enter，一个新的后台会话启动并显示为一行。这里输入的每个提示词都开一个新会话，再输入一个并回车是并行启动第二个，而不是给第一个发后续消息。每个会话独立消耗订阅额度。
查看并回复（peek）：用方向键选中一行，按 Space 打开 peek 面板，显示最近输出或它在等的问题；输入回复并回车就能在不离开智能体视图的情况下发送。
附着与分离：对行按 Enter 或 → 附着，会话接管终端成为完整交互会话；在空提示符上按 ← 分离回到表格。
把已有会话带进来：在已开的会话里运行 /bg，或在空提示符上按 ←，会话放入后台并出现在列表里。在普通 claude 会话里，提示栏的 ← 提示会显示等你的后台智能体数量，如 ← 2 agents。

默认打开智能体视图

在 /config 里打开 Open agents view by default，或直接设置 defaultToAgentsView：

/config defaultToAgentsView=true

之后单独运行 claude 就打开智能体视图。想在设置开启时启动普通会话，传一个提示词：claude "fix the login test"。

监控会话

默认列表显示你启动的所有后台会话（跨所有项目）。用 --cwd 缩小到某个项目：

claude agents --cwd ~/projects/my-app

你在其他终端开着的交互会话在被放入后台之前不会出现；子智能体和队友也不会作为单独的行列出。

读懂会话状态

每行以图标开头，颜色和动画表示状态：

状态	含义
Working（动画）	Claude 正在运行工具或生成回复
Needs input（黄）	等待只有你能提供的东西：问题的答案、权限决定、沙箱放行网络主机、MCP 服务器的输入请求等
Idle（暗）	无事可做，等你的下一个提示
Completed（绿）	任务成功完成
Failed（红）	任务出错结束
Stopped（灰）	你用 `Ctrl+X` 或 `claude stop` 停止，或进程被外部结束

图标形状表示底层进程是否在运行：✻ 或动画 ✽ 是进程活着；∙ 是进程已退出，你仍可 peek，回复或附着时 Claude 会从中断处重启；✢ 是在两次迭代之间休眠的 /loop 会话，行里显示运行次数和倒计时。

后台会话不需要任何终端保持打开，由独立的 supervisor 进程运行，关掉智能体视图、关闭 shell，工作仍继续。会话状态在自动更新和 supervisor 重启后仍保留，机器睡眠期间也会保留，唤醒后恢复；关机则会停止运行中的会话。

行摘要与 PR 状态

每行的一句话摘要由 Haiku 级模型生成，说明会话在做什么、需要什么或产出了什么；会话工作时，行文本最多每 15 秒基于会话自己的最近输出更新（不发请求），长回合里每隔几分钟由模型重写。摘要请求通过你的常规提供商计费，适用与会话相同的数据使用条款。

当会话开了 PR，行右侧显示链接标签：GitHub PR 是 #1234，GitLab MR 是 !1234，数字的颜色代表状态：黄色是等检查或评审（或检查失败）、绿色是检查通过且无评审阻塞、紫色是已合并、灰色是草稿或已关闭。对以 PR 结尾的任务，看到数字变绿就可以评审并合并了。关联多个 PR 时显示 3 PRs 这样的计数。

整理列表

默认分组把需要你的排在最上面（Ready for review、Needs input 在 Working 和 Completed 之上）。Ctrl+S 切换为按目录分组，选择会被记住。组内：Ctrl+T 置顶并在空闲时保持进程运行，Shift+↑/↓ 重排，Ctrl+R 重命名，在组标题上按 Enter 折叠。

要从列表移除会话，按 Ctrl+X 停止它，两秒内再按一次删除；在组标题上按 Ctrl+X 会在确认后删除整组。删除后会话从列表里消失，Claude 为它创建的 worktree 会根据你的删除方式和 worktree 内容被移除、保留或原地留下；对话转录仍保留在本机。在调度输入里输入 /resume 可以打开选择器找回包括已删除会话在内的过往会话。

过滤

在调度输入里输入以下内容是过滤而不是调度：a:<name>（运行某命名智能体的会话）、s:<state>（如 s:working，s:blocked 表示所有在等你的）、#<number> 或 PR/MR 链接（处理该 PR 的会话）、其他 URL（首个提示词里包含该 URL 的会话）。

键盘快捷键

在智能体视图里按 ? 查看当前上下文下的全部快捷键。主要的：

快捷键	动作
`↑` / `↓`	在行间移动
`Enter`	附着到选中会话；输入框有文字时是调度
`Space`	打开或关闭 peek 面板
`→`	附着到选中会话
`Alt+1`..`Alt+9`	附着到当前目录下的第 1–9 个会话
`Tab`	输入为空时浏览所有子智能体，否则应用高亮的建议
`Ctrl+S` / `Ctrl+T` / `Ctrl+R`	切换分组 / 置顶 / 重命名
`Ctrl+G`	在 `$VISUAL` 或 `$EDITOR` 里打开调度提示
`Ctrl+X`	停止会话；两秒内再按一次删除
`Esc`	关闭 peek、清空输入或退出
`Ctrl+C`	清空输入；按两次退出

Ctrl+S、Ctrl+T 和 Ctrl+G 遵循你的 keybindings.json，可通过 agents:switchView、agents:togglePin 等动作重绑。

调度新智能体

可以从智能体视图调度，也可以把已有交互会话发送/复制到后台，或直接从 shell 启动（claude --bg）。每个会话在哪个目录、用什么权限模式/模型/力度、能继承哪些设置、插件和 MCP 服务器，在官方原文里有专门章节；文件编辑的隔离方式（会话需要时移入 worktree）也在那里说明。

从 shell 管理会话

每个后台会话有一个短 ID（claude --bg 启动时打印，也是 ~/.claude/jobs/ 下的目录名）。

命令	作用
`claude agents`	打开智能体视图
`claude agents --cwd <path>`	只显示该路径下启动的会话
`claude agents --json`	以 JSON 数组打印会话并退出
`claude attach <id>`	在当前终端附着
`claude logs <id>`	打印会话最近的输出
`claude stop <id>`	停止会话（也接受 `claude kill`）
`claude respawn <id>` / `--all`	重启会话（例如换用更新后的二进制）
`claude rm <id>`	从列表移除，连同安全时 Claude 创建的 worktree；转录保留，仍可 `claude --resume`
`claude daemon status`	打印 supervisor 的状态、版本、socket 目录和 worker 数
`claude daemon stop --any`	停止 supervisor 及其托管的会话；`--keep-workers` 保留会话

用 JSON 读取会话状态

claude agents --json 是从 Claude Code 之外读取会话状态的受支持方式（比如状态栏、调度器或另一个监督后台工作的 Claude 会话）。加 --all 还包括已完成的后台会话，--cwd 限制范围。每个条目有 cwd、kind（interactive 或 background）、startedAt；后台会话还有 id 和 state：

`state`	含义
`working`	一个回合在运行，或会话在自行推进（如 `/loop` 迭代或等 CI）
`blocked`	在等你：它问的问题、权限或沙箱决定、只有你能清除的错误（如登录过期）
`done`	上一回合完成了你要求的事，等你的下一个提示
`failed` / `stopped`	出错结束 / 被停止

进程活着时还有 pid 和 status（busy、waiting、idle），waiting 时 waitingFor 说明在等什么（权限提示、需要输入、沙箱请求等）。~/.claude/jobs/<id>/ 下的文件不是稳定接口，请用 --json。

后台会话如何托管

智能体视图里列出的每个会话都是后台会话，无论你当前是否附着；直接运行 claude 开的会话绑定在那个终端上，关闭就结束，除非你把它放入后台。运行 /status，后台会话的 Session kind 显示 background job · attached 或 background job · unattended，其他显示 interactive。

supervisor 是在你首次放会话进后台或打开智能体视图时自动启动的后台服务，每个会话是它下面的独立进程：

工作中、停在权限提示或对话框、或已附着：进程保持运行
完成或在等你下一条消息，且约一小时没人附着：supervisor 停掉进程释放资源，对话留在磁盘上，下次附着或回复时从原处恢复；置顶可以让它保持运行
意外退出：supervisor 重启进程
自动更新后：supervisor 重启到新版本，并在后台迁移空闲会话；工作中、等你或已附着的会话不会被打断

状态存放在 Claude Code 配置目录（设置 CLAUDE_CONFIG_DIR 时用该目录，并作为独立实例运行）：~/.claude/daemon.log（supervisor 日志）、daemon/roster.json（运行中后台会话列表）、jobs/<id>/state.json、jobs/<id>/tmp/（会话的临时目录，Claude 在那里 Write/Edit 不需要权限提示，会话删除时一并移除）。每个后台会话设有 CLAUDE_JOB_DIR 环境变量指向它的 jobs/<id> 目录。

关闭智能体视图

把 disableAgentView 设置设为 true 或设置 CLAUDE_CODE_DISABLE_AGENT_VIEW 环境变量即可完全关闭后台智能体和智能体视图；管理员可以通过托管设置强制。

限制

速率限制：后台会话与交互会话一样消耗订阅额度，并行十个智能体消耗额度的速度大约是一个的十倍
会话在本地：后台会话在你的机器上运行，睡眠期间保留，关机则停止
Claude 创建的 worktree 随会话在智能体视图中被删除：删除前先提交对该 worktree 的改动（某些删除会保留 worktree）

官方原文还有一节排障：如 claude agents 列出子智能体而不是打开视图、视图里没有会话、背景化时的确认对话框、macOS 上后台会话无法读取桌面/文档/下载文件夹或访问局域网主机、.claude/worktrees/ 越积越多等，遇到时以官方为准。