cmux：专为 AI 编程 Agent 打造的 macOS 终端神器
cmux：专为 AI 编程 Agent 打造的 macOS 终端神器
GitHub 19.3k Stars，开源免费，原生 Swift 构建——这款终端彻底改变了我和 AI 编程助手协作的方式。
一、痛点：多个 AI Agent 同时跑，你怎么管？
如果你用过 Claude Code、Codex、OpenCode 等 AI 编程工具，一定遇到过这种场景：
同时开着五六个终端窗口，每个里面都跑着一个 AI Agent 在帮你写代码。Agent 跑到一半需要你确认，但系统通知只显示"Claude is waiting for your input"——没有任何上下文，你根本不知道是哪个项目、哪个任务在等你。
标签页越开越多，你要在一堆窗口里逐个翻找，效率极低。
更麻烦的是，现有的多数终端和编排工具要么是 Electron/Tauri 套壳，内存吃得凶、启动慢；要么是 GUI 编排器，把你锁死在它的工作流里，无法自定义。
cmux 就是为了解决这个问题而生的。
二、cmux 是什么？
cmux是一款基于 Ghostty 渲染引擎、专为 AI 编程 Agent 优化的 macOS 原生终端。它由 Manaflow AI 开发，目前在 GitHub 上已获得19,300+ Stars，代码完全开源（GPL-3.0 协议）。
核心定位一句话概括：一个带侧边栏、通知系统和内置浏览器的终端，让你同时管理多个 AI 编程 Agent 不再焦虑。
技术底层：用Swift + AppKit原生构建，不是套壳 Electron，启动快、内存占用低，GPU 加速渲染，兼容你现有的~/.config/ghostty/config配置文件，无缝迁移。
三、核心功能详解
🔔 通知环（Notification Rings）
这是 cmux 最具特色的功能。当某个 AI Agent 需要你介入时，对应的终端面板会出现一个蓝色光环，侧边栏的标签也会同步亮起——一眼就能看出是哪个任务在等你，完全不需要逐个窗口去查。
按下⌘ Shift U可直接跳转到最近一条未读通知，效率拉满。
🗂️ 垂直标签页 + 侧边栏
传统终端的横向标签页在开了十几个窗口之后基本无法阅读。cmux 采用垂直侧边栏布局，每个标签页不只显示名称，还显示：
- 当前Git 分支
- 关联的PR 状态和编号
- 工作目录
- 正在监听的端口
- 最新的通知文本
这意味着你扫一眼侧边栏，就能掌握所有 Agent 的实时状态。
🌐 内置浏览器
cmux 内置了一个可编程的浏览器面板，可以和终端左右分屏显示。AI Agent 可以直接与浏览器交互：
- 快照页面的无障碍树（Accessibility Tree）
- 获取元素引用、点击、填写表单
- 执行 JavaScript
你的 Claude Code 不再需要切换到外部浏览器验证效果，直接在终端旁边的浏览器面板里实时预览开发服务器。
浏览器还支持从 Chrome、Firefox、Arc 等 20+ 浏览器导入 Cookie 和会话，面板打开即已登录。
🖥️ SSH 远程工作区
执行cmux ssh user@remote会直接创建一个远程机器的完整工作区。最贴心的一点：浏览器面板的流量会自动通过远程网络路由，localhost 直接可用，无需额外配置端口转发。拖拽图片到远程会话还会自动通过 scp 上传。
🤖 一键启动 Claude Code Teams
cmux claude-teams一条命令启动 Claude Code 的多 Agent 协作模式（teammate mode）。每个 teammate 作为原生分屏面板生成，自带侧边栏元数据和通知，无需 tmux。
四、如何安装和使用
安装方式
方式一：DMG 安装（推荐）
直接下载 DMG 文件，拖入 Applications 文件夹。cmux 通过 Sparkle 自动更新，只需下载一次：
👉 下载 cmux for macOS
方式二：Homebrew
brew tap manaflow-ai/cmux brewinstall--caskcmux基础工作流
1. 启动多个 Agent 工作区
# 新建工作区⌘ N# 在工作区内创建分屏⌘ D# 向右分屏⌘ Shift D# 向下分屏2. 设置 Agent 通知钩子
# 为已安装的 AI 工具自动配置 hookscmux hooks setup# 指定工具cmux hooks setup codex cmux hooks setup--agentopencode支持 Claude Code、Codex、Grok、OpenCode、Gemini、GitHub Copilot、Cursor CLI 等主流工具。
3. 使用通知系统
在 Agent 的 hook 里调用cmux notify发送通知：
cmux notify"任务完成，请确认代码"Agent 等待时，面板出现蓝环，⌘ Shift U跳转到最新未读。
4. 打开内置浏览器
⌘ Shift L# 在分屏中打开浏览器5. 常用快捷键速查
| 快捷键 | 操作 |
|---|---|
⌘ N | 新建工作区 |
⌘ 1–8 | 跳转到第 N 个工作区 |
⌘ D | 向右分屏 |
⌘ Shift D | 向下分屏 |
⌘ Shift U | 跳转到最新未读通知 |
⌘ I | 打开通知面板 |
⌘ Shift L | 打开浏览器分屏 |
⌘ B | 切换侧边栏 |
会话恢复
退出 cmux 时会自动保存当前会话（窗口布局、工作目录、滚动历史、浏览器记录），下次启动自动恢复。Agent 会话的恢复需要在安装 Agent CLI 后执行cmux hooks setup。
五、和其他工具比较
| 特性 | cmux | 普通终端（如 Ghostty/iTerm2） | Electron 系编排器 |
|---|---|---|---|
| 原生性能 | ✅ Swift/AppKit | ✅ | ❌ |
| Agent 通知环 | ✅ | ❌ | 部分支持 |
| 侧边栏带 Git/PR 信息 | ✅ | ❌ | 部分支持 |
| 内置可编程浏览器 | ✅ | ❌ | 部分支持 |
| 兼容 Ghostty 配置 | ✅ | ✅ | ❌ |
| 开源免费 | ✅ GPL-3.0 | ✅ | 多数收费 |
六、总结
cmux 切中了 AI 编程时代一个真实且高频的痛点：当你同时运行多个 AI Agent 时，如何高效地监控和调度它们。
它的解法不是再造一个臃肿的 GUI 编排平台，而是在终端本身上做文章——用通知环让你一眼看清哪个 Agent 在等你，用垂直侧边栏展示每个工作区的实时状态，用内置浏览器让 Agent 和前端直接联动，然后把一切都做成可组合的原语，让开发者自由搭建自己的工作流。
用作者自己的话说：
“cmux is a primitive, not a solution. Give a million developers composable primitives and they’ll collectively find the most efficient workflows faster than any product team could design top-down.”
如果你是重度 Claude Code / Codex 用户，在 Mac 上同时跑多个 AI Agent，cmux 非常值得一试。免费、开源、原生，没有任何理由不装一个。
GitHub：https://github.com/manaflow-ai/cmux
官网文档：https://cmux.com/docs/getting-started
本文基于 cmux v0.64.x 版本撰写。项目更新活跃，最新特性请以官方仓库为准。