当多个 Agent 同时运行时,哪个需要你介入,哪个已经完成,哪个正在烧钱?Agents 侧边栏是快速筛查这些任务的控制台。本教程从上到下逐一讲解面板结构——行结构、状态分组、预览窗格、调度输入框——并解释在启动任何任务之前你需要做出的那个关键信任决策。
对话标签页是你逐步驾驭 Agent 的地方;Agent View 则是你观察那些已脱手运行的任务的地方。大多数时候两者并用:前台是你正在思考的对话,旁边还有三四个已调度的后台任务在运行——测试套件、重构、快照扫描——等你随时回来查看。Agents 面板就是管理这"第二堆"任务的仪表盘。
bypassPermissions 含义Agent View 中的"Agent"指的是一个 Claude Code 会话——但这些会话出现在这里有三种不同的原因:
这种分组不是装饰性的,每组回答的是不同的问题:"我在做什么?"、"现在什么需要我介入?"、"我最近做了什么?" 如果你只记住本教程的一件事,就记住哪个分组回答哪个问题——面板的其余部分都以此为基础展开。
点击活动栏中的 Agents 按钮——那个堆叠矩形图标,从上往下第四个,位于 Source Control 下方。悬停任意活动栏图标可确认标签;Agents 图标的标签就是"Agents"。
目前没有打开面板的快捷键。如果你经常使用活动栏,过几天就会靠肌肉记忆记住它的位置。
如果你从未调度过后台 Agent,也没有打开 Claude 对话标签页,你会看到空状态提示:"No active sessions — Open a Claude tab or dispatch a background agent above." 这是正常的——面板是动态的,不会预填任何内容。
面板由四个堆叠区域组成。了解每个区域的用途,能让后续教程内容容易理解得多。
| 区域 | 内容 | 用途 |
|---|---|---|
| 标题栏(Header) | "AGENTS"标题 + 刷新按钮(↻) | 当某个任务的状态看起来不新鲜时,强制重新扫描 ~/.lingcode/jobs/。 |
| 调度栏(Dispatch bar) | 文本框"Dispatch a background agent…"+ 发送按钮 | 输入目标,按 ↩,走开。详见第五步。 |
| 分组列表(Grouped list) | Active → 状态分组 → Recent | 任务列表。点击某行即可对其操作。 |
| 预览窗格(Peek pane)(选中后台任务行时显示) | 转录内容 + 底部回复输入框 | 无需离开侧边栏即可观察任务进度。详见第六步。 |
后台任务按状态分组:Working、Idle、Completed、Failed、Stopped。这种分组让"现在什么需要我介入"一目了然——Failed 组或长时间未更新的 Working 行是优先查看的对象。
每个后台任务行在一行内压缩了五条信息。从左往右读,但把每个信号当作独立的——你很少需要同时看全部五个。
? = 需要输入。空心灰圆 = Idle(空闲)。绿色 ✓ = Completed(已完成)。红色 ! = Failed(失败)。灰色停止标记 = Stopped(已停止)。这是你判断"是否需要操作"的主要渠道。$0.0423)。只在任务产生消费后才显示。这是失控循环的早期预警——如果某行费用涨得比预期快,请及时介入。30s、5m、2h、3d。告诉你该行的"新鲜度"——一个超过一小时没有更新的 Working 行很可能已经卡住了。你不需要死记颜色代码——悬停任何元素,提示就会告诉你。本节的重点是让你意识到每个字形都有其特定含义,这样你才不会对它们视而不见。
在调度栏中输入一个完整的目标——比如"运行测试套件,修复所有失败的快照"——然后按 ↩(或点击发送箭头)。Agent 立即在独立进程中启动,调度框随即清空,一两秒内 Working 分组下会出现一条新行。你可以关闭 Agents 面板、切换项目,甚至关闭窗口——任务会继续运行。
任务在当前项目的根目录下运行(即编辑器中打开的目录)。如果没有打开任何目录,则回退到你的主目录。
点击任意状态分组下的行,面板下半部分会分出一个预览窗格,显示:
⏵)、工具结果(↳ 或 ✗)以及最终结果(done 或 failed)回复输入框是最值得注意的地方。当 Agent 进程仍在运行时,它处于禁用状态,占位文字会根据禁用原因而变化:
这就是设计意图:你调度了一次自主运行。你回复的是它的结论或待回答的问题,而不是它执行中途的状态。如果你需要在任务进行中途插话,请先使用Stop(第七步),然后再发送新提示。
右键单击任意状态分组下的后台任务行,可打开操作菜单。每项操作都有其特定用途:
| 操作 | 适用场景 |
|---|---|
| Open in Window(在窗口中打开) | 预览窗格最多显示 12 条转录记录。如需查看完整历史、与另一个任务并排对比,或进行长时间审查,可将其弹出为独立窗口。 |
| Stop(停止) | 终止正在运行的进程。仅在行的进程状态为 alive 时可用——之后显示"Stop (already exited)"且无效。 |
| Rerun (fresh session)(重跑,全新会话) | 用干净的对话重新调度相同的提示词。适合需要第二次独立运行,或第一次运行陷入混乱、想要重来而不是追加回合时使用。 |
| Pin / Unpin(置顶 / 取消置顶) | 已置顶的行无论新旧都排在分组顶部。适合标记你真正关注的两三个任务——调度了十几个任务后仍能快速扫描面板。 |
| Rename…(重命名) | 根据提示词开头自动生成的名称往往没有辨识度("Run the…"、"Fix the…")。重命名为你能一眼识别的内容。 |
| Delete(删除) | 若任务仍在运行则先停止,然后从磁盘移除条目并丢弃转录内容。操作前有确认对话框——请认真阅读。 |
具体来说,使用 Agents 面板的日常流程大致如下:
bash npm test、read src/<file>.snap,然后写入。关闭面板,继续你的主要工作。$0.0312,PR 圆点为黄色——检查待定中。done 结束,附有 Agent 的摘要:"Regenerated 4 snapshot files; opened PR #847."重点不在于具体流程——而在于你只打开了面板三次,从未坐在那里盯着 Agent 工作,而行上的字形在每次查看时都已告诉你一切所需信息。这正是 Agent View 所优化的使用方式。
以下内容目前不存在,以免你花时间寻找:没有筛选或搜索框、没有多选、没有批量 Stop/Delete,也没有打开面板的快捷键。如果任务多到让你觉得缺少这些功能,建议减少调度数量,或使用 Pin 把重要任务置顶。"Recent"分组最多显示 20 条——更旧的保存会话仍然存在,可从任意 Claude Code 对话标签页内的历史弹窗中打开。