Claude Code mit deinem eigenen API-Key nutzen

Setze zwei Umgebungsvariablen, und Claude Code läuft mit deinem UplinkSwitch-Key. Gleiches Tool, gleiche Modelle, Live-Preise.

Key holen

Geprüft 2026-11-13

Was du brauchst

  • Claude Code ist installiert, und claude liegt in deinem PATH.
  • Ein UplinkSwitch-Key aus der Konsole, mit aufgeladenem Guthaben. Guthaben lädst du ab $10 vorab auf, per Karte, WeChat Pay, Apple Pay, Google Pay oder Krypto.

Zwei Variablen

  • ANTHROPIC_BASE_URL richtet Claude Code auf UplinkSwitch aus. Füge den Wert mit dem /v1 ein. Das Gateway akzeptiert den Pfad, den Claude Code daraus baut.
  • ANTHROPIC_AUTH_TOKEN sendet den Key als Authorization: Bearer. ANTHROPIC_API_KEY funktioniert stattdessen und sendet den Key als x-api-key. Setze eine von beiden, nicht beide.
  • Eine Anfrage mit zwei verschiedenen Keys wird mit einem 400 abgelehnt.
  • Die Base-URL allein reicht nicht. Ohne eine der Key-Variablen nutzt Claude Code weiter einen gespeicherten claude.ai-Login.
shell
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claude

Dauerhaft in settings.json speichern

Trag beide Variablen in ~/.claude/settings.json unter env ein, dann gelten sie für jedes Projekt. .claude/settings.local.json gilt für ein einzelnes Projekt.

  • Drei weitere Variablen benennen die Modelle hinter den Aliasen: ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL und ANTHROPIC_DEFAULT_HAIKU_MODEL. Setze sie auf IDs wie claude-opus-5-5, claude-sonnet-5-5 und claude-haiku-5-5.
  • Halte den Key aus der .claude/settings.json eines Projekts heraus. Diese Datei ist dafür gedacht, committet und geteilt zu werden.
  • Setzen ein Shell-Export und eine Settings-Datei dieselbe Variable, gewinnt die Settings-Datei.
  • Die Erweiterung für VS Code liest Zugangsdaten aus ihrer eigenen Einstellung claudeCode.environmentVariables in den Benutzereinstellungen von VS Code.

Ein Modell wählen

Die Aliase opus, sonnet und haiku lösen zu dem auf, was die drei Modellvariablen benennen. Die Haiku-Variable verschiebt auch Hintergrundarbeit wie Sitzungstitel auf dieses Modell. Wechsle in einer Sitzung mit /model, beim Start mit claude --model claude-opus-5-5 oder für eine Sitzung mit ANTHROPIC_MODEL.

Claude Code spricht das API-Format von Anthropic, und hier wird jedes Chat-Modell in diesem Format bereitgestellt, auch GPT, Gemini, DeepSeek, Kimi und die unzensierten Builds. Jede Chat-ID aus der Modellliste funktioniert in denselben Variablen und wird als Messages-Antwort beantwortet, Tool-Calls eingeschlossen.

Was Claude Code mit diesem Key kostet

Die Tabelle zeigt die Claude-Modelle pro Million Tokens, live aus dem Katalog, neben dem veröffentlichten Listenpreis von Anthropic. Jedes Claude-Modell auf dem Key steht auf der Seite Claude-API-Preise.

Claude Code sendet bei jedem Turn die gesamte Unterhaltung und markiert sie für den Prompt-Cache. Aus dem Cache gelesene Tokens werden zum Cache-Preis abgerechnet, einem Bruchteil des Input-Preises. Der Cache hält standardmäßig fünf Minuten, ein Turn nach einer längeren Pause zahlt also einmal den Input-Preis für den gesamten Kontext.

Die Kosten, die Claude Code anzeigt, sind seine eigene Schätzung zum Listenpreis von Anthropic. Was du bezahlt hast, steht in der Konsole auf der Seite Nutzung.

ModellInputGecachter InputOutputKontext
Claude Fable 5.2claude-fable-5.2Anthropic$4.00Listenpreis $8.00$0.10Listenpreis $0.20$20.00Listenpreis $40.001,000,000
Claude Fable 5.1claude-fable-5.1Anthropic$6.00Listenpreis $10.00$2.00Listenpreis $0.25$30.00Listenpreis $50.001,000,000
Claude Opus 5.5claude-opus-5-5Anthropic$2.716Listenpreis $4.00$0.1455Listenpreis $0.20$9.70Listenpreis $20.001,000,000
Claude Sonnet 5.5claude-sonnet-5-5Anthropic$1.20Listenpreis $2.00$0.075Listenpreis $0.10$3.00Listenpreis $10.001,000,000
Claude Haiku 5.5claude-haiku-5-5Anthropic$0.0582Listenpreis $0.10$0.01Listenpreis $0.01$0.1455Listenpreis $0.501,000,000
Claude Fable 5claude-fable-5Anthropic$3.00Listenpreis $10.00$0.30Listenpreis $1.00$15.00Listenpreis $50.001,000,000
Claude Opus 5claude-opus-5Anthropic$1.80Listenpreis $5.00$0.16Listenpreis $0.50$7.50Listenpreis $25.001,000,000
Claude Sonnet 5claude-sonnet-5Anthropic$1.20Listenpreis $2.00$0.12Listenpreis $0.20$3.00Listenpreis $10.001,000,000
Claude Opus 4.8claude-opus-4-8Anthropic$1.80Listenpreis $5.00$0.16Listenpreis $0.50$7.50Listenpreis $25.001,000,000
Claude Opus 4.7claude-opus-4-7Anthropic$1.80Listenpreis $5.00$0.16Listenpreis $0.50$7.50Listenpreis $25.001,000,000
Claude Opus 4.6claude-opus-4-6Anthropic$1.80Listenpreis $5.00$0.16Listenpreis $0.50$7.50Listenpreis $25.001,000,000
Claude Sonnet 4.6claude-sonnet-4-6Anthropic$1.80Listenpreis $3.00$0.18Listenpreis $0.30$9.00Listenpreis $15.001,000,000
Claude Haiku 4.5claude-haiku-4-5Anthropic$0.60Listenpreis $1.00$0.06Listenpreis $0.10$3.00Listenpreis $5.00200,000

USD pro Million Tokens

Prüfen, ob es funktioniert

Sende eine kleine Nachricht. Mit -i gibt curl die Response-Header aus: x-uplink-request-id benennt die Anfrage, und x-uplink-charge ist, was sie in USD gekostet hat.

Starte dann claude. Die Anfrage erscheint innerhalb von Sekunden in der Konsole. In Claude Code zeigt /status eine Zeile Anthropic base URL mit der UplinkSwitch-Adresse und eine Zeile mit der Key-Variable, die du gesetzt hast. Fehlt die Zeile mit der Base-URL, ist die Variable nicht in der Sitzung angekommen.

curl
curl -i https://api.uplinkswitch.com/v1/messages \
  -H "Authorization: Bearer sk-uplink-live-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-fable-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'

Fehler und Lösungen

  • invalid_api_key (401): Der Key ist falsch oder widerrufen, oder er steht in einer Variable, die Claude Code nicht gelesen hat. Prüfe /status.
  • insufficient_balance (402): Lade in der Konsole auf. monthly_limit_reached (402) bedeutet, dass der Key das für ihn gesetzte monatliche Ausgabenlimit erreicht hat.
  • model_not_found (404): Die ID steht nicht in der Modellliste. Prüfe die Modellvariablen auf Tippfehler.
  • Claude Code fordert dich zum Login auf, obwohl der curl-Test funktioniert: Setze den Key in einem Shell-Export oder in ~/.claude/settings.json. Eine Settings-Datei im Projekt gilt erst nach der Ersteinrichtung und der Vertrauensabfrage.
  • Eine Warnung beim Start nennt zwei Quellen für Zugangsdaten: Ein gespeicherter Login und die Variable sind beide aktiv. Führe /logout aus, um nur den Key zu behalten.
  • ANTHROPIC_API_KEY ist gesetzt, wird aber ignoriert: Die Variable braucht eine einmalige Freigabe. Schalte unter /config die Option Use custom API key ein oder nutze ANTHROPIC_AUTH_TOKEN.

Fragen

Ja. Jedes Chat-Modell wird hier im Anthropic-Format bereitgestellt. Eine ID von GPT, Gemini, DeepSeek oder einem unzensierten Modell funktioniert also in den Modellvariablen und wird als Messages-Antwort beantwortet, Tool-Calls eingeschlossen.

Ja. Gecachter Input wird zum Cache-Preis abgerechnet. Steht im Eintrag einer Anfrage eine Zahl an Cache-Read-Tokens über null, hat das Caching funktioniert.

Remote Control und Sprachdiktat brauchen einen claude.ai-Login und sind deshalb aus, solange eine Key-Variable gesetzt ist. Die MCP-Tool-Suche ist auf einem Host außerhalb von Anthropic aus, und ENABLE_TOOL_SEARCH=true schaltet sie ein.

Entferne ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN aus der Umgebung und aus settings.json, falls du sie dort eingetragen hast.

Die Seite Nutzung in der Konsole zeigt, was du bezahlt hast. Eine einzelne Anfrage findest du über ihre Request-ID. Der Eintrag listet Input-Tokens, Cache-Read-Tokens, Output-Tokens und den Betrag in USD und erscheint innerhalb von etwa einer Minute im Log.

Guthaben lädst du ab $10 in der Konsole vorab auf, per Karte, WeChat Pay, Apple Pay, Google Pay oder Krypto, ohne Abo. Jede Aufladung sichert deine Preise für 30 Tage.

Hol dir einen Key für Claude Code

Zwei Variablen, prepaid ab $10, kein Abo und 30 Tage Preisgarantie bei jeder Aufladung.

Key holen
Join on Telegram