Agenci i modele CodeRouter

Ta strona pokazuje, jak każdy agent łączy się z CodeRouter na Twoim Macu i na maszynie cmux Cloud oraz jak wybiera model.

Na Twoim Macu

cr uruchamia już zainstalowanego agenta i kieruje go do CodeRouter na czas tego uruchomienia. Agent musi być w PATH. Wszystko po nazwie agenta jest przekazywane bez zmian.

Codex

cr codex uruchamia Codex z dostawcą modeli CodeRouter. Podpolecenia takie jak exec, review i resume działają tak samo. cr naked uruchamia zwykły Codex z pominięciem CodeRouter.

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

OpenCode

cr opencode wczytuje modele z kont OpenCode Go Twojego zespołu i używa pierwszego, chyba że podasz --model. Wartość --model musi być jednym z tych modeli; dla każdego innego dostawcy uruchom zwykłe opencode.

cr opencode
cr opencode --model <model>

Pi

cr pi dodaje do Pi dostawcę coderouter z tymi samymi modelami co Codex i używa pierwszego modelu, chyba że podasz --model. Dostawca jest stały, więc --provider jest odrzucane. Obsługa Pi jest eksperymentalna.

cr pi
cr pi --model <model>

Claude Code i inni klienci API

cr nie ma programu uruchamiającego Claude Code. Aby kierować przez CodeRouter Claude Code na Macu lub dowolne narzędzie korzystające z Anthropic Messages API albo OpenAI Responses API, utwórz klucz API CodeRouter i skieruj narzędzie na coderouter.dev.

Utwórz klucz w sekcji API keys panelu CodeRouter. Klucz zaczyna się od crk_ i jest wyświetlany jeden raz. Tworzenie i unieważnianie kluczy wymaga uprawnienia do zarządzania kluczami API w zespole, które zawsze masz w swoim osobistym zespole: 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_...

Klucz API organizacji używa tylko udostępnionych kont zespołu. Klucz w Twoim osobistym zespole może też używać Twoich prywatnych kont. CodeRouter obsługuje OpenAI Responses API, a nie Chat Completions.

Na maszynie, która nie może otworzyć przeglądarki, cr login --api-key loguje cr kluczem, a CODEROUTER_API_KEY podaje klucz dla pojedynczego polecenia. Unieważnij klucz w panelu lub uruchom cr logout na maszynie, która go używa.

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

Na maszynach cmux Cloud

Maszyny Cloud nie wymagają konfiguracji. Każdy agent korzysta z kont CodeRouter Twojego zespołu przez prywatny adres CodeRouter, a cmux zapisuje jego konfigurację przy pierwszym uruchomieniu powłoki lub agenta:

• Claude Code dostaje ANTHROPIC_BASE_URL i zastępczy ANTHROPIC_API_KEY przy każdym uruchomieniu, a nie z każdej powłoki, więc nigdy nie mają pierwszeństwa przed Twoim własnym logowaniem. Pytania przy pierwszym uruchomieniu mają już odpowiedzi.
• Codex dostaje dostawcę modeli cmux w ~/.codex/config.toml.
• Pi dostaje nadpisanie dostawcy w ~/.pi/agent/models.json.
• OpenCode przy pierwszym uruchomieniu pobiera listę dostawców z CodeRouter, zapisuje ją w ~/.config/cmux/opencode-team.json i przy każdym uruchomieniu dodaje ją do Twojej własnej konfiguracji.

cmux zapisuje każdy plik tylko wtedy, gdy go brakuje, więc Twoje zmiany są zachowane. Konfiguracja Codex, która już wskazuje innego dostawcę modeli, pozostaje nietknięta.

Aby zamiast tego używać własnego konta, uruchom cr use own na maszynie, a następnie zaloguj się tak, jak zwykle robi to agent: /login w Claude Code, codex login lub opencode auth login. cr use team przełącza z powrotem, cr use own codex zmienia jednego agenta, a cr use pokazuje, jak loguje się każdy agent. Bez wyboru agent, do którego zalogowano się na maszynie, używa Twojego własnego konta, a agent, dla którego zespół nie ma konta, pokazuje swoje zwykłe logowanie. Zmiana obowiązuje przy następnym uruchomieniu agenta.

Uruchamiaj agentów jak zwykle. cmux coderouter agent zamienia sam prompt na jednorazową formę agenta; na maszynie działa w bieżącym terminalu, a na Macu uruchamia agenta na wskazanej maszynie, podobnie jak 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"

Maszyny Cloud używają kont zespołu, do którego należą. Jeśli agent zgłasza, że żadne konto nie jest dostępne, dodaj konto lub udostępnij istniejące temu zespołowi.

Modele

Codex i Pi używają katalogu modeli konta wybranego przez CodeRouter, udostępnianego pod /v1/models, więc selektor modeli w Codex pokazuje to, czego mogą używać Twoje konta. Wybierz model flagą -m w Codex lub poleceniem /model. Dla klucza OpenRouter CodeRouter wysyła sam identyfikator modelu OpenAI jako openai/<model>.

OpenCode wyświetla modele z kont OpenCode Go zespołu.

Claude Code wysyła model wybrany przez --model lub /model, a CodeRouter przekazuje go do wybranego konta. Konta subskrypcji i kluczy API obsługują modele, na które Anthropic zezwala dla danego konta.

Konta Bedrock tłumaczą identyfikatory modeli Claude na identyfikatory modeli Bedrock za pomocą wbudowanej tabeli, a identyfikatory Bedrock są przekazywane bez zmian. Model bez mapowania zwraca not_found_error. Aby zmapować inny model, dodaj konto z --model:

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

Na maszynie Cloud cmux coderouter models wypisuje katalog modeli Codex w formacie JSON.

# Inside a Cloud machine
cmux coderouter models