Claude Code nutzen mit OpenRouter

Wenn Sie den reibungslosen Workflow von Claude Code (dem CLI-Tool von Anthropic) schätzen, wissen Sie wahrscheinlich, dass es standardmäßig das Anthropic API-Format erwartet. Aber was, wenn Sie ein anderes Modell verwenden oder neue Modelle erkunden möchten, die nicht über die direkte Anthropic-API verfügbar sind? Genau hier kommt OpenRouter ins Spiel! Es bietet einen einheitlichen, OpenAI-kompatiblen API-Zugang zu Hunderten von Modellen von vielen verschiedenen Anbietern.

Indem Sie die beiden Systeme verbinden, erhalten Sie das Beste aus beiden Welten: die entwicklerfreundliche Oberfläche von Claude Code und den breiten Modellkatalog von OpenRouter. Diese Integration bezeichnen wir als „Claude Code mit Openrouter.“

Der Trick besteht darin, einen „Router / Proxy“ zu verwenden, der zwischen den beiden API-Formaten übersetzt. Sobald Sie ihn eingerichtet haben, können Sie Claude Code wie gewohnt ausführen, aber mit OpenRouter als Backend.

Wesentliche Vorteile der Verwendung von Claude Code mit Openrouter

Die Kombination von Claude Code und Openrouter erschließt eine Reihe leistungsstarker Vorteile:

• Zugang zu über 400 Modellen — darunter Claude-Varianten, GPT-ähnliche Modelle, Open-Source-LLMs und mehr.
• Kein Anthropic-Abonnement erforderlich — Sie zahlen nur für die Nutzung über das Pay-as-you-go-Preismodell von Openrouter.
• Flexibler Modellwechsel — wechseln Sie Modelle während einer Sitzung in Claude Code mit /model, oder routen Sie basierend auf dem Aufgabentyp (leichtgewichtig vs. Schlussfolgerung, Kosten vs. Leistung).
• Kostenoptimierung — kostengünstige oder kostenlose Modelle für Routineaufgaben, leistungsstarke Modelle nur bei Bedarf: ideal für kostenbewusste Entwickler.
• Lokales oder Cloud-basiertes Routing — führen Sie alles lokal für den Datenschutz aus, oder hosten Sie Ihren Router für die gemeinsame Teamnutzung, CI/CD oder Cloud-Automatisierung.
• Tools & Flexibilität — einige Router unterstützen erweiterte Funktionen wie Streaming, Modell-Fallback, Multiplexing mehrerer Anbieter und die Integration in umfassendere Entwicklungs-Workflows.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

1. Claude Code global installiert (z.B. über npm install -g @anthropic-ai/claude-code).

2. Ein Openrouter-Konto mit einem gültigen API-Schlüssel (sk-or-...) (Erstellen Sie ein Konto bei OpenRouter).

3. Ein Router-/Proxy-Tool (Docker ist am einfachsten, aber auch Node.js-basierte Router funktionieren) zur Formatkonvertierung

4. Grundkenntnisse im Umgang mit Umgebungsvariablen und der Kommandozeile

Mit diesem Setup können Sie Claude Code auf den Router verweisen – der dann Anfragen an Openrouter weiterleitet und Antworten zurückleitet.

Methode 1: y-router (Am einfachsten und empfohlen)

Einer der am häufigsten verwendeten Router für dieses Setup ist y-router. Er fungiert als Übersetzer zwischen dem erwarteten Anthropic-API-Format und Openrouters OpenAI-ähnlicher API (Repository ansehen unter: GitHub). So geht's Schritt für Schritt mit y-router:

1. y-router lokal bereitstellen (Docker empfohlen):

git clone https://github.com/luohy15/y-router.git
cd y-router
docker compose up -d

Dies startet einen lokalen Router-Dienst, der (standardmäßig) auf http://localhost:8787 lauscht.

2. Konfigurieren Sie Ihre Umgebungsvariablen, damit Claude Code seine Anfragen an y-router sendet und nicht direkt an Anthropic:

export ANTHROPIC_BASE_URL="http://localhost:8787"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-openrouter-key>"
export ANTHROPIC_MODEL="z-ai/glm-4.5-air"   # for a fast, lightweight model
# or export ANTHROPIC_MODEL="z-ai/glm-4.5"   # for a more powerful model

3. Claude Code ausführen:

claude

Die Oberfläche wird wie gewohnt gestartet. Wenn Sie /model eingeben, sehen Sie das von Openrouter betriebene Modell. Herzlichen Glückwunsch – Sie verwenden jetzt Claude Code mit Openrouter. (ishan.rs)

Diese Methode hält das Routing lokal, einfach und unter Ihrer Kontrolle – ideal für Entwickler, die Wert auf Datenschutz und minimalen Overhead legen.

Methode 2: Claude Code Router (npm-basiert, funktionsreich)

Wenn Sie Docker nicht verwenden möchten, gibt es eine weitere robuste Option: Claude Code Router – ein Node.js-basiertes Router-Tool, das Claude Code den Zugriff auf externe Anbieter ermöglicht (Repository ansehen unter GitHub). So richten Sie es ein:

1. Global installieren:

npm install -g @musistudio/claude-code-router

Erstellen Sie dann eine Konfigurationsdatei (z.B. ~/.claude-code-router/config.json) mit Ihren bevorzugten Einstellungen und Modellen. Viele Benutzer fügen Openrouter als Anbieter hinzu, geben ihren API-Schlüssel an und listen unterstützte Modelle auf (weitere Details zu dieser Methode unter lgallardo.com).

2. Router starten:

ccr start

Sobald er läuft, setzen Sie ANTHROPIC_BASE_URL auf die URL des Routers und verwenden Sie claude wie gewohnt. Der Router übersetzt Anfragen und ermöglicht ein dynamisches Umschalten zwischen Modellen – einschließlich Fallback-Verhalten, Routing-Regeln und vielem mehr.

Diese Methode ist leistungsstark, wenn Sie mehr Kontrolle über Modell-Routing, Fallback-Richtlinien oder die Integration in größere Toolchains (wie CI/CD, automatisierte Skripte oder Multi-Modell-Experimente) wünschen.

Methode 3: Direkter Openrouter Proxy (Minimaler Setup für schnelle Tests)

Wenn Sie nur einen schnellen Check oder Test durchführen möchten – ohne einen vollständigen Router zu betreiben – können Sie versuchen, Claude Code direkt auf einen Openrouter-kompatiblen Proxy oder minimalen Adapter zu verweisen. Es gibt einige Community-Lösungen, um dies zu erleichtern (Repository ansehen unter GitHub).

Zum Beispiel könnten Sie Folgendes einstellen:

export ANTHROPIC_BASE_URL="https://proxy-your-choice.com"
export ANTHROPIC_AUTH_TOKEN="sk-or-<your-key>"
export ANTHROPIC_MODEL="openrouter/model-name"

Führen Sie dann Claude Code aus. Dieser Ansatz ist nützlich für kurzlebige Tests oder schnelle Experimente. Er kann jedoch an Robustheit mangeln (z.B. für Streaming, Tool-Calling oder Langzeitsitzungen), abhängig von der Proxy-Implementierung.

Best Practices & Tipps für eine reibungslose Erfahrung

1. Modellkompatibilität prüfen — nicht alle Modelle unterstützen erweiterte Funktionen wie Tool-Aufrufe oder lange Kontextfenster. Verwenden Sie leichtere Modelle für einfache Aufgaben, leistungsfähigere Modelle für anspruchsvolle Aufgaben wie Schlussfolgerung oder Codierung.
2. API-Schlüssel sichern — behandeln Sie Ihren Openrouter API-Schlüssel wie ein Geheimnis; speichern Sie ihn sicher und geben Sie ihn niemals clientseitig preis.
3. Kosten verwalten — überwachen Sie die Token-Nutzung bei großen Modellen; ziehen Sie Prompt-Caching, Fallback-Modelle oder aufgabenbasiertes Routing in Betracht, um das Kosten-/Leistungsverhältnis zu optimieren.
4. Routing-Setup testen — nach der Konfiguration immer mit einfachen Befehlen testen (z.B. claude --model <model>), um sicherzustellen, dass alles korrekt geroutet wird.
5. Fallback-Routing für Zuverlässigkeit nutzen — bei Multi-Modell-Setups konfigurieren Sie Fallback-Optionen, damit der Router bei Nichtverfügbarkeit eines Modells automatisch zu einem anderen wechseln kann.

Häufig gestellte Fragen

F1. Muss ich für Anthropic bezahlen, um Claude Code mit Openrouter zu nutzen?
Nein. Wenn Claude Code mit Openrouter (über einen Router oder Proxy) konfiguriert ist, verwendet es Ihren Openrouter API-Schlüssel für Anfragen – Sie benötigen kein kostenpflichtiges Anthropic-Abonnement.

F2. Kann ich Modelle während derselben Claude Code-Sitzung spontan wechseln?
Ja. Viele Router (und Claude Code selbst) ermöglichen es Ihnen, Modelle mit /model <model_name> zu wechseln. Dies funktioniert in den meisten Fällen mitten im Gespräch.

F3. Sind alle Modelle in Openrouter mit Claude Code-Funktionen (wie Tool-Ausführung, Streaming) kompatibel?
Nicht immer. Einige „Nur-Text“- oder leichtere Modelle unterstützen möglicherweise keine Tool-Aufrufe, langen Kontext oder Streaming. Für komplexe Workflows verwenden Sie Modelle, die bekanntermaßen diese Funktionen unterstützen.

F4. Ist ein lokaler Docker-Router sicherer als ein gehosteter?
Im Allgemeinen ja. Das lokale Betreiben eines Routers gibt Ihnen die volle Kontrolle und vermeidet die Offenlegung Ihres API-Schlüssels gegenüber externen Diensten. Gehostete Router sind bequem, können aber Kompromisse bei Sicherheit oder Zuverlässigkeit mit sich bringen.

F5. Kann ich dieses Setup in CI/CD oder automatisierte Workflows integrieren?
Absolut. Tools wie Claude Code Router unterstützen Konfigurationsdateien und Umgebungsvariablen, was die Integration in Automatisierungspipelines (GitHub Actions, Skripte usw.) erleichtert.

Fazit

Die Verwendung von Claude Code mit Openrouter ist eine elegante und leistungsstarke Methode, um sich von der Bindung an einen einzelnen Anbieter zu befreien, während eine vertraute, optimierte Entwickleroberfläche beibehalten wird. Egal, ob Sie einen lokalen Router über Docker betreiben, einen Node.js-basierten Router verwenden oder über einen minimalen Proxy testen – Sie öffnen die Tür zu einem riesigen Katalog von Modellen, flexiblen Kostenoptionen und maßgeschneiderten Workflows.

Für Entwickler, Nebenprojekte oder Teams, die KI-gestütztes Codieren ohne hohen Overhead optimieren möchten, bietet dieses Setup eine überzeugende Balance aus Kontrolle, Flexibilität und Skalierbarkeit. Mit nur wenigen Konfigurationsschritten können Sie die Möglichkeiten Ihres KI-Assistenten dramatisch erweitern – und dann wechseln oder skalieren, wenn sich Ihre Anforderungen entwickeln.

Probieren Sie es aus: Ihre nächste Code-Sitzung könnte bald von einem Modell angetrieben werden, das Sie nie für möglich gehalten hätten – alles unter der vertrauten Claude Code-Oberfläche.