Referência de configuração
Localização do arquivo de configuração: ~/.config/ccmux/config.toml
Editável em linha a partir do Configurações tela no TUI (↑/↓ para se mover, Enter para editar, e para abrir $EDITOR).
Idioma da interface
lang = "ru" # en, zh, es, ja, ko, fr, de, pt-br, ru; omit to follow LC_ALL, then LANG
lang é uma chave de nível superior: coloque-a antes de qualquer [section] cabeçalhos. O TUI oferece suporte a inglês, chinês simplificado, espanhol, japonês, coreano, francês, alemão, português do Brasil e russo. Altere a linha de idioma em Configurações para mudar imediatamente; a reabertura do tour e dos painéis de pesquisa também usa o novo idioma. A maior parte da saída CLI permanece em inglês. Liste os idiomas disponíveis com ccmux languageou salve uma preferência com ccmux language ru.
[projetos]
[projects]
root = "~/Projects" # where ccmux looks for projects
[agentes]
[agents]
default = "claude" # "claude" | "codex" | "antigravity" | "cursor" | "pi" | "grok" | "muse"
Define o agente usado por ccmux new quando não --agent bandeira é dada. Substituído por projeto pelo .ccmux/agent arquivo.
[cláudio]
[claude]
default_model = "claude-opus-4-8" # or "opus" / "sonnet" / "haiku" / "opusplan" / ""
Fixa um modelo Claude padrão para sessões que o próprio ccmux inicia. ccmuxd exporta como ANTHROPIC_MODEL ao iniciar claude, então o pino sobrevive ao claude --continue || claude || zsh cadeia de fallback (uma
--model se aplicaria apenas à primeira invocação). O daemon relê a configuração a cada inicialização, portanto, uma alteração entra em vigor imediatamente – sem necessidade de reinicialização.
Duas maneiras de configurá-lo sem editar este arquivo:
- TUI: abra o Claude tela e pressione
M(shift-M). O seletor mostra o catálogo de modelos que o daemon descobriu — primeiro viaclaude -p(funciona por assinatura e Usuários API desdeclaudelida com sua própria autenticação), então via/v1/modelsseANTHROPIC_API_KEYestá definido, caindo em uma lista binária com curadoria. UM[current]tag marca seu pin existente. - CLI:
ccmux agents set-default-model <id>grava a mesma chave. Não passe nenhum argumento para limpar.ccmux agents models [--refresh] [--json]lista o catálogo descoberto.
Vazio (ou não definido) herda o próprio Claude Code ~/.claude/settings.json
padrão. O pino é por máquina; As instalações da irmã Claude em diretórios domésticos compartilhados (NFS, sshfs) mantêm suas próprias configurações.
[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
[sono]
[sleep]
# "off" | "safe" | "dangerous" | "very_dangerous"
mode = "safe"
idle_release_minutes = 10
low_battery_cutoff = 20 # dangerous mode auto-downgrades below this %
| Modo | Comportamento |
|---|---|
off |
Sem prevenção do sono |
safe |
caffeinate -s (somente AC) em macOS; systemd-inhibit em Linux |
dangerous |
Funciona com bateria; downgrades automáticos quando a bateria < low_battery_cutoff |
very_dangerous |
Cancelamento de fechamento da tampa via pmset/systemctl; requer sudo sem senha |
O modo macOS padrão evita a suspensão do sistema com alimentação CA, mas não substitui a suspensão com tampa fechada. O comportamento da bateria e as substituições em todo o sistema dependem do modo e da plataforma selecionados. Para trabalho autônomo, use um host que possa permanecer ligado e on-line.
[notificações]
[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"
Ajude a melhorar o ccmux
Encontrou um bug, uma explicação confusa ou uma tradução que pode melhorar? Toda contribuição é bem-vinda. Abra uma issue ou envie um pull request.
Detectou um erro ou algo desatualizado? Edite esta página em GitHub.