Claude Code auf
einen benutzerdefinierten API-Endpunkt ausrichten
Stand 2026-10-07 reichen laut Gateway-Doku von Anthropic zwei Variablen: ANTHROPIC_BASE_URL für den Endpunkt und ANTHROPIC_AUTH_TOKEN für die Zugangsdaten, gesendet als Authorization: Bearer-Header (liest Ihr Gateway x-api-key, nehmen Sie ANTHROPIC_API_KEY); beides geht auch im env-Block von settings.json. Seit Claude Code 2.1.285 laufen Modelle mit 1M-Fenster (Opus 4.7+, Sonnet 5+, Fable) hinter einer eigenen ANTHROPIC_BASE_URL mit 1M; endet Ihr Gateway bei 200K, empfiehlt die offizielle Doku /autocompact 200k. Cloud-Sitzungen gehören nicht zu einer Gateway-Bereitstellung, dort gesetzte Gateway-Variablen werden nicht angewendet.
Aktualisiert 2026-10-08
Richten Sie dieses Tool auf den QCode-Endpunkt — ein Key für Claude, GPT und chinesische Modelle.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard / AMEX), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Vier Dinge, die Sie wissen sollten
Die Mindestkonfiguration
ANTHROPIC_BASE_URL verweist auf den Endpunkt und ANTHROPIC_AUTH_TOKEN liefert die Zugangsdaten. In den meisten Fällen ist das alles, was Sie brauchen.
Wo die Zugangsdaten landen
Laut Doku (Stand 2026-10-07): ANTHROPIC_AUTH_TOKEN landet in Authorization: Bearer, ANTHROPIC_API_KEY in x-api-key, apiKeyHelper in beiden; steckt der Schlüssel in der falschen Variable, kommt er in einem Header an, den das Gateway nicht liest, und die Anfrage scheitert mit 401.
Die zweite Konfigurationsmöglichkeit
Wenn Sie lieber keine Umgebungsvariablen verwenden, tragen Sie dieselben Schlüssel in den env-Block von settings.json ein – die Struktur entspricht sich eins zu eins.
Web- und Cloud-Sitzungen
Laut Doku (Stand 2026-10-07): Cloud-Sitzungen gehören nicht zu einer Gateway-Bereitstellung, in der Umgebungskonfiguration einer Cloud-Sitzung gesetzte Gateway-Variablen werden nicht angewendet; muss der Verkehr über das Gateway laufen, schalten Sie diese Oberflächen für die betroffenen Nutzer nicht frei.
Warum diese beiden Variablen genügen
Stand 2026-10-07 lautet die Antwort weiterhin: zwei Variablen. Der ausgehende Datenverkehr von Claude Code ist konfigurierbar: ANTHROPIC_BASE_URL bestimmt, wohin Anfragen gehen, und ANTHROPIC_AUTH_TOKEN bestimmt, welche Zugangsdaten sie begleiten. Die Dokumentation formuliert den zweiten Punkt klar – diese Umgebungsvariable ist der Schritt, der den Key in den Authorization-Header legt, und genau diesen Header liest ein Gateway. Solange Ihr Endpunkt das Anthropic-Protokoll spricht und über den Authorization-Header authentifiziert, funktioniert die Integration ohne Änderungen am Client-Code.
Die dokumentierten Varianten und die Änderung in 2.1.285 (geprüft am 2026-10-07)
Die erste Variante sind Umgebungsvariablen: Setzen Sie ANTHROPIC_BASE_URL auf Ihren Endpunkt und ANTHROPIC_AUTH_TOKEN auf die Zugangsdaten. Die zweite ist der env-Block in settings.json mit denselben Schlüsselnamen. Die Dokumentation beschreibt außerdem apiKeyHelper: einen Befehl, den Claude Code ausführt, um Ihre Gateway-Zugangsdaten abzurufen, statt sie aus einer statischen Umgebungsvariable zu lesen – geeignet für Zugangsdaten, die rotiert werden müssen. Zwei weitere Abschnitte – Gateway-Modelle zur Modellauswahl hinzufügen und Datenverkehr außerhalb des Gateway-Pfads abschalten – lohnen sich für ein Enterprise-Deployment. Ergänzung 2026-10-07: Der Changelog-Eintrag zu Claude Code 2.1.285 (veröffentlicht am 2026-09-29) lautet „Changed sessions behind a custom ANTHROPIC_BASE_URL to use the 1M context window of models that have one (Opus 4.7+, Sonnet 5+, Fable); run /autocompact 200k if your gateway stops at 200K“. Die Seite zur Modellkonfiguration ergänzt, dass Claude Code ein niedrigeres Limit des Gateways oder des Servers dahinter nicht erkennen kann.
Drei Schritte zur Verbindung
Setzen Sie die beiden Variablen: ANTHROPIC_BASE_URL auf den Endpunkt und ANTHROPIC_AUTH_TOKEN auf die Zugangsdaten. Probieren Sie es zuerst in einer sauberen Shell aus, statt direkt in Ihre globale Konfiguration zu schreiben.
Senden Sie eine minimale Anfrage, um zu bestätigen, dass es funktioniert, und prüfen Sie, ob das in der Antwort zurückgegebene Modell dem angeforderten entspricht – daran erkennen Sie auch, ob dazwischen eine Umschreibungsschicht liegt.
Sobald alles stabil läuft, machen Sie es dauerhaft: Verschieben Sie es in den env-Block von settings.json oder injizieren Sie es in der CI aus Ihrem Secret Store (die dokumentierte CI-Form übergibt die Zugangsdaten aus Secrets an ANTHROPIC_AUTH_TOKEN). Wenn die Zugangsdaten rotiert werden müssen, wechseln Sie zu apiKeyHelper.
Von Anthropic dokumentiert vs. beim Endpunkt-Anbieter nachfragen
Von Anthropic dokumentiert
① Was ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN jeweils bewirken. ② Dass die Zugangsdaten im Authorization-Header übertragen werden. ③ Dass der env-Block von settings.json eine gleichwertige zweite Variante ist. ④ Dass apiKeyHelper die Zugangsdaten per Befehl statt über eine statische Variable abruft. ⑤ Dass Cloud-Sitzungen (die Webversion) und Claude Code in Slack nicht Teil einer Gateway-Bereitstellung sind und in der Umgebung einer Cloud-Sitzung gesetzte Gateway-Variablen nicht angewendet werden. ⑥ Seit Claude Code 2.1.285 laufen Modelle mit 1M-Fenster (Opus 4.7+, Sonnet 5+, Fable) hinter einer eigenen ANTHROPIC_BASE_URL mit 1M; endet ein Gateway bei 200K, wird /autocompact 200k empfohlen (Wortlaut des Changelogs, geprüft am 2026-10-07).
Beim Endpunkt-Anbieter nachfragen
Ob die Base-URL ein Pfadsuffix tragen soll, welche Modell-IDs bereitgestellt werden, ob 1M Kontext und Caching unterstützt werden und wie hoch die Obergrenze für Parallelität ist – all das hängt vom Endpunkt ab, mit dem Sie sich verbinden, und die Dokumentation von Anthropic beantwortet es für diesen nicht. Prüfen Sie bei einem 404 zuerst den Pfadanteil Ihrer Base-URL anhand der Dokumentation des Anbieters; bei einem 401 vergewissern Sie sich, dass die Zugangsdaten im Authorization-Header übertragen werden und nicht anderswo. Fragen Sie besonders nach dem Kontextlimit: Seit 2.1.285 plant Claude Code hinter einem eigenen Endpunkt mit 1M, erkennt ein niedrigeres Gateway-Limit aber nicht; endet das Gateway bei 200K, führen Sie wie offiziell empfohlen /autocompact 200k aus.
Zwei Orte zur Konfiguration
Umgebungsvariablen
Am schnellsten zu ändern und richtig für den ersten funktionierenden Versuch. Der Nachteil: Sie gehen leicht verloren – ein neues Terminal oder ein anderer CI-Runner, und sie sind weg – und die Zugangsdaten liegen in der Prozessumgebung. Gut für Tests und einmalige Aufgaben.
Der env-Block in settings.json
Er wandert mit der Konfiguration mit, statt von Ihrer aktuellen Shell abzuhängen, und eignet sich daher für dauerhafte Einstellungen. Die Zugangsdaten stehen jedoch weiterhin im Klartext auf der Festplatte. Müssen sie rotiert werden oder sollen sie nicht auf der Festplatte liegen, verwenden Sie stattdessen apiKeyHelper: einen Befehl, den Claude Code aufruft, um die Zugangsdaten bei Bedarf abzurufen.
Die drei häufigsten Stolpersteine
① Gesetzt, aber ohne Wirkung: Prüfen Sie, ob die Variable für den Prozess sichtbar ist, den Sie tatsächlich ausführen, und ob sie nicht von einem gleichnamigen Schlüssel in settings.json überdeckt wird – wenn beide existieren, entscheidet die tatsächliche Ladereihenfolge. ② Keine Wirkung in Web- oder Cloud-Sitzungen: Das ist dokumentiertes Verhalten – laut aktueller Gateway-Doku sind Cloud-Sitzungen nicht Teil einer Gateway-Bereitstellung, dort gesetzte Gateway-Variablen werden nicht angewendet. ③ Auffälliges Verhalten bei kontobezogenen Funktionen: Laut Dokumentation kann eine mit ANTHROPIC_AUTH_TOKEN authentifizierte Sitzung bei der Verfügbarkeitsprüfung ein Ergebnis erhalten, das von der Einstellung der Organisation abweicht, weil diese Prüfung eine claude.ai-Anmeldung oder einen Anthropic-API-Key voraussetzt.
Bei QCode
Stand 2026-10-07 nennt die QCode-Doku für Claude Code genau die beiden Variablen oben: ANTHROPIC_BASE_URL auf https://api.qcode.cc/api (ohne abschließenden Schrägstrich) und ANTHROPIC_AUTH_TOKEN auf Ihren Schlüssel mit cr_ am Anfang; ein Tool, das nur ANTHROPIC_API_KEY liest, funktioniert mit demselben cr_-Schlüssel. Claude-Modelle laufen nur über den Endpunkt mit Anthropic-Protokoll. Diese Seite macht keine Zusage zum Kontextlimit einzelner Modelle bei QCode; bei einem Kontextlimit-Fehler senken Sie die Schwelle wie von Claude Code empfohlen mit /autocompact. Nach dem Verbinden sofort zwei Dinge prüfen: eine minimale Anfrage senden und das zurückgemeldete Modell mit dem angefragten vergleichen, dann einmal usage und Abbuchungen abgleichen. Abgerechnet wird pro Token, die Preise je Modell stehen unter /models.
Was sich ändert, sobald ANTHROPIC_BASE_URL auf ein Gateway zeigt
Beide Einschränkungen stehen im offiziellen Eintrag zu ANTHROPIC_BASE_URL unter einer Bedingung: Der Wert zeigt auf einen Host, der nicht vom Erstanbieter stammt. QCode ist ein solcher Host, daher gelten beide auch für diese Route.
Die MCP-Tool-Suche ist standardmäßig deaktiviert
Der offizielle Eintrag ist eindeutig: Zeigt die Variable auf einen Host, der nicht vom Erstanbieter stammt, ist die MCP-Tool-Suche standardmäßig deaktiviert; wenn Ihr Proxy tool_reference-Blöcke weiterleitet, setzen Sie ENABLE_TOOL_SEARCH=true und prüfen Sie es einmal. Leitet der Proxy sie nicht weiter, kostet Sie das Deaktiviertlassen nur diese Abkürzung beim Abruf – gewöhnliche Tool-Aufrufe und Nachrichten sind davon nicht betroffen. Geprüft am 2026-10-07.
Remote Control ist deaktiviert
Dasselbe Dokument: Ab v2.1.196 funktioniert Remote Control nicht mehr, wenn die Variable auf einen anderen Host als api.anthropic.com zeigt – wie schon bei Amazon Bedrock, Google Cloud Agent Platform und Microsoft Foundry. Wenn Sie Remote-Control-Sitzungen vom Smartphone aus starten, betrachten Sie das als bekannte Grenze und nicht als Fehler, den Sie suchen müssten. Geprüft am 2026-10-07.
Über welchen Header die Zugangsdaten laufen
Die offizielle Aufteilung: Wenn Ihr Gateway-Team von Bearer-Token oder Authorization-Header spricht, setzen Sie ANTHROPIC_AUTH_TOKEN; ist von API-Key oder x-api-key die Rede, setzen Sie ANTHROPIC_API_KEY; wenn niemand etwas dazu sagt, beginnen Sie laut Dokumentation mit ANTHROPIC_AUTH_TOKEN und prüfen mit einer minimalen Anfrage, ob ein Wechsel nötig ist. QCode akzeptiert beides – die einzige Frage ist, welche Variable Sie schreiben. Geprüft am 2026-10-07.
Diese drei Hinweise stammen aus dem Eintrag zu ANTHROPIC_BASE_URL und der Seite zur Anbindung von LLM-Gateways in der Dokumentation von Anthropic (geprüft am 2026-10-07). Beide Verhaltensweisen hängen von der Claude-Code-Version ab, die Sie einsetzen; maßgeblich bleiben daher die aktuellen Dokumente.
FAQ
Was ist die minimale Menge an Variablen?
Zwei: ANTHROPIC_BASE_URL für den Endpunkt und ANTHROPIC_AUTH_TOKEN für die Zugangsdaten. Laut Dokumentation ist Letztere die Variable, die den Key in den Authorization-Header setzt.
Sollte die Base-URL einen Pfad-Suffix enthalten?
Das hängt vom Endpunkt ab, mit dem Sie sich verbinden; die Dokumentation von Anthropic beantwortet das für diesen nicht. Am schnellsten klären Sie es, indem Sie der Dokumentation des Anbieters folgen und eine minimale Anfrage senden – bei einem 404 sollten Sie zuerst den Pfadanteil prüfen. Für QCode nennt die Doku https://api.qcode.cc/api, ohne abschließenden Schrägstrich.
Kann ich ganz ohne Umgebungsvariablen auskommen?
Ja – tragen Sie dieselben Schlüssel in den env-Block von settings.json ein. Wenn die Zugangsdaten rotiert werden müssen oder Sie sie nicht im Klartext auf der Festplatte ablegen möchten, verwenden Sie stattdessen apiKeyHelper: einen Befehl, den Claude Code ausführt, um die Zugangsdaten abzurufen.
Warum wirkt es in der Webversion nicht?
Das ist dokumentiertes Verhalten. Stand 2026-10-07 heißt es in der offiziellen Gateway-Doku: Claude Code in Slack und Cloud-Sitzungen (die Webversion) sind nicht Teil einer Gateway-Bereitstellung, und Gateway-Variablen aus der Umgebungskonfiguration einer Cloud-Sitzung werden nicht angewendet; muss der Datenverkehr über Ihr Gateway laufen, aktivieren Sie diese Zugänge für die betreffenden Nutzer nicht. Die am 2026-09-22 abgerufene Fassung sagte zusätzlich, beide always use Anthropic's API (nutzen immer die API von Anthropic); in der aktuellen Doku fehlt dieser Halbsatz.
Wie konfiguriere ich es in CI?
Die dokumentierte Form übergibt die Zugangsdaten aus Ihrem Secret Store an ANTHROPIC_AUTH_TOKEN, wobei die Base-URL wie gewohnt gesetzt wird. Legen Sie die Zugangsdaten nicht in einer Konfigurationsdatei im Repository ab – das ist nicht anders, als sie fest einzucodieren.
Was sollte ich als Erstes prüfen, sobald die Verbindung steht?
Dass das in der Antwort zurückgegebene Modell dasjenige ist, das Sie angefragt haben. Trägt es ein Präfix, ein Suffix oder einen Anbieternamen, die nicht in Ihrer Anfrage standen, sitzt eine Umschreibungsschicht dazwischen. Das ist nicht zwingend schlecht, bestimmt aber, wie Sie zuordnen sollten, was Sie später auf der Rechnung sehen.
Quellen
Was die beiden Umgebungsvariablen tun, in welchem Header die Zugangsdaten landen, die env-Block-Form in settings.json, die Definition von apiKeyHelper und dass Cloud-Sitzungen nicht über ein Gateway laufen: Anthropic-Dokumentation „Connect Claude Code to an LLM gateway“ (code.claude.com/docs/en/llm-gateway-connect, erstmals abgerufen am 2026-09-02, erneut geprüft am 2026-10-07). Der Eintrag ANTHROPIC_BASE_URL: Seite zu den Umgebungsvariablen von Claude Code (abgerufen am 2026-10-07). 1M Kontext und /autocompact 200k: Changelog von Claude Code (CHANGELOG.md im GitHub-Repository anthropics/claude-code, Eintrag 2.1.285) und Seite zur Modellkonfiguration, Veröffentlichungsdatum aus den GitHub Releases desselben Repositorys, alles abgerufen am 2026-10-07. QCode-Einrichtung: die Seiten zu Umgebungsvariablen und Endpunkten auf docs.qcode.cc (abgerufen am 2026-10-07). Pfadform, verfügbare Modelle und Limits eines Endpunkts hängen vom jeweiligen Anbieter ab; diese Seite antwortet nicht für ihn.
Zwei Variablen, zuerst in einer sauberen Shell ausprobiert
Sobald es funktioniert, prüfen Sie das zurückgegebene Modell und gleichen die Nutzung ab, bevor Sie es in die Konfiguration übernehmen.
Weiterführende Lektüre
Cline mit einem OpenAI-kompatiblen Endpunkt
Wie die Konfiguration eines benutzerdefinierten Endpunkts in einer anderen Art von Client aussieht.
Monatliches API-Guthaben bei Claude Max und Team
Seit 2026-10-07: $100 / $200 / bis zu $500, Einlösen über eine Console-Organisation, ohne Claude Code, kein Übertrag.
Claude Code in Japan: Praxisleitfaden
Zahlungsmethoden (Karte, Apple Pay, Google Pay, Krypto), japanische Doku und Einrichtung von ANTHROPIC_BASE_URL.
Die zitierte offizielle Dokumentation wurde zuletzt am 2026-10-07 geprüft und kann sich ändern; maßgeblich sind die Seiten von Anthropic. Pfadform, Modellauswahl und Limits eines Endpunkts richten sich nach der Doku des jeweiligen Anbieters; welche Modelle es gibt, zeigt /models.