Wmux 实战:Windows 上原生运行多 AI 编码 Agent 的终端多路复用器
问题:Windows 下跑多个 AI 编码 Agent 为何如此麻烦?
如果你主要在 Windows 上开发,同时又想同时运行 Claude Code、Codex CLI、Gemini CLI 等多个 AI 编码 Agent,很快就会发现一个尴尬的事实:Windows 没有原生 tmux。
macOS 和 Linux 用户可以用 tmux 在单个窗口中管理多个终端会话,分屏运行不同 Agent,随时切换查看状态。而在 Windows 上,即使启用 WSL,也需要复杂的配置才能勉强实现类似效果。更麻烦的是,大多数 AI Agent 需要读取终端输出来理解环境状态,WSL 层会增加不必要的延迟和兼容性问题。
Windows 上的终端复用一直是个被忽视的痛点——每个开发者都在凑合,但很少有人真正解决它。
Wmux(158⭐, MIT, TypeScript)就是为填补这个空白而生的。它是一个原生 Windows 终端多路复用器,专为 AI 编码 Agent 设计,让你在一个窗口内同时运行 Claude Code、Codex CLI、Gemini CLI,还内置了浏览器自动化、零配置 MCP 集成,而且不需要 WSL。
安装:30 秒搞定
Wmux 提供多种安装方式,推荐使用 winget(Windows 包管理器):
winget install openwong2kim.wmux
或者用 Chocolatey:
choco install wmux
也可以直接从 GitHub Releases 下载 Setup.exe。
⚠️ 安装器目前没有经过 Authenticode 签名,SmartScreen 可能会弹出警告。这是正常的——点击「更多信息 → 仍要运行」即可。建议用 winget 或 Chocolatey 安装来跳过这个提示。
上手:5 分钟开始并行编码
安装完成后启动 Wmux,你会看到一个类似 tmux 的分屏终端界面。
第一步:启动多个 AI Agent
按 Ctrl+D 向右分屏,Ctrl+Shift+D 向下分屏。在左分屏中启动 Claude Code:
claude
在右分屏中启动 Codex CLI:
codex
每个分屏都是一个独立的 PTY 会话,Agent 之间互不干扰。你甚至可以在第三个分屏中运行 Gemini CLI 执行测试。
第二步:使用内置浏览器
按 Ctrl+Shift+L 打开内置浏览器面板。Wmux 通过 Chrome DevTools Protocol(CDP)驱动一个真实的 Chrome 实例。你的 Agent 可以通过 MCP 工具直接操控这个浏览器——搜索网页、截图、填写表单。
第三步:体验 Session 持久化
这是 Wmux 区别于普通终端模拟器的核心功能。关掉 Wmux 窗口、重启电脑后,重新打开 Wmux,你之前的会话依然在运行——包括所有进程和终端输出。Claude Code 甚至在重启后会自动恢复到之前的对话上下文。
Fleet View:多 Agent 一目了然
当你有多个 Agent 分布在多个工作区时,按 Ctrl+Shift+A 打开 Fleet View。它会以网格形式展示所有工作区中的所有 Agent 会话,并将等待输入的 Agent(被阻塞的任务)自动置顶显示。点击任意一个即可跳转过去处理。
关键特性一览
相比传统方案(WSL + tmux 或 Windows Terminal 多标签),Wmux 的核心优势在于:
| 特性 | Wmux | Windows Terminal | WSL + tmux |
|---|---|---|---|
| Agent 自动检测 | ✅ Claude Code/Codex/Gemini 等 | ❌ | ❌ |
| MCP 集成 | ✅ 零配置自动注册 | ❌ | ❌ 需手动配置 |
| 内置浏览器 | ✅ Chrome CDP | ❌ | ❌ |
| 会话持久化 | ✅ 崩溃/重启后恢复 | ❌ | ✅ tmux 自身支持 |
| Fleet View | ✅ 批量管理 | ❌ | ❌ 需额外工具 |
| 原生 Windows | ✅ | ✅ | ❌ 依赖 WSL |
| 安装复杂度 | 一条 winget 命令 | 内置 | 需安装 WSL + tmux |
快捷键飞行指南
| 快捷键 | 功能 |
|---|---|
Ctrl+D | 向右分屏 |
Ctrl+Shift+D | 向下分屏 |
Ctrl+Shift+L | 打开浏览器面板 |
Ctrl+Shift+A | 打开 Fleet View |
Ctrl+T | 新建标签页 |
Ctrl+N | 新建工作区 |
` Ctrl+ “ | 浮动面板 |
Ctrl+B + 方向键 | tmux 风格跳转面板 |
Ctrl+I | 通知面板 |
适用场景与局限
最佳场景:
- Windows 开发者同时使用多个 AI 编码 Agent
- 需要 Agent 驱动真实浏览器操作(填写表单、截图验证)
- 需要长时间运行的 Agent 任务(确保会话不因崩溃丢失)
- 希望像 tmux 一样管理终端分屏,但不想折腾 WSL
需要注意:
- 仅支持 Windows 10/11,macOS 和 Linux 用户请使用 tmux 或类似工具
- 安装器的 SmartScreen 问题在使用 winget/Chocolatey 后可以绕过
- 浏览器自动化依赖 Chrome,需要系统中安装 Chrome 浏览器
- AI Agent 检测仅用于状态显示,不调用 AI API 也不捕获 Agent 输出
总结
如果你在 Windows 上同时使用多个 AI 编码 Agent,Wmux 是目前最原生的解决方案。它用一条 winget 命令安装,零配置就能让 Claude Code、Codex CLI、Gemini CLI 在同一个窗口中并行工作,还附带了内置浏览器、Fleet View 和 MCP 集成——所有这些都不需要 WSL。对于 Windows 开发者来说,这是填补生态空白的实用工具。