# Agentes e modelos do CodeRouter Esta página mostra como cada agente chega ao CodeRouter no seu Mac e em uma máquina do cmux Cloud, e como cada agente escolhe um modelo. | Agente | No seu Mac | Em uma máquina do Cloud | | --- | --- | --- | | Codex | `cr codex` | Automático | | OpenCode | `cr opencode` | Automático | | Pi | `cr pi` (experimental) | Automático | | Claude Code | Chave de API do CodeRouter | Automático | ## No seu Mac O cr inicia o agente que você já instalou e o aponta para o CodeRouter naquela execução. O agente precisa estar no seu PATH. Tudo após o nome do agente é repassado sem alterações. ### Codex cr codex executa o Codex com um provedor de modelos do CodeRouter. Subcomandos como exec, review e resume funcionam da mesma forma. cr naked executa o Codex puro, sem o CodeRouter. ``` cr codex cr codex exec "fix the failing test" cr codex -m cr naked ``` ### OpenCode cr opencode carrega os modelos das contas OpenCode Go da sua equipe e usa o primeiro, a menos que você passe --model. Um valor de --model precisa ser um desses modelos; execute o opencode puro para qualquer outro provedor. ``` cr opencode cr opencode --model ``` ### Pi cr pi adiciona ao Pi um provedor coderouter com os mesmos modelos do Codex e usa o primeiro modelo, a menos que você passe --model. O provedor é fixo, então --provider é recusado. O suporte ao Pi é experimental. ``` cr pi cr pi --model ``` ### Claude Code e outros clientes de API O cr não tem um iniciador para o Claude Code. Para rotear o Claude Code no seu Mac, ou qualquer ferramenta que fale a Anthropic Messages API ou a OpenAI Responses API, crie uma chave de API do CodeRouter e aponte a ferramenta para coderouter.dev. Crie uma chave na seção de chaves de API do painel do CodeRouter. A chave começa com crk\_ e é exibida uma única vez. Criar ou revogar uma chave exige permissão para gerenciar chaves de API nessa equipe, que você sempre tem na sua equipe pessoal: [cmux.com/dashboard/coderouter](https://cmux.com/pt-BR/dashboard/coderouter) ``` # Claude Code and Anthropic Messages API clients export ANTHROPIC_BASE_URL=https://coderouter.dev export ANTHROPIC_API_KEY=crk_... claude # OpenAI Responses API clients export OPENAI_BASE_URL=https://coderouter.dev/v1 export OPENAI_API_KEY=crk_... ``` A chave de API de uma organização usa apenas as contas compartilhadas da equipe. Uma chave na sua equipe pessoal também pode usar suas contas privadas. O CodeRouter atende a OpenAI Responses API, não Chat Completions. Em uma máquina que não consegue abrir um navegador, cr login --api-key inicia a sessão do cr com uma chave, e CODEROUTER\_API\_KEY fornece uma chave para um único comando. Revogue uma chave no painel ou execute cr logout na máquina que a usa. ``` cr login --api-key CODEROUTER_API_KEY= cr codex exec "run the tests" ``` ## Em máquinas do cmux Cloud As máquinas do Cloud não precisam de configuração. Cada agente usa as contas do CodeRouter da sua equipe por meio de um endereço privado do CodeRouter, e o cmux grava a configuração dele na primeira vez que um shell ou o agente é iniciado: - O Claude Code recebe ANTHROPIC\_BASE\_URL e uma ANTHROPIC\_API\_KEY de espaço reservado sempre que é iniciado, não de cada shell, então elas nunca têm prioridade sobre o seu próprio login. Os prompts da primeira execução já estão respondidos. - O Codex recebe um provedor de modelos cmux em ~/.codex/config.toml. - O Pi recebe uma substituição de provedor em ~/.pi/agent/models.json. - O OpenCode baixa sua lista de provedores do CodeRouter na primeira vez que é iniciado, a salva em ~/.config/cmux/opencode-team.json e a adiciona à sua própria configuração a cada execução. O cmux grava cada arquivo apenas quando ele não existe, então suas edições são mantidas. Uma configuração do Codex que já indica outro provedor de modelos não é alterada. Para usar sua própria conta, execute cr use own na máquina e depois faça login da forma que o agente normalmente faz: /login no Claude Code, codex login ou opencode auth login. cr use team volta para as contas da equipe, cr use own codex muda um único agente e cr use mostra como cada agente faz login. Sem uma escolha, um agente em que você fez login na máquina usa sua própria conta, e um agente para o qual sua equipe não tem conta mostra o login normal. Uma alteração vale na próxima vez que o agente for iniciado. Execute os agentes normalmente. cmux coderouter agent transforma um prompt simples na forma de execução única do agente; dentro de uma máquina ele roda no terminal atual, e no seu Mac ele inicia o agente na máquina que você indicar, como cmux vm agent. ``` # Inside a Cloud machine claude codex cmux coderouter agent claude "summarize the current checkout" # From your Mac cmux coderouter agent codex --machine brave-otter -- "run the tests" ``` As máquinas do Cloud usam as contas da equipe dona delas. Se um agente informar que nenhuma conta está disponível, adicione uma ou compartilhe uma existente com essa equipe. ## Modelos Codex e Pi usam o catálogo de modelos da conta que o CodeRouter seleciona, disponível em /v1/models, então o seletor de modelos do Codex mostra o que suas contas podem usar. Escolha um modelo com a flag -m do Codex ou com o comando /model. Para uma chave do OpenRouter, o CodeRouter envia um ID de modelo OpenAI simples como openai/. O OpenCode lista os modelos das contas OpenCode Go da equipe. O Claude Code envia o modelo que você escolhe com --model ou /model, e o CodeRouter o encaminha para a conta selecionada. Contas de assinatura e de chave de API atendem os modelos que a Anthropic permite para essa conta. As contas do Bedrock traduzem IDs de modelos Claude para IDs de modelos do Bedrock com uma tabela embutida, e IDs do Bedrock passam sem alterações. Um modelo sem mapeamento retorna not\_found\_error. Para mapear outro modelo, adicione a conta com --model: ``` cmux coderouter claude add bedrock --region us-east-1 \ --model = ``` Dentro de uma máquina do Cloud, cmux coderouter models imprime o catálogo de modelos do Codex como JSON. ``` # Inside a Cloud machine cmux coderouter models ``` Canonical: https://cmux.com/pt-BR/docs/coderouter/agents Documentation index: https://cmux.com/llms.txt