Claude API: Key, Bedrock, Vertex oder Foundry
Die Anleitung erklärt vier Wege für die Claude API auf einem VPS: Anthropic-Key, AWS-IAM, Google-ADC und Microsoft-Entra. Wichtig: Bedrock nutzt keinen Anthropic-Key.
Die Authentifizierungswege der Claude API
Bei der Authentifizierung der Claude API kommt es auf eine Entscheidung an: Welche Zugangsdaten sendet Ihr Client über das Netzwerk? Anthropic führt neben der direkten Claude API fünf Cloud-Plattformen auf: Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (Google managed), Claude Models on Google Cloud (Anthropic managed) und Microsoft Foundry. Die direkte Anthropic API akzeptiert einen API-Schlüssel oder ein kurzlebiges Token im Header Authorization: Bearer. API-Schlüssel im älteren Header x-api-key werden weiterhin akzeptiert. Amazon Bedrock unterstützt die AWS-Anforderungssignierung und Bedrock API keys. In dieser Konfiguration gibt es an keiner Stelle einen Anthropic-Schlüssel. Google Cloud sendet ein kurzlebiges Google-Zugriffstoken. Microsoft Foundry verwendet einen von Azure ausgestellten Schlüssel oder ein Microsoft Entra-Token. Die vier folgenden Abschnitte behandeln diese Zugangsdaten-Konfigurationen. Die separaten, von Anthropic verwalteten Angebote für AWS und Google Cloud werden zusammen mit den jeweiligen Cloud-Varianten erklärt.
Diese Anleitung beschreibt, wie Sie ein SDK (Software Development Kit) in einen Dienst auf einem Linux-Server integrieren. Wenn Sie stattdessen das Befehlszeilentool Claude Code konfigurieren, sind Variablen und Ablauf anders: Siehe Claude Code auf Bedrock oder Vertex ausrichten. Wenn der Dienst noch nicht existiert, erstellen Sie ihn zunächst mit eine erste Claude API-Anwendung auf einem VPS und kehren Sie anschließend für die Zugangsdaten hierher zurück.
Alle folgenden Angaben wurden im August 2026 anhand der Plattformdokumentation von Anthropic geprüft und am 16 October 2026 erneut mit der Dokumentation jedes Anbieters abgeglichen. Die Details zum Modellzugriff in Bedrock wurden am 19 October 2026 nochmals anhand der AWS-Dokumentation geprüft. Die Seiten von Anthropic zu allen vier Wegen, zu API-Schlüsseln und zu API-Versionen wurden am 27 October 2026 erneut geprüft. Die Seiten von Anthropic zu Microsoft Foundry, beiden Bedrock-Endpunkten, dem von Google verwalteten Weg, Claude Platform on AWS, zur Authentifizierung, zu Workload Identity Federation und zu API-Versionen wurden am 10 November 2026 erneut geprüft, ebenso das Changelog des Ruby SDK. Modell-IDs, Preise, SDK-Versionen und Endpunktstrukturen ändern sich regelmäßig. Daher verweist diese Anleitung auf die Seiten der Anbieter, statt Werte auszugeben, die veralten.
Route 1: ein Anthropic API key
Dies ist der direkte Weg und der einzige, bei dem Anthropic das Secret ausstellt. Die Requests gehen an den Messages-Endpunkt auf Anthropic's API-Host, und jeder Request enthält drei Header.
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "MODEL_ID", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'Ersetzen Sie MODEL_ID durch eine aktuelle Kennung aus Anthropic's models overview. Eine erfolgreiche Antwort ist JSON und enthält ein content-Array sowie ein usage-Objekt. Ein falscher oder abgelaufener Key führt zu HTTP 401 mit authentication_error. Ein fehlender anthropic-version-Header ist ein separater Fehler, weil dieser Header bei jedem Request erforderlich ist; die SDKs setzen ihn automatisch. Im Oktober 2026 stellt Anthropic's Dokumentation Authorization: Bearer als wichtigste Möglichkeit zum Übertragen des Keys dar und bezeichnet x-api-key als veraltet. Beide werden jedoch akzeptiert, daher funktioniert der obige Befehl weiterhin. Die aktuellen großen SDK-Versionen übertragen den Key ebenfalls als Authorization: Bearer. Ein Proxy oder Gateway, das X-Api-Key ausliest, muss daher beim Upgrade angepasst werden. Die im Befehl verwendete Version 2023-06-01 wird weiterhin akzeptiert. Anthropic's neueste API-Version ist 2026-10-21. Diese Version wird von den genannten SDK-Versionen standardmäßig verwendet und lehnt einige ältere Request-Parameter wie temperature ab.
Die Client-Erstellung ist bei diesen Setups am kürzesten, weil nichts konstruiert werden muss. Jedes offizielle SDK liest ANTHROPIC_API_KEY selbstständig aus der Umgebung.
import os
from anthropic import Anthropic
client = Anthropic() # reads ANTHROPIC_API_KEY from the environment
message = client.messages.create(
model=os.environ["CLAUDE_MODEL"],
max_tokens=64,
messages=[{"role": "user", "content": "Hello"}],
)
print(message.usage)Es ist sinnvoll, die Modellkennung neben dem Key in der Umgebung zu hinterlegen. Modellnamen ändern sich nach einem Zeitplan, den Sie nicht kontrollieren. Ein erneutes Deployment des Codes, nur um eine Zeichenfolge zu ändern, lässt sich vermeiden.
Keys werden in der Console erstellt. Dabei wählen Sie den Ablaufzeitpunkt: Voreinstellungen von 3 Stunden, 1 Tag, 7 Tagen oder 30 Tagen, eine benutzerdefinierte Dauer oder Never, abhängig von der maximalen Ablaufregel Ihrer Organisation. Der Ablaufzeitpunkt wird bei der Erstellung festgelegt und kann später nicht geändert werden. Anthropic informiert den Ersteller eines langlebigen Keys vor dessen Ablauf per E-Mail. Ein Key mit kurzer Gültigkeitsdauer läuft dagegen ohne Warn-E-Mail ab. Ein abgelaufener Key führt zu 401 und kann nicht reaktiviert werden. Die Lösung ist daher immer ein neuer Key.
Bei der direkten API müssen Sie keine Region auswählen. Die Abrechnung erfolgt direkt über Ihre Anthropic-Organisation. Workspaces beschränken einen Key auf ein Projekt. Damit lässt sich am klarsten nachvollziehen, welche Kosten ein einzelner Dienst verursacht. Beschränken Sie den Key eines Servers bei der Erstellung auf dessen Workspace. Ein persönlicher oder Service-Account-Key ohne Workspace-Zuordnung muss bei jedem Request einen anthropic-workspace-id-Header senden. Andernfalls antwortet die API mit 400 und invalid_request_error. Wählen Sie für einen Dienst einen Service-Account-Key. Ein persönlicher Key funktioniert nicht mehr, wenn die Person, die ihn erstellt hat, die Organisation verlässt. Die Berechnung hinter diesen Kosten wird unter dem Vergleich der API-Preise pro Token mit einem Abonnement erklärt.
Eine weitere Option gehört an diese Stelle, weil sie das statische Secret vollständig entfernt. Workload Identity Federation ermöglicht es einem Workload, ein OpenID Connect (OIDC)-Token eines bereits vertrauenswürdigen Identity Providers gegen ein kurzlebiges Anthropic-Token bei POST /v1/oauth/token einzutauschen. Das SDK erneuert dieses Token, bevor es abläuft. Es wird niemals eine sk-ant-api...-Zeichenfolge erstellt oder irgendwo kopiert. Das eignet sich für Kubernetes, GitHub Actions und Cloud-VMs, die bereits eine Plattformidentität besitzen. Ein einfacher VPS hat normalerweise keinen solchen Issuer. Auf diesem System ist ein API-Key in einer Datei daher die sachgerechte Lösung, und der restliche Leitfaden geht davon aus.
Route 2: AWS-Anmeldedaten in Amazon Bedrock
In Bedrock benötigen Sie keinen Anthropic-Schlüssel. Mit AWS-Anmeldedaten signiert das SDK jede HTTP-Anfrage mit AWS Signature Version 4 (SigV4). AWS entscheidet dann, ob dieser Aufrufer das Modell verwenden darf.
pip install -U "anthropic[bedrock]"
aws sts get-caller-identityaws sts get-caller-identity gibt die Kontonummer und den ARN (Amazon Resource Name) der Identität aus, die Ihre Anmeldedaten ergeben. Führen Sie den Befehl bei der Verwendung von SigV4 vor allen anderen Schritten aus. Für SigV4 löst das SDK Anmeldedaten aus dem Konstruktor, Umgebungsvariablen und der standardmäßigen AWS-Anmeldedatenkette auf. Die Auswahl der Region erfolgt davon getrennt. Im Python-AnthropicBedrock-Client führt ein als api_key oder über AWS_BEARER_TOKEN_BEDROCK bereitgestellter Bedrock-API-Schlüssel zu ValueError, wenn Sie gleichzeitig aws_access_key, aws_secret_key, aws_session_token oder aws_profile übergeben. Ohne diese expliziten Argumente wählt der Schlüssel die Bearer-Authentifizierung anstelle der AWS-Anmeldedatenkette. Der TypeScript-Client gibt dem Bedrock-API-Schlüssel Vorrang vor expliziten AWS-Anmeldedaten. Der STS-Befehl testet keine Bearer-Authentifizierung.
Bei der Client-Erstellung ändern sich die Klasse und ein Argument.
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-east-1")AnthropicBedrock steuert die InvokeModel-Integration von Bedrock. Seit Oktober 2026 dokumentiert Anthropic außerdem Claude in Amazon Bedrock: einen Messages-API-Endpunkt unter https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages für Claude Opus 4.7 und spätere Modelle, der über einen AnthropicBedrockMantle-Client aus demselben Paket erreicht wird. Er unterstützt AWS-Anmeldedaten und Bedrock-Bearer-Tokens. Die Voraussetzungen für den Modellzugriff unterscheiden sich bei den beiden Endpunkten, wie weiter unten erklärt.
Beachten Sie die Änderung in der Zeile pip install -U. Seit dem 27. Oktober 2026 sendet das aktuelle SDK standardmäßig die API-Version 2026-10-21, auch über Bedrock. Anthropic dokumentiert, dass die ARN-versionierten Modell-IDs für Claude Opus 4.6 und frühere Versionen, die dort aufgeführt sind, diese Version in Bedrock nicht unterstützen und einen 400-Fehler zurückgeben können. Wenn ein Dienst eines dieser Modelle verwendet, belassen Sie das SDK bei der derzeit verwendeten Version und pinnen Sie diese. Alternativ migrieren Sie den Dienst zuerst auf ein Modell der Version Claude 4.7 oder höher.
Die Region ist hier nicht nur eine Formalität. Bedrock-Endpunkte gelten jeweils für eine Region. Die verfügbaren Claude-Modelle unterscheiden sich je nach Region. Außerdem ist die Region Teil der SigV4-Signatur. Eine für eine Region berechnete Signatur wird daher von einer anderen Region abgewiesen. Setzen Sie AWS_REGION in der Dienstumgebung explizit, weil sich die SDKs bei einer fehlenden Angabe unterschiedlich verhalten. Wie im Oktober 2026 dokumentiert, liest der Python-AnthropicBedrock-Client AWS_REGION oder AWS_DEFAULT_REGION. Danach verwendet er die Region Ihrer boto3-Sitzung oder Ihres AWS-Profils, einschließlich ~/.aws/config, und löst ValueError aus, wenn keine Region ermittelt werden kann. Der TypeScript-Client liest AWS_REGION und verwendet us-east-1, wenn diese Variable nicht gesetzt ist. Für die Region liest er ~/.aws/config nicht. Deshalb kann die AWS CLI auf demselben Rechner Claude-Modelle erfolgreich auflisten, während ein Node-Prozess die falsche Region verwendet: Die CLI hat Ihre Konfigurationsdatei gelesen, der Client jedoch nicht.
Auf einer EC2-Instanz weisen Sie eine IAM-Rolle (Identity and Access Management) zu. Es wird kein Geheimnis auf der Festplatte gespeichert, weil der Instance Metadata Service das SDK mit temporären Anmeldedaten versorgt. Ein VPS außerhalb von AWS hat weder eine Instance-Rolle noch einen Metadata Service. Dann müssen Sie zwischen einem langfristig gültigen Zugriffsschlüsselpaar eines IAM-Benutzers und einer Föderation wählen. Beim Zugriffsschlüsselpaar liegt auf dem System dieselbe Art von Geheimnis wie bei einem Anthropic-Schlüssel. Bei einer Föderation authentifizieren Sie sich bei Ihrem Identity Provider, rufen AWS STS (Security Token Service) auf und verwenden die zurückgegebenen temporären Anmeldedaten. Bedrock akzeptiert außerdem Bedrock-API-Schlüssel. Diese Bearer-Tokens werden über AWS_BEARER_TOKEN_BEDROCK übergeben. AWS dokumentiert zwei Arten. Ein kurzfristiger Schlüssel ist bis zu 12 Stunden gültig oder, falls kürzer, nur so lange wie die Sitzung, durch die er erzeugt wurde. Er übernimmt die Berechtigungen der IAM-Identität, die ihn erzeugt hat. AWS empfiehlt diese Art für den Produktivbetrieb. Ein langfristiger Schlüssel bleibt bis zu einem Ablaufdatum gültig, das Sie bei der Erstellung festlegen, beispielsweise 30 oder 90 Tage mit --credential-age-days. Wenn dieser API-Parameter fehlt, läuft er nicht ab. Die Console erstellt dahinter einen IAM-Benutzer. AWS empfiehlt diese Art nur für Erkundungen. Ein langfristiger Schlüssel funktioniert nur in der Region, in der er erzeugt wurde. Die Verwendung in einer anderen Region gibt Credential should be scoped to a valid region zurück.
Die Abrechnung erfolgt über Ihr AWS-Konto und nicht über Anthropic. Das ist normalerweise der wichtigste Grund für diese Variante. Regionale Endpunkte haben gegenüber dem globalen Endpunkt einen Aufschlag von 10 %, wie im Oktober 2026 dokumentiert. Claude Platform on AWS ist ein separates Produkt. Anthropic betreibt es, AWS rechnet es über AWS Marketplace ab, und die Authentifizierung erfolgt mit SigV4 oder mit einem in der AWS Console erzeugten API-Schlüssel. Schlüssel aus der Claude Console funktionieren dort nicht. Der Zugriff erfolgt über einen AnthropicAWS-Client, den Anthropic als Beta kennzeichnet. Einen Bedrock-Fehler sollten Sie kennen, weil er wie ein Berechtigungsproblem aussieht, aber keines ist: Invocation of model ID ... with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model. Das betrifft das Modell-Routing. Eine Änderung der Anmeldedaten behebt den Fehler daher nicht.
Route 3: Google-Anmeldedaten auf Vertex AI
Anthropic bezeichnet diese Route in seiner Dokumentation inzwischen als Claude Models on Google Cloud (Google managed). Google betreibt sie als Teil seiner Agent Platform, der neuen Bezeichnung für das, was aus Vertex AI hervorgegangen ist. Der unten gezeigte Host aiplatform.googleapis.com, das zusätzliche anthropic[vertex] und die Klasse AnthropicVertex bleiben unverändert.
Google Cloud verwendet Application Default Credentials (ADC). Dabei handelt es sich um eine feste Suchreihenfolge, die die Google-Authentifizierungsbibliotheken verwenden, um Anmeldedaten zu finden, ohne dass Sie diese angeben müssen. ADC prüft zuerst GOOGLE_APPLICATION_CREDENTIALS, dann die von gcloud auth application-default login geschriebene Datei und anschließend das über den Metadata Server zugewiesene Service Account.
pip install -U "anthropic[vertex]"
gcloud auth application-default loginAuf einer Workstation schreibt die Anmeldung $HOME/.config/gcloud/application_default_credentials.json, danach ist keine weitere Konfiguration erforderlich. Auf einem Server sollten Sie die Anmeldedaten eines menschlichen Benutzers nicht speichern. Der Befehl unterstützt auch die Identitätsübernahme eines Service Account. Außerhalb von Google Cloud gibt es ebenfalls keinen Google Metadata Server. Verwenden Sie daher GOOGLE_APPLICATION_CREDENTIALS, um ADC auf eine Konfigurationsdatei für Workload Identity Federation oder eine Service-Account-Schlüsseldatei zu verweisen. Eine JSON-Datei mit einem Service-Account-Schlüssel ist ein langlebiges Geheimnis und muss genau nach den später in diesem Leitfaden beschriebenen Vorgaben behandelt werden. Innerhalb von Google Cloud weisen Sie der VM einen Service Account zu. Dann gibt es keine Datei, die geschützt werden muss. Die von ADC gefundene Identität benötigt eine IAM-Rolle, die die Berechtigung aiplatform.endpoints.predict enthält, beispielsweise Agent Platform User (roles/aiplatform.user).
from anthropic import AnthropicVertex
client = AnthropicVertex(project_id="my-project", region="global")Wenn Sie unterhalb des SDK direkt mit HTTP arbeiten, ändern sich zwei Dinge. Die Modellkennung wird aus dem Request-Body in den URL-Pfad verschoben, und anthropic_version wird aus dem Header in den Body verschoben. Mit Stand vom 27. Oktober 2026 akzeptiert die Anthropic-Dokumentation dort entweder vertex-2023-10-16 oder die neuere API-Version 2026-10-21. Bei den Anmeldedaten handelt es sich um ein gewöhnliches Google-Access-Token. Im folgenden Befehl verwendet gcloud auth print-access-token die eigene Anmeldung der gcloud CLI anstelle von ADC. Führen Sie daher zuerst gcloud auth login oder gcloud init auf dem Rechner aus, auf dem Sie den Befehl testen.
curl https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/anthropic/models/${MODEL_ID}:rawPredict \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"anthropic_version": "vertex-2023-10-16", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'Die Region ist ein eigener Parameter. global führt für die Verfügbarkeit ein dynamisches Routing durch, us und eu sind Multi-Region-Kennungen, und ein Name wie us-east5 legt eine einzelne Region fest. Mit Stand vom Oktober 2026 dokumentiert Anthropic Endpunkte für einzelne Regionen nur für Claude Sonnet 4.6 und frühere Modelle. Neuere Modelle verwenden globale oder Multi-Region-Endpunkte. Multi-Region- und regionale Endpunkte kosten 10% mehr als globale Endpunkte, wie im Oktober 2026 dokumentiert. Die Abrechnung erfolgt über das Google-Cloud-Projekt. Kontingente und Rechnungen werden daher von Google verwaltet.
Mit Stand vom 27. Oktober 2026 dokumentiert Anthropic außerdem ein zweites Google-Cloud-Angebot. Dessen Request-Struktur ist anders. Bei Claude Models on Google Cloud (Anthropic managed) betreibt Anthropic die Claude API selbst unter claude.googleapis.com. Der Zugriff erfolgt über einen AnthropicGoogleCloud-Client. Die Authentifizierung verwendet weiterhin Google-Cloud-Anmeldedaten einschließlich ADC. Der Request entspricht jedoch der direkten API: model bleibt im Body, und die Version wird im Header anthropic-version übertragen. Der Zugriff erfolgt über eigene IAM-Rollen (roles/claude.user und verwandte Rollen). Bei der Einrichtung wird für das Projekt eine neue Anthropic-Organisation erstellt. Die Nutzung wird über den Google Cloud Marketplace abgerechnet. Wenn Ihre Request-URLs aiplatform enthalten und mit :rawPredict enden, verwenden Sie die in diesem Abschnitt beschriebene von Google verwaltete Route.
Weg 4: Microsoft Foundry ist der Azure-Weg
Wenn Sie auf Azure nach Claude gesucht haben, ist dies der passende Abschnitt. Ein unterstützter Weg ist verfügbar. Claude läuft in Microsoft Foundry (früher Azure AI Foundry) und wird über den Azure Marketplace in Claude Consumption Units abgerechnet. Sie erstellen eine Foundry-Ressource, stellen darin ein Claude-Modell bereit und rufen einen von Azure gehosteten Endpunkt unter https://{resource}.services.ai.azure.com/anthropic/v1/* auf.
Es funktionieren zwei Arten von Zugangsdaten. Die erste ist ein von Azure ausgestellter Schlüssel aus dem Tab Details der Bereitstellung im Foundry-Portal. Sie wird in einem Header api-key oder x-api-key gesendet. Die zweite ist ein Microsoft Entra-Token. Auf einem Server ist dies die bessere Wahl, weil dann Azure role-based access control steuert, wer den Endpunkt aufrufen darf.
ACCESS_TOKEN=$(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv)
curl https://${RESOURCE}.services.ai.azure.com/anthropic/v1/messages \
-H "content-type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-d '{"model": "DEPLOYMENT_NAME", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'Das Feld model enthält den Bereitstellungsnamen, keine Modell-ID. Standardmäßig sind beide identisch. Sie unterscheiden sich jedoch, sobald Sie selbst einen Bereitstellungsnamen vergeben. Das ist die häufigste Ursache für einen Deployment not found-Fehler bei einer ansonsten korrekten Anfrage. Die Python- und TypeScript-SDKs lesen ANTHROPIC_FOUNDRY_API_KEY und ANTHROPIC_FOUNDRY_RESOURCE aus der Umgebung. Laut Dokumentation vom 10 November 2026 unterstützt Foundry alle sieben offiziellen SDKs: C#, Go, Java, PHP, Python, Ruby und TypeScript. Go verwendet ein eigenes Paket foundry (go get github.com/anthropics/anthropic-sdk-go/v2/foundry). Ruby erhielt in Version 2.5.0 des Gems ein eigenes Anthropic::FoundryClient. Diese Version wurde am 4 November 2026 veröffentlicht. Vor dieser Version musste Ruby den generischen Client auf die Foundry-Basis-URL ausrichten.
Ein generischer Client auf der Foundry-Basis-URL hat weiterhin eine Besonderheit. Das gilt für Ruby-Code vor Version 2.5.0 ebenso wie für die ant CLI, die Anthropic in den eigenen Foundry-Beispielen auf diese Weise verwendet. Wenn Sie dem generischen Client keine Zugangsdaten ausdrücklich übergeben und ANTHROPIC_API_KEY oder ANTHROPIC_AUTH_TOKEN weiterhin in der Umgebung gesetzt ist, übernimmt der Client diesen Wert und sendet Ihre Anthropic-Zugangsdaten an einen Microsoft-Endpunkt. Heben Sie die Variable auf oder übergeben Sie den Foundry-Schlüssel beziehungsweise das Token ausdrücklich an den Client. In Ruby ist der Wechsel zu Anthropic::FoundryClient die sauberere Lösung. Dieser Client akzeptiert den Foundry-Schlüssel oder einen Entra-Token-Provider. Ein Entra-Zugriffstoken hat eine zufällige Standardlaufzeit von 60 bis 90 Minuten. Ein lang laufender Prozess muss es daher erneuern, statt es beim Start einmalig zu übernehmen.
Wie lange ist die auf Ihrem Server gespeicherte Zugangsinformation gültig?
Die Daten hinter diesem Diagramm
[
{
"label": "Anthropic key, 30-day preset",
"max_lifetime_hours": 720
},
{
"label": "Anthropic key, 7-day preset",
"max_lifetime_hours": 168
},
{
"label": "AWS STS assumed role",
"max_lifetime_hours": 12
},
{
"label": "Bedrock short-term API key",
"max_lifetime_hours": 12
},
{
"label": "Entra ID access token, default upper bound",
"max_lifetime_hours": 1.5
},
{
"label": "Federated Anthropic token, default",
"max_lifetime_hours": 1
}
]Dies sind von den jeweiligen Anbietern veröffentlichte Obergrenzen und Standardwerte, die im Oktober 2026 ermittelt wurden. Es handelt sich nicht um Messwerte. Sie sind aus einem Grund wichtig: Sie zeigen, wie lange eine offengelegte Zugangsinformation noch funktioniert, während Sie erst feststellen, dass sie offengelegt wurde. Das föderierte Anthropic-Token am unteren Ende der Grafik ist standardmäßig bis zu 1 Stunde gültig. Zusätzlich ist es durch das Doppelte der verbleibenden Gültigkeitsdauer des Tokens des Identitätsanbieters begrenzt. Ein Microsoft Entra access token hat keinen einheitlichen Standardwert: Microsoft weist jedem Token eine zufällige Gültigkeitsdauer zwischen 60 und 90 Minuten zu, im Durchschnitt 75 Minuten. In der Grafik wird es mit seiner Obergrenze von 1.5 Stunden dargestellt. Dieser Standardwert hängt außerdem vom Client, von der Ressource und davon ab, ob Conditional Access im Tenant aktiviert ist. Wenn sowohl der Client als auch die Ressource Continuous Access Evaluation unterstützen, kann Entra die Gültigkeitsdauer auf 24 bis 28 Stunden verlängern und das Token stattdessen bei Ereignissen wie der Deaktivierung eines Kontos nahezu in Echtzeit widerrufen. Eine Token lifetime policy des Tenants kann einen Wert zwischen 10 Minuten und 23:59:59 festlegen. Die SDKs aktualisieren föderierte Anthropic-Tokens automatisch. Konfigurieren Sie auf Foundry einen Entra token provider für die Token-Aktualisierung, statt eine feste Token-Zeichenfolge zu übergeben. Eine Federation Rule kann die eigene Token-Gültigkeitsdauer auf einen Wert zwischen einer Minute und 24 Stunden setzen. Der Connect workload wizard der Console trägt standardmäßig 10 Minuten ein. Lesen Sie daher die Regel aus, statt den Standardwert anzunehmen. Eine angenommene Rolle und ein kurzlebiger Bedrock API key haben jeweils eine Gültigkeitsdauer von 12 Stunden. Ein langlebiger Bedrock API key ist in der Grafik nicht enthalten, weil es für ihn keine feste Obergrenze gibt: Er bleibt bis zum Ablaufzeitpunkt gültig, der bei seiner Erstellung festgelegt wurde, oder läuft nicht ab, wenn CredentialAgeDays beim API-Aufruf nicht angegeben wurde. Deshalb empfiehlt AWS ihn nur für Tests und Erkundungen. Ein mit der Voreinstellung für 30 Tage erstellter Key bleibt 720 Stunden gültig. Das ist die Zugangsinformation, die einen Monat lang in einer Datei auf Ihrem Server liegt.
Wo das Credential auf einem VPS liegt
Legen Sie das Secret in einer Datei ab, die nur root lesen kann, und lassen Sie es von systemd an den Prozess übergeben. Dieser Teil bleibt über jede SDK-Version hinweg gültig. Deshalb lohnt es sich, ihn einmal korrekt umzusetzen.
sudo useradd --system --home /opt/claude-app --shell /usr/sbin/nologin claudeapp
sudo install -d -m 700 -o root -g root /etc/claude-app
sudo install -m 600 -o root -g root /dev/null /etc/claude-app/env
sudoedit /etc/claude-app/envDie Datei enthält einfache KEY=value-Zeilen. Keine export, keine Anführungszeichen und keine Shell-Syntax, weil systemd die Datei selbst parst, statt sie über eine Shell auszuführen.
ANTHROPIC_API_KEY=sk-ant-api03-REPLACE-ME
CLAUDE_MODEL=REPLACE-ME[Unit]
Description=Claude API service
After=network-online.target
[Service]
User=claudeapp
EnvironmentFile=/etc/claude-app/env
ExecStart=/opt/claude-app/venv/bin/python -m claude_app
Restart=on-failure
[Install]
WantedBy=multi-user.targetsystemd liest EnvironmentFile= als root ein, bevor es auf User=claudeapp wechselt. Das Servicekonto benötigt daher keinen Lesezugriff auf die Datei. Der Modus 600 mit root als Eigentümer ist ausreichend. Deshalb setzt der Befehl install weiter oben die Datei entsprechend. Starten Sie den Dienst mit sudo systemctl enable --now claude-app. Prüfen Sie anschließend mit systemctl status claude-app, ob die Unit active (running) erreicht hat, statt in einer Neustartschleife zu laufen.
Vier Dinge sollten Sie vermeiden. Für jedes gibt es einen überprüfbaren Grund:
- Schreiben Sie den Schlüssel nicht mit
Environment=in die Unit-Datei. Eine Unit unter/etc/systemd/systemist für alle Benutzer lesbar. Daher gibtsystemctl cat claude-appdas Secret an jeden lokalen Benutzer aus. - Committen Sie das Secret nicht.
.gitignorehält eine neue Datei aus einem Commit heraus. Eine bereits committete Datei wird dadurch nicht entfernt, weil die Git-Historie alles behält, was ihr übergeben wurde. - Bauen Sie das Secret nicht in ein Container-Image ein.
ENV-Werte bleiben in der Image-Konfiguration erhalten. Build-Argumente sind außerdem in der Image-Historie oder in Provenance-Metadaten sichtbar. Wenn Sie die Datei in einer späteren Layer löschen, wird sie aus der früheren Layer nicht entfernt. Übergeben Sie Secrets stattdessen zur Laufzeit mit--env-fileoder über eine gemountete Datei. - Betrachten Sie die Prozessumgebung nicht als vor root geschützt.
sudo cat /proc/$(pgrep -u claudeapp -f claude_app | head -1)/environ | tr '\0' '\n'gibt den Schlüssel aus. Der Befehl zum Lesen der Datei benötigt selbstsudo. Eine Shell-Eingabeumleitung wird vorsudoausgeführt und verwendet die Berechtigungen Ihres aktuellen Kontos. Das Ziel ist, das Secret von allen anderen Konten auf dem Server fernzuhalten, nicht von root. root kann es unabhängig von Ihrer Konfiguration lesen.
Dieser letzte Punkt zeigt die Grenze dieses Designs. Die Datei, die nur root lesen kann, schützt den gespeicherten Schlüssel. Jeder Code, der als Servicekonto läuft, kann jedoch die Prozessumgebung lesen. Untergeordnete Prozesse erben sie ebenfalls. Dieser Ansatz ist ungeeignet, wenn der Prozess Code ausführt, den Sie nicht selbst geschrieben haben. Alles, was der Prozess ausführen kann, kann auch seine eigene Umgebung lesen. Secrets außerhalb der Reichweite eines KI-Agenten halten behandelt diesen Fall. Das ist ein anderes Problem mit einer anderen Lösung.
Wie rotiere ich den Schlüssel ohne Ausfall?
Rotieren Sie zuerst vorwärts und widerrufen Sie den alten Schlüssel zuletzt. Der folgende Neustart des einzelnen Dienstes unterbricht den Dienst kurzzeitig. Für unterbrechungsfreie Verfügbarkeit muss während des Neustarts eine andere Instanz die Anfragen verarbeiten.
- Erstellen Sie den neuen Schlüssel in der Konsole im selben Workspace wie den alten.
- Schreiben Sie ihn mit
sudoeditin/etc/claude-app/env. - Führen Sie
sudo systemctl restart claude-appaus. - Bestätigen Sie, dass der Dienst Anfragen beantwortet, und widerrufen Sie anschließend den alten Schlüssel in der Konsole.
EnvironmentFile wird beim Start der Unit gelesen. Ein laufender Prozess behält daher den Wert, den er beim Start erhalten hat. systemctl daemon-reload liest die Unit-Dateien erneut ein und ändert die Umgebung eines laufenden Prozesses nicht. Nur ein Neustart übernimmt den neuen Schlüssel. Wenn Sie den Schlüssel in Schritt 1 statt in Schritt 4 widerrufen, entsteht ein Ausfall, der bis zu Schritt 3 andauert.
Die Cloud-Routen werden beim Provider rotiert. Ein IAM-Benutzer unterstützt gleichzeitig zwei aktive Zugriffsschlüssel. Erstellen Sie daher den zweiten Schlüssel, stellen Sie ihn bereit und löschen Sie anschließend den ersten. Ein Google-Service-Account-Schlüssel wird auf dieselbe Weise rotiert. Eine Foundry-Ressource enthält zwei Schlüssel. Durch die Neugenerierung eines Schlüssels funktioniert sein alter Wert sofort nicht mehr. Stellen Sie den Dienst daher auf den anderen Schlüssel um, bevor Sie den bisher verwendeten Schlüssel neu generieren. Entra-Tokens und föderierte Anthropic-Tokens müssen nicht manuell rotiert werden. Das ist das stärkste Argument dafür, sie einzusetzen, wo dies möglich ist.
Legen Sie in der Konsole außerdem ein Ausgabenlimit für den Workspace fest. Ein offengelegter Schlüssel ist zunächst ein Kostenrisiko. Wie Sie die Ausgaben eines Agenten auf einem VPS begrenzen beschreibt die verfügbaren Kontrollen.
Warum gibt mein Client 401 oder 403 zurück?
401 mit authentication_error bei der direkten API. Der Schlüssel ist falsch, widerrufen oder abgelaufen. Das Ablaufdatum wird häufig übersehen, weil sich der Code nicht geändert hat und die Anfrage gestern noch funktioniert hat. Prüfen Sie die Ablaufdatum-Spalte des Schlüssels in der Console oder lesen Sie expires_at über die Admin API aus. Dort ist der Wert für Schlüssel ohne Ablaufdatum null. Ein persönlicher Schlüssel funktioniert außerdem nicht mehr, wenn sein Besitzer die Organisation verlässt.
Das SDK ignoriert Ihre Federation-Konfiguration und verwendet stattdessen einen Schlüssel. ANTHROPIC_API_KEY und ANTHROPIC_AUTH_TOKEN stehen in der Reihenfolge für Credential-Vorrang über Federation. Daher überschreibt jeder dieser Werte die Federation-Konfiguration. Besonders wichtig: Eine als leerer String exportierte Variable belegt ihren Platz weiterhin. Dadurch authentifiziert ANTHROPIC_API_KEY="" das SDK mit einem leeren Schlüssel, anstatt auf den nächsten Eintrag zurückzufallen. Verwenden Sie unset ANTHROPIC_API_KEY.
401 mit der unveränderten Meldung Authentication failed bei Federation. Diese Meldung ist absichtlich für jede mögliche Ursache identisch. Ein Aufrufer kann dadurch die Konfiguration Ihrer Regeln nicht anhand des Fehlertexts prüfen. Der tatsächliche Grund wird auf der Seite mit dem Authentifizierungsverlauf in der Console erfasst. Beginnen Sie dort, statt das JWT zu erraten.
403 bei Foundry. Das Token wurde erfolgreich authentifiziert, aber Ihrem Azure-Konto fehlt eine Rolle, die diesen Aufruf erlaubt. Weisen Sie der Identität, die die Anfrage stellt, eine Azure-RBAC-Rolle wie Foundry User (früher Azure AI User) oder Cognitive Services User zu.
Beliebige Fehler bei Bedrock. Führen Sie für die SigV4-Authentifizierung zuerst aws sts get-caller-identity als Servicebenutzer aus. Der Befehl zeigt, ob das System überhaupt verwendbare AWS-Credentials besitzt. Damit lässt sich ein Credential-Problem von einem Problem mit dem Modellzugriff oder einer nicht passenden Region unterscheiden. Mit Stand vom 29. Oktober 2026 aktiviert AWS in kommerziellen Regionen den Zugriff auf viele Modelle bei der ersten Verwendung, sofern die erforderlichen AWS-Marketplace-Berechtigungen vorhanden sind. Für einige Modelle ist jedoch ein separater Zugriff auf Kontoebene erforderlich. Für Anthropic-Modelle, die über die InvokeModel-Route aufgerufen werden, ist zunächst pro Konto ein einmaliges Use-Case-Formular erforderlich. Für eine gesamte AWS Organization genügt das Formular einmal, in Opt-in-Regionen muss es jedoch erneut ausgefüllt werden. Bis die Freischaltung abgeschlossen ist, gibt der Aufruf AccessDeniedException zurück. AWS dokumentiert, dass das Formular nicht für den bedrock-mantle-Endpunkt gilt. Der erste Aufruf eines Modells in einem Konto veranlasst Bedrock außerdem, das AWS-Marketplace-Abonnement im Hintergrund zu starten. Für dieses Abonnement benötigt eine Identität die Berechtigungen aws-marketplace:Subscribe, aws-marketplace:Unsubscribe und aws-marketplace:ViewSubscriptions. Fehlende Berechtigungen führen beim ersten Aufruf nicht unbedingt sofort zu einem Fehler. AWS dokumentiert, dass Aufrufe bis zu 15 Minuten erfolgreich sein können, während das Abonnement eingerichtet wird. Sobald das Abonnement fehlschlägt, geben spätere Aufrufe denselben Fehler AccessDeniedException zurück. Wenn ein Dienst in den ersten Minuten funktioniert und danach ausfällt, liegt die Ursache wahrscheinlich hier und nicht bei den Credentials. Nach der Vergabe der Berechtigungen benötigt AWS bis zu 2 Minuten, um das Abonnement abzuschließen. Ein Modell, das in der aufgerufenen Region nicht angeboten wird, schlägt unabhängig von der Qualität der Credentials fehl.
FAQ
Benötige ich einen Anthropic API-Schlüssel, um Claude über Bedrock oder Vertex zu verwenden?
Nein. Bei Amazon Bedrock signiert das SDK Anfragen mit AWS-Anmeldedaten über SigV4 oder sendet einen Bedrock API-Schlüssel. Bei Google Cloud sendet es ein Google access token, das über Application Default Credentials ermittelt wird. In keiner der beiden Konfigurationen gibt es ein von Anthropic ausgestelltes Geheimnis. Die Nutzung wird dem Cloud-Konto und nicht Anthropic in Rechnung gestellt. Deshalb ist ein in ANTHROPIC_API_KEY hinterlegter Anthropic-Schlüssel auf diesen Hosts ebenfalls ein Risiko: Ein generischer Client, der auf einen Cloud-Endpunkt zeigt, sendet ihn ohne Weiteres dorthin.
Ist Claude auf Azure verfügbar?
Ja, über Microsoft Foundry, früher Azure AI Foundry. Sie erstellen eine Foundry-Ressource, stellen darin ein Claude-Modell bereit und rufen https://{resource}.services.ai.azure.com/anthropic/v1/messages entweder mit einem von Azure ausgestellten Schlüssel in einem api-key-Header oder mit einem Microsoft Entra bearer token auf. Die Nutzung wird über den Azure Marketplace in Claude Consumption Units abgerechnet. Das Feld model im Request-Body muss den Namen Ihrer Bereitstellung enthalten. Dieser entspricht nur dann dem Modellbezeichner, wenn Sie beim Erstellen der Bereitstellung den Standardnamen beibehalten haben. Der Name kann anschließend nicht geändert werden.
Wo sollte ich den Claude API-Schlüssel auf einem Linux-Server speichern?
In einer root gehörenden Datei mit dem Modus 600, die über EnvironmentFile= in einer systemd-Unit geladen wird. systemd liest diese Datei als root, bevor es zum User= der Unit wechselt. Das Dienstkonto benötigt daher keinen Zugriff darauf. Speichern Sie den Schlüssel nicht im Repository, nicht direkt in der Unit-Datei, die weltweit lesbar ist und von systemctl cat ausgegeben wird, und nicht in der Konfiguration, den Layern oder den Build-Metadaten eines Container-Images.
Warum gibt meine Claude API-Anfrage plötzlich 401 zurück, obwohl sich nichts geändert hat?
Ein Schlüssel gibt 401 zurück, sobald er das bei seiner Erstellung festgelegte Ablaufdatum erreicht. Das Ablaufdatum wird bei der Erstellung gesetzt und kann anschließend nicht bearbeitet werden. Kurzlebige Schlüssel laufen ohne Warnung per E-Mail ab. Ein abgelaufener Schlüssel kann nicht reaktiviert werden. Erstellen Sie daher einen Ersatzschlüssel, schreiben Sie ihn in die Umgebungsdatei, starten Sie den Dienst neu und widerrufen Sie anschließend den alten Schlüssel. Wenn der Schlüssel definitiv noch gültig ist, prüfen Sie, ob eine veraltete Anmeldeinformation ihn überschreibt: ANTHROPIC_API_KEY, das auf eine leere Zeichenfolge gesetzt ist, hat weiterhin Vorrang vor den weiter unten aufgeführten Federation- und Profile-Quellen.