Claude Code API Key — So bekommst und konfigurierst du ihn

Claude Code benötigt einen API Key, um überhaupt mit Claude-Modellen arbeiten zu können. Egal ob du Claude Code zum ersten Mal einrichtest oder von einem direkten Anthropic-Account zu einem Flat-Rate-Gateway wechselst: Der Ablauf besteht aus Key erstellen, zwei Environment Variables setzen und die Verbindung testen.

Was ist ein Claude Code API Key?

Ein Claude Code API Key ist der Authentifizierungsnachweis, mit dem die Claude Code CLI Anfragen an einen Claude-Modellanbieter senden darf. Ohne gültigen Key schlägt jeder Befehl in Claude Code mit einem Auth-Fehler fehl, weil die CLI nicht nachweisen kann, dass dein Account berechtigt ist. Technisch ist der Key ein geheimer String, den du in einer env var speicherst. Üblich sind ANTHROPIC_API_KEY, der als x-api-key Header gesendet wird, oder ANTHROPIC_AUTH_TOKEN, der als Bearer Token gesendet wird. Beide Varianten funktionieren mit AI Prime Tech Unlimited, sodass du dich an dem Setup orientieren kannst, das dein Tool oder deine bestehende Shell-Konfiguration bereits nutzt.

Wenn du statt Anthropic direkt ein Gateway wie AI Prime Tech Unlimited verwendest, kommt der API Key nicht aus der Anthropic Console, sondern aus dem Dashboard des Gateways. Das Format des Keys kann anders aussehen, aber die Einrichtung in Claude Code bleibt praktisch identisch: Du legst den Key in deiner Umgebung ab, setzt die Base URL auf das Gateway und Claude Code übernimmt den Rest. Wichtig ist: Deine Nutzung hängt dann an deinem Gateway-Guthaben oder Abo, nicht an Anthropic Billing. Das ist besonders interessant, wenn du Claude API kaufen möchtest, aber vorher planbare claude api kosten oder einen unbegrenzter claude zugang suchst.

Ein einzelner Key kann auf mehreren Geräten und in mehreren Claude Code Sessions gleichzeitig verwendet werden. Für Solo-Setups ist das bequem, etwa wenn du zwischen Laptop, Desktop und Remote-Server wechselst. In Teams solltest du Keys aber nicht unkontrolliert teilen. Jede Anfrage wird demselben Account, denselben Limits und demselben Guthaben zugerechnet. Besser ist es, pro Entwickler einen eigenen Key im Dashboard zu erstellen. So bleiben Usage Tracking, Sperrung einzelner Keys und Rate Limiting nachvollziehbar, ohne dass du bei einem kompromittierten Key das komplette Team-Setup austauschen musst.

Schritt 1 — Registrieren und Key erstellen

Öffne unlimited.aiprimetech.io und erstelle einen Account. Für die Registrierung brauchst du eine E-Mail-Adresse und ein Passwort. Nach der Bestätigung deiner E-Mail loggst du dich im Dashboard ein. Wechsle dort in den Bereich API Keys und klicke auf Generate New Key. Vergib einen sprechenden Namen wie "claude-code-laptop", "work-desktop" oder "ci-runner", damit du später sofort erkennst, wofür der Key gedacht ist. Das hilft enorm, wenn du alte Keys aufräumen, Geräte ersetzen oder einen Key gezielt widerrufen möchtest.

Kopiere den Key direkt nach der Erstellung. Die meisten Dashboards zeigen API Keys aus Sicherheitsgründen nur ein einziges Mal vollständig an. Speichere ihn in einem Password Manager, einem sicheren Secret Store oder einer verschlüsselten Notiz. Lege ihn nicht in Chatverläufen, Screenshots, Tickets oder unverschlüsselten Textdateien ab. Wenn du den Key verlierst, ist das kein Drama: Du kannst jederzeit einen neuen Key erstellen und deine Environment Variables aktualisieren. Den alten Key solltest du dann aber im Dashboard widerrufen, damit keine verwaisten Zugangsdaten aktiv bleiben.

Direkt nach der Registrierung hast du zwar einen Key, aber noch nicht unbedingt Guthaben. Das reicht für ungefähr 1 Million Sonnet Tokens oder rund 200.000 Opus Tokens, also mehr als genug, um Claude Code sauber zu testen, ein paar echte Coding-Sessions zu fahren und deine Toolchain zu prüfen. Wenn du nach "claude api kostenlos" suchst, ist das der sinnvollste Einstieg: kostenlos testen, Setup validieren und erst danach entscheiden, ob Pay-as-you-go oder ein Flat-Rate-Plan besser passt.

Schritt 2 — Environment Variables setzen

Claude Code liest für ein Gateway-Setup vor allem zwei Environment Variables: ANTHROPIC_BASE_URL und ANTHROPIC_API_KEY. ANTHROPIC_BASE_URL muss auf den Root Host des Gateways zeigen, also ohne zusätzlichen Pfad am Ende. Setze sie auf https://claudeapikey.dev. Der Anthropic SDK hängt /v1/messages automatisch an. Wenn du versehentlich /v1 in die Base URL einträgst, landet die Anfrage bei /v1/v1/messages und führt typischerweise zu 404-Fehlern. Das ist eine der häufigsten Ursachen, wenn der Key korrekt ist, Claude Code aber trotzdem keine Antworten bekommt.

Unter Linux oder macOS fügst du die Variablen in dein Shell Profile ein, zum Beispiel in ~/.bashrc, ~/.zshrc oder ~/.profile. Typisch sind export ANTHROPIC_BASE_URL="https://claudeapikey.dev" und export ANTHROPIC_API_KEY="your-key-here". Danach musst du entweder das Profil neu laden oder ein neues Terminal öffnen. Unter Windows setzt du die Variablen als System Environment Variables über Settings > System > Advanced system settings > Environment Variables. Alternativ kannst du sie in deinem PowerShell $PROFILE setzen, wenn du Claude Code hauptsächlich aus PowerShell heraus startest.

Für Projekt-spezifische Konfigurationen kannst du eine .env-Datei im Root deines Projekts anlegen und dort dieselben Variablen definieren. Claude Code lädt .env-Dateien aus dem aktuellen Arbeitsverzeichnis, und diese Werte haben normalerweise Vorrang vor globalen Systemvariablen. Das ist praktisch, wenn du verschiedene API-Anbieter, unterschiedliche Keys oder getrennte Budgets pro Projekt nutzt. Achte unbedingt darauf, .env in deine .gitignore aufzunehmen. Ein versehentlich committeter API Key ist ein echtes Sicherheitsproblem, weil jeder mit Repository-Zugriff deine Credits verbrauchen oder Anfragen über deinen Account senden könnte.

Wenn du bereits andere Developer Tools wie Cursor, Cline, Aider oder eigene Scripts nutzt, kannst du oft denselben Gateway-Key wiederverwenden. Entscheidend ist, dass das Tool entweder die Anthropic Messages API oder einen kompatiblen Endpoint unterstützt und dass Base URL sowie Auth Header korrekt gesetzt sind. Für Claude Code ist die Kombination aus ANTHROPIC_BASE_URL und ANTHROPIC_API_KEY der einfachste Weg. Wenn du später die claude code api kosten vergleichen möchtest, bekommst du über das Gateway-Dashboard einen besseren Überblick, weil die Nutzung zentral zusammenläuft.

Schritt 3 — Verbindung prüfen

Nachdem du die Environment Variables gesetzt hast, öffne eine neue Terminal-Session, damit die Variablen wirklich geladen werden. Starte dann Claude Code und sende eine einfache Nachricht wie "Hello, confirm you can respond." Wenn Claude antwortet, funktioniert dein Setup Ende-zu-Ende: Der API Key ist gültig, die Base URL zeigt auf das richtige Gateway, die Authentifizierung klappt und AI Prime Tech Unlimited routet deine Anfrage erfolgreich an ein Claude-Modell. Dieser erste Test sollte bewusst simpel sein, damit du Verbindungsprobleme nicht mit Prompt- oder Projektproblemen verwechselst.

Wenn die Prüfung fehlschlägt, ist die Fehlermeldung meist sehr aussagekräftig. Ein 401- oder 403-Fehler bedeutet in der Regel, dass der API Key ungültig, abgelaufen, falsch kopiert oder widerrufen wurde. Kopiere ihn erneut aus dem Dashboard oder erstelle einen neuen Key. Ein 404-Fehler weist fast immer auf eine falsche Base URL hin, besonders auf ein versehentliches /v1 am Ende oder auf doppelte Pfadbestandteile. Ein Connection refused, Timeout oder DNS-Fehler bedeutet dagegen, dass das Gateway nicht erreichbar ist. Prüfe dann Netzwerk, VPN, Proxy, Firewall oder Unternehmensrichtlinien.

Du kannst die Verbindung zusätzlich programmatisch mit curl testen. Ein direkter Request auf den Models Endpoint zeigt dir, ob Auth und Gateway unabhängig von Claude Code funktionieren: curl -H 'Authorization: Bearer YOUR_KEY' https://claudeapikey.dev/v1/models. Wenn der Request eine Liste verfügbarer Modelle zurückgibt, ist dein Key gültig und das Gateway erreichbar. Falls curl funktioniert, Claude Code aber nicht, liegt das Problem fast sicher am Laden der Environment Variables, am Shell-Kontext oder daran, dass Claude Code aus einer anderen Umgebung gestartet wird, zum Beispiel aus einer IDE, einem Terminal-Tab mit alter Session oder einem Remote-Container.

Für eine saubere Diagnose lohnt es sich, die Variablen direkt im selben Terminal zu prüfen, aus dem du Claude Code startest. Unter bash oder zsh verwendest du echo $ANTHROPIC_BASE_URL und echo $ANTHROPIC_API_KEY, wobei du den Key natürlich nicht öffentlich anzeigen solltest. Unter PowerShell nutzt du echo $env:ANTHROPIC_BASE_URL. Wenn die Base URL leer ist oder nicht exakt auf https://claudeapikey.dev zeigt, behebe zuerst das Environment-Setup. Erst wenn diese Werte stimmen, solltest du nach Modellnamen, Limits oder Account-Guthaben suchen.

Schritt 4 — Modellpräferenzen konfigurieren

Standardmäßig verwendet Claude Code seine eingebauten Modell-Auswahlen für die jeweiligen Klassen wie Sonnet, Opus oder Haiku. Du kannst diese Auswahl mit zusätzlichen Environment Variables überschreiben: ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL und ANTHROPIC_DEFAULT_FABLE_MODEL. Setze diese Werte immer auf exakt die Modell-IDs, die das Gateway unterstützt. Modellnamen sind keine freien Labels, sondern konkrete Identifier. Schon ein Bindestrich zu viel, eine alte Versionsnummer oder abweichende Groß-/Kleinschreibung kann dazu führen, dass Claude Code ein "model not found" zurückbekommt.

Für die meisten Entwickler reicht ein pragmatisches Setup: ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 und ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6. Claude Code nutzt Sonnet für viele alltägliche Interaktionen, weil es schnell und stark genug für typische Coding-Aufgaben ist. Opus kommt ins Spiel, wenn du es über den /model-Befehl auswählst oder wenn ein stärkeres Modell für Planung, Architektur oder komplexe Refactorings sinnvoll ist. AI Prime Tech Unlimited unterstützt die aktuellen Claude-Modellversionen, sodass du je nach Aufgabe zwischen Geschwindigkeit, Qualität und Kostenprofil wechseln kannst.

Aktiviere außerdem die Gateway Model Discovery mit CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1. Dadurch fragt Claude Code das Gateway nach verfügbaren Modellen, statt sich ausschließlich auf eine hart codierte Liste zu verlassen. Das ist besonders nützlich, wenn neue Claude-Versionen verfügbar werden oder ein Gateway mehrere Modellvarianten anbietet. Zusätzlich empfiehlt sich CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, damit nicht notwendiger Traffic wie Telemetrie nicht über das Gateway läuft. Das reduziert Rauschen im Dashboard, hält Logs übersichtlicher und kann die Latenz minimal verbessern.

Wenn du planst, Claude Code intensiv zu nutzen, solltest du Modellpräferenzen nicht nur technisch, sondern auch wirtschaftlich betrachten. Viele Suchen nach "claude api kosten" oder "claude code api kosten" entstehen, weil Token-basierte Abrechnung bei langen Coding-Sessions schwer vorhersehbar ist. Ein Gateway mit Gratisguthaben und optionalem Flat-Rate-Zugang macht Tests einfacher: Du kannst Sonnet für tägliche Arbeit nutzen, Opus gezielt für schwierige Aufgaben einsetzen und anschließend entscheiden, ob Pay-as-you-go oder ein unbegrenzter Claude Zugang besser zu deinem Workflow passt.

Häufige Auth-Fehler beheben

Das häufigste Problem ist, dass Environment Variables nicht geladen wurden. Nachdem du Variablen in deinem Shell Profile gesetzt hast, musst du ein neues Terminal öffnen oder das Profil neu laden. Bestehende Terminals behalten ihre alte Umgebung. Unter Windows reicht manchmal ein neuer Tab nicht aus; du musst die Terminal-App komplett neu starten oder dich neu anmelden, damit Systemvariablen übernommen werden. Prüfe die Werte mit echo $ANTHROPIC_BASE_URL unter bash/zsh oder echo $env:ANTHROPIC_BASE_URL in PowerShell. Wenn dort nichts steht, kann Claude Code den Wert ebenfalls nicht sehen.

Wenn du trotz gültiger Verbindung "model not found" bekommst, passt der Modell-Identifier nicht zu dem, was das Gateway anbietet. Modell-IDs sind versionsspezifisch und case-sensitive. Prüfe im Dashboard oder über den /v1/models Endpoint, welche Identifier exakt unterstützt werden. Häufige Fehler sind alte Namen wie "claude-3-opus" statt "claude-opus-4-6", ein unvollständiger Sonnet-Identifier oder zusätzliche Leerzeichen am Ende des env var Werts. Kopiere Modellnamen am besten direkt aus der Model-Liste, statt sie aus Blogposts, alten Docs oder Chatverläufen abzutippen.

Rate-Limit-Fehler oder 429-Antworten direkt nach dem Setup bedeuten meistens, dass dein Gratisguthaben aufgebraucht ist, kein aktiver Plan vorhanden ist oder dein Account-Limit erreicht wurde. Prüfe im Dashboard dein Guthaben und die aktive Subscription. Wenn du ohne Unterbrechung weiterarbeiten willst, kannst du Pay-as-you-go-Guthaben hinzufügen oder auf einen Unlimited-Plan wechseln, zum Beispiel 1 Tag für $9 oder 1 Woche für $39, mit Flat-Rate-Zugang zu allen Modellen ohne klassische Per-Token-Abrechnung.

Ein weiterer Stolperstein sind mehrere konkurrierende Konfigurationsquellen. Wenn du globale Environment Variables, eine .env-Datei, IDE-Settings und vielleicht noch ein CI-Secret gleichzeitig nutzt, kann Claude Code andere Werte lesen, als du erwartest. Entferne testweise doppelte Einträge oder starte Claude Code aus einem minimalen Terminal, in dem du die Variablen explizit setzt. So findest du schnell heraus, ob ein alter Key, eine falsche Base URL oder ein Projekt-spezifischer Override das Problem verursacht. Für ein stabiles Setup lohnt es sich, Keys eindeutig zu benennen, .env-Dateien sauber zu versionieren ohne Secrets und Team-Regeln festzulegen, wann Keys rotiert werden.

# Zu ~/.bashrc oder ~/.zshrc hinzufügen:
export ANTHROPIC_BASE_URL="https://claudeapikey.dev"
export ANTHROPIC_API_KEY="your-key-from-dashboard"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Verbindung prüfen:
# $ source ~/.bashrc && claude
# Oder das Gateway direkt testen:
# $ curl -H "x-api-key: $ANTHROPIC_API_KEY" https://claudeapikey.dev/v1/models

FAQ

Brauche ich einen separaten Key für Claude Code und andere Tools?
Nein. Derselbe API Key funktioniert für Claude Code, Cursor, Cline, Aider und andere Tools, die die Anthropic Messages API oder einen OpenAI-kompatiblen Endpoint nutzen. Ein Key kann mehrere Developer Tools bedienen.

Soll ANTHROPIC_BASE_URL /v1 enthalten?
Nein. Setze nur den Root Host: https://claudeapikey.dev. Der Anthropic SDK hängt /v1/messages automatisch an. Wenn du /v1 einfügst, entsteht ein doppelter Pfad und die Anfrage endet typischerweise mit 404.

Was passiert, wenn mein Gratisguthaben aufgebraucht ist?
Claude Code gibt dann Rate-Limit- oder Insufficient-Balance-Fehler zurück. Du kannst im Dashboard Pay-as-you-go-Guthaben hinzufügen oder auf einen Unlimited-Plan wechseln, zum Beispiel 1 Tag für $9 oder 1 Woche für $39.

Kann ich denselben Key auf mehreren Geräten nutzen?
Ja. Ein Key funktioniert gleichzeitig auf mehreren Geräten. Alle Anfragen zählen aber zum selben Account-Guthaben und denselben Rate Limits. Für Teams sind separate Keys pro Entwickler besser, damit Tracking und Sperrung sauber bleiben.