# 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/uk/docs/coderouter/cli Documentation index: https://cmux.com/llms.txt