Claude Code OpenRouter einrichten: Setup und Meinung 2026

Robin, Pexon Consulting | 10 Min. Lesezeit | 10.09.2026

TL;DR: Claude Code OpenRouter kurz erklärt

Claude Code OpenRouter bindet die CLI über drei Umgebungsvariablen an OpenRouters Anthropic-Skin, ohne lokalen Proxy. Pexon Consulting (80 Mitarbeiter, Microsoft Partner) sieht das als Team-Schicht für Failover und Budget, nicht als Produktions-Gateway für deutschen Quellcode. Stand 10.09.2026: Claude Code v2.1.268, Anthropic-Modelle pinnen, Fast Mode nur auf konkretem Opus.

Das Problem: die Session stirbt, die Rechnung kommt später

Sie sind mitten im Refactor. Claude Code hat zwölf Dateien im Kontext, der Diff ist halb angewandt, dann kommt das Rate-Limit. Genau dieses Bild nutzt OpenRouter in der eigenen Anleitung vom 16.06.2026. Wir sehen denselben Abbruch in Teams, nur mit einem zweiten Akt: Fünf Entwickler, fünf Anthropic-Logins, keine gemeinsame Kappe, bis die Rechnung da ist.

Claude Code selbst ist kein Nischenwerkzeug mehr. Quelle: das öffentliche Repo anthropics/claude-code steht bei 144.665 GitHub-Sternen, Abruf am 10.09.2026. Die CLI liegt bei v2.1.268 (npm und GitHub-Release, veröffentlicht 10.09.2026). Wer das auf zehn Laptops ohne Steuerungsschicht laufen lässt, kauft sich Sichtbarkeit erst mit dem Monatssaldo.

OpenRouter setzt sich dazwischen: Anthropic-kompatibler Endpoint, Failover zwischen Anthropic-Providern, Credits statt Einzelabo, Activity-Dashboard. Das löst Rate-Limits und Team-Billing. Es löst nicht die Frage, ob Ihr Source Code über eine US-Gateway-Schicht darf.

Claude Code OpenRouter einrichten: die drei Variablen

Die Integration ist offiziell. Nach Angaben von OpenRouter in der Claude-Code-Integration spricht Claude Code das native Anthropic-Protokoll gegen OpenRouters Anthropic Skin, ohne lokalen Proxy. Ältere Guides mit claude-code-router auf localhost sind für diesen Pfad überflüssig.

Drei Dinge müssen stimmen, sonst authentifiziert Claude Code weiter gegen Anthropic und Sie debuggen Phantom-Fehler.

1. Basis-URL ist https://openrouter.ai/api, ohne /v1. Die normale OpenAI-kompatible URL ist hier falsch.
2. Der OpenRouter-Key (Prefix sk-or-) liegt in ANTHROPIC_AUTH_TOKEN. Claude Code schickt das als Authorization: Bearer.
3. ANTHROPIC_API_KEY muss ein leerer String sein, nicht unset. Sonst geht der Key als x-api-key raus und die Session fällt auf Anthropic zurück.

# ~/.zshrc oder ~/.bashrc. Key VOR dem Token setzen
export OPENROUTER_API_KEY="$(security find-generic-password -s openrouter -w)"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""   # muss explizit leer sein
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Danach Shell neu laden. source ~/.zshrc oder ein neues Terminal. Wer die alte Umgebung testet, erklärt das Setup für kaputt.

Projektbezogen geht dasselbe in .claude/settings.local.json. Die Datei nicht mit Key committen. Eine projektweite .env liest der native Installer nicht. Das steht in der Doku, und trotzdem landen Keys dort, weil jedes andere Tool sie dort erwartet.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "<openrouter-key>",
    "ANTHROPIC_API_KEY": "",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Wer vorher mit einem Anthropic-Account eingeloggt war, muss einmal /logout laufen, dann CLI beenden und neu starten. Auf macOS liegt die Session in der Keychain unter Claude Code-credentials. Bleibt der Eintrag nach /logout, löschen und neu starten. Typisches Symptom sonst: model-not-found für openrouter/auto oder openrouter/pareto-code.

Prüfung innen:

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://openrouter.ai/api

Steht dort ANTHROPIC_API_KEY oder eine Claude-Login-Methode, hat die Umgebung die Session nicht erreicht. Parallel sollten Requests im OpenRouter Activity Dashboard auftauchen.

Installation, falls noch nicht da:

# nativ, empfohlen
curl -fsSL https://claude.ai/install.sh | bash

# oder npm, Node 18+
npm install -g @anthropic-ai/claude-code

Modelle, Fable und Fast Mode: wo die Doku lügt, wenn Sie ungenau lesen

Claude Code verteilt Arbeit auf Rollen. OpenRouter mappt die Variablen auf Modell-Slugs. Unsere Empfehlung: Anthropic first-party pinnen, nicht den Katalog durchspielen.

export ANTHROPIC_DEFAULT_FABLE_MODEL="~anthropic/claude-fable-latest[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="~anthropic/claude-sonnet-latest[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="~anthropic/claude-haiku-latest"
export CLAUDE_CODE_SUBAGENT_MODEL="~anthropic/claude-opus-latest[1m]"

Fable ist seit Claude Code 2.1.x die vierte Klasse. Über OpenRouter erscheint sie in /model nicht von selbst. Ohne ANTHROPIC_DEFAULT_FABLE_MODEL bleibt der Slot leer. Claude Fable 5.1 ist seit dem 01.09.2026 draußen (anthropic/claude-fable-5.1 auf OpenRouter, 1M Kontext, 10/50 USD je Million Token, Cache-Reads 0,25 USD). Für lange Agentenläufe ist das der Slot. Für Alltags-Diffs bleibt Sonnet.

Das [1m] am Slug ist kein OpenRouter-Feature. Claude Code nimmt sonst 200k Kontext an und compact früher als nötig. OpenRouter streift den Marker vor dem Routing wieder ab.

Gateway-Discovery (CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1) zeigt eine Kuratliste, nicht den ganzen Katalog. Ein Teil der Einträge landet bei Nicht-Anthropic-Providern. Claude Code ist auf Anthropic-Tool-Calls gebaut. OpenRouter sagt das selbst: garantiert ist nur Anthropic 1P, und den sollten Sie als Top-Provider setzen. Englische Anleitungen, die openrouter/free auf alle fünf Slots legen, sind Klickköder. Tool-Use, Thinking-Blöcke und Agenten-Loops kippen dort zuerst. Wir raten davon ab, sobald der Agent Dateien schreibt.

Fast Mode ist die zweite Falle. Anthropic verspricht bis 2,5x schnellere Ausgabe zum Aufpreis. Auf OpenRouter ist das ein fast-Service-Tier auf dem normalen Modell, nicht mehr die deprecated *-fast-Geschwister. Unterstützt sind Claude Opus 4.6, 4.7, 4.8 und Opus 5. Fable hat keinen Fast-Tier. /fast auf Fable schaltet die Session auf Ihr konfiguriertes Opus um. Das beschleunigt Fable nicht, es wechselt das Modell und die Rechnung.

# ab Claude Code v2.1.96 (Release 08.04.2026), aktuell v2.1.268
export CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1

/fast hängt speed: "fast" nur an, wenn die aufgelöste Modell-ID eine unterstützte Opus-Version ist. Steht ANTHROPIC_DEFAULT_OPUS_MODEL auf ~anthropic/claude-opus-latest, meldet die CLI Fast Mode ON und schickt den Parameter trotzdem nicht. Standardtempo, Standardpreis. Deshalb pinnen wir Opus in dem Snippet oben auf anthropic/claude-opus-5, nicht auf den Alias.

Bedrock und Vertex bedienen Fast Mode nicht. Failover auf diese Provider bedeutet: kein Fast-Tier, auch wenn /fast an ist.

Kosten: OpenRouter schlägt auf die Tokenpreise der Provider nichts drauf. Auf Credit-Käufe kommt 5,5 Prozent oben drauf, Minimum 0,80 USD. OpenRouter rechnet selbst vor: 10 Millionen Token Sonnet im Monat, 80/20 Input/Output, rund 54 USD Token plus etwa 3 USD Fee. Dafür Failover und eine Rechnung. Das Free-Tier (50 Requests am Tag, 1.000 nach 10 USD Credits) ist zum Anfassen da, nicht für Produktivsessions.

Eine Statusline aus dem Repo OpenRouterTeam/openrouter-examples (383 Sterne, Abruf 10.09.2026) zeigt Provider, Modell und laufende Kosten. Sie ersetzt eine andere Statusline vollständig. Jeder Refresh trifft die Generation-API. Für den Laptop ok. Kein Betriebsreporting.

Pexon-Meinung: OpenRouter vor Claude Code, aber nicht als Unternehmens-Gateway

Kurze Antwort: ja für das Entwicklerteam, das Anthropic schon nutzt und Sichtbarkeit will. Nein als dauerhafte Kontrollebene für Quellcode in regulierten deutschen Firmen.

Was OpenRouter hier wirklich gut macht, ist die Management-Schicht, die Anthropic lokal nicht mitliefert. Ein Key, Limits pro Person, Failover wenn Anthropic drosselt, Dashboard statt Excel nach dem Monat. Für Agent-SDKs gelten dieselben drei Variablen, weil das SDK Claude Code als Runtime nutzt. Die GitHub Action ist derselbe Trick in CI:

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.OPENROUTER_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://openrouter.ai/api
    ANTHROPIC_AUTH_TOKEN: ${{ secrets.OPENROUTER_API_KEY }}

In der Action darf ANTHROPIC_API_KEY aus dem Input gefüllt sein. Der Lauf ist nicht interaktiv, die Base-URL zwingt den Traffic trotzdem nach OpenRouter. Lokal bleibt die leere API-Key-Variable Pflicht. Wer das vermischt, hat genau den Auth-Konflikt, den die Troubleshooting-Seite beschreibt.

Was OpenRouter nicht ist: Ihr LLM-Gateway im Sinne von Keys im Vault, SSO, Tenant-Trennung, Audit im eigenen Netz. Den Vergleich Self-Host gegen Managed haben wir getrennt aufgeschrieben, unter LiteLLM gegen OpenRouter. Für Claude Code ändert sich an der Linie nichts. Marketplace ist Messstand und Team-Abrechnung. Produktions-Kontrollebene ist Cluster oder zumindest ein Gateway, das Sie betreiben.

Datenschutz: OpenRouter loggt Prompts standardmäßig nicht, Opt-in für Prompt-Logging und ein weiteres Opt-in für 1 Prozent Rabatt gegen Trainingsnutzung. Das ist die Speicherfrage, nicht die Rechtsraumfrage. Requests laufen über OpenRouter-Infrastruktur. Für personenbezogene Tickets und Kundencode in Banking oder Energie ist das die falsche Ebene. CISO-Pfad bleibt Bedrock, Azure-seitige Residenz oder eigenes Gateway, wie im Claude-Code-DSGVO-Check. Wer nur „wir loggen nicht“ als Freigabe nimmt, hat den CLOUD-Act-Teil nicht gelesen.

Key in der ~/.zshrc ist für einen Laptop akzeptabel, für ein Team fahrlässig. Keychain oder Secret-Store, Rotation, Widerruf. Ein geleakter sk-or- in einem Dotfiles-Repo ist kein theoretisches Risiko.

Pexon Consulting betreibt 14 KI-Agenten produktiv und setzt Claude Code intern. Unsere Linie intern: Anthropic-Modelle, gepinnte IDs, Budget sichtbar. Für Kunden mit Quellcode-Auflage bleibt OpenRouter Evaluierung, nicht die Produktions-Kontrollebene.

Den Claude-Code-Schnitt selbst, Skills, Hooks, Team-Rollout, klären wir unter Claude Code im Unternehmen. OpenRouter ersetzt diese Arbeit nicht. Es verschiebt nur die Rechnung.

Häufig gestellte Fragen

Brauche ich ein Anthropic-Abo für Claude Code OpenRouter?

Nein. Die CLI rechnet über OpenRouter-Credits. Ein Anthropic-Plan ist dafür nicht nötig. Wer vorher mit einem Claude-Account eingeloggt war, muss /logout laufen, sonst überschreibt die gecachte Session die drei Variablen.

Was kostet Claude Code über OpenRouter?

Sie zahlen den Tokenpreis des Providers plus 5,5 Prozent auf Credit-Käufe, Minimum 0,80 USD. Inference selbst bleibt auf Provider-Niveau. Fast Mode auf Opus 5 ist ein Aufpreis-Tier. Die genaue Session sehen Sie im Activity-Dashboard, nicht in der Anthropic-Console.

Claude Code OpenRouter oder LiteLLM, was sollen wir nehmen?

Kommt auf die Kontrollfrage an. Sichtbarkeit und Failover für ein Dev-Team: OpenRouter ist in einer Stunde da. Keys, SSO, Residenz, Audit: LiteLLM oder ein Cluster-Gateway. Beides parallel als „die Wahrheit“ ist fast immer falsch. Eine Schicht muss die Rechnung besitzen.

Kann ich kostenlose OpenRouter-Modelle in Claude Code nutzen?

Technisch oft ja, produktiv nein. OpenRouter garantiert Claude Code nur gegen Anthropic first-party. Free-Modelle haben kleinere Kontextfenster und brechen Tool-Calls. Für Datei-Edits im Repo ist das Geldverschwendung in Form von kaputten Diffs, auch wenn die Zeile 0,00 USD zeigt.

Loggt OpenRouter unseren Source Code?

Standardmäßig nein, nur Metadaten wie Tokenzahlen. Prompt-Logging ist Opt-in. Das schließt Speicherung, nicht US-Jurisdiktion. Für regulierten Quellcode bleibt der Gateway-Ort die eigentliche Entscheidung, nicht der Haken in den Account-Settings.

Nächster Schritt

Drei Variablen beweisen, dass die CLI über OpenRouter antwortet. Sie beweisen nicht, dass Budgets, Residenz und Audit im Unternehmen halten.

Verwandte Themen