CLI et dépannage CodeRouter
CodeRouter a deux ensembles de commandes. cr, aussi installé sous le nom coderouter, vous connecte, gère les abonnements et lance les agents. cmux coderouter gère les comptes Claude de l'équipe et l'utilisation des machines Cloud via l'app cmux connectée, et transmet tout autre verbe à cr.
Installation et connexion
Le programme d'installation télécharge un binaire vérifié par somme de contrôle dans ~/.coderouter/bin, y lie cr et ajoute ce répertoire au PATH de votre shell. Relancez-le pour mettre à jour. Il prend en charge macOS et Linux sur arm64 et x64. Le même CLI est publié sur npm et PyPI.
curl -fsSL https://cmux.com/coderouter/install.sh | sh
npm install -g coderouter
uv tool install coderoutercr login ouvre votre navigateur et affiche un lien de secours. Sans navigateur local, utilisez --device-auth et ouvrez le lien sur un autre appareil, ou cr login --code pour coller un code ou un lien magique.
cr login
cr login --device-auth
cr login --code [code-or-url]
cr logoutcr
Sans commande, cr affiche vos comptes et leur utilisation. Le routage des agents est toujours explicite : codex, opencode et pi seuls continuent de fonctionner sans 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 <name>] [--stdin]
cr add opencode
cr remove [account] [--yes]
cr transfer [account] [--to <team>] [--yes]
cr accounts [--watch] [--json] # aliases: list, ls, usage
cr org current | list | switch <name-or-id>
cr login [--api-key <key>] [--device-auth] [--code [code-or-url]]
cr logout
cr doctor
cr upgradeUn espace de travail ChatGPT personnel et un d'équipe peuvent partager un même e-mail. Lancez cr add codex une fois par espace de travail et choisissez l'espace de travail dans le navigateur ; CodeRouter les garde comme comptes distincts.
cmux coderouter
Ces verbes passent par l'app cmux, qui doit être lancée et connectée (cmux auth login). Ajoutez --json pour une sortie lisible par une machine et --team <id> pour cibler une autre équipe que celle sélectionnée.
cmux coderouter status
cmux coderouter machines
cmux coderouter claude list
cmux coderouter claude add oauth-token [--label <name>] [--stdin]
cmux coderouter claude add api-key [--label <name>] [--stdin]
cmux coderouter claude add bedrock [--label <name>] [--region <region>] [--model <claude-id>=<bedrock-id>]...
cmux coderouter claude disable <account>
cmux coderouter claude enable <account>
cmux coderouter claude remove <account>
cmux coderouter claude clear
cmux coderouter agent <claude|codex|opencode|pi> [vm-agent-options] -- <prompt>claude add oauth-token lit CLAUDE_CODE_OAUTH_TOKEN ou --stdin. Dans un terminal sans l'un ni l'autre, il lance claude setup-token et lit le token affiché par cette commande. claude add api-key lit ANTHROPIC_API_KEY, --stdin ou une invite masquée. claude add bedrock lit AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY et l'AWS_SESSION_TOKEN facultatif, et prend la région depuis --region, AWS_REGION ou AWS_DEFAULT_REGION.
Un <account> peut être son identifiant, son libellé ou son identifiant masqué. disable retire un compte de la rotation jusqu'à ce que vous le réactiviez.
Tout autre verbe cmux coderouter, et toute commande cmux cr, exécute cr sans modification. Si cr est absent, cmux propose de lancer le programme d'installation. cmux ne transmet à cr ni ses propres variables d'environnement ni sa connexion.
cmux cr accounts
cmux coderouter loginDans une machine Cloud
Chaque machine Cloud a son propre cmux avec des verbes CodeRouter qui ne nécessitent pas de connexion. La gestion des comptes reste sur votre Mac : claude, login et logout sont donc refusés dans une machine.
cmux auth status [--json]
cmux coderouter status [--json]
cmux coderouter usage [--json|--tsv] [--days <n>]
cmux coderouter models
cmux coderouter accounts [--json]
cmux coderouter org current [--json]
cmux coderouter agent <claude|codex|opencode|pi> [--timeout <seconds>] [args...]
cr use [own|team|auto] [claude|codex|opencode] [--json] # your own sign-in or the team's accountsDépannage
Les messages de la première colonne sont ceux qu'affiche l'agent, cr ou cmux.
| Message ou symptôme | Solution |
|---|---|
| Sign in with `cr login` and retry. (Aussi : Missing coderouter route token.) | Lancez cr login. Pour un client d'API, vérifiez que la clé est définie et commence par crk_. |
| Your coderouter session expired or was revoked. | Relancez cr login. Une clé API révoquée cesse de fonctionner immédiatement ; créez-en une nouvelle. |
| No healthy Codex subscription is currently available. | Lancez cr pour voir l'état de chaque compte. Ajoutez un compte avec cr add, ou attendez la fin d'un temps de repos. Pour les machines Cloud d'une organisation, partagez le compte avec l'équipe. |
| No Claude upstream account is configured for this team. | Ajoutez-en un avec cr add claude ou cmux coderouter claude add. Pour les machines Cloud d'une organisation, partagez-le avec l'équipe. |
| Every Claude upstream account of this team is cooling down or disabled. | Réessayez après le temps de repos, réactivez un compte désactivé avec cmux coderouter claude enable, ou ajoutez un autre compte. |
| not_found_error depuis un compte Bedrock | Le modèle n'a pas de correspondance Bedrock. Supprimez le compte et ajoutez-le de nouveau avec --model <claude-id>=<bedrock-id>. |
| The team's Bedrock account is missing a region. | Supprimez le compte et ajoutez-le de nouveau avec --region, ou avec AWS_REGION défini. |
| CodeRouter CLI is not installed. | Lancez le programme d'installation, ou répondez y quand cmux cr propose de l'installer. |
| Codex is not installed or is not on PATH (ou OpenCode, ou Pi). | Installez l'agent. cr lance la copie qu'il trouve dans votre PATH. |
| `codex` resolves back to coderouter. | Votre commande codex pointe vers cr. Placez le véritable exécutable Codex en premier dans votre PATH. |
| `<model>` is not a coderouter OpenCode model. | Choisissez un modèle de vos comptes OpenCode Go, ou lancez opencode seul pour un autre fournisseur. |
| cmux: OpenCode provider configuration is unavailable; retry in one minute. | La machine n'a pas pu télécharger la liste des fournisseurs OpenCode. Attendez une minute et relancez OpenCode. |
| CodeRouter: TLS edge unreachable, or route rejected, dans cmux auth status à l'intérieur d'une machine. | La machine ne peut pas atteindre CodeRouter, ou CodeRouter a refusé l'identifiant de la machine. Réessayez dans un instant. Si le problème persiste, contactez le support avec le nom de la machine et la sortie de cmux auth status --json. |
| coderouter is temporarily unavailable. Retry shortly. | CodeRouter ou le stockage des comptes est brièvement indisponible. Réessayez ; si l'erreur persiste, signalez-la avec l'ID de requête. |
Diagnostic
cr doctor indique si cr est connecté et quels endpoints CodeRouter il utilise. cmux coderouter status affiche la connexion cmux, l'équipe sélectionnée et les comptes Claude de cette équipe.
cr doctor
cmux coderouter statusObtenir de l'aide
Quand vous signalez une requête en échec, incluez la valeur de l'en-tête de réponse x-coderouter-request-id. Elle identifie cette requête précise dans les journaux de CodeRouter.