Agents et modèles CodeRouter

Cette page montre comment chaque agent atteint CodeRouter sur votre Mac et sur une machine cmux Cloud, et comment chaque agent choisit un modèle.

Sur votre Mac

cr lance l'agent que vous avez déjà installé et le dirige vers CodeRouter pour cette exécution. L'agent doit être dans votre PATH. Tout ce qui suit le nom de l'agent est transmis sans modification.

Codex

cr codex lance Codex avec un fournisseur de modèles CodeRouter. Les sous-commandes comme exec, review et resume fonctionnent de la même façon. cr naked lance Codex seul, sans CodeRouter.

cr codex
cr codex exec "fix the failing test"
cr codex -m <model>
cr naked

OpenCode

cr opencode charge les modèles des comptes OpenCode Go de votre équipe et utilise le premier, sauf si vous passez --model. Une valeur --model doit être l'un de ces modèles ; pour tout autre fournisseur, lancez opencode seul.

cr opencode
cr opencode --model <model>

Pi

cr pi ajoute à Pi un fournisseur coderouter avec les mêmes modèles que Codex et utilise le premier modèle, sauf si vous passez --model. Le fournisseur est fixe, donc --provider est refusé. La prise en charge de Pi est expérimentale.

cr pi
cr pi --model <model>

Claude Code et autres clients d'API

cr n'a pas de lanceur pour Claude Code. Pour router Claude Code sur votre Mac, ou tout outil qui parle l'Anthropic Messages API ou l'OpenAI Responses API, créez une clé API CodeRouter et dirigez l'outil vers coderouter.dev.

Créez une clé dans la section API keys du tableau de bord CodeRouter. La clé commence par crk_ et ne s'affiche qu'une fois. Créer ou révoquer une clé nécessite l'autorisation de gérer les clés API dans cette équipe, que vous avez toujours dans votre équipe personnelle : 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_...

La clé API d'une organisation utilise seulement les comptes partagés de l'équipe. Une clé de votre équipe personnelle peut aussi utiliser vos comptes privés. CodeRouter sert l'OpenAI Responses API, pas Chat Completions.

Sur une machine qui ne peut pas ouvrir de navigateur, cr login --api-key connecte cr avec une clé, et CODEROUTER_API_KEY en fournit une pour une seule commande. Révoquez une clé dans le tableau de bord, ou lancez cr logout sur la machine qui l'utilise.

cr login --api-key <key>
CODEROUTER_API_KEY=<key> cr codex exec "run the tests"

Sur les machines cmux Cloud

Les machines Cloud ne nécessitent aucune configuration. L'environnement de la machine dirige OPENAI_BASE_URL et ANTHROPIC_BASE_URL vers une adresse CodeRouter privée, et cmux écrit la configuration de chaque agent la première fois qu'un shell ou l'agent démarre :

• Claude Code lit ANTHROPIC_BASE_URL et un ANTHROPIC_API_KEY factice dans l'environnement. Ses questions de premier lancement sont déjà répondues.
• Codex reçoit un fournisseur de modèles cmux dans ~/.codex/config.toml.
• Pi reçoit une surcharge de fournisseur dans ~/.pi/agent/models.json.
• OpenCode télécharge sa liste de fournisseurs depuis CodeRouter au premier démarrage et l'enregistre dans ~/.config/opencode/opencode.json.

cmux n'écrit chaque fichier que s'il est absent, donc vos modifications sont conservées. Une configuration Codex qui nomme déjà un autre fournisseur de modèles n'est pas modifiée.

Lancez les agents comme d'habitude. cmux coderouter agent transforme un simple prompt en forme ponctuelle de l'agent ; dans une machine, il s'exécute dans le terminal actuel, et sur votre Mac, il démarre l'agent sur la machine que vous indiquez, comme 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"

Les machines Cloud utilisent les comptes de l'équipe qui les possède. Si un agent signale qu'aucun compte n'est disponible, ajoutez-en un ou partagez un compte existant avec cette équipe.

Modèles

Codex et Pi utilisent le catalogue de modèles du compte choisi par CodeRouter, servi sur /v1/models : le sélecteur de modèles de Codex affiche donc ce que vos comptes peuvent utiliser. Choisissez un modèle avec l'option -m de Codex ou sa commande /model. Pour une clé OpenRouter, CodeRouter envoie un identifiant de modèle OpenAI simple sous la forme openai/<model>.

OpenCode liste les modèles des comptes OpenCode Go de l'équipe.

Claude Code envoie le modèle choisi avec --model ou /model, et CodeRouter le transmet au compte sélectionné. Les comptes par abonnement et par clé API servent les modèles qu'Anthropic autorise pour ce compte.

Les comptes Bedrock traduisent les identifiants de modèles Claude en identifiants de modèles Bedrock grâce à une table intégrée, et les identifiants Bedrock passent sans modification. Un modèle sans correspondance renvoie not_found_error. Pour associer un autre modèle, ajoutez le compte avec --model :

cmux coderouter claude add bedrock --region us-east-1 \
  --model <claude-model-id>=<bedrock-model-id>

Dans une machine Cloud, cmux coderouter models affiche le catalogue de modèles Codex en JSON.

# Inside a Cloud machine
cmux coderouter models