Een Claude API-key maak je aan in Claude Console, bij Settings → API keys. Daarmee geef je een toepassing toegang tot de API. Een betaald Claude-chatabonnement bevat niet automatisch API-tegoed: het abonnement en het gebruik via Console worden apart afgerekend.
Een API-key aanmaken
- Open Claude Console via de officiële Claude-website en controleer met welk account en welke organisatie je bent ingelogd.
- Ga naar Settings → API keys → Create key.
- Geef de sleutel een herkenbare naam, bijvoorbeeld
website-acceptatie. Kies een vervaldatum die past bij het gebruik. - Kies bij Linked account het account waarvoor de sleutel werkt. Een persoonlijke sleutel is verbonden aan je eigen account; het maken van een serviceaccount-sleutel vraagt beheerdersrechten.
- Beperk de sleutel waar passend tot de benodigde workspace. Bewaar de geheime waarde meteen op de plek waar je toepassing haar verwacht.
Ontbreekt een optie, controleer dan je organisatierol. De actuele documentatie onderscheidt persoonlijke sleutels, serviceaccount-sleutels en oudere workspace-sleutels. Een oudere handleiding kan daarom andere velden tonen. Geef je sleutel niet meer bereik alleen om een foutmelding te laten verdwijnen.
De sleutel in een toepassing gebruiken
Veel Claude-SDK's lezen de omgevingsvariabele ANTHROPIC_API_KEY. Gebruik de geheime instellingen van je hostingplatform of een secret manager om die variabele in te stellen. Bij lokaal ontwikkelen kan een afgeschermd env-bestand geschikt zijn als je toepassing het ondersteunt. Zet het bestand buiten versiebeheer.
Controleer lokaal eerst alleen of de variabele bestaat. Dit Python-voorbeeld doet geen API-verzoek, toont de sleutel niet en veroorzaakt dus geen Claude-API-verbruik:
import os
if not os.environ.get("ANTHROPIC_API_KEY"):
raise RuntimeError("ANTHROPIC_API_KEY ontbreekt")
print("De variabele is ingesteld; de sleutel is niet getest.")Een succesvolle controle bewijst alleen dat er een waarde aanwezig is. Of die geldig is, welke rechten ze heeft en of er tegoed beschikbaar is, staat daarmee nog niet vast. Plak nooit de sleutel in JavaScript dat bezoekers in hun browser ontvangen. Laat een eigen server de API-koppeling afhandelen.
Kosten en foutmeldingen uit elkaar houden
Controleer vóór de eerste echte aanvraag de facturering en gebruiksinstellingen in Console. Een authenticatiefout vraagt om controle van sleutel en rechten. Een melding over tegoed vraagt om controle van API-facturering. Opnieuw betalen voor je chatabonnement lost dat tweede probleem niet op. Lees voor de bredere keuze wanneer je de Claude API nodig hebt.
Houd productie en experimenten gescheiden met eigen sleutels. Zo kun je een testintegratie stoppen zonder een werkende dienst af te sluiten. Log hooguit sleutelnaam, tijdstip en foutcode, nooit de autorisatieheader of volledige configuratie.
Een gelekte of oude sleutel vervangen
Schakel een blootgestelde sleutel direct uit in Console. Disable is omkeerbaar; verwijderen is definitief. Maak een vervangende sleutel aan, werk de geheime instelling van de toepassing bij en controleer vervolgens haar werking. Bekijk ook het verbruik sinds het mogelijke lek. Alleen de sleutel uit een openbaar bestand halen is onvoldoende: kopieën en Git-geschiedenis kunnen blijven bestaan.