# CLI CodeRouter и устранение неполадок У CodeRouter два набора команд. cr, который также устанавливается как coderouter, выполняет вход, управляет подписками и запускает агентов. cmux coderouter управляет аккаунтами Claude команды и расходом облачных машин через приложение cmux с выполненным входом, а все остальные команды передает в cr. ## Установка и вход Установщик загружает бинарный файл с проверенной контрольной суммой в ~/.coderouter/bin, создает на него ссылку cr и добавляет этот каталог в PATH оболочки. Для обновления запустите его снова. Поддерживаются macOS и Linux на arm64 и x64. Тот же CLI опубликован в npm и PyPI. ``` curl -fsSL https://cmux.com/coderouter/install.sh | sh npm install -g coderouter uv tool install coderouter ``` cr login открывает браузер и выводит запасную ссылку. Без локального браузера используйте --device-auth и откройте ссылку на другом устройстве или cr login --code, чтобы вставить код или magic link. ``` cr login cr login --device-auth cr login --code [code-or-url] cr logout ``` ## cr Без команды cr показывает ваши аккаунты и их расход. Маршрутизация агентов всегда явная: обычные codex, opencode и pi работают и без 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 ``` Личное и командное рабочее пространство ChatGPT могут использовать один email. Выполните cr add codex один раз для каждого рабочего пространства и выберите его в браузере; CodeRouter хранит их как отдельные аккаунты. ## cmux coderouter Эти команды работают через приложение cmux, которое должно быть запущено и с выполненным входом (cmux auth login). Добавьте --json для машиночитаемого вывода и --team , чтобы выбрать команду, отличную от текущей. ``` 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 читает CLAUDE\_CODE\_OAUTH\_TOKEN или --stdin. В терминале без того и другого он запускает claude setup-token и читает токен, который выводит эта команда. claude add api-key читает ANTHROPIC\_API\_KEY, --stdin или скрытый запрос. claude add bedrock читает AWS\_ACCESS\_KEY\_ID, AWS\_SECRET\_ACCESS\_KEY и необязательный AWS\_SESSION\_TOKEN, а регион берет из --region, AWS\_REGION или AWS\_DEFAULT\_REGION. может быть ID аккаунта, его меткой или замаскированным идентификатором. disable выводит аккаунт из ротации, пока вы снова его не включите. Все остальные команды cmux coderouter и все команды cmux cr запускают cr без изменений. Если cr отсутствует, cmux предлагает запустить установщик. cmux не передает в cr свои переменные окружения и свой вход. ``` cmux cr accounts cmux coderouter login ``` ## Внутри облачной машины На каждой облачной машине есть свой cmux с командами CodeRouter, которым не нужен вход. Управление аккаунтами остается на вашем Mac, поэтому claude, login и logout внутри машины отклоняются. ``` 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 ``` ## Устранение неполадок Сообщения в первом столбце выводят агент, cr или cmux. | Сообщение или симптом | Решение | | --- | --- | | Sign in with \`cr login\` and retry. (Также: Missing coderouter route token.) | Выполните cr login. Для API-клиента проверьте, что ключ задан и начинается с crk\_. | | Your coderouter session expired or was revoked. | Снова выполните cr login. Отозванный API-ключ сразу перестает работать; создайте новый. | | No healthy Codex subscription is currently available. | Выполните cr, чтобы увидеть состояние каждого аккаунта. Добавьте аккаунт через cr add или дождитесь окончания паузы. Для облачных машин организации откройте доступ к аккаунту для команды. | | No Claude upstream account is configured for this team. | Добавьте аккаунт через cr add claude или cmux coderouter claude add. Для облачных машин организации откройте к нему доступ для команды. | | Every Claude upstream account of this team is cooling down or disabled. | Повторите после паузы, включите отключенный аккаунт через cmux coderouter claude enable или добавьте другой аккаунт. | | not\_found\_error от аккаунта Bedrock | У модели нет сопоставления Bedrock. Удалите аккаунт и добавьте его снова с --model =. | | The team's Bedrock account is missing a region. | Удалите аккаунт и добавьте его снова с --region или с заданным AWS\_REGION. | | CodeRouter CLI is not installed. | Запустите установщик или ответьте y, когда cmux cr предложит установку. | | Codex is not installed or is not on PATH (или OpenCode, или Pi). | Установите агента. cr запускает копию, которую находит в PATH. | | \`codex\` resolves back to coderouter. | Ваша команда codex указывает на cr. Поставьте настоящий исполняемый файл Codex первым в PATH. | | \`\` is not a coderouter OpenCode model. | Выберите модель из ваших аккаунтов OpenCode Go или запустите обычный opencode для другого провайдера. | | cmux: OpenCode provider configuration is unavailable; retry in one minute. | Машине не удалось загрузить список провайдеров OpenCode. Подождите минуту и снова запустите OpenCode. | | CodeRouter: TLS edge unreachable, или route rejected, в cmux auth status внутри машины. | Машина не может связаться с CodeRouter, или CodeRouter отклонил учетные данные машины. Повторите чуть позже. Если ошибка не исчезает, обратитесь в поддержку и укажите имя машины и вывод cmux auth status --json. | | coderouter is temporarily unavailable. Retry shortly. | CodeRouter или хранилище аккаунтов ненадолго недоступны. Повторите; если ошибка не исчезает, сообщите о ней с ID запроса. | ## Диагностика cr doctor показывает, выполнен ли вход в cr и какие эндпоинты CodeRouter он использует. cmux coderouter status показывает вход в cmux, выбранную команду и аккаунты Claude этой команды. ``` cr doctor cmux coderouter status ``` ## Помощь Сообщая о неудачном запросе, укажите значение заголовка ответа x-coderouter-request-id. Оно идентифицирует этот запрос в записях CodeRouter. Canonical: https://cmux.com/ru/docs/coderouter/cli Documentation index: https://cmux.com/llms.txt