目录

cmux:11k Stars 的 AI 终端多路复用器,让终端成为 AI 工作流中心

cmux:11k Stars 的 AI 终端多路复用器,让终端成为 AI 工作流中心

预计阅读时间:25 分钟 | 难度:⭐⭐⭐


目标读者:希望将终端升级为 AI 工作流中心的开发者 前置知识:终端基础、命令行操作、了解 Claude API 基本概念 预计阅读时间:18 分钟 核心能力:把 Claude AI 能力装进终端,实现工作流自动化

学习目标

完成本文阅读后,你将能够:

  1. 说出 cmux 的核心定位:它和普通终端、Warp 有什么区别
  2. 判断自己是否需要 cmux:列出 3 个适合用 cmux 替代现有终端的场景
  3. 完成一次基础配置:安装 cmux、配置 Claude API Key、运行第一个 AI 命令
  4. 设计一条技能扩展路径:基于 cmux 的 Skills 框架,规划一个自定义工作流

目录


一句话理解 cmux

cmux(manaflow-ai/cmux,11k Stars)是 mana flow.ai 打造的下一代 AI 终端。核心思路:


**简单说**:把 Claude AI 装进终端,加上多路复用和远程 SSH,让终端成为真正的 AI 工作流中心。

---

## 为什么关注这个项目

| 亮点 | 说明 |
|------|------|
| **原生 macOS 应用** | 基于 Swift + libghostty,性能优秀 |
| **Claude 深度整合** | 内置 Claude AI 命令和 Skills |
| **Skills 系统** | 可扩展的 AI 技能框架 |
| **远程 SSH** | 支持远程终端和 daemon |
| **26+ 语言** | 完善的国际化支持 |

对比传统方案:

| 方案 | AI 能力 | 终端复用 | 远程 SSH | 开发活跃度 |
|------|---------|----------|----------|------------|
| tmux | ❌ | ✅ | ❌ | 中 |
| Warp | ✅ 内置 | ✅ | ❌ | 高 |
| **cmux** | ✅ Claude 集成 | ✅ | ✅ | **极高**(每日提交)|

---

## 核心数据

| 指标 | 数值 |
|------|------|
| GitHub Stars | **11k** |
| Forks | **760** |
| 提交数 | 1,894 次 |
| 分支数 | 602 个 |
| Tags | 124 个 |
| 许可证 | AGPL-3.0 + 商业许可 |
| 最新版本 | v0.x.x(预发布) |
| 开发节奏 | **每日提交**(最新 17 分钟前)|

---

## 工作原理

### 核心架构

```text

**关键技术选型**:

| 组件 | 技术 | 优势 |
|------|------|------|
| 终端渲染 | libghostty | GPU 加速、高性能 |
| 开发语言 | Swift | 原生 macOS 体验 |
| 构建工具 | Xcode / Swift PM | 标准化 |
| 远程 daemon | Go | 跨平台、高性能 |

---

## 核心功能详解

### 1. 终端多路复用

类似 tmux 的能力,但专为 macOS 优化:

| 功能 | 快捷键 | 说明 |
|------|--------|------|
| 新建标签页 | `Cmd+T` | 垂直标签页 |
| 垂直分屏 | `Cmd+D` | 上下分屏 |
| 水平分屏 | `Cmd+[` | 左右分屏 |
| 会话持久化 | 自动 | 关闭不丢失 |

### 2. Claude AI 整合

**内置 Claude 命令**:

```bash
# 直接调用 Claude
cmux claude "解释这段代码的逻辑"

# 使用 Claude 分析项目
cmux claude --analyze .

# 自动化代码审查
cmux claude --review src/
```text
skills/
├── git-helper/
│   └── SKILL.md          # Git 辅助技能
├── code-review/
│   └── SKILL.md          # 代码审查技能
└── ...
```markdown
# skills/my-skill/SKILL.md

# My Skill

## 触发条件
当用户输入 /my-skill 或匹配关键词时激活

## 执行逻辑
1. 读取上下文
2. 调用 Claude API
3. 返回格式化结果

## 配置参数
- api_key: API 密钥
- model: 使用哪个模型
- temperature: 创造性程度
```bash
# 远程服务器上启动
cmux daemon start --port 8080

# SSH 隧道连接
ssh -L 8080:localhost:8080 user@remote-server

# 本地连接远程
/cmux connect user@remote-server:8080
```bash
# 安装
brew install manaflow-ai/tap/cmux

# 基本命令
cmux help              # 查看帮助
cmux launch            # 启动 GUI
cmux claude "prompt"   # 直接调用 Claude
cmux omo               # oh-my-openagent 集成
cmux daemon            # 远程 daemon 管理
```bash
# Homebrew(推荐)
brew install manaflow-ai/tap/cmux

# 或下载预编译包
# https://github.com/manaflow-ai/cmux/releases
```bash
# 克隆仓库
git clone https://github.com/manaflow-ai/cmux.git
cd cmux

# Xcode 打开
open GhosttyTabs.xcodeproj

# 或命令行构建
swift build
```bash
# Claude API(必需)
export CLAUDE_API_KEY=sk-ant-...

# 远程 daemon 端口
export CMUX_DAEMON_PORT=8080
```text
cmux/
├── AppIcon.icon/           # 应用图标
├── Assets.xcassets/        # 资产目录
├── CLI/                    # 命令行工具
├── GhosttyTabs.xcodeproj/  # Xcode 项目
├── Sources/                # 核心源码
├── cmuxTests/              # 单元测试
├── cmuxUITests/            # UI 测试
├── daemon/remote/          # 远程 daemon (Go)
├── docs/                   # 文档
├── ghostty/                # Ghostty 子模块
├── skills/                 # Skills 技能文件
├── tests/                  # 测试套件
├── tests_v2/               # 测试套件 v2
├── web/                    # Web 界面
├── .claude/commands/        # Claude 命令
├── scripts/                # 构建脚本
└── vendor/                # 第三方依赖
```bash
# 启动 GUI
cmux launch

# 或直接打开
open -a cmux
```bash
# 解释代码
cmux claude "解释这个函数的逻辑"

# 代码审查
cmux claude --review ./src

# 项目分析
cmux claude --analyze .

# 自动生成测试
cmux claude --generate-tests ./tests
```bash
ssh user@remote-server
cmux daemon start --port 8080
```bash
# SSH 隧道
ssh -L 8080:localhost:8080 user@remote-server

# 连接
/cmux connect localhost:8080

国际化

cmux 支持 26+ 种语言,README 有多个语言版本:

语言文件
EnglishREADME.md
简体中文README.zh-CN.md
繁体中文README.zh-TW.md
日语README.ja.md
韩语README.ko.md
俄语README.ru.md
乌克兰语README.uk.md
越南语README.vi.md
泰语README.th.md
土耳其语README.tr.md

与同类项目对比

项目StarsAI 整合终端复用远程 SSH平台
cmux11kClaude 深度整合macOS
tmux33k全平台
screen2k全平台
Ghostty26kmacOS/Linux
Warp20k内置 AImacOS/Linux

cmux 的独特优势

  1. 原生 macOS:Swift + libghostty,性能优秀
  2. Claude 深度整合:不只是 AI 提示,而是系统级集成
  3. Skills 可扩展:开放的技能框架
  4. 远程工作流:真正的跨设备 AI 工作站

适用场景

场景说明推荐度
AI 开发将 Claude 能力融入日常终端⭐⭐⭐⭐⭐
远程开发SSH 远程 + AI 辅助⭐⭐⭐⭐⭐
工作流自动化自定义 Skills 实现自动化⭐⭐⭐⭐
跨设备开发多设备同步工作流⭐⭐⭐⭐
代码审查Claude 辅助代码审查⭐⭐⭐⭐⭐

常见问题

Q1:cmux 和 Warp 有什么区别?

对比cmuxWarp
AI 整合Claude API(可切换模型)Warp 内置 AI
扩展性Skills 框架完全可定制有限扩展
远程 SSH✅ 原生支持❌ 不支持
许可证AGPL-3.0 + 商业专有

Q2:需要付费吗?

核心功能免费。AGPL-3.0 许可证下可免费使用,商业使用需联系 mana flow.ai 获取商业许可。

Q3:Windows/Linux 支持吗?

目前主要支持 macOS。Linux 支持在规划中(Ghostty 已有 Linux 版本)。

Q4:Skills 和 Claude Commands 有什么区别?

  • Claude Commands:简单的指令触发,执行单一任务
  • Skills:复杂的工作流,包含多步骤逻辑、配置参数、上下文管理

自测题

用这份清单检验你对 cmux 的掌握程度:

基础概念

  • 能说清 cmux 和传统终端(如 iTerm2、Terminal.app)的核心区别
  • 能解释为什么 cmux 选择 Swift + libghostty 而不是 Electron
  • 能说出 cmux 的 Skills 系统和 Claude Code 的 Skills 有什么异同

配置与使用

  • 能为 cmux 配置 Claude API Key 并设置环境变量
  • 能创建一个自定义 Skill 并实现基本功能
  • 能配置远程 daemon 并实现跨设备开发

决策与对比

  • 能为"个人开发"和"团队协作"两种场景分别判断是否需要 cmux
  • 能对比 cmux、Warp、tmux 三者的适用边界
  • 能判断一个现有工作流是否值得迁移到 cmux

进阶路径

第一步:基础配置(1-2 天)

  1. 安装 cmux 并配置 Claude API
  2. 尝试内置的 Claude 命令(cmux claude "...")
  3. 阅读一个现有 Skill 的源码(如 skills/git-helper/SKILL.md
  4. 理解 Skill 的触发条件和执行逻辑

第二步:自定义扩展(3-7 天)

  1. 创建一个自定义 Skill,解决一个真实痛点(如自动格式化代码、自动提交消息)
  2. 学习 cmux 的 Hooks 系统,实现事件驱动的工作流
  3. 尝试远程 daemon,体验跨设备 AI 终端

第三步:深度集成(长期)

  1. 将 cmux 集成到现有开发流(如 Git hooks、CI/CD)
  2. 探索 cmux 的源码,理解其架构设计
  3. 为 cmux 贡献 Skill 或提交 PR

相关资源

资源链接用途
官方文档https://cmux.dev/docs完整配置指南
Skills 示例https://github.com/manaflow-ai/cmux/tree/main/skills学习最佳实践
Discord 社区https://discord.gg/cmux获取帮助和交流

总结

价值总结

维度传统终端cmux 终端
AI 能力Claude 深度整合
操作方式纯手动智能自动化
使用范围单机跨设备同步
扩展方式固定功能Skills 可扩展

相关资源

资源链接
GitHubhttps://github.com/manaflow-ai/cmux
官网https://cmux.dev
发布页https://github.com/manaflow-ai/cmux/releases
Homebrewbrew install manaflow-ai/tap/cmux

文档版本 1.1 | 更新日期:2026-03-28 | Stars: 11k ⭐