Агенти та моделі CodeRouter

На цій сторінці показано, як кожен агент під’єднується до CodeRouter на вашому Mac і на машині cmux Cloud та як він вибирає модель.

На вашому Mac

cr запускає вже встановленого агента й спрямовує його в CodeRouter на час цього запуску. Агент має бути в PATH. Усе після імені агента передається без змін.

Codex

cr codex запускає Codex із провайдером моделей CodeRouter. Підкоманди, наприклад exec, review і resume, працюють так само. cr naked запускає звичайний Codex в обхід CodeRouter.

cr codex
cr codex exec "fix the failing test"
cr codex -m <model>
cr naked

OpenCode

cr opencode завантажує моделі з акаунтів OpenCode Go вашої команди й використовує першу, якщо ви не вказали --model. Значення --model має бути однією з цих моделей; для будь-якого іншого провайдера запускайте звичайний opencode.

cr opencode
cr opencode --model <model>

Pi

cr pi додає в Pi провайдера coderouter з тими самими моделями, що й у Codex, і використовує першу модель, якщо ви не вказали --model. Провайдер фіксований, тому --provider відхиляється. Підтримка Pi експериментальна.

cr pi
cr pi --model <model>

Claude Code та інші API-клієнти

У cr немає запуску для Claude Code. Щоб спрямувати через CodeRouter Claude Code на Mac або будь-який інструмент, що працює з Anthropic Messages API чи OpenAI Responses API, створіть API-ключ CodeRouter і вкажіть інструменту coderouter.dev.

Створіть ключ у розділі API keys панелі CodeRouter. Ключ починається з crk_ і показується один раз. Для створення чи відкликання ключа потрібне право керувати API-ключами в команді; в особистій команді воно у вас є завжди: cmux.com/dashboard/coderouter

# Claude Code and Anthropic Messages API clients
export ANTHROPIC_BASE_URL=https://coderouter.dev
export ANTHROPIC_API_KEY=crk_...
claude

# OpenAI Responses API clients
export OPENAI_BASE_URL=https://coderouter.dev/v1
export OPENAI_API_KEY=crk_...

API-ключ організації використовує лише спільні акаунти команди. Ключ у вашій особистій команді може використовувати й ваші приватні акаунти. CodeRouter підтримує OpenAI Responses API, але не Chat Completions.

На машині, де не можна відкрити браузер, cr login --api-key виконує вхід cr за ключем, а CODEROUTER_API_KEY задає ключ для однієї команди. Відкличте ключ на панелі або виконайте cr logout на машині, яка його використовує.

cr login --api-key <key>
CODEROUTER_API_KEY=<key> cr codex exec "run the tests"

На машинах cmux Cloud

Хмарні машини не потребують налаштування. Кожен агент використовує акаунти CodeRouter вашої команди через приватну адресу CodeRouter, а cmux записує його конфігурацію під час першого запуску оболонки або агента:

• Claude Code отримує ANTHROPIC_BASE_URL і заглушку ANTHROPIC_API_KEY під час кожного запуску, а не з кожної оболонки, тому вони ніколи не мають пріоритету над вашим власним входом. Запитання першого запуску вже мають відповіді.
• Codex отримує провайдера моделей cmux у ~/.codex/config.toml.
• Pi отримує перевизначення провайдера в ~/.pi/agent/models.json.
• OpenCode під час першого запуску завантажує список провайдерів із CodeRouter, зберігає його в ~/.config/cmux/opencode-team.json і додає до вашої власної конфігурації під час кожного запуску.

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

Щоб натомість використовувати власний акаунт, виконайте cr use own на машині, а потім увійдіть так, як зазвичай входить агент: /login у Claude Code, codex login або opencode auth login. cr use team повертає акаунти команди, cr use own codex змінює одного агента, а cr use показує, як входить кожен агент. Якщо вибір не зроблено, агент, у який ви ввійшли на машині, використовує ваш власний акаунт, а агент, для якого команда не має акаунта, показує звичайний вхід. Зміна набуває чинності під час наступного запуску агента.

Запускайте агентів як звичайно. cmux coderouter agent перетворює простий промпт на одноразовий запуск агента; усередині машини він працює в поточному терміналі, а на вашому Mac запускає агента на вказаній машині, як cmux vm agent.

# Inside a Cloud machine
claude
codex
cmux coderouter agent claude "summarize the current checkout"

# From your Mac
cmux coderouter agent codex --machine brave-otter -- "run the tests"

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

Моделі

Codex і Pi використовують каталог моделей акаунта, вибраного CodeRouter, доступний за /v1/models, тому вибір моделі в Codex показує те, що доступно вашим акаунтам. Виберіть модель прапорцем Codex -m або командою /model. Для ключа OpenRouter CodeRouter надсилає простий ID моделі OpenAI як openai/<model>.

OpenCode показує моделі з акаунтів OpenCode Go команди.

Claude Code надсилає модель, вибрану через --model або /model, а CodeRouter передає її вибраному акаунту. Акаунти з підпискою та API-ключем обслуговують моделі, які Anthropic дозволяє для цього акаунта.

Акаунти Bedrock перетворюють ID моделей Claude на ID моделей Bedrock за вбудованою таблицею, а ID Bedrock передаються без змін. Для моделі без зіставлення повертається not_found_error. Щоб зіставити іншу модель, додайте акаунт з --model:

cmux coderouter claude add bedrock --region us-east-1 \
  --model <claude-model-id>=<bedrock-model-id>

Усередині хмарної машини cmux coderouter models виводить каталог моделей Codex у форматі JSON.

# Inside a Cloud machine
cmux coderouter models