使用 agent view 管理多个代理

​

快速开始

claude agents

​

使用 agent view 监控会话

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

Pinned
  ✽ clawd walk cycle          Drawing the walk-cycle sprite frames          3m

Ready for review
  ∙ jump physics              Opened PR with collision fix                 #2048  2h

Needs input
  ✻ power-up design           double jump or wall climb?                    1m

Working
  ✽ collision detection       Adding swept-AABB checks to CollisionSystem   2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Completed
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

​

读取会话状态

​

行摘要

​

拉取请求状态

• Claude Code 将标签写为 #1234 用于拉取请求，!1234 用于 GitLab 合并请求。
• Claude Code 即使无法检测到超链接支持（例如通过 SSH 或 tmux）也会发出链接。设置 FORCE_HYPERLINK=0 将标签呈现为纯文本。
• 在你向会话发送后续内容后，Claude Code 保持标签，同时行返回到实时进度。

• 当 Claude 用 gh 编辑、评论、关闭或标记拉取请求为就绪时，Claude Code 链接命令自己的输出命名的拉取请求。捕获的输出不命名拉取请求的 gh 命令不创建链接；gh pr merge 是常见情况，因为它仅将其结果打印到交互式终端。
• 当 Claude 用 gh pr checkout 检出拉取请求或推送到分支时，Claude Code 用 gh pr view 查找分支并链接其打开的拉取请求。
• 当 Claude 推送时拉取请求不需要已存在：Claude Code 在同一目录中最多五个后续 git、gh、glab 或 curl 命令运行后重试分支查找，所以在推送后创建的拉取请求，包括 Claude 通过 GitHub REST API 创建的，在重试找到它时链接。

​

窥视和回复

• 等待你的会话：它提出的确切问题，在回复输入上方
• 已完成的会话：其结果
• 工作中的会话：其完整状态句子

​

附加到会话

​

在不离开终端的情况下切换会话

• 按 Enter 重新打开对话。
• 按 Esc 撤销切换并返回对话。如果 Esc 显示 Still starting — try again in a moment，后台会话还没有准备好，所以稍后再按一次 Esc。
• 按 Ctrl+C 两次以退出到你的 shell。

​

组织列表

• 按 Ctrl+T 将会话固定到顶部并在空闲时保持其进程运行
• 按 Shift+↑ 或 Shift+↓ 重新排序会话
• 按 Ctrl+R 重命名会话
• 在组标题上按 Enter 折叠它

• /resume 命名一个 id 或搜索项
• 视图用 --cwd 作用域
• 视图用 --safe-mode 启动
• 视图用 --permission-mode 或 --settings 等标志打开

​

过滤会话

​

快捷键

​

调度新代理

​

从 agent view

• /exit 和 /quit 关闭 agent view
• /logout 将你登出
• /model 设置 调度模型
• /login 打开登录对话框，以便你可以在不附加到会话的情况下再次登录
• 裸 /resume 或其 /continue 别名打开存储库过去会话的选择器，以 恢复一个 作为后台会话。需要 Claude Code v2.1.212 或更高版本

​

调度到特定目录

• 在该目录中打开 claude agents。
• 在父目录中打开 claude agents 并在提示中用 @<repo> 提及一个子存储库。输入 @ 会列出这些目标：
  • 启动目录下一级的 Git 存储库
  • 你启动的存储库的已注册 git worktrees，这些 worktrees 位于其目录树内，例如 Claude 在 .claude/worktrees/ 下创建的那些，标记有其检出的分支。在存储库外添加的 worktrees，例如用 git worktree add ../feature 添加的，不会被列出
  • 任何已在列表中有会话的目录
  名称包含空格的目录不会被列出。
• 从 shell，cd 进入目录并运行 claude --bg "<prompt>"。

​

从会话内部

​

将会话发送到后台

​

使用 /fork 复制会话

• 像任何调度的会话一样，副本 在编辑文件前移动到其自己的 worktree。在这种情况下，确认不会提及副本运行的位置。
• 当你的会话在启动后移动到其链接的 worktree 时，副本从会话移动前的位置开始，除非它 就地编辑，在那里的自己的 worktree 中进行代码更改。当你的 worktree 在分支上检出时，该指令也告诉一个副本，其任务建立在你的工作基础上，以你的分支为基础创建其新分支，因为你的分支在你的 worktree 中保持检出。确认以 runs in the origin tree 结尾。
• 当你在具有主工作树的存储库的链接 worktree 内启动会话时，副本在该主工作树中启动，具有相同的 worktree-of-its-own 规则但没有分支指令。确认也以 runs in the origin tree 结尾。
• 在裸存储库布局的 worktree 内启动的会话没有主工作树可返回，所以副本保持在原地，确认以 edits this checkout 结尾。当 worktree 隔离在不在链接 worktree 内的会话中被 关闭 时，也会出现相同的注释，因为副本随后编辑你打开的文件。

​

后台化时会继承什么

• --mcp-config 和 --strict-mcp-config
• --settings
• --add-dir
• --plugin-dir
• --fallback-model
• --allow-dangerously-skip-permissions

​

从你的 shell

claude --bg "investigate the flaky SettingsChangeDetector test"

claude --agent code-reviewer --bg "address review comments on PR 1234"

claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

backgrounded · 7c5dcf5d · flaky-test-fix
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

​

运行 shell 命令

claude --bg --exec 'pytest -x'

​

文件编辑如何隔离

• 会话已经在链接的 git worktree 内，无论 Claude 是在 .claude/worktrees/ 下创建的还是你用 git worktree add 在其他地方创建的
• Claude 正在编辑的文件在链接的 git worktree 内，例如会话或其 subagent 用 git worktree add 创建的
• 工作目录不是 git 存储库且没有配置 WorktreeCreate hook
• 写入在工作目录外

{
  "worktree": {
    "bgIsolation": "none"
  }
}

• 提交并推送：Claude 无需询问即可提交，当存储库有远程时推送分支。
• 草稿拉取请求：当任务要求时 Claude 打开一个，#N label 出现在行上。
• 永不：推送到 main 或 master、强制推送和合并。
• 你的 git 指令优先：如果任务、CLAUDE.md 或 memory 说你自己处理提交或推送，Claude 将 git 留给你。

​

删除会话会移除什么

• Agent view 删除它，包括未提交的更改，所以先提交你想保留的内容。
• claude rm 当它有未提交的更改时保留它，以及会话行。
• 当另一个运行中的会话正在使用或已锁定 worktree 时，agent view 和 claude rm 都不会删除它，再次删除不会改变这一点。Claude Code 保留 worktree 和会话，并命名保留的目录和原因；在 agent view 中，会话的行显示 not deleted。关闭另一个会话，然后再次删除。
• 当你删除一个 worktree 有 Claude Code 无法确认保存在其他地方的提交的会话时，Claude Code 保留 worktree 和会话，消息命名 worktree 的分支和有多少未推送的提交。消息还提供两种前进方式：推送提交，或再次删除以丢弃它们。 远程上的提交不会阻止删除。本地副本上的提交也不会，只要该分支在你的主检出（存储库目录本身而不是 worktree）中检出。 在该拒绝后，你选择：
  • 要保留提交，推送它们或将它们合并到该默认分支，然后再次删除会话。
  • 要丢弃它们，再次删除会话而不推送：在 agent view 中的其行上按 Ctrl+X 两次，或运行拒绝打印的 claude rm <id> --discard-unpushed 命令。这会删除会话和 worktree 以及其分支，丢弃未推送的提交和任何未提交的更改。
  当你再次删除时，Claude Code 仅丢弃拒绝显示的内容：如果 worktree 自那以后获得了提交，Claude Code 再次保留它并显示更新的状态。 当另一个已完成会话的记录也命名 worktree 时，当你再次删除时它保留；推送提交，然后再次删除。
• git 不再识别的 worktree，例如在 git worktree prune 后，不会阻止删除。Claude Code 删除会话并在磁盘上留下目录。
• 当 git 或你的 WorktreeRemove hook 无法删除 worktree 时，Claude Code 保留 worktree 和会话，消息命名原因。对于 hook，消息说它如何结束，例如 exited 1，并引用其 stderr 的开始。消息还告诉你接下来要做以下哪一个：
  • 再次删除会话以无论如何删除目录，在 agent view 中的其行上按 Ctrl+X 两次或运行 claude rm 拒绝打印的 claude rm <id> --force-remove-worktree <worktree-id> 命令。Claude Code 仅在它可以确认目录是存储库在 .claude/worktrees/ 下的链接 worktrees 之一，没有对跟踪文件的未提交更改、其内没有嵌套存储库，没有其他会话的记录命名它时才提供此选项。worktree 的分支保留在存储库中。
  • 修复阻碍的东西，例如提交或隐藏未提交的更改、关闭使用目录的任何东西或修复 hook，然后再次删除会话。
  • 自己删除目录，然后再次删除会话。

• Agent view 在丢弃它们前要求相同的 Ctrl+X 双按。对于 hook 创建的目录，它运行你的 WorktreeRemove hook，没有一个它拒绝删除并保留会话。
• claude rm 保留会话和 worktree，并命名原因。

​

设置模型

/model opus
refactor auth
/model sonnet
run the test suite

• 从 shell，用 claude --bg 传递 --model。
• 附加到运行中的会话并运行 /model 以切换：从选择器中选择，或输入 /model <name>，保存为你的新会话默认值，除非你在选择器中按 s 进行仅会话切换。如果会话被重新生成，仅会话切换会持续。
• 调度一个 subagent，其 frontmatter 设置 model 字段。

​

权限模式、模型和工作量

​

设置和提供商

​

LLM gateway

• 你用 ← 或 /background 后台化你自己的会话
• 你调度一个会话到你所在的目录
• 你通过附加或回复它唤醒你所在目录中的停止会话

​

权限模式

• 用 /bg 或 ← 后台化：Claude Code 保留会话所在的权限模式，所以你切换到 acceptEdits 或 auto 的会话在分离后仍保持该模式
• 从你用 ← 打开的 agent view 调度：目标自己的配置优先，你来自的会话的权限模式在没有其他设置一个时适用
• 从 shell 中启动的 claude agents 或用 claude --bg 调度：新会话以新 claude 会话在该目录中的方式启动，除非你从用 dispatch defaults 打开的 agent view 调度它。Which permission mode a session starts in 列出顺序

1. 目标目录的 permissions.defaultMode。两个来源规则适用：
   • auto 和 bypassPermissions 仅从托管设置、--settings 文件或 ~/.claude/settings.json 生效。
   • Claude Code 拒绝来自项目的 .claude/settings.json 或 .claude/settings.local.json 的 defaultMode，该模式选择比你来自的会话所在的更宽松的模式。
2. 你来自的会话的权限模式

​

调度默认值

claude agents --permission-mode plan --model opus --effort high

​

重新启动时持续什么

​

Settings、plugins 和 MCP servers

claude agents --settings ./ci-settings.json --add-dir ../shared-lib

​

从 shell 管理会话

​

将会话列为 JSON

​

从脚本读取会话状态

​

后台会话如何被托管

​

监督进程

• 工作中、暂停在权限提示或其他对话上，或已连接：进程继续运行。运行中的子代理、工作流或监视器计为工作中。
• 已完成或等待你的下一条消息，且未连接约一小时：监督进程停止该进程以释放资源。以向你提问结束其轮次的会话计为等待你的下一条消息。对话保存在磁盘上，下次你连接或回复时，会话从中断处恢复。使用 Ctrl+T 固定会话以保持其进程运行。
• 在监督进程运行时意外退出：监督进程重新启动该进程。使用 ← 或 /background 后台化的会话（例如使用 kill）标记为已停止而不是重新启动。对于以关闭结束的会话，请参阅会话在关闭后显示为失败或已停止。
• 自动更新后：监督进程重新启动自身到新版本，并在后台移动空闲会话。工作中、等待你或已连接的会话不会被中断。

​

状态存储位置

​

关闭 agent view

​

Troubleshooting

​

claude agents 列出子代理而不是打开代理视图

​

代理视图打开时没有会话

​

后台处理显示 Background this session? 对话框

• 无法移动的工作：该会话有无法移动到后台会话的工作，例如正在运行的监视器。对话框命名 Claude Code 会停止的工作，并分别计算转移的任务数。
• 具有运行子代理的工作流：动态工作流仍然有子代理在运行。工作流本身会转移，但其运行的子代理从头开始重新启动，对话框会说明有多少个。
• 自动工件回复：Claude 自动回复工件上的评论。这些回复在后台会话中继续，对话框会说明这一点。

​

提示被拒绝为过短

​

会话在关闭后显示为失败或已停止

• 在 48 小时内，会话显示为失败。附加或回复它，它会从中断的地方重新启动。
• 超过 48 小时，例如机器关闭数天后，会话显示为已停止，并显示 ended while the background service was off。在该行上按 Enter，页脚会显示 Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it. 在同一行上再次按 Enter 来恢复其保存的对话。回复或 claude attach <id> 会在没有该页脚提示的情况下恢复它。

​

打开会话说对话已经打开

• 您恢复对话的终端，例如使用 claude --resume 或 /resume：该行显示 Open in a terminal，并提示在那里继续，打开该行显示 Can't open — this session is running in another terminal。在该终端中继续，或退出它并再次打开该行。
• 另一个非交互式 Claude Code 进程，例如同一对话的后台会话进程，尚未退出：打开该行显示 This conversation is already open in another running Claude session。使用该进程，或等待它退出并再次打开该行。

​

打开会话说它没有保存的转录

​

终端主机已死亡或会话停止响应

​

终端主机已死亡

• 在代理视图中，该行显示 terminal host process died — press Enter to restart。在它上面按 Enter，Claude Code 在新的主机进程上重新启动会话。
• 从 shell，claude attach <id> 重新启动已标记为失败的会话。否则它报告原因并退出，告诉您运行 claude attach <id>。

​

会话没有响应

• 在代理视图中，页脚显示 Press enter again to restart this session — it isn't responding (its conversation is saved and resumes). 在同一行上再次按 Enter，Claude Code 停止无响应的进程并重新启动会话；没有第二次按下，它不会停止任何内容。
• 从 shell，claude attach <id> 报告原因并退出，告诉您运行 claude stop <id>，然后 claude attach <id>。

​

会话在启动前失败，并显示 possibly low memory 注释

​

代理视图说后台服务没有响应

claude daemon stop --any --keep-workers

​

分派失败，显示 Could not resolve authentication method

claude daemon stop --any --keep-workers

​

后台会话无法在 macOS 上读取 Desktop、Documents 或 Downloads

​

后台会话无法在 macOS 上访问本地网络主机

​

附加后会话响应缓慢

​

.claude/worktrees/ 正在填满

​

限制

• 速率限制适用：后台会话消耗你的订阅使用量，与交互式会话相同，因此并行运行十个代理的配额消耗速度大约是运行一个代理的十倍。
• 会话是本地的：后台会话在你的机器上运行。它们在机器睡眠时保留，但在机器关闭时停止。
• Claude 创建的 worktrees 在 agent view 中随会话删除：在删除在其自己的 worktree 中编辑文件的会话之前，请提交更改。某些删除会保留 worktree。

​

相关资源

• 并行运行代理：比较 agent view 与 subagents、agent teams 和 worktrees
• 跨会话消息传递：让您的会话相互传递发现
• Agent teams：协调相互发送消息的多个会话
• 在云端使用 Claude Code：在托管的云环境中运行会话而不是本地
• Projects：让 Claude 从一个对话中协调并行云会话，并告诉您哪些需要您

​

版本历史