Claude API: wat het is en wie hem echt nodig heeft

Wat de Claude API is

De Claude API is de toegang tot Claude voor software in plaats van voor mensen. Je programma stuurt een verzoek via HTTPS naar Anthropic en krijgt een antwoord terug als JSON (een tekstformaat voor gestructureerde gegevens). Er is geen chatvenster en geen app: wat de gebruiker ziet, bouw je zelf. API staat voor application programming interface, een vaste afspraak over hoe twee programma's met elkaar praten.

Wil je alleen met Claude chatten of een tekst laten herschrijven? Dan heb je de API niet nodig. Neem dan een abonnement op claude.ai. De API is voor wie Claude wil inbouwen: in eigen software, in een n8n-workflow, in een programmeertool of in een interne tool voor het eigen team.

Alle feiten over prijzen, valuta en btw in dit artikel zijn gecontroleerd op de eigen pagina's van Anthropic op 6 oktober 2026. Ze kunnen daarna veranderen.

Heeft Claude een API?

Ja. Anthropic, het bedrijf achter Claude, biedt de Claude API aan op https://api.anthropic.com. Je hebt er twee dingen voor nodig: een account in de Claude Console en een API-sleutel. De Console vind je op platform.claude.com. Daar koop je tegoed en maak je sleutels aan. Je ziet er ook je verbruik.

Via de API gebruik je dezelfde Claude-modellen als in de chat. Welke modellen er nu zijn, en met welke ID je ze aanroept, staat in het modeloverzicht van Anthropic. Die lijst verandert een paar keer per jaar. Neem de ID dus altijd van die pagina over en niet uit een oud artikel.

Claude is ook bereikbaar via cloudplatforms zoals Amazon Bedrock en Google Cloud. De rekening loopt dan via die partij, met de voorwaarden van die partij. Dit artikel gaat over de directe API van Anthropic.

Is claude.ai iets anders dan de Claude API?

Ja. Het zijn twee aparte producten, met aparte accounts en aparte rekeningen. Anthropic zegt het zelf in het helpcentrum: een betaald Claude-abonnement "doesn't include access to the Claude API or Console". Een Pro- of Max-abonnement geeft je dus geen API-tegoed. Omgekeerd geeft API-tegoed je geen extra berichten in de chat.

Naast de prijs verschilt vooral wat je krijgt. In claude.ai krijg je een complete app. Via de API krijg je alleen het model, en de rest regel je zelf. De volgende vijf punten laten zien wat dat in de praktijk betekent.

Geen projecten, geen geheugen, geen interface

De API onthoudt niets tussen twee verzoeken. Anthropic noemt de Messages API in de documentatie "stateless". Wil je een gesprek voeren, dan stuurt je programma bij elk verzoek de hele geschiedenis opnieuw mee. Dat heeft een direct gevolg voor de kosten: je betaalt bij elk nieuw verzoek opnieuw voor de eerdere berichten, omdat ze opnieuw als invoer meegaan.

Projecten, geüploade kennisbestanden en het geheugen van claude.ai bestaan in de API niet als knop. Je bouwt ze zelf, met je eigen database en je eigen code, of je laat ze weg. De Console heeft wel een playground. Daar test je een prompt in de browser voordat je hem in code zet. Dat is een testomgeving voor ontwikkelaars en geen vervanging van de chat-app.

Je brengt je eigen client mee

Een client is het programma dat de verzoeken verstuurt. Dat kan curl zijn in een terminal, een eigen script, of een tool die al met de API kan praten. Anthropic levert officiële SDK's (software development kits, bibliotheken die het verzoek voor je opbouwen) voor onder meer Python, TypeScript, Go en Java. Een SDK zet de verplichte headers voor je en probeert een mislukt verzoek automatisch opnieuw.

Veel bestaande tools vragen alleen om een API-sleutel. In n8n vul je die sleutel in bij de Anthropic-koppeling, en daarna kan elke workflow Claude aanroepen. Hoe dat er in de praktijk uitziet, staat in AI-workflows bouwen met Claude in n8n. Claude Code is een bijzonder geval: je logt daar in met je abonnement of met een API-sleutel, en die keuze bepaalt welke rekening je krijgt. Het verschil staat uitgelegd in inloggen in Claude Code met een abonnement of met een API-sleutel.

Een apart Console-account en een aparte rekening

In de Console maak je een organisatie aan. Die organisatie heeft eigen sleutels en eigen betaalgegevens. Je bestaande login voor claude.ai verandert daar niets aan. Voor de API gelden de Commercial Terms van Anthropic, de zakelijke voorwaarden. Woon of werk je in de Europese Economische Ruimte, dan is je contractpartij volgens die voorwaarden Anthropic Ireland, Limited. Dat is van belang voor de btw, en verderop staat waarom.

Gebruiksniveaus en rate limits in plaats van een venster van vijf uur

Een abonnement op claude.ai rekent met een gebruiksvenster van vijf uur. Is je ruimte op, dan wacht je tot het venster verloopt. De API werkt anders. Je organisatie krijgt een gebruiksniveau (tier), en dat niveau bepaalt twee soorten limieten.

De eerste is een rate limit: hoeveel je per minuut mag vragen. Anthropic meet dat per model in drie getallen: RPM (requests per minute, verzoeken per minuut), ITPM (input tokens per minute) en OTPM (output tokens per minute). Een token is een klein stukje tekst, vaak een deel van een woord. De limiet werkt als een emmer die continu bijloopt (Anthropic noemt het een token bucket), dus er is geen vast moment waarop alles weer op nul staat. Ga je erover, dan krijg je HTTP-status 429 met het fouttype rate_limit_error en een retry-after-header. Die header zegt hoeveel seconden je moet wachten. Wat de andere headers in een antwoord betekenen, lees je in de rate-limitheaders van de Claude API uitgelegd.

De tweede is een maandelijks bestedingsplafond. Op 6 oktober 2026 noemt Anthropic drie standaardniveaus: Start met een plafond van 500 dollar per maand, Build met 1.000 dollar en Scale met 200.000 dollar. Nieuwe organisaties kunnen eerst in een Evaluation-niveau beginnen, met lagere limieten. Je stijgt automatisch naar een hoger niveau naarmate je organisatie meer gebruiksgeschiedenis opbouwt. Bereik je het plafond, dan stopt de API tot 00:00 UTC op de eerste dag van de volgende maand. Je krijgt dan ook een 429, maar zonder retry-after-header en met de foutcode enforced_spend_limit_reached. Opnieuw proberen helpt dus niet. Je kunt in de Console onder Settings, Billing ook een eigen, lager plafond instellen. Dat is verstandig voor elk project dat zelfstandig draait.

Andere standaardregels voor je gegevens

Voor de API zeggen de Commercial Terms het kort: "Anthropic may not train models on Customer Content from Services." Wat je via de API stuurt, wordt dus niet gebruikt om modellen te trainen. Volgens het privacycentrum van Anthropic worden invoer en uitvoer van de API binnen 30 dagen verwijderd. Er zijn uitzonderingen. Markeert het veiligheidssysteem een verzoek als overtreding van de Usage Policy, dan kan Anthropic die gegevens tot 2 jaar bewaren. Bestanden die je via de Files API uploadt, blijven staan tot je ze zelf verwijdert. Grote klanten kunnen een aparte afspraak maken over zero data retention.

Bij claude.ai beslis je het zelf met de instelling Model Improvement in je privacy-instellingen. Staat die aan, dan mag Anthropic je gesprekken gebruiken voor training en ze in geanonimiseerde vorm tot 5 jaar bewaren. Staat die uit, dan verdwijnt een gesprek dat je verwijdert binnen 30 dagen uit de systemen. Het verschil is dus: bij de API is "geen training" de standaard, bij de chat is het een keuze die je zelf moet maken.

Wie heeft de Claude API nodig?

Je hebt de API nodig als Claude iets moet doen zonder dat er een mens in een chatvenster typt. Een paar voorbeelden uit de praktijk:

• Een ontwikkelaar die een eigen app bouwt, bijvoorbeeld een klantenservicetool die binnenkomende mail sorteert en een conceptantwoord klaarzet.
• Een kleine Nederlandse webwinkel die productteksten automatisch laat schrijven zodra er een nieuw artikel in het systeem komt.
• Een administratiekantoor dat een n8n-workflow laat draaien die pdf-facturen leest en de bedragen in een spreadsheet zet.
• Een team dat een programmeertool met een API-sleutel gebruikt, omdat het verbruik op de zakelijke rekening van de organisatie moet komen.

Je hebt de API niet nodig als je zelf met Claude wilt praten. Dan is een abonnement eenvoudiger: je krijgt een app met geheugen, en je betaalt een vast bedrag per maand. Twee vragen die hier vaak bij komen kijken, hebben een eigen artikel. Of de API of een abonnement goedkoper uitvalt, hangt af van hoeveel je gebruikt, en dat rekenen we door in de Claude API en een abonnement vergeleken op kosten. Of je de API gratis kunt proberen, staat in is de Claude API gratis te gebruiken.

Hoe betaal je voor de Claude API?

De API werkt standaard met tegoed vooraf. Je koopt tegoed in de Console, onder Settings, Billing. Elk verzoek dat lukt, wordt van dat tegoed afgeschreven. Volgens het helpcentrum betaal je alleen voor geslaagde verzoeken. Een verzoek dat mislukt, kost niets. Grotere organisaties kunnen via het salesteam een maandfactuur achteraf afspreken.

Dit zijn de vragen die een Nederlandse lezer meestal stelt, met wat Anthropic er op 6 oktober 2026 zelf over zegt.

In welke valuta koop je tegoed? In Amerikaanse dollars. Anthropic publiceert de API-prijzen in dollars per miljoen tokens, en de bestedingsplafonds staan in de documentatie als bedragen in USD. Het helpcentrum noemt geen euro-optie voor tegoed in de Console. Je bank of creditcardmaatschappij rekent het bedrag om naar euro's, en kan daar een opslag voor vragen. Meer over valuta lees je in de valuta van je Claude-rekening wijzigen.

Is er een minimumbedrag? De hulppagina over betalen en de Credit Terms van Anthropic noemen geen minimumbedrag voor een aankoop. De Console laat bij het kopen zien welk bedrag je kunt invullen. Vertrouw daarom op wat de Console je toont, en niet op een bedrag dat je op een andere website leest.

Wat gebeurt er met ongebruikt tegoed? Tegoed verloopt een jaar na de aankoopdatum, en die datum kan niet worden verlengd. Aankopen worden niet terugbetaald. Koop dus kleine bedragen tot je weet wat je verbruikt. Wil je niet dat een draaiende workflow stilvalt, zet dan auto-reload aan. Daarmee koopt de Console automatisch bij zodra je saldo onder een grens komt die je zelf kiest.

Hoe werkt btw op de Claude API voor een Nederlands bedrijf?

De prijzen op de prijspagina van Anthropic zijn exclusief btw (belasting over de toegevoegde waarde). Het helpcentrum zegt dat je factuuradres bepaalt welke belastingregels gelden. Of je btw betaalt, hangt daarnaast af van één veld: het btw-id van je organisatie.

Een bedrijf met een btw-id. Vul je btw-identificatienummer in bij de Console, onder Settings, Organization. Je contractpartij is Anthropic Ireland, een bedrijf in een ander EU-land. Bij een zakelijke dienst tussen twee EU-landen geldt dan de verleggingsregeling. De factuur komt zonder btw, en jij geeft de btw zelf aan in je btw-aangifte, in rubriek 4b. Mag je die btw volledig aftrekken, dan trek je hetzelfde bedrag in dezelfde aangifte af als voorbelasting. Per saldo betaal je dan niets. Gebruik je btw-id (het nummer dat begint met NL en eindigt op B gevolgd door twee cijfers), niet je omzetbelastingnummer. Voor een eenmanszaak zijn dat sinds 2020 twee verschillende nummers. Controleer je nummer vooraf in het VIES-systeem van de Europese Commissie, want een nummer dat daar niet klopt, wordt niet als zakelijk herkend.

Let op: de hulppagina's van Anthropic beschrijven de verleggingsregeling niet in woorden. Ze vertellen alleen waar je het btw-id invult. De verlegging volgt uit de Europese btw-regels. Kijk daarom naar je eerste factuur. Staat er btw op, dan is je btw-id niet opgeslagen of niet geldig. Vul het in vóór je eerste aankoop, en bespreek de verwerking bij twijfel met je boekhouder.

Een particulier zonder btw-id. Dan rekent Anthropic btw op basis van je factuuradres. Voor een adres in Nederland is dat het algemene tarief van 21 procent, bovenop de dollarprijs. Die btw kun je als particulier niet terugvragen. Voor abonnementen op claude.ai werkt de btw op een vergelijkbare manier, en dat staat uitgewerkt in facturen en btw bij een Claude-abonnement.

Je eerste verzoek, op je eigen computer

Dit voorbeeld voer je zelf uit, op je eigen computer of server. Het kost een paar cent aan tegoed. Je hebt een terminal met curl nodig.

1. Maak een account aan op platform.claude.com en koop een klein bedrag aan tegoed onder Settings, Billing.
2. Maak onder Settings, API keys een nieuwe sleutel aan. Je ziet de volledige sleutel maar één keer, dus kopieer hem direct.
3. Zet de sleutel in een omgevingsvariabele, zodat hij niet in je code of je shellgeschiedenis terechtkomt.

read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY

read -rs leest wat je plakt zonder het op het scherm te tonen. Druk na het plakken op Enter. Waarom een sleutel nooit in een repository hoort, en welke andere manieren van inloggen er zijn, staat in authenticatie bij de Claude API uitgelegd.

Vraag eerst welke modellen je organisatie kan gebruiken:

curl -s https://api.anthropic.com/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01"

Je krijgt een JSON-lijst terug. Elk model heeft een veld id. Kies er een, en zet die ID in een tweede variabele:

export CLAUDE_MODEL="plak-hier-een-id-uit-de-lijst"

Stuur dan je eerste vraag:

curl -s 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\": \"$CLAUDE_MODEL\", \"max_tokens\": 1024, \"messages\": [{\"role\": \"user\", \"content\": \"Leg in twee zinnen uit wat een API is.\"}]}"

Een gezond antwoord heeft "type": "message", een blok content met de tekst, en "stop_reason": "end_turn". Onderaan staat een blok usage met input_tokens en output_tokens. Dat zijn de tokens waarvoor je betaalt. Kijk daar na elke test naar, want zo leer je wat een taak kost.

Gaat het mis, dan krijg je een JSON-object met "type": "error". Het veld error.type vertelt je waarom:

• authentication_error (status 401): de sleutel is ongeldig, bijvoorbeeld verkeerd geplakt of ingetrokken. Controleer met echo ${#ANTHROPIC_API_KEY} of de variabele niet leeg is. Een 0 betekent dat de sleutel niet in deze terminal staat.
• billing_error (status 402): er is een probleem met je betaalgegevens. Kijk in de Console onder Settings, Billing.
• rate_limit_error (status 429): je zit boven een limiet of boven je maandplafond. Staat er een retry-after-header bij, wacht dan dat aantal seconden.
• not_found_error (status 404): meestal een typefout in de URL of een model-ID die niet bestaat. Neem de ID opnieuw over uit de lijst van /v1/models.

Elk antwoord bevat ook een header request-id. Noem die ID als je contact opneemt met support, zodat Anthropic precies dat verzoek kan terugvinden. Wil je na deze test een echte toepassing laten draaien die dag en nacht bereikbaar is, dan is je eerste Claude-app op een VPS de logische volgende stap.

FAQ

Heeft Claude een API?

Ja. Anthropic biedt de Claude API aan op https://api.anthropic.com. Je maakt een account aan in de Claude Console op platform.claude.com en koopt daar tegoed. Met een API-sleutel uit de Console kan daarna elk programma dat HTTPS-verzoeken stuurt Claude aanroepen, van een curl-commando tot een n8n-workflow.

Is claude.ai iets anders dan de Claude API?

Ja. Claude.ai is een chat-app met projecten en geheugen, voor een vast maandbedrag. De Claude API is toegang voor software, zonder interface, met betaling per gebruik vanuit tegoed in de Console. Het zijn aparte producten met aparte accounts. Een betaald abonnement geeft geen API-tegoed, en API-tegoed geeft geen extra ruimte in de chat.

Krijg ik API-toegang bij mijn Pro- of Max-abonnement?

Nee. Anthropic zegt in het helpcentrum dat een betaald abonnement geen toegang geeft tot de Claude API of de Console. Wil je beide, dan neem je het abonnement voor de chat en koop je apart tegoed in de Console voor de API.

Betaal ik btw op de Claude API als Nederlands bedrijf?

Met een geldig btw-id in de Console, onder Settings, Organization, hoort de factuur van Anthropic Ireland zonder btw te komen. Je geeft de btw dan zelf aan via de verleggingsregeling in rubriek 4b en trekt die af als voorbelasting. Zonder btw-id rekent Anthropic btw op basis van je factuuradres, en die kun je als particulier niet terugvragen. Op 6 oktober 2026 koop je het tegoed in Amerikaanse dollars.