tmux-bridge 让 Claude Code、Codex 和 Gemini 在一个终端里协同干活

你会得到什么

不用再开好几个终端、手动在 AI 之间搬消息。装上 tmux-bridge 之后，Claude Code、Codex、Gemini CLI、Kimi Code 这些 Agent 能读到彼此的终端、互相发任务，全程通过 MCP。比如让 Gemini 查资料、Claude 写代码、Codex 审一遍，它们自己接力。

这篇面向已经在用命令行 Agent 的人，大约十几分钟。

先搞懂一个词：tmux

tmux 是个"终端分屏"工具：把一个终端窗口切成好几块（叫 pane），每块各跑一个程序，互不打扰。你可以一块跑 Claude Code、一块跑 Codex、一块看日志，同时都在眼前。

问题是：这几块默认互相看不见。tmux-bridge 就是来打通它们的——让每个 Agent 都能读、能往别的 pane 里发消息。

第 1 步：装 tmux

# macOS
brew install tmux
# Ubuntu / Debian
sudo apt install tmux

装完输入 tmux 能进去就行，按 Ctrl-b 再按 d 退出。

第 2 步：一条命令搭好桥

npx tmux-bridge-mcp setup

它会把 tmux-bridge 这个 MCP 服务器加到你电脑上已装的 Agent 里（Claude Code、Codex、Gemini、Kimi 等）。跑完按提示把用到的 Agent 重启一下，让它们读到新配置。

第 3 步：分屏，给每块起个名

开一个 tmux 会话，切成几块，每块跑一个 Agent，并按角色命名，方便互相点名：

tmux new -s team       # 新建一个叫 team 的会话
# 在里面：Ctrl-b % 左右分屏，Ctrl-b " 上下分屏
# 每块启动一个 Agent：claude / codex / gemini / kimi

让 Agent 之间好称呼，给每块起名（在对应 pane 里让 Agent 调 tmux_name，或你自己设），例如 claude、codex、gemini、kimi。

第 4 步：让它们协同

接下来就是用大白话指挥。在一个 Agent 里，你可以说：

• "读一下 codex 那块现在在干嘛。"（它会去读 Codex 终端的最后几行）
• "把这个文件交给 claude 审一遍。"（它会把任务发到 Claude 那块）
• "等 gemini 查完，把结果拿过来接着写。"

你不用记新命令——这些都是标准的 MCP 工具调用（tmux_read 读、tmux_message + tmux_keys 发、tmux_name 命名）。Agent 只要支持 MCP，就自动会用。

几个好习惯

常见问题

• 装完没反应：Agent 要重启才会加载新的 MCP 配置。先退出再重开。
• 点名点不到：确认那块 pane 已经起了名，名字和你说的一致。
• 读到的是旧内容：tmux_read 读的是当前终端画面，刷新慢时再让它读一次。

延伸

• 不熟悉 MCP？先看 MCP 手册，它讲清楚了 Agent 是怎么用工具的。
• 想理解"多个 Agent 协同"这件事，看 Agent 手册。
• 项目主页：https://github.com/howardpen9/tmux-bridge