Een Claude API key maak je aan in de Claude Console op platform.claude.com, onder API keys. Je geeft de key een naam, kiest een verloopdatum en koppelt hem aan jezelf of aan een service account. De Console toont de volledige key één keer, direct na het aanmaken. Met die key roep je de Claude API aan vanuit je eigen software.
Voor gebruik van de key heb je tegoed nodig, want de API werkt met vooraf gekochte credits. Een key zelf is gratis en een abonnement op Claude Pro of Max geeft geen API-toegang, al krijgen Max- en Team-abonnees een maandelijks API-tegoed.
Ben je een key kwijt, dan maak je een nieuwe. Bewaar een key in een omgevingsvariabele en nooit in je code, en geef teamleden eigen keys per workspace. Werkt een key niet, dan vertelt de foutcode je waar het probleem zit.
Wat is een Claude API key?
Een Claude API key is een geheime sleutel waarmee software zich aanmeldt bij de Claude API van Anthropic. Elke aanvraag aan de API draagt die sleutel mee, zodat Anthropic herkent welk account de aanvraag doet en wie het verbruik betaalt.
Een Claude API key en een Anthropic API key zijn hetzelfde. Een key begint altijd met sk-ant- en hoort bij één organisatie in de Claude Console. Met de key spreek je de API aan vanuit een eigen script, een automatiseringstool of een applicatie, los van de chatomgeving op claude.ai.
Hoe maak je een Claude API key aan?
Om een Claude API key aan te maken, doorloop je zes stappen in de Claude Console:
- Log in bij de Claude Console op platform.claude.com, of maak daar een account aan.
- Open de pagina API keys via platform.claude.com/settings/keys.
- Klik op Create key en geef de key een herkenbare naam, bijvoorbeeld de naam van het script dat hem gebruikt.
- Kies een verloopdatum: 3 uur, 1 dag, 7 dagen, 30 dagen, een eigen termijn of Never.
- Zet Linked account op jezelf of op een service account, en kies eventueel een workspace waartoe de key beperkt blijft.
- Kopieer de key die met sk-ant- begint en bewaar hem direct op een veilige plek.
De verloopdatum ligt vast op het moment van aanmaken en is achteraf niet te wijzigen. Kies Never alleen voor een key die je zelf beheert en periodiek vervangt.
Moet je eerst tegoed kopen?
Ja, voor het gebruik van een Claude API key heb je eerst tegoed nodig, want Anthropic rekent de API af via vooraf gekochte credits. Volgens Anthropic krijgen nieuwe gebruikers wel een klein gratis tegoed om de API te testen.
Credits koop je in de Console via Billing, met een creditcard. Daarvoor heb je de rol Admin of Billing nodig in de organisatie. Gekochte credits verlopen een jaar na aankoop, en met auto-reload koopt de Console automatisch bij zodra je saldo onder een zelfgekozen grens zakt.
Het verbruik gaat per token: elke aanvraag kost tokens voor de invoer en voor het antwoord. Hoe tokens bij AI worden geteld, bepaalt dus direct hoe snel je tegoed opraakt. De prijzen per model staan bij de kosten van Claude, in de sectie over de API.
Is een Claude API key gratis?
Ja, een Claude API key aanmaken is gratis, maar het gebruik ervan niet. Je betaalt voor de tokens die je via de key verbruikt, en een abonnement op Claude dekt die kosten niet.
Volgens Anthropic geeft een betaald Claude-abonnement geen toegang tot de API of de Console. De uitzondering zijn Max en Team, die maandelijks API-tegoed krijgen. Anthropic rekent dat tegoed in dollars. Omgerekend tegen de ECB-koers van 15 oktober 2026 krijgt Max 5x ongeveer 89 euro per maand aan API-tegoed (100 dollar) en Max 20x ongeveer 178 euro (200 dollar). Team krijgt ongeveer 18 of 89 euro per seat (20 of 100 dollar), samen maximaal ongeveer 446 euro per maand (500 dollar).
Het API-tegoed claim je na zeven dagen via de instellingen van claude.ai, en ongebruikt tegoed vervalt aan het eind van elke factuurperiode. Free, Pro en Enterprise komen er niet voor in aanmerking.
Waar vind je je API key terug?
Je API key vind je na het aanmaken niet meer terug, want de Console toont de volledige key maar één keer. Op de pagina API keys zie je daarna wel de naam en de instellingen van de key, maar niet de key zelf.
Ben je de key kwijt, maak dan een nieuwe aan en zet de oude op Disable of Delete. Disable is omkeerbaar, Delete is definitief. Een verlopen key is alleen nog te verwijderen.
Hoe bewaar je een API key veilig?
Een API key bewaar je veilig in een omgevingsvariabele of een secrets manager, nooit in de broncode zelf. De officiële SDK’s van Anthropic lezen de variabele ANTHROPIC_API_KEY automatisch, zodat de key nergens in je scripts hoeft te staan.
Een key in code die op GitHub of in een gedeelde map belandt, geeft iedereen die hem vindt toegang tot je tegoed. Vervang een gelekte key direct: verwijder hem in de Console en maak een nieuwe aan. Een key met een verloopdatum beperkt de schade als dat toch gebeurt.
Let op als ANTHROPIC_API_KEY op je computer is ingesteld. Claude Code gebruikt volgens Anthropic de key uit ANTHROPIC_API_KEY in plaats van je abonnement, waardoor je verbruik als API-kosten wordt afgerekend in plaats van binnen je Pro- of Max-limiet.
Hoe beheer je API keys voor een team?
API keys voor een team beheer je met workspaces en service accounts in de Claude Console. Een workspace scheidt projecten of afdelingen, met eigen keys, eigen limieten en een eigen overzicht van het verbruik.
Anthropic onderscheidt drie soorten keys. Een persoonlijke key handelt namens jou en stopt zodra je uit de organisatie vertrekt. Een service account key handelt namens een service account en blijft werken als een medewerker vertrekt, wat hem geschikt maakt voor automatiseringen. Workspace keys bestaan nog, maar Anthropic noemt ze inmiddels verouderd.
Stel daarnaast een eigen bestedingslimiet in via Billing en Spend limits. Die limiet ligt onder het maximum van je usage tier. Omgerekend tegen dezelfde koers is dat ongeveer 446 euro per maand voor Start (500 dollar), 892 euro voor Build (1.000 dollar) en ruim 178.000 euro voor Scale (200.000 dollar). Nieuwe organisaties starten volgens Anthropic soms in een evaluatieniveau met lagere limieten, die automatisch stijgen naarmate het account gebruiksgeschiedenis opbouwt.
Wat doe je als je API key niet werkt?
Werkt je API key niet, dan wijst de foutcode in het antwoord van de API de oorzaak aan. Vier codes komen het vaakst voor:
- 401: de key is ongeldig, verlopen, uitgeschakeld of verkeerd gekopieerd.
- 400: je eigen bestedingslimiet is bereikt, of een key zonder workspace mist de header anthropic-workspace-id.
- 429: je zit boven de rate limit van je tier, of de maandelijkse bestedingsgrens van je tier is bereikt.
- 529: de API van Anthropic is tijdelijk overbelast.
Een 429 door de bestedingsgrens van je tier verdwijnt niet door opnieuw te proberen: het gebruik blijft gepauzeerd tot de eerste dag van de volgende maand, tenzij je een hoger niveau aanvraagt. Een 429 door de rate limit en een 529 zijn wel tijdelijk. In een productie-workflow op mijn VPS liep ik tegen beide aan, en zonder retry-logica in de code stopt een script dan halverwege.
Hoe leer je bouwen met je eerste API key?
Bouwen met je eerste API key leer je door één concrete taak te automatiseren, zoals het samenvatten van binnenkomende documenten of het opstellen van conceptmails. De key is daarbij alleen de toegang; de waarde zit in een goede prompt, een vaste uitvoer en een controle op die uitvoer.
De AI automatisering cursus leert je die stappen zonder technische voorkennis: met Claude een automatisering bouwen voor terugkerend werk, met een controlestap op de uitvoer. Met een goed beheerde key en een duidelijke taak is de Claude Console het startpunt van je eerste werkende toepassing.
