# 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.

| Agent | Auf deinem Mac | Auf einer Cloud-Maschine |
| --- | --- | --- |
| Codex | `cr codex` | Automatisch |
| OpenCode | `cr opencode` | Automatisch |
| Pi | `cr pi` (experimentell) | Automatisch |
| Claude Code | CodeRouter-API-Schlüssel | Automatisch |

## 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](https://cmux.com/de/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. Jeder Agent nutzt die CodeRouter-Konten deines Teams über eine private CodeRouter-Adresse, und cmux schreibt seine Konfiguration, sobald zum ersten Mal eine Shell oder der Agent startet:

-   Claude Code erhält ANTHROPIC\_BASE\_URL und einen Platzhalter-ANTHROPIC\_API\_KEY bei jedem Start, nicht aus jeder Shell, sodass sie nie Vorrang vor deiner eigenen Anmeldung haben. 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, speichert sie in ~/.config/cmux/opencode-team.json und fügt sie bei jedem Start deiner eigenen Konfiguration hinzu.

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.

Um stattdessen dein eigenes Konto zu nutzen, führe cr use own auf der Maschine aus und melde dich dann so an, wie es der Agent normalerweise vorsieht: /login in Claude Code, codex login oder opencode auth login. cr use team wechselt zurück, cr use own codex ändert einen einzelnen Agenten, und cr use zeigt, wie sich jeder Agent anmeldet. Ohne Auswahl nutzt ein Agent, bei dem du dich auf der Maschine angemeldet hast, dein eigenes Konto, und ein Agent, für den dein Team kein Konto hat, zeigt seine normale Anmeldung. Eine Änderung gilt beim nächsten Start des Agenten.

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
```

Canonical: https://cmux.com/de/docs/coderouter/agents

Documentation index: https://cmux.com/llms.txt
