SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor

Claude API authenticatie: Anthropic, AWS, GCP en Azure

Leer hoe u een Claude API client veilig authenticeert via Anthropic API keys, AWS IAM, Google ADC of Microsoft Entra. Voorkom fouten bij het beheer van uw server credentials.

De authenticatieroutes voor de Claude API

Authenticatie voor de Claude API komt neer op één beslissing: welke inloggegevens uw client over de verbinding stuurt. Anthropic biedt de directe Claude API en vijf cloudplatformen aan: Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (beheerd door Google), Claude Models on Google Cloud (beheerd door Anthropic) en Microsoft Foundry. De directe Anthropic API accepteert een API-sleutel of een kortstondig token in een Authorization: Bearer-header, en accepteert nog steeds API-sleutels in de verouderde x-api-key-header. Amazon Bedrock ondersteunt AWS-request signing en Bedrock API-sleutels; in die configuratie bestaat nergens een Anthropic-sleutel. Google Cloud verstuurt een kortstondig Google-toegangstoken. Microsoft Foundry vereist een door Azure uitgegeven sleutel of een Microsoft Entra-token. De vier onderstaande secties behandelen deze configuraties voor inloggegevens, waarbij de afzonderlijke door Anthropic beheerde AWS- en Google Cloud-aanbiedingen naast hun cloud-tegenhangers worden uitgelegd.

Deze handleiding is bedoeld voor het koppelen van een SDK (software development kit) aan een service die op een Linux-server draait. Als u in plaats daarvan de Claude Code command-line tool configureert, zijn de variabelen en de flow anders: zie Claude Code naar Bedrock of Vertex wijzen. Als de service nog niet bestaat, bouw deze dan eerst met een eerste Claude API-app op een VPS en keer hier terug voor de inloggegevens.

Alles hieronder is op 2026 gecontroleerd aan de hand van de platformdocumentatie van Anthropic en op 16 oktober 2026 opnieuw gecontroleerd aan de hand van de documentatie van elke provider; de details over modeltoegang voor Bedrock zijn op 19 oktober 2026 opnieuw gecontroleerd aan de hand van de AWS-documentatie. De pagina's van Anthropic voor alle vier de routes, voor API-sleutels en voor API-versies zijn op 27 oktober 2026 opnieuw gecontroleerd. De pagina's van Anthropic voor Microsoft Foundry, beide Bedrock-endpoints, de door Google beheerde route, Claude Platform on AWS, authenticatie, Workload Identity Federation en API-versies zijn op 10 november 2026 opnieuw gecontroleerd, samen met de changelog van de Ruby SDK. Model-identifiers, prijzen, SDK-versies en endpoint-vormen veranderen continu, dus deze handleiding linkt naar de pagina's van de provider in plaats van waarden af te drukken die verouderd raken.

Route 1: een Anthropic API-sleutel

Dit is de directe route en de enige manier waarop Anthropic het geheim uitgeeft. Verzoeken gaan naar het Messages-eindpunt op de API-host van Anthropic en elk verzoek bevat drie headers.

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"}]}'

Vervang MODEL_ID door een actuele identificatie uit het modeloverzicht van Anthropic. Een correct antwoord is JSON die een content-array en een usage-object bevat. Een onjuiste of verlopen sleutel resulteert in HTTP 401 met authentication_error. Een ontbrekende anthropic-version-header is een afzonderlijke fout, omdat deze header bij elk verzoek vereist is; de SDK's stellen deze automatisch voor u in. Sinds oktober 2026 presenteert de documentatie van Anthropic Authorization: Bearer als de primaire methode om de sleutel te verzenden en noemt het x-api-key verouderd, maar beide worden geaccepteerd, dus het bovenstaande commando werkt nog steeds. De huidige grote versies van de SDK's verzenden de sleutel ook als Authorization: Bearer, dus een proxy of gateway die X-Api-Key leest, moet worden aangepast bij een upgrade. De 2023-06-01-versie in het commando wordt nog steeds geaccepteerd; de nieuwste API-versie van Anthropic is 2026-10-21, die door die SDK-versies standaard wordt verzonden en die enkele oudere verzoekparameters zoals temperature afwijst.

Het opbouwen van de client is de kortste van deze configuraties, omdat er niets opgebouwd hoeft te worden. Elke officiële SDK leest ANTHROPIC_API_KEY zelfstandig uit de omgeving.

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)

Het is raadzaam om de model-identificatie naast de sleutel in de omgeving te bewaren. Modelnamen veranderen volgens een schema waar u geen controle over heeft, en het opnieuw uitrollen van code om één tekenreeks aan te passen is vermijdbaar werk.

Sleutels worden aangemaakt in de Console, waar u bij het aanmaken een verloopdatum kiest: voorinstellingen van 3 uur, 1 dag, 7 dagen of 30 dagen, een aangepaste duur, of Nooit, afhankelijk van het maximale verloopbeleid van uw organisatie. De verloopdatum staat vast bij het aanmaken en kan later niet worden gewijzigd. Anthropic e-mailt de maker van de sleutel voordat een langlopende sleutel verloopt, maar een sleutel met een korte levensduur verloopt zonder enige waarschuwingsmail. Een verlopen sleutel geeft een 401-foutmelding en kan niet worden geactiveerd; de enige oplossing is dus een nieuwe sleutel.

Er is geen regio te kiezen bij de directe API en de factuur gaat rechtstreeks naar uw Anthropic-organisatie. Workspaces beperken een sleutel tot één project, wat de meest overzichtelijke manier is om te zien wat een enkele service verbruikt. Beperk de sleutel van een server tot de bijbehorende workspace wanneer u deze aanmaakt: een sleutel voor een persoonlijk account of serviceaccount die niet aan een workspace is gekoppeld, moet bij elk verzoek een anthropic-workspace-id-header meesturen, anders antwoordt de API met 400 en invalid_request_error. Kies voor een service een serviceaccount-sleutel, omdat een persoonlijke sleutel niet meer werkt wanneer de persoon die deze heeft aangemaakt de organisatie verlaat. Zie hoe API-prijzen per token zich verhouden tot een abonnement voor de berekening achter die factuur.

Eén optie hoort hier nog thuis, omdat deze het statische geheim volledig verwijdert. Workload Identity Federation stelt een workload in staat om een OpenID Connect (OIDC)-token van een vertrouwde identiteitsprovider in te ruilen voor een kortstondig Anthropic-token op POST /v1/oauth/token, en de SDK ververst dat token voordat het verloopt. Er wordt nergens een sk-ant-api...-tekenreeks aangemaakt of gekopieerd. Dit is geschikt voor Kubernetes, GitHub Actions en cloud-VM's, die al over een platformidentiteit beschikken. Een standaard VPS heeft meestal geen dergelijke uitgever, dus op die machine is een API-sleutel in een bestand het eerlijke antwoord, en de rest van deze handleiding behandelt het op die manier.

Route 2: AWS-credentials op Amazon Bedrock

Op Bedrock gebruikt u helemaal geen Anthropic-sleutel. Met AWS-credentials ondertekent de SDK elk HTTP-verzoek met AWS Signature Version 4 (SigV4), en AWS bepaalt of de aanroeper het model mag gebruiken.

pip install -U "anthropic[bedrock]"
aws sts get-caller-identity

aws sts get-caller-identity toont het accountnummer en de ARN (Amazon Resource Name) van de identiteit waaraan uw credentials zijn gekoppeld. Voer dit commando als eerste uit wanneer u SigV4 gebruikt. Voor SigV4 lost de SDK constructor-credentials, omgevingsvariabelen en de standaard AWS-credentialchain op; de regio-selectie staat hier los van. In de Python AnthropicBedrock-client veroorzaakt een Bedrock API-sleutel die wordt meegegeven als api_key of via AWS_BEARER_TOKEN_BEDROCK een ValueError als u ook aws_access_key, aws_secret_key, aws_session_token of aws_profile doorgeeft. Zonder deze expliciete argumenten kiest de sleutel voor bearer-authenticatie in plaats van de AWS-credentialchain. De TypeScript-client geeft voorrang aan de Bedrock API-sleutel boven expliciete AWS-credentials. Het STS-commando test geen bearer-authenticatie.

Wat verandert bij het opbouwen van de client is de klasse en één argument.

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-east-1")

AnthropicBedrock stuurt de InvokeModel-integratie van Bedrock aan. Sinds oktober 2026 documenteert Anthropic ook Claude in Amazon Bedrock, een Messages API-endpoint op https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages voor Claude Opus 4.7 en latere modellen, bereikbaar via een AnthropicBedrockMantle-client uit hetzelfde pakket. Dit ondersteunt AWS-credentials en Bedrock bearer-tokens; de vereisten voor modeltoegang verschillen tussen de twee endpoints, zoals hieronder uitgelegd.

Let op de upgrade in die pip install -U-regel. Sinds 27 oktober 2026 verstuurt de nieuwste SDK standaard API-versie 2026-10-21, ook via Bedrock. Anthropic documenteert dat de ARN-versie-gebaseerde model-ID's die zij vermelden voor Claude Opus 4.6 en eerder die versie op Bedrock niet ondersteunen en een 400-fout kunnen retourneren. Als een service een van die modellen aanroept, behoud dan de huidige SDK-versie en zet deze vast, of migreer de service eerst naar een Claude 4.7-model of later.

De regio is hier geen decoratie. Bedrock-endpoints zijn regiospecifiek, de beschikbare Claude-modellen verschillen per regio, en de regio maakt deel uit van de SigV4-handtekening. Een handtekening die voor de ene regio is berekend, wordt door een andere regio afgewezen. Stel AWS_REGION expliciet in de service-omgeving in, omdat de SDK's onderling verschillen over het gedrag wanneer u dit weglaat. Zoals gedocumenteerd in oktober 2026, leest de Python AnthropicBedrock-client AWS_REGION of AWS_DEFAULT_REGION, daarna de regio van uw boto3-sessie of AWS-profiel (inclusief ~/.aws/config), en genereert een ValueError als er niets wordt gevonden. De TypeScript-client leest AWS_REGION, valt terug op us-east-1 wanneer dit niet is ingesteld, en leest ~/.aws/config niet voor de regio. Daarom kan de AWS CLI wel Claude-modellen weergeven op dezelfde machine waar een Node-proces de verkeerde regio aanroept: de CLI las uw configuratiebestand en de client niet.

Op een EC2-instantie koppelt u een IAM-rol (identity and access management) en komt er nooit een geheim op de schijf terecht, omdat de instantie-metadataservice tijdelijke credentials aan de SDK verstrekt. Een VPS buiten AWS heeft geen instantierol of metadataservice. U kiest dan tussen een langdurig access key-paar van een IAM-gebruiker op de server, wat dezelfde klasse geheim is als een Anthropic-sleutel, of federatie: authenticeer bij uw identiteitsprovider, roep AWS STS (security token service) aan en gebruik de tijdelijke credentials die dit retourneert. Bedrock accepteert ook Bedrock API-sleutels, dit zijn bearer-tokens die via AWS_BEARER_TOKEN_BEDROCK worden doorgegeven, en AWS documenteert twee soorten. Een kortstondige sleutel is maximaal 12 uur geldig, of de duur van de sessie die deze heeft gegenereerd indien korter, erft de rechten van de IAM-identiteit die deze heeft gegenereerd, en is het type dat AWS aanbeveelt voor productie. Een langdurige sleutel blijft geldig tot een vervaldatum die u kiest bij het aanmaken (bijvoorbeeld 30 of 90 dagen met --credential-age-days), of verloopt niet als die API-parameter wordt weggelaten; de Console maakt hiervoor een IAM-gebruiker aan en AWS raadt dit alleen aan voor verkenning. Een langdurige sleutel werkt alleen in de regio waar deze is gegenereerd; gebruik in een andere regio resulteert in Credential should be scoped to a valid region.

De kosten worden in rekening gebracht op uw AWS-account in plaats van bij Anthropic, wat meestal de voornaamste reden is om hiervoor te kiezen. Regionale endpoints zijn 10% duurder dan het globale endpoint, zoals gedocumenteerd in oktober 2026. Claude Platform on AWS is een apart product: Anthropic beheert het, AWS factureert het via AWS Marketplace, en het authenticeert met SigV4 of met een API-sleutel gegenereerd in de AWS Console (sleutels uit de Claude Console werken daar niet), via een AnthropicAWS-client die Anthropic als bèta markeert. Eén Bedrock-fout is het vermelden waard omdat deze lijkt op een rechtenprobleem, maar dat niet is: 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. Dat is model-routing, en geen enkele wijziging in credentials zal dit verhelpen.

Route 3: Google-referenties op Vertex AI

De documentatie van Anthropic noemt deze route nu Claude Models on Google Cloud (Google managed), die Google beheert als onderdeel van het Agent Platform, de nieuwe naam van Google voor wat voortkwam uit Vertex AI. De aiplatform.googleapis.com host, de anthropic[vertex] extra en de AnthropicVertex class die hieronder worden getoond, zijn ongewijzigd.

Google Cloud gebruikt Application Default Credentials (ADC), een vaste zoekvolgorde die de Google-authenticatiebibliotheken volgen om een referentie te vinden zonder dat u deze hoeft op te geven. ADC controleert eerst GOOGLE_APPLICATION_CREDENTIALS, daarna het bestand dat is geschreven door gcloud auth application-default login, en vervolgens het serviceaccount dat is gekoppeld via de metadataserver.

pip install -U "anthropic[vertex]"
gcloud auth application-default login

Op een werkstation schrijft die login $HOME/.config/gcloud/application_default_credentials.json en bent u klaar. Vermijd op een server het opslaan van de inloggegevens van een menselijke gebruiker; het commando ondersteunt ook impersonatie van serviceaccounts. Buiten Google Cloud is er bovendien geen Google-metadataserver, dus gebruik GOOGLE_APPLICATION_CREDENTIALS om ADC te laten verwijzen naar een configuratiebestand voor Workload Identity Federation of een sleutelbestand van een serviceaccount. Een JSON-sleutelbestand van een serviceaccount is een langdurig geheim en vereist exact de afhandeling die later in deze handleiding wordt beschreven. Binnen Google Cloud koppelt u een serviceaccount aan de VM en hoeft er geen bestand te worden beveiligd. Welke identiteit ADC ook vindt, deze heeft een IAM-rol nodig die de aiplatform.endpoints.predict permissie bevat, zoals Agent Platform User (roles/aiplatform.user).

from anthropic import AnthropicVertex

client = AnthropicVertex(project_id="my-project", region="global")

Twee zaken veranderen als u onder de SDK naar raw HTTP gaat. De model-identifier verplaatst zich uit de request body naar het URL-pad, en anthropic_version verplaatst zich uit de header naar de body. Sinds 27 oktober 2026 accepteert de documentatie van Anthropic daar vertex-2023-10-16 of de nieuwere API-versie 2026-10-21. De referentie is een standaard Google-toegangstoken. In het onderstaande commando gebruikt gcloud auth print-access-token de eigen login van de gcloud CLI in plaats van ADC, dus voer eerst gcloud auth login of gcloud init uit op de machine waar u dit test.

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"}]}'

Regio is een essentieel argument. global routeert dynamisch voor beschikbaarheid, us en eu zijn multi-regio-identifiers, en een naam zoals us-east5 zet een enkele regio vast. Sinds oktober 2026 documenteert Anthropic endpoints voor één regio alleen voor Claude Sonnet 4.6 en ouder; nieuwere modellen gebruiken de globale of multi-regio-endpoints. Multi-regio- en regionale endpoints kosten 10% meer dan globale, zoals gedocumenteerd in oktober 2026. Facturering verloopt via het Google Cloud-project, dus quota en facturen zijn van Google.

Sinds 27 oktober 2026 documenteert Anthropic ook een tweede Google Cloud-aanbod, en de structuur van het verzoek is anders. In Claude Models on Google Cloud (Anthropic managed) beheert Anthropic de Claude API zelf op claude.googleapis.com, bereikbaar via een AnthropicGoogleCloud client. Het authenticeert nog steeds met Google Cloud-referenties, inclusief ADC, maar het verzoek ziet eruit als de directe API: model blijft in de body en de versie wordt meegegeven in de anthropic-version header. Toegang komt voort uit eigen IAM-rollen (roles/claude.user en gerelateerde), de configuratie creëert een nieuwe Anthropic-organisatie voor het project, en het gebruik wordt gefactureerd via de Google Cloud Marketplace. Als uw request-URL's aiplatform bevatten en eindigen op :rawPredict, bevindt u zich op de door Google beheerde route die in deze sectie wordt beschreven.

Route 4: Microsoft Foundry is de Azure-route

Als u zocht naar Claude op Azure, dan is dit de sectie die u zocht, en er bestaat inderdaad een ondersteunde route. Claude draait in Microsoft Foundry (voorheen Azure AI Foundry) en wordt gefactureerd via de Azure Marketplace in Claude Consumption Units. U maakt een Foundry-resource aan, implementeert een Claude-model daarin en roept een door Azure gehost endpoint aan op https://{resource}.services.ai.azure.com/anthropic/v1/*.

Twee soorten inloggegevens werken. De eerste is een door Azure uitgegeven sleutel uit het tabblad Details van de implementatie in de Foundry-portal, verzonden in een api-key- of x-api-key-header. De tweede is een Microsoft Entra-token, wat op een server de betere keuze is omdat Azure role-based access control dan bepaalt wie het endpoint mag aanroepen.

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"}]}'

Het model-veld bevat uw deployment name, niet een model-identifier. Deze twee komen standaard overeen, maar ze komen niet meer overeen zodra u zelf een naam geeft aan een implementatie, wat de gebruikelijke oorzaak is van een Deployment not found-fout bij een verder correct verzoek. De Python- en TypeScript-SDK's lezen ANTHROPIC_FOUNDRY_API_KEY en ANTHROPIC_FOUNDRY_RESOURCE uit de omgeving. Zoals gedocumenteerd op 10 november 2026, dekt de Foundry-ondersteuning alle zeven officiële SDK's: C#, Go, Java, PHP, Python, Ruby en TypeScript. Go gebruikt een specifiek foundry-pakket (go get github.com/anthropics/anthropic-sdk-go/v2/foundry) en Ruby kreeg een specifieke Anthropic::FoundryClient in versie 2.5.0 van de gem, uitgebracht op 4 november 2026. Vóór die release moest Ruby-code de generieke client naar de Foundry-basis-URL wijzen.

Een generieke client naar de Foundry-basis-URL wijzen blijft een risico, of het nu gaat om Ruby-code geschreven vóór 2.5.0 of de ant CLI, die Anthropic's eigen Foundry-voorbeelden op die manier aanroepen. Als u niet expliciet inloggegevens doorgeeft aan de generieke client en ANTHROPIC_API_KEY of ANTHROPIC_AUTH_TOKEN is nog steeds ingesteld in de omgeving, dan pakt de client deze op en verstuurt uw Anthropic-inloggegevens naar een Microsoft-endpoint. Verwijder de variabele of geef de Foundry-sleutel of het token expliciet door aan de client. In Ruby is overstappen op Anthropic::FoundryClient, dat de Foundry-sleutel of een Entra-tokenprovider accepteert, de schonere oplossing. Een Entra-toegangstoken krijgt een willekeurige standaardlevensduur van 60 tot 90 minuten, dus een langlopend proces moet dit verversen in plaats van er bij de start één vast te leggen.

Hoe lang blijven de inloggegevens op uw server geldig?

GrafiekDocumented credential lifetime by route, hours
De gegevens achter deze grafiek
[
  {
    "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
  }
]

Dit zijn de maxima en standaardwaarden zoals gepubliceerd door elke aanbieder en gelezen in oktober 2026; het zijn geen gemeten waarden. Ze zijn om één reden van belang: ze geven aan hoe lang een gelekte inloggegeven bruikbaar blijft terwijl u nog bezig bent te ontdekken dat er een lek is. Het gefedereerde Anthropic-token onderaan de grafiek is standaard maximaal 1 uur geldig, eveneens begrensd door tweemaal de resterende levensduur van het token van de identiteitsaanbieder. Een Microsoft Entra-toegangstoken heeft geen vaste standaardwaarde: Microsoft geeft elk token een willekeurige levensduur tussen 60 en 90 minuten (gemiddeld 75), in de grafiek weergegeven op de bovengrens van 1.5 uur. Deze standaardwaarde varieert bovendien per client, per resource en afhankelijk van of Conditional Access is ingeschakeld in de tenant. Wanneer zowel de client als de resource Continuous Access Evaluation ondersteunen, kan Entra de levensduur verlengen tot 24 à 28 uur en het token bij gebeurtenissen zoals het uitschakelen van een account vrijwel direct intrekken. Een tenant-beleid voor tokenlevensduur kan deze instellen op een waarde tussen 10 minuten en 23:59:59. De SDK's verversen gefedereerde Anthropic-tokens automatisch; configureer op Foundry een Entra-tokenprovider om tokens te verversen in plaats van een vaste token-string door te geven. Een federatieregel kan een eigen tokenlevensduur instellen van één minuut tot 24 uur, en de Connect-werkbelastingwizard van de Console vult standaard 10 minuten in; lees daarom de regel in plaats van uit te gaan van de standaardwaarde. Een aangenomen rol (assumed role) en een kortstondige Bedrock API-sleutel zijn beide 12 uur geldig. Een langdurige Bedrock API-sleutel staat niet in de grafiek omdat deze geen vast maximum heeft: de sleutel blijft geldig tot de bij aanmaak gekozen vervaldatum, of verloopt helemaal niet als CredentialAgeDays werd weggelaten uit de API-aanroep. Daarom raadt AWS deze sleutels alleen aan voor verkenning. Een sleutel die is aangemaakt met de voorinstelling van 30 dagen blijft 720 uur geldig, en dat is de inloggegeven die een maand lang in een bestand op uw server staat.

Waar de inloggegevens op een VPS staan

Plaats het geheim in een bestand dat alleen door root gelezen kan worden en laat systemd dit aan het proces doorgeven. Dit onderdeel overleeft elke SDK-versie, dus het is de moeite waard om dit eenmalig en correct uit te voeren.

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/env

Het bestand bevat platte KEY=value-regels. Gebruik geen export, geen aanhalingstekens en geen shell-syntaxis, omdat systemd het bestand zelf parseert in plaats van het via een shell uit te voeren.

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.target

systemd leest EnvironmentFile= als root, voordat het overschakelt naar User=claudeapp. Het service-account heeft daarom nooit leestoegang tot het bestand nodig. Modus 600 met root als eigenaar is voldoende; daarom stelt het bovenstaande install-commando dit zo in. Start het met sudo systemctl enable --now claude-app en bevestig daarna met systemctl status claude-app dat de unit de status active (running) heeft bereikt in plaats van in een herstartlus te blijven hangen.

Vermijd de volgende vier zaken, elk met een reden die u zelf kunt verifiëren:

  • Schrijf de sleutel niet met Environment= in het unit-bestand. Een unit onder /etc/systemd/system is leesbaar voor iedereen, waardoor systemctl cat claude-app het geheim aan elke lokale gebruiker toont.
  • Commit het bestand niet. .gitignore houdt een nieuw bestand uit een commit, maar doet niets met een bestand dat al is gecommit, omdat de git-geschiedenis alles bewaart wat erin is geplaatst.
  • Verwerk het niet in een container-image. ENV-waarden blijven behouden in de image-configuratie en build-argumenten zijn zichtbaar in de image-geschiedenis of herkomstmetadata. Het verwijderen van het bestand in een latere laag verwijdert het niet uit de eerdere laag. Geef geheimen tijdens runtime door met --env-file of een gemount bestand.
  • Beschouw de procesomgeving niet als privé ten opzichte van root. sudo cat /proc/$(pgrep -u claudeapp -f claude_app | head -1)/environ | tr '\0' '\n' toont de sleutel. Het bestand-leescommando zelf heeft sudo nodig; een shell-input-omleiding wordt uitgevoerd vóór sudo en gebruikt de rechten van uw huidige account. Het doel is om het geheim weg te houden bij elk ander account op de machine, niet bij root, die het hoe dan ook kan lezen.

Dat laatste punt markeert de grens van wat dit ontwerp u oplevert. Het bestand dat alleen toegankelijk is voor root beschermt de opgeslagen sleutel, maar elke code die onder het service-account draait, kan de procesomgeving lezen en onderliggende processen erven deze. Dit is niet de juiste methode wanneer het proces code uitvoert die u niet zelf heeft geschreven, omdat alles wat het proces kan uitvoeren ook zijn eigen omgeving kan lezen. Geheimen buiten het bereik van een AI-agent houden behandelt dat scenario, wat een ander probleem is met een ander antwoord.

Hoe roteer ik de sleutel zonder downtime?

Roteer vooruit en trek de oude sleutel pas daarna in. De herstart van de service die hieronder wordt beschreven, onderbreekt de dienstverlening kortstondig; voor ononderbroken beschikbaarheid is een tweede instantie nodig die verzoeken afhandelt tijdens de herstart.

  1. Maak de nieuwe sleutel aan in de Console, in dezelfde workspace als de oude.
  2. Schrijf deze naar /etc/claude-app/env met sudoedit.
  3. Voer sudo systemctl restart claude-app uit.
  4. Controleer of de service reageert op verzoeken en trek daarna de oude sleutel in via de Console.

EnvironmentFile wordt gelezen wanneer de unit start, dus een draaiend proces behoudt de waarde die het bij de start heeft gekregen. systemctl daemon-reload herlaadt unit-bestanden, maar wijzigt de omgeving van een draaiend proces niet; alleen een herstart verwerkt de nieuwe sleutel. Het intrekken van de sleutel in stap 1 in plaats van stap 4 veroorzaakt een uitval die duurt tot stap 3.

Cloud-routes roteren bij de provider. Een IAM-gebruiker ondersteunt twee actieve toegangssleutels tegelijk; maak daarom de tweede aan, implementeer deze en verwijder daarna de eerste. Een Google service account-sleutel roteert op dezelfde wijze. Een Foundry-resource bevat twee sleutels, en het opnieuw genereren van een sleutel zorgt ervoor dat de oude waarde onmiddellijk niet meer werkt. Verplaats de service daarom naar de andere sleutel voordat u de sleutel die in gebruik is opnieuw genereert. Entra-tokens en gefedereerde Anthropic-tokens vereisen geen handmatige rotatie; dit is het sterkste argument om deze te gebruiken waar mogelijk.

Stel terwijl u in de Console bent een bestedingslimiet in voor de workspace. Een gelekte sleutel is kostbaar nog voordat er andere problemen ontstaan, en het beperken van de uitgaven van een agent op een VPS legt uit hoe u deze controles instelt.

Waarom geeft mijn client 401 of 403 terug?

401 met authentication_error op de directe API. De sleutel is onjuist, ingetrokken of verlopen. Verloop is een oorzaak die mensen vaak over het hoofd zien, omdat de code niet is gewijzigd en het verzoek gisteren nog werkte. Controleer de verloopkolom van de sleutel in de Console, of lees expires_at uit via de Admin API, waar deze null is voor sleutels zonder verloopdatum. Een persoonlijke sleutel werkt ook niet meer wanneer de eigenaar de organisatie verlaat.

De SDK negeert uw federatie-instellingen en gebruikt in plaats daarvan een sleutel. ANTHROPIC_API_KEY en ANTHROPIC_AUTH_TOKEN staan in de prioriteitsvolgorde voor inloggegevens boven federatie, dus beide overschrijven deze. Het scherpe randje hiervan: een variabele die als lege string is geëxporteerd, bezet nog steeds zijn plek, dus ANTHROPIC_API_KEY="" zorgt ervoor dat de SDK authenticeert met een lege sleutel in plaats van door te gaan naar de volgende optie. Gebruik unset ANTHROPIC_API_KEY.

401 met de algemene melding Authentication failed bij federatie. Die melding is bewust identiek voor elke mogelijke oorzaak, zodat een aanroeper uw regelconfiguratie niet kan achterhalen door de fouttekst te lezen. De werkelijke reden staat geregistreerd op de pagina met authenticatiegeschiedenis in de Console. Begin daar in plaats van te gissen naar de JWT.

403 op Foundry. Het token is geauthenticeerd, maar uw Azure-account mist een rol die de aanroep toestaat. Wijs een Azure RBAC-rol toe, zoals Foundry User (voorheen Azure AI User) of Cognitive Services User, aan de identiteit die het verzoek doet.

Alles op Bedrock. Voer voor SigV4-authenticatie eerst aws sts get-caller-identity uit als de servicegebruiker. Dit beantwoordt of de machine überhaupt bruikbare AWS-inloggegevens heeft, wat een probleem met inloggegevens scheidt van een probleem met modeltoegang of een regio-mismatch. Sinds 2026-10-29 schakelt AWS in commerciële regio's toegang tot veel modellen in bij het eerste gebruik met de vereiste AWS Marketplace-machtigingen, maar sommige modellen vereisen afzonderlijke toegang op accountniveau. Anthropic-modellen die via de InvokeModel-route worden aangeroepen, hebben eerst een eenmalig use-case-formulier per account nodig (of eenmaal voor een hele AWS Organization, hoewel opt-in-regio's dit opnieuw vereisen), en totdat dit is verwerkt, geeft de aanroep AccessDeniedException terug. AWS documenteert dat het formulier niet van toepassing is op het bedrock-mantle-endpoint. De eerste aanroep naar een model in een account zorgt er ook voor dat Bedrock op de achtergrond het AWS Marketplace-abonnement start, en dat abonnement vereist een identiteit die over de machtigingen aws-marketplace:Subscribe, aws-marketplace:Unsubscribe en aws-marketplace:ViewSubscriptions beschikt. Ontbrekende machtigingen leiden niet noodzakelijkerwijs tot het falen van die eerste aanroep: AWS documenteert dat aanroepen tot 15 minuten kunnen slagen terwijl het abonnement wordt opgezet, en zodra het abonnement faalt, geven latere aanroepen dezelfde AccessDeniedException terug. Een service die de eerste paar minuten werkte en daarna begon te falen, wijst hierop in plaats van op de inloggegevens. Nadat u de machtigingen heeft verleend, staat AWS maximaal 2 minuten toe voor het voltooien van het abonnement. Een model dat niet wordt aangeboden in de regio die u aanroept, faalt ongeacht hoe correct de inloggegevens zijn.

FAQ

Heb ik een Anthropic API-sleutel nodig om Claude te gebruiken op Bedrock of Vertex?

Nee. Op Amazon Bedrock ondertekent de SDK verzoeken met AWS-referenties via SigV4 of verstuurt een Bedrock API-sleutel. Op Google Cloud wordt een Google-toegangstoken verstuurd dat wordt gevonden via Application Default Credentials. In beide configuraties bestaat er geen door Anthropic uitgegeven geheim; het verbruik wordt gefactureerd aan het cloudaccount in plaats van aan Anthropic. Dit is ook de reden waarom een Anthropic-sleutel die achterblijft in ANTHROPIC_API_KEY een risico vormt op deze hosts: een generieke client die naar een cloud-endpoint wijst, zal deze zonder problemen meesturen.

Is Claude beschikbaar op Azure?

Ja, via Microsoft Foundry, voorheen Azure AI Foundry. U maakt een Foundry-resource aan, implementeert een Claude-model daarin en roept https://{resource}.services.ai.azure.com/anthropic/v1/messages aan met een door Azure uitgegeven sleutel in een api-key-header of een Microsoft Entra bearer-token. Het verbruik wordt gefactureerd via de Azure Marketplace in Claude Consumption Units. Het veld model in de request body moet uw deployment-naam bevatten. Deze komt alleen overeen met de model-identifier als u de standaardnaam heeft behouden bij het aanmaken van de deployment; de naam kan achteraf niet meer worden gewijzigd.

Waar moet ik de Claude API-sleutel opslaan op een Linux-server?

In een bestand dat eigendom is van root met modus 600, geladen via EnvironmentFile= in een systemd-unit. systemd leest dat bestand als root voordat het overschakelt naar de User= van de unit, waardoor het service-account er geen toegang toe hoeft te hebben. Houd de sleutel buiten de repository, buiten het unit-bestand zelf (dat voor iedereen leesbaar is en wordt weergegeven door systemctl cat), en buiten container-imageconfiguraties, lagen en build-metadata.

Waarom begon mijn Claude API-verzoek 401-fouten te geven terwijl er niets was veranderd?

Een sleutel die de bij aanmaak gekozen vervaldatum heeft bereikt, geeft een 401-fout. De vervaldatum wordt ingesteld bij het aanmaken, kan achteraf niet worden bewerkt en kortstondige sleutels verlopen zonder waarschuwingsmail. Een verlopen sleutel kan niet opnieuw worden geactiveerd; maak daarom een vervangende sleutel aan, schrijf deze in het omgevingsbestand, herstart de service en trek de oude sleutel daarna in. Als de sleutel zeker nog geldig is, controleer dan of een verouderde referentie deze niet overschrijft: ANTHROPIC_API_KEY ingesteld op een lege string krijgt nog steeds voorrang op de federatie- en profielbronnen daaronder.

Was dit artikel nuttig?

#claude#api#authentication#bedrock#vertex#secrets-management