# CLI y solución de problemas de CodeRouter CodeRouter tiene dos conjuntos de comandos. cr, también instalado como coderouter, inicia tu sesión, gestiona suscripciones y lanza agentes. cmux coderouter gestiona las cuentas de Claude del equipo y el uso de las máquinas de Cloud a través de la app de cmux con la sesión iniciada, y pasa cualquier otro verbo a cr. ## Instalar e iniciar sesión El instalador descarga un binario verificado por suma de comprobación en ~/.coderouter/bin, enlaza cr a él y añade ese directorio al PATH de tu shell. Vuelve a ejecutarlo para actualizar. Es compatible con macOS y Linux en arm64 y x64. La misma CLI está publicada en npm y PyPI. ``` curl -fsSL https://cmux.com/coderouter/install.sh | sh npm install -g coderouter uv tool install coderouter ``` cr login abre tu navegador e imprime un enlace alternativo. Sin un navegador local, usa --device-auth y abre el enlace en otro dispositivo, o cr login --code para pegar un código o un enlace mágico. ``` cr login cr login --device-auth cr login --code [code-or-url] cr logout ``` ## cr Sin ningún comando, cr muestra tus cuentas y su uso. El enrutamiento de agentes siempre es explícito: codex, opencode y pi sin más siguen funcionando sin 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 ``` Un espacio de trabajo personal y uno de equipo de ChatGPT pueden compartir un correo electrónico. Ejecuta cr add codex una vez por espacio de trabajo y elige el espacio de trabajo en el navegador; CodeRouter los guarda como cuentas separadas. ## cmux coderouter Estos verbos se ejecutan a través de la app de cmux, que debe estar en ejecución y con la sesión iniciada (cmux auth login). Añade --json para una salida legible por máquinas y --team para actuar sobre un equipo distinto del seleccionado. ``` 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 lee CLAUDE\_CODE\_OAUTH\_TOKEN o --stdin. En un terminal sin ninguno de los dos, ejecuta claude setup-token y lee el token que imprime ese comando. claude add api-key lee ANTHROPIC\_API\_KEY, --stdin o un prompt oculto. claude add bedrock lee AWS\_ACCESS\_KEY\_ID, AWS\_SECRET\_ACCESS\_KEY y el AWS\_SESSION\_TOKEN opcional, y toma la región de --region, AWS\_REGION o AWS\_DEFAULT\_REGION. Un puede ser su id, su etiqueta o su identificador enmascarado. disable saca una cuenta de la rotación hasta que la vuelvas a activar. Cualquier otro verbo de cmux coderouter, y cualquier comando cmux cr, ejecuta cr sin cambios. Si falta cr, cmux ofrece ejecutar el instalador. cmux no pasa a cr sus propias variables de entorno ni su sesión. ``` cmux cr accounts cmux coderouter login ``` ## Dentro de una máquina de Cloud Cada máquina de Cloud tiene su propio cmux con verbos de CodeRouter que no necesitan iniciar sesión. La gestión de cuentas se queda en tu Mac, así que claude, login y logout se rechazan dentro de una 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 ``` ## Solución de problemas Los mensajes de la primera columna son lo que imprime el agente, cr o cmux. | Mensaje o síntoma | Solución | | --- | --- | | Sign in with \`cr login\` and retry. (También: Missing coderouter route token.) | Ejecuta cr login. Para un cliente de API, comprueba que la clave está definida y empieza por crk\_. | | Your coderouter session expired or was revoked. | Vuelve a ejecutar cr login. Una clave de API revocada deja de funcionar al instante; crea una nueva. | | No healthy Codex subscription is currently available. | Ejecuta cr para ver el estado de cada cuenta. Añade una cuenta con cr add, o espera a que termine un periodo de espera. Para las máquinas de Cloud de una organización, comparte la cuenta con el equipo. | | No Claude upstream account is configured for this team. | Añade una con cr add claude o cmux coderouter claude add. Para las máquinas de Cloud de una organización, compártela con el equipo. | | Every Claude upstream account of this team is cooling down or disabled. | Reintenta después del periodo de espera, activa una cuenta desactivada con cmux coderouter claude enable o añade otra cuenta. | | not\_found\_error desde una cuenta de Bedrock | El modelo no tiene correspondencia en Bedrock. Elimina la cuenta y vuelve a añadirla con --model =. | | The team's Bedrock account is missing a region. | Elimina la cuenta y vuelve a añadirla con --region, o con AWS\_REGION definida. | | CodeRouter CLI is not installed. | Ejecuta el instalador, o responde y cuando cmux cr ofrezca instalarla. | | Codex is not installed or is not on PATH (o OpenCode, o Pi). | Instala el agente. cr lanza la copia que encuentra en tu PATH. | | \`codex\` resolves back to coderouter. | Tu comando codex apunta a cr. Pon el ejecutable real de Codex primero en tu PATH. | | \`\` is not a coderouter OpenCode model. | Elige un modelo de tus cuentas de OpenCode Go, o ejecuta opencode sin más para otro proveedor. | | cmux: OpenCode provider configuration is unavailable; retry in one minute. | La máquina no pudo descargar la lista de proveedores de OpenCode. Espera un minuto y vuelve a iniciar OpenCode. | | CodeRouter: TLS edge unreachable, or route rejected, en cmux auth status dentro de una máquina. | La máquina no puede llegar a CodeRouter, o CodeRouter rechazó la credencial de la máquina. Reintenta en un momento. Si persiste, contacta con soporte con el nombre de la máquina y la salida de cmux auth status --json. | | coderouter is temporarily unavailable. Retry shortly. | CodeRouter o el almacén de cuentas no está disponible durante un momento. Reintenta; si el error persiste, infórmalo con el ID de la solicitud. | ## Diagnóstico cr doctor indica si cr tiene la sesión iniciada y qué endpoints de CodeRouter usa. cmux coderouter status muestra la sesión de cmux, el equipo seleccionado y las cuentas de Claude de ese equipo. ``` cr doctor cmux coderouter status ``` ## Obtener ayuda Cuando informes de una solicitud fallida, incluye el valor del encabezado de respuesta x-coderouter-request-id. Identifica esa solicitud concreta en los registros de CodeRouter. Canonical: https://cmux.com/es/docs/coderouter/cli Documentation index: https://cmux.com/llms.txt