Агенты и модели 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