Claude Code 如何用 claude agents 视图管理多个后台会话claude-howto 的状态查看与会话派发配置【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto当你同时在跑后台 agent、定时任务或用claude --bg派发的会话时靠切换多个终端标签页来盯状态很快就顾不过来了。Claude Code v2.1.139 起提供的Agent Viewclaude agentsResearch Preview解决的就是这个问题它把本机上所有 Claude Code 会话列在一个界面里并显示每个会话的当前状态running、blocked on you、done。前提是你已安装 Claude Code文档推荐的安装方式是npm install -g anthropic-ai/claude-code且版本不低于 v2.1.139从视图派发会话时用到的部分参数还要求更高版本下文会逐个标注。打开 Agent View 查看会话状态# 打开 Agent View claude agents这是查看多后台会话状态的主路径。打开后你会看到一台机器上全部 Claude Code 会话的单一列表每个会话带有当前状态running、blocked on you、done。文档明确说明它是多个终端标签页来回切换场景的替代方案适用于后台 agent、scheduled tasks 和--bg启动的会话。需要说明的是Agent View 目前标记为Research Preview功能已稳定到可日常使用但后续仍可能变化。如果你发现某个界面细节与文档描述不一致先考虑这一点。从视图派发会话时可用哪些配置从视图派发一个会话或在终端执行claude --bg prompt时可以传与claude本身相同的配置参数。下表是文档中为 Agent View 派发路径列出的参数括号内是该参数的引入版本版本低于该值时参数不可用参数引入版本用途--cwd pathv2.1.141将会话列表或新会话限定到某个工作目录--add-dir pathv2.1.142给派发的会话追加工作目录--settings pathv2.1.142为派发的会话指定一份settings.json--mcp-config pathv2.1.142为派发的会话指定 MCP 配置--plugin-dir pathv2.1.142为派发的会话指定插件目录--permission-mode modev2.1.142设置派发的会话的权限模式plan、acceptEdits、auto等--model modelv2.1.142为派发的会话固定一个模型--effort levelv2.1.142固定 effort 级别low/medium/high/xhigh/max--dangerously-skip-permissionsv2.1.142派发会话时跳过所有权限确认——文档注明只在沙箱中使用--jsonv2.1.145以机器可读 JSON 打印 agent 列表供脚本消费状态栏、会话选择器、tmux-resurrect 集成等一个典型的派发组合把新会话固定在某个工作目录、只读权限模式和指定模型上claude --bg 审计这个模块的权限校验逻辑 \ --cwd ~/work/repo \ --permission-mode plan \ --model sonnet--cwd除了约束新会话也可以用来把 Agent View 里看到的会话列表限定到某个目录——多项目并行时先按目录过滤再判断状态。从交互会话里派生后台会话/fork 与 /subtask如果你已经在一个交互会话里工作不想开新终端文档记录了两条派生路径均在 REPL 内输入/fork [prompt]v2.1.212把当前对话复制进一个新的后台会话你继续留在原会话从此两个会话相互独立副本会在claude agents里占自己的一行。除副本就地修改的情况外Claude Code 会指示副本在改代码前先创建自己的 worktree该隔离指示要求 v2.1.221。/subtask task派生一个继承完整对话的 forked subagent 去执行任务你这边继续干活它同样拥有claude agents里的一行完成后结果返回到你的对话。注意/fork与/subtask在v2.1.212对调了角色v2.1.161–v2.1.211 之间/fork做的是现在/subtask的事。还有一个边界条件当 agent view 被关闭时/subtask不可用/fork会保留旧的 forked-subagent 行为。所以上面这些用法都以 v2.1.212 为前提低于该版本时行为不同按旧语义理解即可。用 --json 把状态查询脚本化--jsonv2.1.145是文档给出的机器可读验证方式把 agent 列表打印为 JSON文档列举的用途包括状态栏、会话选择器、tmux-resurrect 集成。文档未给出 JSON 字段的具体示例输出因此这里只展示一条按文档用途组装的查询骨架.status等字段路径需以实际输出为准# 列出全部后台会话的机器可读状态v2.1.145 claude agents --json # 文档用途示例挑出被阻塞、等待你处理的会话 claude agents --json | jq .[] | select(.status blocked on you)第二条命令中的jq表达式是按文档中--json的用途说明组装的具体字段名以你本机--json的实际输出为准。会话的常驻与恢复文档明确记录了三个与后台会话生命周期直接相关的操作CtrlT 在 claude agents 中把选中的会话置顶pinv2.1.147 ShiftTab 在已 attach 的 agent 会话内循环切换权限模式含 auto modev2.1.143 /resume 不带参数输入时打开历史会话选择器并作为后台会话恢复所选会话v2.1.212Pin 一个会话对列表中的会话按CtrlT。置顶的后台会话空闲时保持存活会在原地重启以应用 Claude Code 更新内存压力下降级时会话时非置顶会话先被处理置顶会话最后。文档特别提示这个CtrlT只在 Agent View 中生效在主会话里它切换的是任务列表视图。恢复历史会话在 agent view 中不带参数输入/resume会打开一个过去会话的 picker——包括已被移出可见列表的会话——并把选中的会话作为后台会话恢复。状态流转的一个已知修复会话完成工作但后台 shell 仍开着时状态会卡在 Workingv2.1.141 修复了这一点此类会话现在会从 Working 进入 Completed。如果你用的是更早版本遇到已完成却仍显示 Working的会话先看版本号。后台会话是否编辑到独立 worktree 由worktree.bgIsolation设置控制v2.1.143它决定来自/bg、claude --bg或 Agent View 的后台会话是拿自己的 worktree还是直接编辑前台工作副本。需要多会话并行改代码而不互相踩脚时这项配置值得关注。边界与限制版本Agent View 为 v2.1.139 且处于 Research Preview 阶段派发参数中--cwd需 v2.1.141其余派发参数需 v2.1.142--json需 v2.1.145pin 会话需 v2.1.147/resume的后台恢复行为需 v2.1.212。状态标识文档列出的状态是running、blocked on you、done工作/完成态在 v2.1.141 的语境中又写作 Working/Completed两者分别描述同一状态机在不同阶段的显示。沙箱限定--dangerously-skip-permissions会跳过派发会话的所有权限确认文档明确限定只用于沙箱环境日常使用不建议带上。界面细节Agent View 处于 Research Preview除上述已版本化的行为外文档未对视图内的全部键位做穷举说明遇到未文档化的按键行为以实际版本为准。完整参数清单可回看 CLI 参考中的 Agent View 小节/fork、/subtask、/resume的语义细节见 Slash Commands 章节worktree.bgIsolation等会话相关设置在 Advanced Features 中有描述。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
