Source: https://aiprimetech.io/de/learn/claude-code-api-key-setup/ [Startseite](/de/) / [Lernen](/de/learn/) / Claude Code API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn und wann Sie stattdessen claude setup-token verwenden sollten # Claude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden sollten Claude Code benötigt einen API-Schlüssel, um zu funktionieren. Ob Sie Claude Code zum ersten Mal einrichten oder von einem direkten Anthropic-Konto zu einem Gateway mit Pauschaltarif wechseln: Der Vorgang umfasst das Erstellen eines Schlüssels, das Konfigurieren von zwei Umgebungsvariablen und das Überprüfen der Verbindung. ## Claude Code API-Schlüssel: die Kurzfassung Ein Claude Code API-Schlüssel ist ein gewöhnlicher Schlüssel im Anthropic-Format (sk-...), den Claude Code aus ANTHROPIC_API_KEYliest. Erstellen Sie einen in der Claude Console (Einstellungen → API-Schlüssel, wird nur einmal angezeigt) oder im Dashboard dieses Gateways (jederzeit sichtbar), exportieren Sie ihn, und Claude Code startet ohne Browser-Anmeldung. Bei einem Gateway-Schlüssel setzen Sie außerdem ANTHROPIC_BASE_URL auf den Gateway-Host. Damit ist die Einrichtung abgeschlossen; der Rest dieser Seite erläutert die Details — den Unterschied zwischen einem API-Schlüssel, dem OAuth-Token aus /login und einem claude.ai-Sitzungsschlüssel, die Schritte für die einzelnen Betriebssysteme und die Fehler, auf die Nutzer stoßen. ## Was ist ein Claude Code API-Schlüssel? Ein Claude Code API-Schlüssel ist der Authentifizierungsnachweis, mit dem die Claude Code CLI Anfragen an einen Claude-Modellanbieter senden kann. Ohne ihn gibt jeder Befehl, den Sie in Claude Code ausführen, einen Authentifizierungsfehler zurück. Der Schlüssel ist eine Zeichenfolge, die Sie in einer Umgebungsvariablen speichern — entweder ANTHROPIC_API_KEY (wird als x-api-key-Header gesendet) oder ANTHROPIC_AUTH_TOKEN (wird als Bearer-Token gesendet). Beide funktionieren mit AI Prime Tech. Wenn Sie ein Gateway wie AI Prime Tech statt Anthropic direkt verwenden, stammt der Schlüssel aus dem Gateway-Dashboard und nicht aus der Anthropic Console. Das Schlüsselformat kann abweichen, aber der Einrichtungsvorgang in Claude Code ist identisch: Setzen Sie den Schlüssel in Ihrer Umgebung, richten Sie die Basis-URL auf das Gateway aus, und Claude Code übernimmt den Rest. Ihr Schlüssel ist an das Guthaben oder Abonnement Ihres Gateway-Kontos gebunden, nicht an die Abrechnung von Anthropic. Ein Schlüssel kann gleichzeitig auf mehreren Rechnern und in mehreren Claude Code-Sitzungen verwendet werden. Wenn Sie einen Schlüssel jedoch im Team teilen, wird die gesamte Nutzung auf die Ratenlimits und das Guthaben desselben Kontos angerechnet. Erstellen Sie für Teamkonfigurationen im Dashboard einen separaten Schlüssel pro Entwickler, damit Nutzungserfassung und Ratenbegrenzung für jede Person korrekt funktionieren. ## API-Schlüssel vs. OAuth-Token — und was ein „Sitzungsschlüssel“ ist Claude Code akzeptiert zwei Arten von Authentifizierungsnachweisen. Ein API-Schlüssel (ANTHROPIC_API_KEY oder ANTHROPIC_AUTH_TOKEN, das als Bearer-Token gesendet wird) wird pro Token gegen ein API-Guthaben abgerechnet — diesen verwenden Sie mit einem Gateway. Ein OAuth-Token stammt aus einem Claude Pro- oder Max-Abonnement: /login meldet Sie innerhalb von Claude Code an, und claude setup-token erstellt ein langlebiges Token, das Sie in CI oder auf einem Rechner ohne grafische Oberfläche verwenden können, sodass das Abonnement statt eines API-Guthabens genutzt wird. Ein „Claude-Sitzungsschlüssel“ ist keines von beiden: Er ist das Browser-Sitzungscookie von claude.ai, das einige inoffizielle Clients auslesen, um die Chat-Oberfläche zu steuern. Er ist kein API-Authentifizierungsnachweis, seine Verwendung verstößt gegen die Nutzungsbedingungen für Privatkunden, er läuft ab und kann zur Sperrung des Kontos führen. Wenn Sie programmatischen Zugriff benötigen, verwenden Sie einen API-Schlüssel — aus der Anthropic Console oder von einem Gateway wie diesem. ## Schritt 1 — Schlüssel erhalten: Claude Console oder Gateway-Dashboard An zwei Stellen können Sie einen Schlüssel erstellen, den Claude Code akzeptiert. Öffnen Sie in der Claude Console (der Claude-Plattform unter platform.claude.com) Einstellungen → API-Schlüssel, klicken Sie auf Schlüssel erstellen, geben Sie ihm einen Namen und kopieren Sie den geheimen Schlüsselwert — die Console zeigt ihn nur einmal an und führt anschließend nur noch den Namen und das Präfix auf. Die Schlüsselverwaltung bedeutet dort daher, einen neuen Schlüssel zu erstellen, statt einen alten abzurufen. Claude Code benötigt einen regulären Schlüssel; ein Admin-API-Schlüssel ist ein anderer Authentifizierungsnachweis zur Verwaltung einer Organisation und authentifiziert keine Anfragen. Führen Sie anschließend export ANTHROPIC_API_KEY=sk-ant-... in Ihrer Shell aus, und Claude Code verwendet ihn ohne /login. Anthropic rechnet pro Token ab und benötigt zunächst eine Zahlungsmethode im Konto. Der schnellere Weg ist ein Gateway-Schlüssel: Registrieren Sie sich unter aiprimetech.io, öffnen Sie API-Schlüssel im Dashboard und klicken Sie auf Erstellen. Der Schlüssel ist jederzeit im Dashboard sichtbar — Sie können ihn beliebig oft erneut kopieren, umbenennen oder widerrufen. Er hat dasselbe sk- Format und funktioniert mit derselben Variablen; der einzige zusätzliche Schritt ist ANTHROPIC_BASE_URL, der in Schritt 2 beschrieben wird. Zu diesem Zeitpunkt haben Sie einen Schlüssel, aber noch kein Guthaben. Laden Sie vor dem Testen einen kleinen Betrag auf — die Modellseite zeigt, was Sie pro Modell für einen Dollar erhalten — oder wählen Sie unter /plans/ einen unbegrenzten Tarif, wenn Sie bereits wissen, dass Sie Claude Code den ganzen Tag nutzen werden. ## Schritt 2 — Umgebungsvariablen setzen Claude Code liest zwei Umgebungsvariablen für die Gateway-Konfiguration: ANTHROPIC_BASE_URL und ANTHROPIC_API_KEY. Setzen Sie ANTHROPIC_BASE_URL auf den Root-Host des Gateways ohne angehängten Pfad. Das Anthropic SDK hängt /v1/messages automatisch an — wenn Sie /v1 in die Basis-URL aufnehmen, werden Anfragen an /v1/v1/messages gesendet und geben 404-Fehler zurück. Fügen Sie unter Linux oder macOS diese Zeilen zu Ihrem Shell-Profil (~/.bashrc, ~/.zshrc oder ~/.profile) hinzu: export ANTHROPIC_BASE_URL="https://aiprimetech.io" und export ANTHROPIC_API_KEY="ihr-schlüssel-hier". Setzen Sie sie unter Windows als Systemumgebungsvariablen über Einstellungen > System > Erweiterte Systemeinstellungen > Umgebungsvariablen oder fügen Sie sie zu Ihrem PowerShell-$PROFILE hinzu. Erstellen Sie für eine projektspezifische Konfiguration eine .env-Datei im Stammverzeichnis Ihres Projekts mit denselben Variablen. Claude Code lädt .env-Dateien aus dem Arbeitsverzeichnis; diese haben Vorrang vor Variablen auf Systemebene. Das ist nützlich, wenn Sie für verschiedene Projekte unterschiedliche API-Anbieter verwenden. Fügen Sie .env unbedingt zu Ihrer .gitignore hinzu, damit Sie Ihren Schlüssel nicht versehentlich in die Versionsverwaltung einchecken. ## Schritt 3 — Verbindung überprüfen Öffnen Sie nach dem Setzen der Umgebungsvariablen eine neue Terminalsitzung, damit die Variablen geladen werden, und starten Sie Claude Code. Geben Sie eine einfache Nachricht wie „Hallo, bestätige, dass du antworten kannst.“ ein. Wenn Sie eine Antwort von Claude erhalten, funktioniert Ihre Einrichtung durchgängig. Der Schlüssel ist gültig, die Basis-URL ist korrekt, und das Gateway leitet Ihre Anfrage erfolgreich an Claude weiter. Wenn die Überprüfung fehlschlägt, zeigt die Fehlermeldung, was schiefgelaufen ist. Ein 401- oder 403-Fehler bedeutet, dass der API-Schlüssel ungültig oder abgelaufen ist — kopieren Sie ihn erneut aus dem Dashboard. Ein 404-Fehler bedeutet fast immer, dass die Basis-URL falsch ist — prüfen Sie, ob versehentlich /v1 angehängt wurde oder abschließende Schrägstriche vorhanden sind. Ein Fehler wegen einer abgelehnten Verbindung bedeutet, dass das Gateway nicht erreichbar ist — prüfen Sie Ihre Netzwerk-, VPN- oder Firewall-Einstellungen. Sie können die Verbindung auch programmatisch überprüfen, indem Sie den Status-Endpunkt des Gateways mit curl aufrufen: curl -H 'Authorization: Bearer YOUR_KEY' https://aiprimetech.io/v1/models — dies gibt die Liste der verfügbaren Modelle zurück, wenn Ihr Schlüssel gültig ist. Wenn dies funktioniert, Claude Code aber nicht, liegt das Problem beim Laden Ihrer Umgebungsvariablen und nicht beim Schlüssel oder Gateway selbst. ## Schritt 4 — Modellpräferenzen konfigurieren Standardmäßig verwendet Claude Code seine integrierte Modellauswahl für jede Stufe (Sonnet, Opus, Haiku). Sie können diese mit zusätzlichen Umgebungsvariablen überschreiben: ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL und ANTHROPIC_DEFAULT_FABLE_MODEL. Setzen Sie diese auf die exakten Modellkennungen, die das Gateway unterstützt. Für die meisten Entwickler reicht es aus, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 und ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6 zu setzen. Claude Code verwendet für die meisten Interaktionen standardmäßig Sonnet und nutzt Opus, wenn Sie es über den Befehl /model auswählen oder wenn der Planungsmodus auf ein leistungsfähigeres Modell umschaltet. Das Gateway unterstützt alle aktuellen Claude-Modellversionen. Aktivieren Sie die Modellerkennung über das Gateway, indem Sie CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 setzen. Dadurch fragt Claude Code die verfügbaren Modelle beim Gateway ab, statt eine fest einprogrammierte Liste zu verwenden. Setzen Sie außerdem CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, um zu verhindern, dass Telemetrieanfragen an das Gateway gesendet werden — das reduziert unnötigen Datenverkehr und verbessert die Anfragelatenz geringfügig. ## Häufige Authentifizierungsfehler beheben Das häufigste Problem ist, dass Umgebungsvariablen nicht geladen werden. Nachdem Sie sie in Ihrem Profil gesetzt haben, müssen Sie ein neues Terminal öffnen — bestehende Terminals verwenden die alte Umgebung. Unter Windows müssen Sie möglicherweise Ihre Terminalanwendung vollständig neu starten, statt nur einen neuen Tab zu öffnen. Prüfen Sie dies mit echo $ANTHROPIC_BASE_URL (bash/zsh) oder echo $env:ANTHROPIC_BASE_URL (PowerShell). Wenn Sie trotz gültiger Verbindung die Fehlermeldung „Modell nicht gefunden“ erhalten, stimmt die Modellkennung nicht mit dem Angebot des Gateways überein. Bei Modell-IDs wird zwischen Groß- und Kleinschreibung unterschieden, und sie sind versionsspezifisch. Prüfen Sie im Dashboard oder am Endpunkt /v1/models die exakt unterstützten Kennungen. Häufige Fehler sind die Verwendung von 'claude-3-opus' statt 'claude-opus-4-6' oder zusätzliche Leerzeichen im Wert der Umgebungsvariablen. Prüfen Sie Ihr Guthaben im Dashboard. Um ohne Unterbrechung fortzufahren, laden Sie entweder nutzungsbasiert abgerechnetes Guthaben auf oder wechseln Sie zu einem unbegrenzten Tarif — 1 Tag ($9) oder 1 Woche ($39) für den Zugriff auf alle Modelle zum Festpreis ohne Abrechnung pro Token. Kopieren ``` # Add to ~/.bashrc or ~/.zshrc: export ANTHROPIC_BASE_URL="https://aiprimetech.io" 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 # Verify connection: # $ source ~/.bashrc && claude # Or test the gateway directly: # $ curl -H "x-api-key: $ANTHROPIC_API_KEY" https://aiprimetech.io/v1/models ``` ## Häufig gestellte Fragen ANTHROPIC_API_KEY — wie erhält man ihn? Erstellen Sie entweder einen Schlüssel in der Claude Console (Einstellungen → API-Schlüssel → Schlüssel erstellen; kopieren Sie den geheimen Schlüsselwert einmalig) oder hier im Gateway-Dashboard, wo er sichtbar bleibt. Exportieren Sie ihn als ANTHROPIC_API_KEY; setzen Sie bei einem Gateway-Schlüssel außerdem ANTHROPIC_BASE_URL. Brauche ich für Claude Code einen anderen Schlüssel als für andere Tools? Nein. Derselbe API-Schlüssel funktioniert mit Claude Code, Cursor, Cline, Aider und jedem anderen Tool, das die Anthropic Messages API oder einen OpenAI-kompatiblen Endpunkt verwendet. Ein Schlüssel, mehrere Tools. Ist ein Claude-Sitzungsschlüssel dasselbe wie ein API-Schlüssel? Nein. Ein Sitzungsschlüssel ist das Browser-Cookie claude.ai, das inoffizielle Clients verwenden; ein API-Schlüssel ist der Zugangsnachweis, den die API und Claude Code erwarten. Nur der API-Schlüssel wird unterstützt, abgerechnet und ist stabil. Wie erhalte ich einen ANTHROPIC_API_KEY? Über die Konsole von Anthropic (Abrechnung zum Listenpreis über Ihr Anthropic-Konto) oder über das Dashboard dieses Gateways (Abrechnung über unter dem Nennwert gekauftes Guthaben oder einen unbegrenzten Tarif). Beide werden in die Umgebungsvariable ANTHROPIC_API_KEY eingetragen. Was bewirkt claude setup-token bewirken? Es erstellt ein langlebiges OAuth-Token für ein Claude-Abonnement, damit Claude Code in CI oder ohne Benutzeroberfläche und ohne interaktive Anmeldung ausgeführt werden kann. Dabei wird das Nutzungskontingent des Abonnements statt API-Guthaben verwendet; bei einem Gateway verwenden Sie stattdessen einen API-Schlüssel. Sollte ANTHROPIC_BASE_URL /v1 enthalten? Nein. Setzen Sie den Wert nur auf den Stammhost: https://aiprimetech.io — das Anthropic SDK hängt /v1/messages automatisch an. Wenn Sie /v1 angeben, entsteht ein doppelter Pfad, der 404-Fehler verursacht. Kann ich denselben Schlüssel auf mehreren Rechnern verwenden? Ja. Ein Schlüssel funktioniert gleichzeitig auf all Ihren Geräten. Die gesamte Nutzung wird auf das Guthaben und die Anfragelimits desselben Kontos angerechnet. Erstellen Sie für Teams separate Schlüssel pro Entwickler, um die Nutzung unabhängig nachzuverfolgen. Claude in wenigen Minuten nutzen Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.[API-Schlüssel erhalten](/register) AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber. ## Weitere Anleitungen zur Claude API [So erhalten Sie einen Claude API-Schlüssel](/de/learn/how-to-get-a-claude-api-key/)[Claude-API-Preise erklärt](/de/learn/claude-api-pricing-explained/)[Die günstigste Möglichkeit, die Claude API zu nutzen](/de/learn/cheapest-way-to-use-claude-api/)[Cursor unbegrenzt mit der Claude API nutzen](/learn/use-claude-api-with-cursor/)[Unbegrenzter Zugang zu Claude Code](/de/learn/use-claude-api-with-claude-code/)[Claude API-Gateway vs. direkter Zugang zu Anthropic](/de/learn/claude-api-vs-anthropic-direct/)[Claude über eine OpenAI-kompatible API nutzen](/de/learn/openai-compatible-claude-api/)[Claude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)](/de/learn/claude-api-models-compared/)[Die Claude API mit Kryptowährungen bezahlen](/de/learn/claude-api-with-crypto-payment/)[Zugang zur Claude API ohne Warteliste](/de/learn/claude-api-without-waitlist/)[So reduzieren Sie den Token-Verbrauch von Claude](/de/learn/how-to-reduce-claude-token-usage/)[Cline unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-cline/)[Roo Code unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-roo-code/)[Claude unbegrenzt in JetBrains-IDEs nutzen](/de/learn/use-claude-api-with-jetbrains/)[Aider unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-aider/)[Claude unbegrenzt in VS Code nutzen](/de/learn/use-claude-api-with-vscode/)[OpenCode unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-opencode/)[Einen unbegrenzten Hermes-Agenten mit Claude betreiben](/de/learn/run-hermes-agent-with-claude-api/)[OpenClaw unbegrenzt mit Claude betreiben](/de/learn/run-openclaw-with-claude-api/)[Was eine Anthropic-kompatible API bedeutet](/de/learn/anthropic-compatible-api/)[Claude Code-API-Kosten — Preise und Möglichkeiten zur Kostensenkung](/de/learn/claude-code-api-costs/)[Claude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige Lösung](/de/learn/claude-api-errors-troubleshooting/)[So kaufen Sie Claude API-Guthaben – und warum Claude-Guthaben besser ist als jedes Angebot zum „Kauf eines Claude-Kontos“](/de/learn/buy-claude-api-credits/)[Kostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?](/de/learn/claude-api-free-trial/)[Claude API vs. Claude Pro/Max-Abonnement — welche Option wählen?](/de/learn/claude-api-vs-subscription/)[Die Codex CLI mit Claude ausführen](/de/learn/use-claude-api-with-codex/)[Claude mit n8n verbinden](/de/learn/use-claude-api-with-n8n/)[LiteLLM-Anfragen an Claude weiterleiten](/de/learn/use-claude-api-with-litellm/)[Claude in Kilo Code verwenden](/de/learn/use-claude-api-with-kilo-code/)[Claude in GitHub Copilot integrieren](/de/learn/use-claude-api-with-github-copilot/)[Zed über das Gateway mit Claude verbinden](/de/learn/use-claude-api-with-zed/)[Cherry Studio mit Claude verbinden](/de/learn/use-claude-api-with-cherry-studio/)[LangChain auf Claude über das Gateway ausrichten](/de/learn/use-claude-api-with-langchain/)[Factory Droid mit Claude betreiben](/de/learn/use-claude-api-with-factory-droid/)[Die Claude Code API erklärt](/de/learn/claude-code-api/)[Die Claude API in Ihre Anwendung integrieren](/de/learn/claude-api-integration/)[So nutzen Sie Claude unbegrenzt – und warum es kein „gecracktes Claude Code“ gibt](/de/learn/get-unlimited-claude-usage/)