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.

# 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

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.