
一句话定位cmux 是基于 Ghostty 渲染引擎构建的原生 macOS 终端应用核心卖点是垂直标签页管理、Agent 通知提醒环、内置浏览器、分屏面板和 CLI/socket 可编程 API。它不是 Ghostty 的 fork而是一个独立的应用层。目前仅支持 macOS 14.0Apple Silicon / Intel开源免费。一、安装与初始化方式一DMG推荐从 cmux.com 下载.dmg拖到「应用程序」文件夹即可。后续通过 Sparkle 自动更新。方式二Homebrewbrew tap manaflow-ai/cmux brewinstall--caskcmux更新时执行brew upgrade --cask cmux。首次打开时 macOS 会提示「来自已识别的开发者」点击「打开」即可。二、理解 cmux 的层级结构cmux 用四层结构组织终端搞清楚这个才能用好快捷键和 APIWindow窗口 └── Workspace工作区 / 侧边栏标签 └── Pane分屏区域 └── Surface面板内的标签页 └── Panel终端或浏览器内容层级是什么创建方式标识WindowmacOS 窗口⌘⇧N—Workspace左侧边栏条目⌘NCMUX_WORKSPACE_IDPane分屏区域⌘D右分屏/ ⌘⇧D下分屏Pane IDSurface面板内的标签页⌘TCMUX_SURFACE_IDPanel终端或浏览器自动创建Panel ID关键理解侧边栏里你看到的每个条目就是一个 Workspacecmux 在 UI 里通常叫它「标签页」而面板内的标签页叫 Surface不要搞混。三、多任务管理工作区 分屏cmux 的侧边栏垂直排列所有 Workspace这是它区别于传统终端/iTerm2 最直观的地方。工作区操作操作快捷键新建工作区⌘N切换工作区⌘1 ~ ⌘9关闭当前工作区⌘⇧W上一个/下一个工作区⌃⌘[ / ⌃⌘]你可以给不同任务分配独立工作区比如「dev」写代码、「server」跑服务、「logs」看日志每个工作区有自己的分屏布局和 Surface。分屏操作操作快捷键向右分屏⌘D向下分屏⌘⇧D在面板间切换⌥⌘ 方向键关闭当前面板⌘W每个 Pane 内还可以创建多个 Surface⌘T 新建⌘[ / ⌘] 切换。四、通知提醒环Agent 需要关注时不会错过这是 cmux 专为 coding agent 设计的杀手级功能。当终端里的进程需要输入或 attention 时cmux 会通过以下方式提醒你通知环面板周围亮起提示光环侧边栏未读标记对应工作区显示红点通知面板弹出通知浮层macOS 桌面通知系统级推送触发方式有两种1. 自动触发Agent如 Claude Code、Codex通过标准终端转义序列OSC 9/99/777自动发送通知。2. 手动触发通过 CLI 或脚本主动发送。cmux notify--titleBuild Complete--body编译完成当你同时跑多个 Agent 或多个长任务时这个通知系统能避免你反复切窗口检查状态。五、内置浏览器终端旁边直接看网页cmux 支持在终端面板旁边直接打开一个浏览器视图而且支持可编程 API。这在以下场景特别实用Agent 需要你确认网页内容时不用切到 Chrome跑前端项目时终端 浏览器在同一窗口内分屏通过 API 自动化浏览器操作比如截图、点击浏览器操作可以通过 CLI 或 socket API 控制具体参考官方「浏览器自动化」文档。六、CLI 与 Socket API自动化脚本控制cmux 内置 CLI 工具默认在 cmux 终端内自动可用。如果要在外部使用创建符号链接sudoln-sf/Applications/cmux.app/Contents/Resources/bin/cmux/usr/local/bin/cmux常用 CLI 命令# 列出所有工作区cmux list-workspaces# 发送通知cmux notify--titleBuild Complete--body编译完成# 浏览器自动化操作详见文档此外cmux 暴露 socket API支持更底层的自动化控制。每个 Surface 都有独立的环境变量CMUX_WORKSPACE_ID和CMUX_SURFACE_ID方便脚本定位当前会话。七、快捷键速查cmux 的终端键位绑定读取自 Ghostty 配置文件~/.config/ghostty/configcmux 特有快捷键工作区、分屏、浏览器、通知可在设置中自定义。常用默认快捷键汇总功能快捷键新建工作区⌘N新建窗口⌘⇧N关闭工作区⌘⇧W切换工作区 1~9⌘1 ~ ⌘9向右分屏⌘D向下分屏⌘⇧D面板间导航⌥⌘ 方向键新建 Surface⌘TSurface 间切换⌘[ / ⌘] 或 ⌃1~⌃9完整快捷键列表见官方文档「快捷键」页面。八、与各种 Agent 的集成cmux 是一个终端所以任何在终端里跑的 agent 都能直接用。官方提到的包括Claude Code、Codex、OpenCode、Gemini CLI、Kiro、Aider、Goose、Amp、Cline、Cursor Agent……cmux 还提供了一些专门的 Agent 集成插件Claude Code Teams 集成oh-my-opencode / oh-my-codex / oh-my-claudecode九、会话恢复当前实现重启 cmux 后它会恢复窗口布局、工作区列表和元数据但不会恢复实时进程状态。也就是说之前跑的 Claude Code、tmux、vim 会话不会自动恢复需要重新启动。对于 Agent 场景可以通过 hook 脚本实现部分会话恢复。十、cmux vs tmux vs iTerm2特性cmuxtmuxiTerm2垂直标签页✅ 原生侧边栏❌ 需要配置❌通知提醒环✅ 原生❌ 需脚本❌内置浏览器✅❌❌GUI 原生应用✅ Swift/AppKit❌ 终端内复用器✅可编程 API✅ CLI Socket✅ 命令丰富⚠️ 有限跨平台❌ 仅 macOS✅✅ macOS简单总结如果你主要在 macOS 上用终端跑 AI Agent、需要同时管理多个任务流、希望有直观的通知和分屏体验cmux 值得一试。如果你需要跨平台或重度依赖 tmux 的会话持久化可以暂时观望。写在最后cmux 的定位很明确不是做一个通用终端而是做一个面向 AI Agent 工作流的生产力终端。它的垂直标签页、通知环、内置浏览器和可编程 API 都是围绕「多任务并行 Agent 交互」这个场景设计的。如果你已经在用 Claude Code、Codex 或其他终端 Agent不妨花半小时试试 cmux看看它的侧边栏管理和通知系统能不能帮你减少切窗口的频次。官网https://cmux.comGitHub开源可自行编译或提 issue推荐一个我个人在使用的AI 中转站 EbeeAIhttps://ebeeai.net注册即送 $10。