快速入门

在运行代理的主机上安装 ccmux。完成设置后，创建项目并连接到第一个会话。

系统要求

• macOS、Linux 或 通过 WSL2 使用 Windows （参见 GitHub 上的 Windows 指南 ；原生 Windows 支持仍在待办列表中）
• 以下任选其一：Homebrew（macOS / Linuxbrew）、curl + POSIX shell，或从源码构建所需的 Go 1.26+
• tmux 和 git。Homebrew 会安装运行依赖；下载脚本只安装 ccmux 二进制文件。运行 ccmux setup 检查依赖，或在从源码构建时使用 make bootstrap 。

安装

选择下载脚本或 Homebrew 安装。如果想参与 ccmux 开发，可以从源码构建。

下载脚本

curl -fsSL https://ccmux.ai/install | sh
ccmux setup

脚本会将最新版本的二进制文件安装到 ~/.local/bin/。如果安装程序提示，请将该目录加入终端的 PATH。运行前可以先 查看安装脚本 。

设置向导会检查依赖项、帮助配置代理 CLI，并安装后台守护进程。启动会话前，请先登录所选代理。如需远程访问，还要将设备连接到 Tailscale。

Homebrew

brew trust --tap skzv/tap
brew install skzv/tap/ccmux
ccmux setup

每台主机只需信任一次软件源。Homebrew 会安装 ccmux 及其打包依赖项，包括 tmux、Mosh 和 ripgrep。

备选方案：从源码安装

mkdir -p ~/Projects && cd ~/Projects
git clone https://github.com/skzv/ccmux.git
cd ccmux && make bootstrap

make bootstrap 检查构建工具链，并可安装缺失项，随后执行 make setup。如果你想跟随 main 分支或参与 ccmux 开发，请使用此方式。

之后可以重新运行设置向导，检查或调整配置。

首次运行

ccmux

TUI 会显示首次使用引导。在任意页面按 ? 查看完整快捷键。

快捷键

你的第一个项目

在 TUI 中： 按 2 进入项目页，然后按 n 打开新建项目表单。填写名称，选择代理（Claude / Codex / Antigravity / Cursor / pi / Grok），然后按 Enter。ccmux 在以下目录创建项目： projects.root ，并立即启动代理会话。

在 shell 中：

ccmux new my-app

创建目录，并使用默认代理启动会话。TUI 自动打开首页，你可以按以下键连接： Enter.

参见 教程 1 获取完整操作指南。

下一步

• 管理多个会话 ，并在不停止代理的情况下分离会话。
• 从手机连接 或 添加另一台主机.
• 连接 MCP 客户端 ，让代理读取会话信息。
• 如果设置失败，请运行 ccmux doctor 并参考 维护指南.

发现错误或过时内容？ 在 GitHub 上编辑此页.