Claude Code mit eigener API verbinden: Base URL, Key und Modell (2026)

Claude Code ist das Kommandozeilen-Werkzeug von Anthropic für die Programmierung und verbindet sich standardmäßig mit der offiziellen Anthropic-Schnittstelle. Teams in China richten es in der Praxis häufig auf ein selbst betriebenes oder Drittanbieter-Gateway aus, um Erreichbarkeit, einheitliche Abrechnung und Kontingentverwaltung zu verbessern. „Eine eigene API anbinden“ bedeutet im Kern, nur drei Dinge zu ändern: wohin die Anfrage geht (Base URL), womit sie sich authentifiziert (Key) und welches Modell aufgerufen wird (Modellname).

Dieser Artikel folgt der Reihenfolge Installation, Umgebungsvariablen, Konfigurationsdatei, Modellwahl, Verbindungstest, Team-Rollout und Sicherheit. Die Befehle beziehen sich vor allem auf macOS und Linux; Windows wird gesondert erwähnt.

Hinweis: Claude und Anthropic sind Marken ihrer jeweiligen Rechteinhaber. Dieser Artikel dient ausschließlich der technischen Einbindung; es besteht keine Verbindung zu den genannten Herstellern. Claude Code wird häufig aktualisiert; Umgebungsvariablen, Konfigurationsoptionen und Menübezeichnungen können sich mit der Version ändern. Maßgeblich sind claude --help, die offizielle Dokumentation und die Einbindungshinweise auf unserer Website.

1. Vor dem Einstieg drei Punkte klären

Claude Code verwendet das Anthropic-Messages-Protokoll, nicht das Chat-Completions-Protokoll von OpenAI. Eine eigene API muss daher mindestens zwei Bedingungen erfüllen: Sie stellt einen Anthropic-kompatiblen /v1/messages-Endpunkt bereit, und der Modellname stimmt mit dem überein, den das Gateway tatsächlich anbietet. Ein Gateway, das ausschließlich einen OpenAI-kompatiblen Endpunkt bereitstellt, lässt sich nicht direkt in Claude Code eintragen, es sei denn, es bietet zusätzlich eine Anthropic-kompatible Route an.

Bereiten Sie vor dem Start drei Dinge vor:

Base URL: die Stamm- oder Grundadresse des Gateways, zum Beispiel https://ai.zhongshangqihang.com. Ob /v1 enthalten sein muss, hängt von der Implementierung ab; maßgeblich sind die Einbindungshinweise auf der Anbieterseite.
API Key: im Kontrollzentrum erstellt, mit Obergrenze und Gültigkeitsdauer. Verwenden Sie für Tests keinen dauerhaft gültigen Key ohne Limit.
Modellname: aus dem Kontrollzentrum oder der Preisübersicht kopieren, nicht aus dem Gedächtnis schreiben. Ein falscher Großbuchstabe oder Bindestrich kann bereits „Modell nicht gefunden“ auslösen.

Wenn Sie noch kein Konto haben, beginnen Sie mit der Registrierung und legen zunächst einen Test-Key mit niedrigem Limit an.

2. Claude Code installieren

Claude Code wird üblicherweise über npm verteilt; daneben gibt es weitere Installationswege. Der häufigste Ablauf:

Prüfen Sie, ob Node.js installiert ist. Verwenden Sie eine noch gewartete LTS-Version; die genaue Mindestversion entnehmen Sie der offiziellen Dokumentation.
Führen Sie npm install -g @anthropic-ai/claude-code aus, um das Werkzeug global zu installieren.
Prüfen Sie mit claude --version, ob der Befehl verfügbar ist, und notieren Sie die Versionsnummer.
Wechseln Sie in ein Testprojektverzeichnis, starten Sie claude und schließen Sie die Ersteinrichtung ab, etwa Theme und Vertrauen für das Verzeichnis.
Wenn Ihr Team Versionen kontrolliert, legen Sie eine Version fest und dokumentieren Sie sie im Onboarding; testen Sie Aktualisierungen zuerst in einem Testprojekt.

node --version
npm install -g @anthropic-ai/claude-code
claude --version
cd /path/to/your-project
claude

Bei einer eigenen API ist in der Regel keine Anmeldung beim Anthropic-Konto erforderlich. Ob die Anmeldung übersprungen wird, hängt jedoch von Version und Konfiguration ab. Wenn beim Start weiterhin eine Anmeldung verlangt wird, prüfen Sie zuerst, ob die Umgebungsvariablen in derselben Shell wirksam sind, in der Claude Code gestartet wird.

3. Umgebungsvariablen: BASE_URL und AUTH_TOKEN

Claude Code liest zwei gängige Authentifizierungsvariablen:

ANTHROPIC_BASE_URL: die Grundadresse für Anfragen.
ANTHROPIC_AUTH_TOKEN: wird als Authorization: Bearer gesendet, üblich bei Gateway-Zugängen.
ANTHROPIC_API_KEY: wird als x-api-key gesendet und entspricht eher der nativen Authentifizierung von Anthropic.

Es genügt, eine der beiden Varianten zu setzen. Authentifiziert das Gateway per Bearer, verwenden Sie ANTHROPIC_AUTH_TOKEN; nutzt es die native Methode, ANTHROPIC_API_KEY. Sind beide gleichzeitig gesetzt, kann die Priorität je nach Version unterschiedlich sein, was zu „richtig eingetragen, trotzdem 401“ führt. Setzen Sie daher nur eine Variable.

export ANTHROPIC_BASE_URL="https://ai.zhongshangqihang.com"
export ANTHROPIC_AUTH_TOKEN="sk-IHR-KEY"
claude

In ~/.zshrc oder ~/.bashrc eingetragen, gilt die Konfiguration dauerhaft; anschließend source ~/.zshrc ausführen. Unter Windows PowerShell verwenden Sie $env:ANTHROPIC_BASE_URL="...", was nur für das aktuelle Fenster gilt; für dauerhafte Einstellungen nutzen Sie die Systemumgebungsvariablen oder setx und öffnen das Terminal neu.

Schreiben Sie export-Zeilen nicht in Projektskripte und committen Sie sie nicht. Sobald ein Schlüssel in der Git-Historie steht, reicht das Löschen der Datei nicht aus, um den Eintrag zu entfernen.

4. settings.json: Konfiguration dauerhaft ablegen

Umgebungsvariablen eignen sich für temporäre Wechsel; für den dauerhaften Einsatz empfiehlt sich die settings-Datei von Claude Code. Es gibt drei übliche Ebenen:

Benutzerebene: ~/.claude/settings.json, gilt für alle Projekte auf diesem Rechner.
Projektebene: .claude/settings.json, kann ins Repository eingecheckt werden und eignet sich für nicht sensible Team-Konfiguration.
Lokale Projektebene: .claude/settings.local.json, wird nicht eingecheckt und eignet sich für persönliche Überschreibungen.

Beispiel:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.zhongshangqihang.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-IHR-KEY"
  },
  "model": "claude-sonnet-4-5"
}

Achtung: Der Key in settings.json steht im Klartext. Auf einem persönlichen Rechner mag das akzeptabel sein, auf gemeinsam genutzten Maschinen, in CI und in Code-Repositories nicht. Legen Sie in Projektdateien nur Base URL und Modellnamen ab; den Key übergeben Sie über Umgebungsvariablen oder ein Secret-Management-Werkzeug. Die Priorität folgt grob der Reihenfolge Unternehmenskonfiguration, Kommandozeilenparameter, lokale Projektkonfiguration, Projektkonfiguration, Benutzerkonfiguration; die konkrete Reihenfolge entnehmen Sie der Dokumentation Ihrer Version.

5. Modellwahl: nach Aufgabe abstufen

Claude-Modelle sind üblicherweise in drei Stufen unterteilt, die sich für unterschiedliche Aufgaben eignen:

Stufe	Typische Verwendung	Abwägung
Opus	Komplexe Refactorings, Analyse über mehrere Dateien, lang laufende Agenten	Leistungsfähiger, meist teurer und möglicherweise langsamer
Sonnet	Alltägliche Programmierung, Bugfixes, Code-Review	Ausgewogenes Verhältnis von Leistung und Kosten, gut als Standard
Haiku	Einfache Vervollständigung, Formatierung, viele kleine Aufgaben	Schnell und kostengünstig, bei komplexen Aufgaben schnell überfordert

In Claude Code lässt sich mit ANTHROPIC_MODEL das Hauptmodell festlegen. Alternativ überschreiben ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL und ANTHROPIC_DEFAULT_HAIKU_MODEL die Zuordnung der einzelnen Stufen. Welche Variablen eine Version unterstützt, kann unterschiedlich sein; prüfen Sie vor der Konfiguration claude --help oder die offizielle Dokumentation.

Der Modellname muss mit dem Modellkatalog des Gateways übereinstimmen. Ein Gateway kann für Upstream-Modelle eigene Bezeichnungen verwenden; der Name aus der offiziellen Dokumentation trifft nicht zwingend zu. Verfügbare Modelle und Abrechnung finden Sie in der Preisübersicht; Preise ändern sich mit Modellversionen und Upstream-Richtlinien.

6. Verbindung prüfen: erst curl, dann Claude Code

Prüfen Sie zunächst am Client vorbei mit curl, ob das Gateway selbst erreichbar ist:

curl "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Antworte nur mit OK"}]
  }'

Wenn das Gateway Bearer-Authentifizierung verwendet, ersetzen Sie x-api-key durch Authorization: Bearer $ANTHROPIC_AUTH_TOKEN. Eine Antwort mit Status 200 und plausiblem Inhalt zeigt, dass mindestens eine funktionierende Kombination aus Base URL, Key und Modell vorliegt.

Kehren Sie dann zu Claude Code zurück und prüfen Sie in dieser Reihenfolge:

claude --version bestätigt, dass der Client ausführbar ist.
Führen Sie im Projektverzeichnis claude doctor aus, sofern die Version den Befehl anbietet, und prüfen Sie Installation und Konfiguration.
Starten Sie claude und sehen Sie mit /status das aktuelle Modell und die Kontoinformationen.
Geben Sie eine risikoarme Aufgabe ein, zum Beispiel „Erkläre die Struktur dieses Verzeichnisses, ohne Dateien zu ändern“.
Beobachten Sie, ob die Antwort korrekt kommt und ob Fehler wie 401, 404 oder „Modell nicht gefunden“ auftreten.

Häufige Symptome und ihre Behandlung:

Symptom	Zuerst prüfen	Vorgehen
401	Key, Variablenname, Request-Header	Key neu kopieren; nur eine Authentifizierungsvariable setzen
404	`/v1` in der Base URL zu viel oder zu wenig	Laut Gateway-Dokumentation auf Grundadresse oder kompatiblen Endpunkt ändern
model not found	Modellname passt nicht zum Gateway-Katalog	Aus Kontrollzentrum oder Preisübersicht kopieren
Zeitüberschreitung	Netzwerk, DNS, Proxy	Mit anderem Netz testen; prüfen, ob der Proxy Header verändert
429	Parallelität oder Kontingent	Parallelität senken; Limit des Keys prüfen

7. Team-Rollout: ein Key pro Person, einheitlicher Einstieg

Für Teams ist ein gemeinsamer Key nicht empfehlenswert. Bewährte Praxis:

ein Key pro Person, mit Namen oder Verwendungszweck im Bezeichner; beim Austritt sofort deaktivieren;
Obergrenzen pro Projekt oder Umgebung, Produktion und Test getrennt;
ein einheitliches Gateway für Verbrauch, Modellverteilung und auffällige Aufrufe;
Base URL und erlaubte Modelle über die Unternehmenskonfiguration vorgeben, damit weniger manuelle Fehler entstehen;
die Einbindung im Onboarding dokumentieren, einschließlich Prüfbefehlen und häufiger Fehler;
Verbrauch wöchentlich oder monatlich prüfen und auffällige Keys zeitnah behandeln.

Wenn das Unternehmen Beschaffungs- und Compliance-Prozesse hat, klären Sie zuerst den Datenfluss: Codeausschnitte werden an das Gateway und dessen Upstream-Modellanbieter gesendet. Ob und wie lange Daten gespeichert und ob sie für Training verwendet werden, regeln die Nutzungsbedingungen. Treffen Sie keine Annahmen.

8. Sicherheitsgrenzen: Keys, Code und Daten

Zum Schluss einige Grundregeln:

Keys gehören nicht in Git, Images, Frontend-Code, Screenshots oder Chatverläufe.
Ergänzen Sie im Projekt eine .gitignore, die mindestens .env, .env.* und .claude/settings.local.json abdeckt.
Bei Verdacht auf eine Kompromittierung sperren Sie zuerst den alten Key und prüfen dann den Verbrauch; ein Passwortwechsel allein genügt nicht.
Setzen Sie Ablaufzeiten für Keys und rotieren Sie sie bei Personaländerungen.
Auf gemeinsam genutzten Rechnern nutzen Sie ein Secret-Management-Werkzeug oder apiKeyHelper, statt Klartext in settings.json zu schreiben.
Installieren Sie Claude Code nur aus vertrauenswürdigen Quellen und lesen Sie vor Aktualisierungen die Änderungshinweise.

Häufige Fragen

Muss man sich für Claude Code immer bei Anthropic anmelden?

Nicht zwingend. Mit einer funktionierenden Base URL und Authentifizierungsvariable kann der Client direkt eine eigene API verwenden; die Ersteinrichtung für Theme und Verzeichnisvertrauen kann dennoch erscheinen. Ob eine Anmeldung nötig ist, hängt von Version und Konfiguration ab. Prüfen Sie bei Problemen zuerst, ob die Umgebungsvariablen in der startenden Shell gelten.

Worin unterscheiden sich ANTHROPIC_API_KEY und ANTHROPIC_AUTH_TOKEN?

Ersterer wird üblicherweise im Header x-api-key gesendet, letzterer als Authorization: Bearer. Welche Variante passt, hängt von der Authentifizierung des Gateways ab. Setzen Sie nur eine, um Header-Konflikte zu vermeiden.

Gehört in die Base URL die Grundadresse oder die Adresse mit /v1?

Claude Code erwartet im Allgemeinen die Grundadresse und ergänzt /v1/messages selbst; manche Gateways verlangen den kompatiblen Endpunkt direkt. Die Prüfung ist einfach: Rufen Sie mit curl die Grundadresse plus /v1/messages auf. Funktioniert das, verwenden Sie die Grundadresse; andernfalls passen Sie die Angabe laut Gateway-Dokumentation an.

Warum funktioniert curl, Claude Code aber meldet einen Fehler?

Häufige Ursachen sind Shell-Variablen, die nicht an die grafische Oberfläche oder das integrierte Terminal der IDE weitergegeben werden, oder zwei gleichzeitig gesetzte Authentifizierungsvariablen. Führen Sie im selben Terminal, in dem Sie Claude Code starten, echo $ANTHROPIC_BASE_URL aus.

Kann ein Team einen gemeinsamen Key verwenden?

Technisch ja, empfehlenswert ist es nicht. Ein gemeinsamer Key erlaubt keine Zuordnung des Verbrauchs zu Personen und erschwert bei einer Kompromittierung die Ursachenklärung. Ein Key pro Person mit Limits und Ablaufdatum ist mit geringerem Verwaltungsaufwand verbunden.

Nächste Schritte

Wenn Sie noch kein Gateway-Konto haben, beginnen Sie mit der Registrierung, erstellen Sie zunächst einen Test-Key mit niedrigem Limit und prüfen Sie ihn in den zwei Schritten dieses Artikels, zuerst mit curl, dann in Claude Code. Modelle und Abrechnung finden Sie in der Preisübersicht; Preise werden angepasst, maßgeblich ist die aktuelle Anzeige.