CodeRouter-Agenten und -Modelle

Diese Seite zeigt, wie jeder Agent CodeRouter auf deinem Mac und auf einer cmux Cloud-Maschine erreicht und wie jeder Agent ein Modell wählt.

Auf deinem Mac

cr startet den Agenten, den du bereits installiert hast, und richtet ihn für diesen Lauf auf CodeRouter aus. Der Agent muss in deinem PATH liegen. Alles nach dem Agentennamen wird unverändert weitergegeben.

Codex

cr codex startet Codex mit einem CodeRouter-Modellanbieter. Unterbefehle wie exec, review und resume funktionieren genauso. cr naked startet normales Codex und umgeht CodeRouter.

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

OpenCode

cr opencode lädt die Modelle der OpenCode Go-Konten deines Teams und nutzt das erste, sofern du nicht --model übergibst. Ein --model-Wert muss eines dieser Modelle sein. Für jeden anderen Anbieter startest du normales opencode.

cr opencode
cr opencode --model <model>

Pi

cr pi fügt Pi einen coderouter-Anbieter mit denselben Modellen wie Codex hinzu und nutzt das erste Modell, sofern du nicht --model übergibst. Der Anbieter ist fest, daher wird --provider abgelehnt. Die Unterstützung für Pi ist experimentell.

cr pi
cr pi --model <model>

Claude Code und andere API-Clients

cr hat keinen Launcher für Claude Code. Um Claude Code auf deinem Mac zu routen, oder jedes Tool, das die Anthropic Messages API oder die OpenAI Responses API spricht, erstellst du einen CodeRouter-API-Schlüssel und richtest das Tool auf coderouter.dev aus.

Erstelle einen Schlüssel im Bereich API keys des CodeRouter-Dashboards. Der Schlüssel beginnt mit crk_ und wird nur einmal angezeigt. Zum Erstellen oder Widerrufen eines Schlüssels brauchst du die Berechtigung, API-Schlüssel in diesem Team zu verwalten. In deinem persönlichen Team hast du sie immer: 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_...

Der API-Schlüssel einer Organisation nutzt nur die geteilten Konten des Teams. Ein Schlüssel in deinem persönlichen Team kann auch deine privaten Konten nutzen. CodeRouter bedient die OpenAI Responses API, nicht Chat Completions.

Auf einer Maschine ohne Browser meldet cr login --api-key cr mit einem Schlüssel an, und CODEROUTER_API_KEY liefert einen Schlüssel für einen einzelnen Befehl. Widerrufe einen Schlüssel im Dashboard oder führe cr logout auf der Maschine aus, die ihn nutzt.

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

Auf cmux Cloud-Maschinen

Cloud-Maschinen brauchen keine Einrichtung. Die Umgebung der Maschine richtet OPENAI_BASE_URL und ANTHROPIC_BASE_URL auf eine private CodeRouter-Adresse aus, und cmux schreibt die Konfiguration jedes Agenten, sobald zum ersten Mal eine Shell oder der Agent startet:

• Claude Code liest ANTHROPIC_BASE_URL und einen Platzhalter-ANTHROPIC_API_KEY aus der Umgebung. Die Fragen beim ersten Start sind bereits beantwortet.
• Codex erhält einen cmux-Modellanbieter in ~/.codex/config.toml.
• Pi erhält eine Anbieter-Überschreibung in ~/.pi/agent/models.json.
• OpenCode lädt beim ersten Start seine Anbieterliste von CodeRouter herunter und speichert sie in ~/.config/opencode/opencode.json.

cmux schreibt jede Datei nur, wenn sie fehlt. Deine Änderungen bleiben also erhalten. Eine Codex-Konfiguration, die bereits einen anderen Modellanbieter nennt, bleibt unverändert.

Starte Agenten wie gewohnt. cmux coderouter agent macht aus einem einfachen Prompt die Einmal-Form des Agenten. Innerhalb einer Maschine läuft er im aktuellen Terminal, und auf deinem Mac startet er den Agenten auf der Maschine, die du angibst, wie 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"

Cloud-Maschinen nutzen die Konten des Teams, dem sie gehören. Meldet ein Agent, dass kein Konto verfügbar ist, füge ein Konto hinzu oder teile ein vorhandenes mit diesem Team.

Modelle

Codex und Pi nutzen den Modellkatalog des Kontos, das CodeRouter auswählt, bereitgestellt unter /v1/models. Die Modellauswahl von Codex zeigt also, was deine Konten nutzen können. Wähle ein Modell mit dem Flag -m von Codex oder mit dessen Befehl /model. Für einen OpenRouter-Schlüssel sendet CodeRouter eine einfache OpenAI-Modell-ID als openai/<model>.

OpenCode listet die Modelle der OpenCode Go-Konten des Teams auf.

Claude Code sendet das Modell, das du mit --model oder /model wählst, und CodeRouter leitet es an das ausgewählte Konto weiter. Abo- und API-Schlüssel-Konten bedienen die Modelle, die Anthropic für dieses Konto erlaubt.

Bedrock-Konten übersetzen Claude-Modell-IDs mit einer eingebauten Tabelle in Bedrock-Modell-IDs. Bedrock-IDs werden unverändert weitergegeben. Ein Modell ohne Zuordnung liefert not_found_error. Um ein weiteres Modell zuzuordnen, füge das Konto mit --model hinzu:

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

Innerhalb einer Cloud-Maschine gibt cmux coderouter models den Codex-Modellkatalog als JSON aus.

# Inside a Cloud machine
cmux coderouter models