教程 搜索 / 原生 Mac IDE / 通过 Agent View 管理后台 Agent
📝 文字 ● 中级 更新于 2026-05-17

通过 Agent View 管理后台 Agent

当多个 Agent 同时运行时,哪个需要你介入,哪个已经完成,哪个正在烧钱?Agents 侧边栏是快速筛查这些任务的控制台。本教程从上到下逐一讲解面板结构——行结构、状态分组、预览窗格、调度输入框——并解释在启动任何任务之前你需要做出的那个关键信任决策。

对话标签页是你逐步驾驭 Agent 的地方;Agent View 则是你观察那些已脱手运行的任务的地方。大多数时候两者并用:前台是你正在思考的对话,旁边还有三四个已调度的后台任务在运行——测试套件、重构、快照扫描——等你随时回来查看。Agents 面板就是管理这"第二堆"任务的仪表盘。

你将学到什么

第一步:建立心智模型

1

两种 Agent 工作,一个任务列表

Agent View 中的"Agent"指的是一个 Claude Code 会话——但这些会话出现在这里有三种不同的原因:

  • Active(活跃)——你当前在编辑器中打开的对话标签页。你正在驾驭它们。
  • 后台任务——你已调度并放手让其独立运行的 Agent,它们在独立进程中运行。
  • Recent(最近)——你保存过的历史对话会话。处于静止状态,可随时重新打开为标签页。

这种分组不是装饰性的,每组回答的是不同的问题:"我在做什么?""现在什么需要我介入?""我最近做了什么?" 如果你只记住本教程的一件事,就记住哪个分组回答哪个问题——面板的其余部分都以此为基础展开。

这与标签页内的历史弹窗不同。每个 Claude 对话标签页都有自己的"打开历史会话"选择器。Agent View 展示的是跨所有标签页的最近 20 个会话,以及当前任何位置正在运行的全部任务。可以把它理解为跨标签页的全局视图。

第二步:打开面板

2

活动栏,从上往下第四个图标

点击活动栏中的 Agents 按钮——那个堆叠矩形图标,从上往下第四个,位于 Source Control 下方。悬停任意活动栏图标可确认标签;Agents 图标的标签就是"Agents"。

目前没有打开面板的快捷键。如果你经常使用活动栏,过几天就会靠肌肉记忆记住它的位置。

如果你从未调度过后台 Agent,也没有打开 Claude 对话标签页,你会看到空状态提示:"No active sessions — Open a Claude tab or dispatch a background agent above." 这是正常的——面板是动态的,不会预填任何内容。

第三步:面板结构解析

3

从上到下:标题栏 → 调度栏 → 列表 → 预览窗格

面板由四个堆叠区域组成。了解每个区域的用途,能让后续教程内容容易理解得多。

区域内容用途
标题栏(Header) "AGENTS"标题 + 刷新按钮(↻) 当某个任务的状态看起来不新鲜时,强制重新扫描 ~/.lingcode/jobs/
调度栏(Dispatch bar) 文本框"Dispatch a background agent…"+ 发送按钮 输入目标,按 ↩,走开。详见第五步。
分组列表(Grouped list) Active → 状态分组 → Recent 任务列表。点击某行即可对其操作。
预览窗格(Peek pane)(选中后台任务行时显示) 转录内容 + 底部回复输入框 无需离开侧边栏即可观察任务进度。详见第六步。

后台任务按状态分组:WorkingIdleCompletedFailedStopped。这种分组让"现在什么需要我介入"一目了然——Failed 组或长时间未更新的 Working 行是优先查看的对象。

第四步:一眼读懂一行

4

每行包含五个筛查信号

每个后台任务行在一行内压缩了五条信息。从左往右读,但把每个信号当作独立的——你很少需要同时看全部五个。

  • 状态图标(最左侧)。闪烁虚线强调点 = Working(运行中)。黄色 ? = 需要输入。空心灰圆 = Idle(空闲)。绿色 ✓ = Completed(已完成)。红色 ! = Failed(失败)。灰色停止标记 = Stopped(已停止)。这是你判断"是否需要操作"的主要渠道。
  • 名称,若已置顶则附有置顶图标(旋转 45°)。名称在调度时根据提示词的开头几个词自动生成——如果不好辨认,可以重命名(第七步)。
  • 活动行 vs. 摘要行。任务 Working 时,显示实时工具调用("bash run_tests.sh"、"read package.json");一旦转为 Idle 或 Completed,则切换为 Agent 的最终摘要文本。同一个位置,两种含义——取决于任务是"飞行中"还是"已落地"。
  • 费用标记(等宽字体,如 $0.0423)。只在任务产生消费后才显示。这是失控循环的早期预警——如果某行费用涨得比预期快,请及时介入。
  • PR 圆点(小彩色圆圈)。紫色 = 至少一个 PR 已合并。绿色 = 所有 PR 的检查均通过。黄色 = 至少一个处于 pending 或失败状态。灰色 = 未知(尚未报告检查结果)。如果超过一个 PR,数字会显示在圆点旁。悬停可看到"2/3 merged"或"Checks pending"等提示。
  • 相对时间(最右侧,等宽字体)。30s5m2h3d。告诉你该行的"新鲜度"——一个超过一小时没有更新的 Working 行很可能已经卡住了。

你不需要死记颜色代码——悬停任何元素,提示就会告诉你。本节的重点是让你意识到每个字形都有其特定含义,这样你才不会对它们视而不见。

"Active"行的行为不同。Active 分组下的行是编辑器中实时的对话标签页。点击它会跳转到那个标签页——不会打开下方的预览窗格。状态分组下的后台任务行才会打开预览窗格。Recent 行则会以新标签页的形式重新加载。同一面板,三种行为,取决于该行所在的分组。

第五步:调度后台 Agent

5

输入目标,按 ↩,走开

在调度栏中输入一个完整的目标——比如"运行测试套件,修复所有失败的快照"——然后按 ↩(或点击发送箭头)。Agent 立即在独立进程中启动,调度框随即清空,一两秒内 Working 分组下会出现一条新行。你可以关闭 Agents 面板、切换项目,甚至关闭窗口——任务会继续运行。

任务在当前项目的根目录下运行(即编辑器中打开的目录)。如果没有打开任何目录,则回退到你的主目录。

请注意副标签文字:"Runs detached with bypassPermissions; close the panel any time." 已调度的 Agent 会在无需请求权限的情况下执行任意工具——bash 命令、文件写入、网络请求。这是你换取"走开不管"便利性所做的交换。适合用于副作用可逆的任务,且在可回滚的项目上操作(测试套件、快照重生、文档清理、你会在合并前审查的依赖升级)。不要用于涉及生产环境、部署或不可恢复状态的操作。如果不确定某个任务是否属于"可逆"范畴,请改用普通对话标签页驾驭它——这样你能看到每个权限提示,在出问题前及时叫停。

第六步:预览窗格

6

点击后台任务行,查看其运行情况

点击任意状态分组下的行,面板下半部分会分出一个预览窗格,显示:

  • 状态标记(左上角):任务状态,颜色与行图标一致
  • 名称、任务 ID 和模型:在日志中重新找到该任务所需的元数据
  • 待回答问题块(黄色背景,"Awaiting your input"):仅当 Agent 提出问题并等待回复时才显示
  • 转录内容:最多显示最近 12 个事件——你的回合、助手的文本、工具调用()、工具结果()以及最终结果(donefailed
  • 回复输入框(底部)

回复输入框是最值得注意的地方。当 Agent 进程仍在运行时,它处于禁用状态,占位文字会根据禁用原因而变化:

  • "Waiting for first SDK turn…"——Agent 尚未建立会话 ID(刚启动)
  • "Agent still working — wait or stop first"——Agent 正在处理当前回合,此时发送新提示会产生冲突
  • "Send a follow-up turn…"——进程已退出,你可以继续对话

这就是设计意图:你调度了一次自主运行。你回复的是它的结论待回答的问题,而不是它执行中途的状态。如果你需要在任务进行中途插话,请先使用Stop(第七步),然后再发送新提示。

第七步:行级操作(右键单击)

7

六项操作,各有其用

右键单击任意状态分组下的后台任务行,可打开操作菜单。每项操作都有其特定用途:

操作适用场景
Open in Window(在窗口中打开) 预览窗格最多显示 12 条转录记录。如需查看完整历史、与另一个任务并排对比,或进行长时间审查,可将其弹出为独立窗口。
Stop(停止) 终止正在运行的进程。仅在行的进程状态为 alive 时可用——之后显示"Stop (already exited)"且无效。
Rerun (fresh session)(重跑,全新会话) 用干净的对话重新调度相同的提示词。适合需要第二次独立运行,或第一次运行陷入混乱、想要重来而不是追加回合时使用。
Pin / Unpin(置顶 / 取消置顶) 已置顶的行无论新旧都排在分组顶部。适合标记你真正关注的两三个任务——调度了十几个任务后仍能快速扫描面板。
Rename…(重命名) 根据提示词开头自动生成的名称往往没有辨识度("Run the…"、"Fix the…")。重命名为你能一眼识别的内容。
Delete(删除) 若任务仍在运行则先停止,然后从磁盘移除条目并丢弃转录内容。操作前有确认对话框——请认真阅读。
删除是不可撤销的破坏性操作。确认提示框的内容为:"'<name>' will be stopped (if running) and removed from disk. Its transcript will be lost." 如果你之后可能还想查看 Agent 做了什么,请先 Stop,把行留在原处。每个任务占用的磁盘空间很小,无需主动删除。

第八步:完整的实战示例

8

一次真实筛查流程的全貌

具体来说,使用 Agents 面板的日常流程大致如下:

  1. 打开项目,打开 Agents 面板,在调度栏输入"运行测试套件,修复所有失败的快照,提一个包含变更的 PR",按 ↩。
  2. 行出现在 Working 分组下,活动行依次显示工具调用——bash npm testread src/<file>.snap,然后写入。关闭面板,继续你的主要工作。
  3. 一小时后再次打开面板。该行已移入 Completed 分组,费用标记显示 $0.0312,PR 圆点为黄色——检查待定中。
  4. 点击该行,预览窗格打开。有待回答问题吗?没有。转录内容显示一次干净的运行,最终以 done 结束,附有 Agent 的摘要:"Regenerated 4 snapshot files; opened PR #847."
  5. 你想看完整转录。右键 → Open in Window,在弹出的详情窗口中阅读整个运行过程,包括它撰写的 PR 描述。
  6. 半小时后刷新面板,PR 圆点变为绿色,从你的常规流程合并即可。

重点不在于具体流程——而在于你只打开了面板三次,从未坐在那里盯着 Agent 工作,而行上的字形在每次查看时都已告诉你一切所需信息。这正是 Agent View 所优化的使用方式。

面板暂未提供的功能

以下内容目前不存在,以免你花时间寻找:没有筛选或搜索框、没有多选、没有批量 Stop/Delete,也没有打开面板的快捷键。如果任务多到让你觉得缺少这些功能,建议减少调度数量,或使用 Pin 把重要任务置顶。"Recent"分组最多显示 20 条——更旧的保存会话仍然存在,可从任意 Claude Code 对话标签页内的历史弹窗中打开。

下一步