配置参考

配置文件位置： ~/.config/ccmux/config.toml

可在 TUI 的 设置 页面中直接编辑（↑/↓ 移动， Enter 编辑， e 打开 $EDITOR).

界面语言

lang = "ru"   # en, zh, es, ja, ko, fr, de, pt-br, ru; omit to follow LC_ALL, then LANG

lang 是顶层配置项：请放在所有 [section] 标题之前。TUI 支持英语、简体中文、西班牙语、日语、韩语、法语、德语、巴西葡萄牙语和俄语。在设置中切换语言后立即生效；重新打开引导和搜索面板也会使用新语言。大多数 CLI 输出仍为英语。查看可用语言： ccmux language，或保存语言偏好： ccmux language ru.

[projects]

[projects]
root = "~/Projects"   # where ccmux looks for projects

[agents]

[agents]
default = "claude"   # "claude" | "codex" | "antigravity" | "cursor" | "pi" | "grok" | "muse"

设置以下命令默认使用的代理： ccmux new ，适用于未指定 --agent 参数时。项目中的 .ccmux/agent 文件可覆盖此设置。

[claude]

[claude]
default_model = "claude-opus-4-8"   # or "opus" / "sonnet" / "haiku" / "opusplan" / ""

为 ccmux 启动的会话固定默认 Claude 模型。ccmuxd 将其导出为 ANTHROPIC_MODEL ，然后启动 claude，因此该设置可在 claude --continue || claude || zsh 回退链中持续生效（ --model 参数只影响首次调用）。守护进程每次启动会话都会重新读取配置，因此修改立即生效，无需重启。

无需编辑此文件的两种设置方式：

• TUI： 打开 Claude 页面并按 M （shift-M）。选择器显示守护进程发现的模型目录——首先通过 claude -p （同时支持订阅 和 API 用户，因为 claude 会自行处理身份验证），然后通过 /v1/models 当 ANTHROPIC_API_KEY 已设置的情况，最后回退到内置模型列表。 [current] 标签标示当前固定的模型。
• 命令行： ccmux agents set-default-model <id> 写入相同配置项。不传参数即可清除。 ccmux agents models [--refresh] [--json] 列出发现的模型目录。

为空或未设置时，继承 Claude Code 自身的 ~/.claude/settings.json 默认值。此设置按机器生效；使用共享主目录（NFS、sshfs）的其他 Claude 安装仍保留各自的设置。

[daemon]

[daemon]
poll_interval_seconds = 2
idle_seconds_for_needs_input = 3
listen_tailnet = false    # set true on a server-mode host
tailnet_port = 7474

[sleep]

[sleep]
# "off" | "safe" | "dangerous" | "very_dangerous"
mode = "safe"
idle_release_minutes = 10
low_battery_cutoff = 20   # dangerous mode auto-downgrades below this %

macOS 默认模式可在接通电源时阻止系统睡眠，但不能阻止合盖睡眠。电池供电行为和系统级覆盖取决于所选模式与平台。如需无人值守运行，请使用能够持续供电并保持在线的主机。

[notifications]

[notifications]
bell = true                    # terminal BEL on needs_input
moshi_suppresses_bell = false  # mute bell when moshi-hook is also reporting

[agents.muse]

[agents.muse]
command = "/path/to/muse"

在 ccmux 中使用 Muse Code

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