青蛙小白
博客 / 2026/02

Claude Code Agent Teams 的分屏(Split Pane)模式

2026/02/09 · — 字 · 阅读约 — 分钟 ·
目录

Agent Teams 默认的 in-process 模式虽然省事,但队员一多,切屏会很麻烦。如果想实现那种多窗口并行的“指挥中心”风格,就得研究一下 Split Pane(分屏)模式

视角解放

在默认模式下,得用 Shift+Up/Down 来回切换队员窗口。而在分屏模式下,每个队员都会分到一个独立的终端窗格(pane)。我们就可以一边看 A 队员写后端,一边盯着 B 队员跑测试。

终端环境

这是最容易踩坑的地方。VS Code 的集成终端、Windows Terminal 还有 Ghostty 的原生分屏目前都不支持。

注意,这里说的“不支持 Ghostty”是指 Claude Code 无法直接调用 Ghostty 的原生分屏接口(其控制 API 尚在开发中,详见 Issue #24189)。

目前只有这两个方案能实现分屏:

  1. tmux:最推荐,通用性最强。
  2. iTerm2:需要装插件和改配置。

如何开启

可以直接在启动命令里强行指定:

claude --teammate-mode tmux

或者在 settings.json 配置里写死:

{
  "teammateMode": "tmux"
}
**提示:**如果设为 auto,只有已经在 tmux 里跑着的时候,它才会自动分屏。

准备工作

  • 用 tmux:确保安装 tmux 且命令行能执行。
  • **用 iTerm2 **:
    1. 需要装一下 it2 CLI
    2. 去设置里(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 的完全体。虽然配置稍微麻烦点,但当看到四五个窗口同时开火刷代码的时候,那个效率感是真的不一样。

参考

评论