Agent Teams 默认的 in-process 模式虽然省事,但队员一多,切屏会很麻烦。如果想实现那种多窗口并行的“指挥中心”风格,就得研究一下 Split Pane(分屏)模式。
视角解放
在默认模式下,得用 Shift+Up/Down 来回切换队员窗口。而在分屏模式下,每个队员都会分到一个独立的终端窗格(pane)。我们就可以一边看 A 队员写后端,一边盯着 B 队员跑测试。
终端环境
这是最容易踩坑的地方。VS Code 的集成终端、Windows Terminal 还有 Ghostty 的原生分屏目前都不支持。
注意,这里说的“不支持 Ghostty”是指 Claude Code 无法直接调用 Ghostty 的原生分屏接口(其控制 API 尚在开发中,详见 Issue #24189)。
目前只有这两个方案能实现分屏:
- tmux:最推荐,通用性最强。
- iTerm2:需要装插件和改配置。
如何开启
可以直接在启动命令里强行指定:
claude --teammate-mode tmux或者在 settings.json 配置里写死:
{
"teammateMode": "tmux"
}**提示:**如果设为
auto,只有已经在 tmux 里跑着的时候,它才会自动分屏。准备工作
- 用 tmux:确保安装
tmux且命令行能执行。 - **用 iTerm2 **:
- 需要装一下 it2 CLI。
- 去设置里(Settings -> General -> Magic)把 Enable Python API 勾上。
问题
- 设置了 tmux 还是回退到了 In-process? 检查一下是不是在 VS Code 里跑的,需要换成原生终端。
- 关于 Ghostty: 既然不支持原生分屏,如果非要在 Ghostty 里用分屏,唯一的办法是先在 Ghostty 中手动启动
tmux。 这样 Claude Code 会通过tmux的协议来创建窗格,从而间接实现在 Ghostty 窗口内的分屏显示。 - 窗口乱了怎么办?
tmux ls查一下,不行就tmux kill-session -t <会话名>重来。 - 资源清理:分屏虽然爽,但活干完了记得
Clean up the team,不然后台可能残留一堆孤儿进程。
总结
最后,分屏模式才是 Agent Teams 的完全体。虽然配置稍微麻烦点,但当看到四五个窗口同时开火刷代码的时候,那个效率感是真的不一样。