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.

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 <model>
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 <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 <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

# 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 <key>
CODEROUTER_API_KEY=<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/<model>.

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 <claude-model-id>=<bedrock-model-id>

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