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.
Geprüft 2026-11-13
Was du brauchst
- Claude Code ist installiert, und
claudeliegt 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_URLrichtet Claude Code auf UplinkSwitch aus. Füge den Wert mit dem/v1ein. Das Gateway akzeptiert den Pfad, den Claude Code daraus baut.ANTHROPIC_AUTH_TOKENsendet den Key alsAuthorization: Bearer.ANTHROPIC_API_KEYfunktioniert stattdessen und sendet den Key alsx-api-key. Setze eine von beiden, nicht beide.- Eine Anfrage mit zwei verschiedenen Keys wird mit einem
400abgelehnt. - Die Base-URL allein reicht nicht. Ohne eine der Key-Variablen nutzt Claude Code weiter einen gespeicherten claude.ai-Login.
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claudeDauerhaft 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_MODELundANTHROPIC_DEFAULT_HAIKU_MODEL. Setze sie auf IDs wieclaude-opus-5-5,claude-sonnet-5-5undclaude-haiku-5-5. - Halte den Key aus der
.claude/settings.jsoneines 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.environmentVariablesin 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.
| Modell | Input | Gecachter Input | Output | Kontext |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2Anthropic | $4.00Listenpreis $8.00 | $0.10Listenpreis $0.20 | $20.00Listenpreis $40.00 | 1,000,000 |
| Claude Fable 5.1claude-fable-5.1Anthropic | $6.00Listenpreis $10.00 | $2.00Listenpreis $0.25 | $30.00Listenpreis $50.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5Anthropic | $2.716Listenpreis $4.00 | $0.1455Listenpreis $0.20 | $9.70Listenpreis $20.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5Anthropic | $1.20Listenpreis $2.00 | $0.075Listenpreis $0.10 | $3.00Listenpreis $10.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5Anthropic | $0.0582Listenpreis $0.10 | $0.01Listenpreis $0.01 | $0.1455Listenpreis $0.50 | 1,000,000 |
| Claude Fable 5claude-fable-5Anthropic | $3.00Listenpreis $10.00 | $0.30Listenpreis $1.00 | $15.00Listenpreis $50.00 | 1,000,000 |
| Claude Opus 5claude-opus-5Anthropic | $1.80Listenpreis $5.00 | $0.16Listenpreis $0.50 | $7.50Listenpreis $25.00 | 1,000,000 |
| Claude Sonnet 5claude-sonnet-5Anthropic | $1.20Listenpreis $2.00 | $0.12Listenpreis $0.20 | $3.00Listenpreis $10.00 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8Anthropic | $1.80Listenpreis $5.00 | $0.16Listenpreis $0.50 | $7.50Listenpreis $25.00 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7Anthropic | $1.80Listenpreis $5.00 | $0.16Listenpreis $0.50 | $7.50Listenpreis $25.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6Anthropic | $1.80Listenpreis $5.00 | $0.16Listenpreis $0.50 | $7.50Listenpreis $25.00 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6Anthropic | $1.80Listenpreis $3.00 | $0.18Listenpreis $0.30 | $9.00Listenpreis $15.00 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5Anthropic | $0.60Listenpreis $1.00 | $0.06Listenpreis $0.10 | $3.00Listenpreis $5.00 | 200,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 -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
/logoutaus, um nur den Key zu behalten. ANTHROPIC_API_KEYist gesetzt, wird aber ignoriert: Die Variable braucht eine einmalige Freigabe. Schalte unter/configdie Option Use custom API key ein oder nutzeANTHROPIC_AUTH_TOKEN.
Fragen
Hol dir einen Key für Claude Code
Zwei Variablen, prepaid ab $10, kein Abo und 30 Tage Preisgarantie bei jeder Aufladung.
Key holen