# CLI e solução de problemas do CodeRouter O CodeRouter tem dois conjuntos de comandos. O cr, também instalado como coderouter, inicia sua sessão, gerencia assinaturas e inicia agentes. O cmux coderouter gerencia as contas Claude da equipe e o uso das máquinas do Cloud pelo app cmux com sessão iniciada, e repassa qualquer outro verbo ao cr. ## Instalar e iniciar sessão O instalador baixa um binário com checksum verificado para ~/.coderouter/bin, vincula o cr a ele e adiciona esse diretório ao PATH do seu shell. Execute-o de novo para atualizar. Ele é compatível com macOS e Linux em arm64 e x64. A mesma CLI é publicada no npm e no PyPI. ``` curl -fsSL https://cmux.com/coderouter/install.sh | sh npm install -g coderouter uv tool install coderouter ``` cr login abre o navegador e imprime um link alternativo. Sem um navegador local, use --device-auth e abra o link em outro dispositivo, ou cr login --code para colar um código ou link mágico. ``` cr login cr login --device-auth cr login --code [code-or-url] cr logout ``` ## cr Sem comando, o cr mostra suas contas e o uso delas. O roteamento de agentes é sempre explícito: codex, opencode e pi puros continuam funcionando sem o CodeRouter. ``` cr # account and usage summary cr codex [arguments...] cr opencode [arguments...] cr pi [arguments...] # experimental cr naked [arguments...] # plain Codex, CodeRouter bypassed (alias: direct) cr add # choose a provider cr add codex cr add claude [--label ] [--stdin] cr add opencode cr remove [account] [--yes] cr transfer [account] [--to ] [--yes] cr accounts [--watch] [--json] # aliases: list, ls, usage cr org current | list | switch cr login [--api-key ] [--device-auth] [--code [code-or-url]] cr logout cr doctor cr upgrade ``` Um espaço de trabalho pessoal e um de equipe do ChatGPT podem compartilhar o mesmo e-mail. Execute cr add codex uma vez por espaço de trabalho e escolha o espaço de trabalho no navegador; o CodeRouter os mantém como contas separadas. ## cmux coderouter Estes verbos rodam pelo app cmux, que precisa estar em execução e com sessão iniciada (cmux auth login). Adicione --json para saída legível por máquina e --team para usar uma equipe diferente da selecionada. ``` cmux coderouter status cmux coderouter machines cmux coderouter claude list cmux coderouter claude add oauth-token [--label ] [--stdin] cmux coderouter claude add api-key [--label ] [--stdin] cmux coderouter claude add bedrock [--label ] [--region ] [--model =]... cmux coderouter claude disable cmux coderouter claude enable cmux coderouter claude remove cmux coderouter claude clear cmux coderouter agent [vm-agent-options] -- ``` claude add oauth-token lê CLAUDE\_CODE\_OAUTH\_TOKEN ou --stdin. Em um terminal sem nenhum dos dois, ele executa claude setup-token e lê o token que esse comando imprime. claude add api-key lê ANTHROPIC\_API\_KEY, --stdin ou um prompt oculto. claude add bedrock lê AWS\_ACCESS\_KEY\_ID, AWS\_SECRET\_ACCESS\_KEY e o AWS\_SESSION\_TOKEN opcional, e obtém a região de --region, AWS\_REGION ou AWS\_DEFAULT\_REGION. Um pode ser o ID, o rótulo ou o identificador mascarado da conta. disable tira uma conta do rodízio até você ativá-la de novo. Qualquer outro verbo do cmux coderouter, e todo comando cmux cr, executa o cr sem alterações. Quando o cr não está instalado, o cmux oferece executar o instalador. O cmux não repassa suas próprias variáveis de ambiente nem sua sessão ao cr. ``` cmux cr accounts cmux coderouter login ``` ## Dentro de uma máquina do Cloud Cada máquina do Cloud tem seu próprio cmux com verbos do CodeRouter que não exigem login. O gerenciamento de contas fica no seu Mac, então claude, login e logout são recusados dentro de uma máquina. ``` cmux auth status [--json] cmux coderouter status [--json] cmux coderouter usage [--json|--tsv] [--days ] cmux coderouter models cmux coderouter accounts [--json] cmux coderouter org current [--json] cmux coderouter agent [--timeout ] [args...] cr use [own|team|auto] [claude|codex|opencode] [--json] # your own sign-in or the team's accounts ``` ## Solução de problemas As mensagens na primeira coluna são o que o agente, o cr ou o cmux imprime. | Mensagem ou problema | Solução | | --- | --- | | Sign in with \`cr login\` and retry. (Também: Missing coderouter route token.) | Execute cr login. Para um cliente de API, verifique se a chave está definida e começa com crk\_. | | Your coderouter session expired or was revoked. | Execute cr login de novo. Uma chave de API revogada para de funcionar na hora; crie uma nova. | | No healthy Codex subscription is currently available. | Execute cr para ver o estado de cada conta. Adicione uma conta com cr add ou aguarde o fim do período de espera. Para as máquinas do Cloud de uma organização, compartilhe a conta com a equipe. | | No Claude upstream account is configured for this team. | Adicione uma com cr add claude ou cmux coderouter claude add. Para as máquinas do Cloud de uma organização, compartilhe-a com a equipe. | | Every Claude upstream account of this team is cooling down or disabled. | Tente de novo após o período de espera, ative uma conta desativada com cmux coderouter claude enable ou adicione outra conta. | | not\_found\_error de uma conta do Bedrock | O modelo não tem mapeamento no Bedrock. Remova a conta e adicione-a de novo com --model =. | | The team's Bedrock account is missing a region. | Remova a conta e adicione-a de novo com --region ou com AWS\_REGION definido. | | CodeRouter CLI is not installed. | Execute o instalador ou responda y quando o cmux cr oferecer a instalação. | | Codex is not installed or is not on PATH (ou OpenCode, ou Pi). | Instale o agente. O cr inicia a cópia que encontrar no seu PATH. | | \`codex\` resolves back to coderouter. | Seu comando codex aponta para o cr. Coloque o executável real do Codex primeiro no seu PATH. | | \`\` is not a coderouter OpenCode model. | Escolha um modelo das suas contas OpenCode Go ou execute o opencode puro para outro provedor. | | cmux: OpenCode provider configuration is unavailable; retry in one minute. | A máquina não conseguiu baixar a lista de provedores do OpenCode. Aguarde um minuto e inicie o OpenCode de novo. | | CodeRouter: TLS edge unreachable, ou route rejected, em cmux auth status dentro de uma máquina. | A máquina não consegue alcançar o CodeRouter, ou o CodeRouter recusou a credencial da máquina. Tente de novo em instantes. Se persistir, fale com o suporte informando o nome da máquina e a saída de cmux auth status --json. | | coderouter is temporarily unavailable. Retry shortly. | O CodeRouter ou o armazenamento de contas está indisponível por um momento. Tente de novo; se o erro persistir, informe-o com o ID da solicitação. | ## Diagnóstico cr doctor mostra se o cr está com sessão iniciada e quais endpoints do CodeRouter ele usa. cmux coderouter status mostra a sessão do cmux, a equipe selecionada e as contas Claude dessa equipe. ``` cr doctor cmux coderouter status ``` ## Obter ajuda Ao relatar uma solicitação com falha, inclua o valor do cabeçalho de resposta x-coderouter-request-id. Ele identifica essa solicitação específica nos registros do CodeRouter. Canonical: https://cmux.com/pt-BR/docs/coderouter/cli Documentation index: https://cmux.com/llms.txt