Agent View:一个窗口管所有 Claude Code sessions
原文:https://docs.claude.com/en/docs/agent-view(实际重定向到
platform.claude.com) 官方定位:Manage multiple agents with agent view 发布:2026-05-13 前后(Claude Code v2.1.139) 状态:Research Preview · 管理员可以通过disableAgentViewmanaged setting 关闭
🔥 影响力卡片
| 维度 | 数据 |
|---|---|
| 引入版本 | Claude Code 2.1.139 (changelog 第一行)— 本机 2026-05-13 已 GA |
| 在 changelog 历史 | claude agents CLI 雏形最早可追溯到第 1807 行(早期),v2.1.139 才正式扩展成完整 UI |
| 用户痛点 | 之前每个 background session 都要单独 terminal 标签;并行 5 个就被 tab 海洋淹没 |
| Anthropic 内部 dogfood 痕迹 | docs 截图里的 demo 主题是”clawd walk cycle / jump physics / collision detection” — 看起来内部正用它做游戏 dogfood |
与 /loop 的整合 | 单独图标 ✢ 表示 sleeping /loop session,直接列在表里 — 显然是给”长跑 + 多任务”独立开发者设计的 |
🎯 为什么必读 (针对独立开发者)
1. 这是 Claude Code 从”一对一聊天工具”变成”agent 队列调度面板”的关键拐点。
之前你想并行做”修 bug + review PR + 调研一个库”三件事,基本只有三个办法:开三个 terminal tab(累)、串行做(慢)、把任务全塞给一个 session(上下文污染)。Agent View 第一次让”启动一个 background session 然后忘了它”成为默认操作。
2. 设计上彻底站在”独立开发者 + 多线并行”那边。
观察几个细节就知道这不是给大团队设计的:
- 没有团队 dashboard、没有跨用户共享 — 每个 session “report only to you”
- supervisor 进程是单用户、本地、长驻,关 terminal 不掉
- filter 用
s:blocked/s:working这种状态过滤,不是项目过滤 — 暗示一个人会同时跨多个 repo 跑 session ←(在空 prompt 上)可以从任意 Claude Code session 一键背景化 + 打开 agent view,完全为”想法切换”的工作方式优化
3. 隐性的”半自动化”门槛被打掉了。
之前要做长跑(让 Claude 自己跑几小时),你要么用 claude -p(无 UI)、要么 /loop + 自己定时回来看。Agent View 配合 v2.1.139 同时上的 /goal 命令(设完成条件,跨 turn 自我推进),意味着你可以:“设个目标 → 发到 background → 关上电脑去做别的 → 几小时后回来看结果”,中间不需要任何运维。
一句话总结
claude agents= Mac 系统监视器 + Tmux session list + GitHub PR 列表的合体,但只服务你一个人,只列你那些”在跑 / 等你 / 跑完了”的 Claude session。
💎 金句墙
★ “Sessions in agent view run independently and report only to you.” “Agent view 里的 sessions 各自独立,只向你一个人汇报。” —— 🟢 独立开发者最该听到的一句话 — 这不是 Slack channel,是你的 agent 队列
★ “You can use
claude agentsas your primary entry point instead ofclaude.” “你可以直接拿claude agents当主入口,代替claude。” —— 🟢 这条藏在 quick start 末尾,但暗示了 Anthropic 自己的推荐方向。预测:未来 6 个月内claude默认行为可能就改成进 agent view
★ “Once a session has finished and sat unattached for about an hour, the supervisor stops its process to free resources… the next time you attach, peek, or reply, the supervisor starts a fresh process from where it left off.” “session 跑完并且没人 attach 1 小时左右,supervisor 会停掉它的进程释放资源。下次你 attach / peek / 回复时,supervisor 会从 session 停下的地方启动一个全新进程。” —— 🟢 这就是为什么 “session 持久化” 跟 “内存占用低” 能同时做到 — disk-first 设计,进程只是状态的一个窗口
★ “Background sessions don’t survive sleep or shutdown.” “background sessions 撑不过睡眠或关机。” —— 🟢 这是当前唯一硬伤(详见后面”陷阱”). Mac 用户配合 caffeinate 解决
📋 核心精读
1. 启动:四步上路
claude agents
打开 Agent View,底部是输入框,上面是 session 表(空的)。
# 在输入框里随便输个 prompt,回车:
"Fix the lint errors in src/components/"
# → 一行新 session 出现在表里,自动起名,开始跑
# 在表里方向键选一行,按 Space:
# → 弹出 peek panel,看 session 在干嘛 / 需不需要你回话
# → 直接在 panel 里输回复,Enter 发出去 — 不用 attach
# 想看完整对话:Enter 或 → 直接 attach
# session 完整接管 terminal,跟你直接跑 `claude` 没区别
# 想回去:空 prompt 上按 ← 就 detach
2. session 状态图标 — 必背的”两层信号”
每个 session 前面的小图标编码了两个独立信号:
信号 A:状态(颜色 + 是否动画)
| 图标颜色/动画 | 含义 |
|---|---|
| 动画转圈 | Working — Claude 正在跑工具或生成回复 |
| 黄色 | Needs input — 在等你回话(权限决定 / 问题回答) |
| 暗色 | Idle — 等输入但没有具体被卡住的问题 |
| 绿色 | Completed — 跑完了,任务成功 |
| 红色 | Failed — 出错 |
| 灰色 | Stopped — 被 Ctrl+X 或 claude stop 停了 |
信号 B:进程状态(图标形状)
| 形状 | 含义 |
|---|---|
✻ 或动画 ✽ | session 进程活着,可以直接回话 |
∙ | 进程已经 exit(supervisor 1h 后会自动释放) — 但你 peek/reply/attach 时会从断点重新拉起一个进程 |
✢ | /loop session 在两次 iteration 之间睡觉 — 行内会显示 run count 和到下次 iteration 的倒计时 |
🟢 这个 ✢ 图标是给”长跑用户”准备的彩蛋:你现在正在跑的 /loop /content-curation-auto ... 那个 session,在 Agent View 里就长这样。
3. 5 个高频键(只背这 5 个就够)
Space peek - 看 session 在干嘛 + 直接回话
Enter / → attach - 接管 terminal,完整对话
← (空输入) detach - 回到表里
? 显示所有快捷键
Ctrl+T pin 当前 session 到顶部
Ctrl+R 重命名、Ctrl+X 停/删、Ctrl+S 切换分组(按状态 ↔ 按目录)是次高频。
4. 启动 background session 的 3 个入口
| 入口 | 何时用 |
|---|---|
claude agents → 底部输入框 → Enter | 多数情况;最自然的入口 |
任何 session 内部 /bg <prompt> 或 /background | 想把当前对话扔到后台继续 |
终端 claude --bg "<prompt>" | 写 shell 脚本 / 想批量启动多个 session |
--bg 配合 --agent 可以让指定 subagent 当主 agent:
claude --agent code-reviewer --bg "address review comments on PR 1234"
5. 文件写入隔离 — 自动 worktree
这是个默认开启但很多人不知道的机制:
- background session 启动时跟你在同一个 cwd,但被禁止写那个目录
- 当 session 想 edit 任何文件时,Claude 自动把它搬到一个 isolated git worktree 下,放在
.claude/worktrees/ - 多个并行 session 各自一个 worktree,读同一个 checkout,写不互踩
- session 被 delete 时,worktree 也被删 — 想保留的改动要先 merge 或 push
例外情况(不会自动隔离):
- session 启动时就已经在某个 worktree 里
- 当前目录不是 git repo
- session 写的是工作目录之外的路径
🟢 实操要点:每个 background session 都是一个游离的 worktree,review 完一定要么 git worktree list 看看在哪、要么从 PR 走。
6. Filter — 输入框的另一个用法
输入框默认是”键入 prompt 启动 session”。但如果你输入的是过滤语法,它变成搜索:
| 输入 | 显示 |
|---|---|
a:<name> | 跑特定 agent 的 sessions |
s:blocked | 所有等你回话的 sessions(救命型常用) |
#1234 或 PR URL | 在做那个 PR 的 session |
🟢 s:blocked 是单手开发者最有用的过滤 — 早上起来打开,只看那些等你拍板的。
7. Supervisor 进程 — 后台心脏
~/.claude/daemon.log supervisor 日志
~/.claude/daemon/roster.json 正在跑的 sessions(用于重启后重连)
~/.claude/jobs/<id>/state.json 每个 session 的状态
行为模式:
- 第一次 background session 或第一次开 agent view 时自动启动
- 跟你的 interactive session 用同一份 OAuth 凭证(不走额外网络连接)
- 监视磁盘上的 Claude Code 二进制,auto-updater 升级后会自动 reload(本地文件 watch,不是网络 check)
- 所有 session 都结束 + 没有 terminal 连接时,supervisor 自己退出
CLAUDE_CONFIG_DIR改路径时,supervisor 用新目录、跑成独立实例 — 可以用来开”沙箱配置”试验
关键事实:supervisor 不依赖 terminal。你可以关 terminal、关 agent view,sessions 照跑不误。
8. 限制(2026-05-13 的真实坑)
| 限制 | 实际影响 |
|---|---|
| Rate limit 按 session 累加 | 10 个 session 并行 = 10× quota 消耗 — Pro/Max 用户要算账,Free 别想了 |
| sessions 本地跑,机器睡 / 关机就停 | Mac 笔记本盖一下 = 全停;重启用 claude respawn --all 唤醒 |
| worktree 跟 session 同生共死 | 删 session 之前必须 merge / push,否则改动消失 |
bypassPermissions / auto 模式 | 从 agent view 启动时不允许(防止你没看着却让 Claude 乱搞);必须先在 interactive claude --permission-mode bypassPermissions 跑一次接受过 |
🟢 译者总评 — 3 个 takeaway
1. 这是过去 6 个月 Claude Code 最重要的一次 UX 变化,但 Anthropic 自己几乎没大张旗鼓宣传。
为什么?因为它改变默认工作流:从”开一个 session 干一件事”变成”派多个 session 各干一件事”。这种变化对 power user 是质变,对新用户没感知 — 所以 Anthropic 把它放 Research Preview,先让重度用户用起来。
2. 跟 /goal + /loop 的组合是真正的”长跑利器”。
设想这样的工作流(我等下就要试):
[早上 9 点] claude agents
→ 派 5 个 background session,每个一个 PR 要修,带 /goal "make CI green"
→ 关 terminal,去做别的事
[中午回来] claude agents
→ 看哪些 ready for review(自动开 PR + CI 通过),merge 之
→ 看哪些 needs input(架构决策),逐个 peek + 拍板
→ 看哪些 failed,debug
这跟传统 “1 个 session 多轮聊” 比,吞吐量 ×5,认知负担 ÷3。代价是 quota 烧 5 倍 — Pro 季付的人要算账。
3. 但目前还是 Research Preview,有两个真坑值得提前规避。
- 机器睡眠 = session 全停:笔记本工作者要么常电源、要么
caffeinate一下、要么接受respawn --all流程 - 每行 summary 是 Haiku 写的:每 15 秒一次刷新 + 每个 turn 结束一次 — 50 个 session 在 working 状态时,会冒出一波 Haiku 请求,会被算进 quota
这两个加起来意味着:Agent View 现在不是”零成本的多线程”,而是”显式开销的多线程”。值得用,但别把它当免费午餐。
🔗 延伸阅读
- 同系列下一篇:
02-remote-control.md—claude.ai/code网页端 + 远程控制本地 CLI(Agent View 的”网页化”版本) 09-routines-schedule.md—/loop//schedule/ CronCreate 三件套,跟 Agent View 一起组成长跑工具链- 官方对照阅读:Run agents in parallel — Anthropic 自己解释 Agent View vs Subagents vs Agent Teams vs Worktrees 的区别
🔗 调研来源(可校验)
- 主要原文:
https://docs.claude.com/en/docs/agent-view(→platform.claude.com/docs/en/agent-view) - 版本号溯源:
anthropics/claude-codeCHANGELOG.md,2.1.139 第一条 - 进一步引用文档:
/en/sub-agents、/en/agent-teams、/en/claude-code-on-the-web、/en/worktrees、/en/settings、/en/permissions - 内部代号验证:Claude Code 内置
Agenttool 的默认 subagent 描述里写了 “FleetView’s default when no agent name is typed” —— FleetView 是 Agent View 的内部别名
📝 本机版本:Claude Code v2.1.139(2026-05-13 安装) — 撰文时即时可用