CodeRouter

CodeRouter це маршрутизатор моделей у cmux. Ваші агенти кодування надсилають запити до CodeRouter, а він передає кожен запит у підписку або API-ключ, які додала ваша команда. Якщо акаунт обмежено за частотою, відхилено або він недоступний, CodeRouter переносить роботу на інший акаунт, і агенти продовжують працювати.

Навіщо він потрібен

• Об’єднуйте кілька підписок ChatGPT, Claude і OpenCode Go та API-ключів і діліться ними з командою.
• Агент продовжує працювати, коли один акаунт вичерпав ліміт використання.
• Надайте машинам cmux Cloud доступ до моделей без зберігання облікових даних на машині.
• Переглядайте використання токенів за кожним акаунтом, API-ключем і хмарною машиною.

Підтримувані акаунти

Кожен акаунт обслуговує агентів, які працюють з API його провайдера. Codex і Pi використовують спільний пул; Claude Code використовує окремий пул акаунтів Claude.

На панелі CodeRouter також можна додати API-ключі, токени Claude та облікові дані Bedrock. Вона показує всі акаунти зі станом, паузою після помилок та активними сесіями: cmux.com/dashboard/coderouter

Як працює маршрутизація

Кожна сесія агента залишається на одному акаунті, поки він справний, тому кеш промптів у провайдера лишається прогрітим. Нова сесія йде на акаунт з найменшою кількістю активних сесій.

Коли провайдер повертає обмеження частоти, відхиляє облікові дані або не відповідає, CodeRouter ставить акаунт на паузу й повторює запит на іншому акаунті. Повтор відбувається лише до того, як агент отримає будь-який вивід моделі, тому відповідь, яка вже почала передаватися, ніколи не надсилається двічі.

Запит до провайдера надсилає розміщений сервіс CodeRouter. Тому трафік до провайдера йде від CodeRouter, а не від вашого Mac чи хмарної машини.

Швидкий старт на Mac

1. Встановіть CLI CodeRouter. Він встановлюється і як coderouter, і як cr. Можна також виконати cmux cr, який під час першого запуску запропонує встановлення.
2. Увійдіть з акаунтом cmux. cr login відкриває браузер; підтвердьте показаний код.
3. Додайте підписку. cr add відкриває меню провайдерів, а cr add codex виконує вхід у ChatGPT у браузері.
4. Запустіть агента через CodeRouter командою cr codex, cr opencode або cr pi. Аргументи після імені агента передаються йому.

curl -fsSL https://cmux.com/coderouter/install.sh | sh
cr login
cr add codex
cr codex

На машинах cmux Cloud

Кожна хмарна машина під’єднується до CodeRouter під час створення. Claude Code, Codex, OpenCode і Pi на машині використовують акаунти вашої команди без входу й без налаштування.

Як агенти налаштовані на хмарних машинах

Команди та спільний доступ

Акаунти належать команді, у яку ви увійшли. cr org list показує ваші команди, а cr org switch змінює команду, яку використовує cr. Команди cmux coderouter приймають --team <id>.

Обліковий запис, доданий до організації, стає спільним для команди: ним можуть користуватися всі учасники та хмарні машини команди. На панелі керування «Зробити приватним» залишає доступ лише тому, хто його додав, а «Поділитися з командою» скасовує це.

В особистій команді нові облікові записи приватні, і ваші приватні облікові записи також обслуговують ваші власні хмарні машини. Хмарні машини організації використовують лише спільні облікові записи, тож приватним обліковим записом потрібно поділитися, перш ніж машина зможе його використовувати.

Будь-який учасник команди може додавати, перейменовувати, вимикати, передавати й видаляти спільні акаунти команди. cr transfer переносить акаунт до іншої команди після вашого підтвердження.

cr org list
cr org switch <name-or-id>
cr accounts
cr transfer [account] [--to <team>]
cr remove [account]

Використання та ліміти

Кожен провайдер враховує використання на акаунті, який обслужив запит, за планом і лімітами цього акаунта. CodeRouter розподіляє роботу між акаунтами, але не підвищує ліміт окремого акаунта.

cr показує стан квоти кожної підписки. Додайте --watch, щоб оновлювати його кожні 30 секунд, або --json для скриптів.

cmux coderouter machines показує використання токенів за 30 днів і еквівалентну вартість за цінами API для кожної хмарної машини. Усередині машини cmux coderouter usage розбиває її використання за днями, робочими просторами, агентами й моделями.

Еквівалентна вартість за цінами API це оцінка за публічними прайс-листами. Це не рахунок.

cr
cr usage --watch
cmux coderouter machines

Облікові дані та конфіденційність

• Облікові дані провайдерів шифруються перед збереженням. Жоден API чи вигляд панелі CodeRouter не повертає збережених облікових даних; акаунти показують лише мітку, email або замаскований ключ.
• cr add і cmux coderouter claude add ніколи не приймають облікові дані провайдера як аргумент команди, бо тоді вони потрапили б в історію оболонки. Вони читають їх зі змінної середовища, стандартного вводу або прихованого запиту.
• cr add codex і cr add opencode виконують вхід у провайдера в браузері. cr codex передає налаштування CodeRouter у Codex лише на цей запуск і не змінює ваш звичайний вхід та конфігурацію Codex.
• Хмарні машини не зберігають облікових даних. Агенти на машині надсилають публічний ключ-заглушку на приватну адресу CodeRouter, а мережева межа машини додає підписані облікові дані, прив’язані до цієї машини. CodeRouter відхиляє ці дані з будь-якої іншої машини й відкликає їх після видалення машини.
• Кожна відповідь CodeRouter містить заголовок x-coderouter-request-id, який ідентифікує запит.

Наступні кроки

• Агенти та моделі: налаштування кожного агента на Mac і на хмарних машинах
• CLI та усунення проблем: усі команди й поширені помилки
• cmux Cloud