背景与痛点

如果你是一位 Windows 开发者，正在尝试使用 Claude Code、Codex CLI 或 Gemini CLI 这些强大的 AI 编码代理，你可能会遇到一些“尴尬”时刻：

• 窗口地狱：为了同时运行多个 AI 代理，不得不在多个终端窗口间不停地 Alt + Tab 切换，手忙脚乱。

• 状态焦虑：交给 AI 一个任务后，只能干等，并不时探过头去瞅一眼“它到底忙完没”。

• 生态缺失：macOS 开发者早有 cmux 这样为 AI 代理设计的“终端神器”，而 Windows 上始终缺少一个成熟的、原生的解决方案。

现在，wmux 的出现完美地解决了这些问题。它是一个专为 Windows 原生构建的 终端复用器，让你能像管理一个高效团队一样，在单一界面中编排、监控并与多个 AI 代理一起工作。

核心亮点：不只是终端，更是 AI 协同工作台

wmux 的强大之处在于其远超普通终端的功能集合。

1. 多 Agent 同屏，原生流畅体验：wmux 基于 Windows 现代终端核心 ConPTY 和硬件加速的 xterm.js + WebGL 构建。你可以像操作 tmux 一样，在同一个窗口内水平或垂直分割出多个窗格（Panes），并让 Claude Code、Codex 和 Gemini CLI 各司其职。会话和工作区的布局在重启后都能完整恢复。

2. AI 代理接管浏览器：wmux 内置了一个与 Chrome DevTools Protocol (CDP) 连接的浏览器面板。当你向 Claude Code 下达如 “在Google上搜索wmux并截图” 这样的指令时，它会自动调用 browser_open、browser_fill 等一系列操作，驱动浏览器去执行。

3. 智能监控，解放你的注意力：传统的模式匹配和烦人的 curl 调试已成过去。wmux 通过分析终端输出的吞吐量来智能判断任务是否完成。当一个长时间运行的代理“由动转静”时，它会通过任务栏闪烁和 Windows 通知来提醒你。此外，它还会主动检测并提示 git push --force、rm -rf 等危险命令，为项目安全加一道锁。

4. Agent-to-Agent (A2A) 通信：这或许是 wmux 最具未来感的特性之一。它通过 a2a_send、a2a_broadcast 等工具，让不同 Agent 之间可以实现“对话”。你可以直接让一个会话中的 Claude Code 告知另一个会话中的 Codex 更新前端类型定义，实现跨 Agent 的自动化协作。

安装指南

wmux 提供了多种安装方式，这里推荐最省心的两种。

方法一：使用 Windows 包管理器 winget（强烈推荐）

这个方式无需面对烦人的“Windows 已保护你的电脑”弹窗。以管理员身份打开 PowerShell，输入以下命令：

winget install openwong2kim.wmux

完成安装后，你就可以在“开始”菜单中找到 wmux 并启动了。

方法二：使用 npm 全局安装

这个方式适合需要在命令行中调用 wmux 的 CLI 或 MCP 服务器功能的场景。它需要你的电脑具备 Node.js 环境，并且会安装到 Node.js 的全局目录下，运行时依赖外部 Node.js 环境，并非独立的桌面应用。它也不提供图形界面，更适合高级用户通过命令行进行自动化操作。

npm install -g @wong2kim/wmux

        注意：如果你在安装过程中遇到类似 EBUSY: resource busy or locked 或 EPERM 的错误，通常是因为文件被其他程序占用或权限不足，使用 winget 安装可以完美避免此问题。

使用教程

        启动 wmux 后，你会看到一个和标准终端很相似的界面，但所有强大的功能都隐藏在内置的快捷键中。

窗格 (Panes) 与工作区 (Workspaces) 管理

• 拆分窗格：Ctrl + D → 将当前窗格垂直拆分；Ctrl + Shift + D → 水平拆分。

• 管理会话：Ctrl + N → 新建一个独立工作区；Ctrl + 1~9 → 在工作区之间快速跳转。

让 AI 接管浏览器

1. 在 wmux 的任一窗格中启动你的 AI Agent（如 Claude Code）。

2. wmux 的 MCP 服务器会自动注册到该 Agent 的环境中。

3. 现在，你可以直接向 Agent 下达自然语言指令（例如：“在度娘里搜一下 ‘wmux’，然后截个图”）。wmux 会将这一系列操作分解给内置的浏览器去执行。

高级特性与配置

• 监控与安全：wmux 会通过系统通知告知任务的完成、异常退出或危险操作，助你告别“保姆式”的监控。

• 会话持久化：wmux 在后台运行一个守护进程 (Daemon)，即便你关闭主窗口甚至重启电脑，所有会话都会在后台继续运行，并在下次启动时完美恢复。

• 配置：wmux 的配置文件位于 %APPDATA%\wmux\config.toml，你可以在这里自定义默认的 Shell 路径等。

总结与展望

        对于希望在 Windows 平台上高效利用 AI 辅助开发的你来说，wmux 不只是一个工具，更像是一种全新的工作流实践。它将多个强大的 AI 代理从混乱的窗口管理中解放出来，整合到一个统一的、可视化的、可编程的平台上。