CLI 参考

使用 CLI 在终端或脚本中创建项目、连接会话和维护安装。为命令添加 --help 即可查看可用参数。

ccmux

ccmux [path]

启动 TUI。可选参数 path 将本次会话限定在该目录，而非 projects.root.

ccmux new

ccmux new <name> [--agent <id>]

在以下目录创建新项目： projects.root ，并启动代理会话。默认代理为 Claude；可通过以下参数为项目覆盖设置： --agent codex, --agent antigravity, --agent cursor, --agent pi，或 --agent grok，或设置 [agents] default 中 config.toml。选择将保存到 <project>/.ccmux/agent ，供后续会话使用。

在 TUI 中按 2 （项目）→ n ，以交互方式填写名称并选择代理。

ccmux list

ccmux list

显示所有运行中的会话（本地及已发现的远程主机）及其状态。

ccmux attach

ccmux attach <name>

连接指定会话。远程会话使用 ssh -t ；若通过以下命令固定主机，则使用 mosh ： --mosh.

ccmux update

ccmux update [--dry-run] [--skip-pull] [--no-restart]

通过 brew 更新 Homebrew 安装，或拉取并重新构建源码，然后重启守护进程。使用下载脚本安装的用户请重新运行安装脚本。详见维护指南.

ccmux daemon

ccmux daemon install   # register ccmuxd under launchd / systemd
ccmux daemon start
ccmux daemon stop
ccmux daemon status

ccmux host add

ccmux host add <name> --addr <host:port> [--mosh]

手动固定主机（适用于非 Tailscale 主机或指定端口）。自动发现的 Tailscale 节点无需此操作。

ccmux moshi-setup

ccmux moshi-setup [--token <token>]

安装 moshi-hook，运行 Easy Pair（二维码）并配置 Claude Code 钩子。 --token 可跳过二维码流程，适用于无界面的环境。

ccmux setup

交互式向导——检查所有依赖项，并可安装缺失项。

ccmux doctor

ccmux doctor

非交互式健康检查。提交问题报告时请附上输出。

ccmux agents

ccmux agents models [--refresh] [--json]
ccmux agents set-default-model [model-id]

配置 ccmux 启动会话时应用的代理级设置。

models 列出守护进程发现的 Claude 模型目录，标注来源（claude-cli / api / fallback），并在当前固定的模型旁标注 * 。 --refresh 强制从守护进程同步刷新（否则返回缓存快照）。 --json 输出原始模型目录，格式与此接口相同： /v1/models.
set-default-model 固定 ccmux 在每个 Claude 会话中通过以下参数指定的模型： ANTHROPIC_MODEL 。接受别名（opus / sonnet / haiku / opusplan）以自动跟随 Anthropic 当前绑定，也可使用具体 ID（claude-opus-4-8）固定版本。不传参数则清除设置。写入 [claude] default_model 中 ~/.config/ccmux/config.toml；守护进程在下次启动会话时读取，无需重启。

发现流程同时适用于 订阅和 API 用户：ccmuxd 首先调用 claude -p （自行处理身份验证），然后回退到 /v1/models 当 ANTHROPIC_API_KEY 已设置的情况，最后使用内置模型列表。每周刷新。

ccmux uninstall

ccmux uninstall [--yes] [--dry-run] [--keep-config] [--keep-chrome]

彻底卸载。绝不会触碰项目目录、笔记或 ~/.claude/.

ccmux language

ccmux language          # list supported languages
ccmux language ru       # save Russian as the interface language
ccmux language pt-BR    # save Brazilian Portuguese

在终端中修改偏好后，请重新打开 ccmux。如需立即切换正在运行的 TUI，请使用设置中的语言选项。

ccmux contribute

ccmux contribute

显示报告问题、改进翻译和提交拉取请求的链接。TUI 帮助面板中也有相同提示。

ccmux usage

ccmux usage [--json]

显示本机守护进程记录的用量。Muse 词元统计包含子代理并排除重复记录；费用不可用时会明确标注。

在 ccmux 中使用 Muse Code

一起改进 ccmux

发现了问题、说明不够清楚，或者翻译可以更自然？欢迎任何大小的贡献。你可以报告问题，或提交拉取请求。

为 ccmux 做贡献改进网站或翻译

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