Referência da CLI
Use o CLI para criar projetos, anexar a sessões e manter sua instalação a partir de um shell ou script. Execute um comando com --help para ver seus sinalizadores disponíveis.
ccmux
ccmux [path]
Inicie o TUI. Opcional path define o escopo da sessão para esse diretório em vez de projects.root.
ccmux new
ccmux new <name> [--agent <id>]
Crie um novo diretório de projeto em projects.root e inicie uma sessão de agente. O agente é padronizado como Claude; substituir por projeto por --agent codex, --agent antigravity, --agent cursor, --agent piou --agent grokou defina [agents] default em config.toml. A escolha é armazenada em <project>/.ccmux/agent e retomado em sessões futuras.
No TUI, pressione 2 (Projetos) → n para preencher o nome e o agente de forma interativa.
ccmux list
ccmux list
Imprime todas as sessões em execução (locais + quaisquer hosts remotos descobertos) com seu estado.
ccmux attach
ccmux attach <name>
Anexar a uma sessão nomeada. Usos ssh -t para sessões remotas; mosh se o host foi fixado com --mosh.
ccmux update
ccmux update [--dry-run] [--skip-pull] [--no-restart]
Atualize uma instalação Homebrew por meio de brew ou extraia e reconstrua uma verificação de origem e reinicie o daemon. Para instalações com script de download, execute novamente o instalador. Veja o guia de manutenção.
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]
Fixe manualmente um host (para hosts não Tailscale ou para forçar uma porta específica). Os pares Tailscale descobertos automaticamente não precisam disso.
ccmux moshi-setup
ccmux moshi-setup [--token <token>]
Instalar moshi-hook, execute Easy Pair (código QR), conecte os ganchos Claude Code. --token ignora o fluxo QR para configurações sem cabeça.
ccmux setup
Assistente interativo — verifica todas as dependências, oferece a instalação das que faltam.
ccmux doctor
ccmux doctor
Verificação de funcionamento não interativa. Inclua a saída ao preencher relatórios de bugs.
ccmux agents
ccmux agents models [--refresh] [--json]
ccmux agents set-default-model [model-id]
Definir configurações em nível de agente ccmux se aplica ao iniciar sessões.
-
modelslista o catálogo do modelo Claude que o daemon descobriu, marcado com a fonte (claude-cli/api/fallback) e um*próximo ao seu pin atual.--refreshforça uma nova busca síncrona do daemon (caso contrário, o instantâneo armazenado em cache será retornado).--jsonemite o catálogo bruto - mesmo formato que/v1/models. -
set-default-modelfixa o modelo ccmux que passa comoANTHROPIC_MODELem cada sessão Claude iniciada. Aceita um alias (opus/sonnet/haiku/opusplan) para rastreamento automático das ligações atuais do Anthropic ou um ID concreto (claude-opus-4-8) para fixar uma versão específica. Omita o argumento para limpar. Escreve[claude] default_modelem~/.config/ccmux/config.toml; o daemon o pega na próxima sessão iniciada - não é necessário reiniciar.
A cadeia de descoberta funciona para usuários de assinatura e API: Chamadas ccmuxd claude -p primeiro (que lida com sua própria autenticação), volta para
/v1/models se ANTHROPIC_API_KEY é definido e, em seguida, para uma lista binária selecionada. Atualiza semanalmente.
ccmux uninstall
ccmux uninstall [--yes] [--dry-run] [--keep-config] [--keep-chrome]
Remoção limpa. Nunca toca em diretórios de projetos, notas ou ~/.claude/.
ccmux language
ccmux language # list supported languages
ccmux language ru # save Russian as the interface language
ccmux language pt-BR # save Brazilian Portuguese
Reabra ccmux após alterar a preferência no shell. Para mudar imediatamente para um TUI aberto, use a linha de idioma em Configurações.
ccmux contribute
ccmux contribute
Mostrar links para relatar problemas, melhorar traduções e enviar solicitações pull. O mesmo prompt está disponível no painel de ajuda do TUI.
ccmux usage
ccmux usage [--json]
Mostra o uso registrado pelo daemon local. A contagem de tokens do Muse inclui subagentes e exclui registros duplicados; custos indisponíveis são indicados explicitamente.
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.