De Claude API is de programmeerbare toegang tot de Claude-modellen van Anthropic: je software stuurt een verzoek en krijgt het antwoord van het model terug, zonder chatvenster. Waar de chat, de desktop-app en Claude Code elk een eigen plek hebben in de Claude handleiding, is de API de route om Claude in je eigen software in te bouwen. Toegang regel je in de Claude Console, los van een eventueel claude.ai-abonnement.
Je zet de API in voor taken die vaker terugkomen dan je met de hand wilt prompten, zoals documenten uitlezen, tickets sorteren of rapportages samenvatten, en voor koppelingen met software die je al gebruikt.
Elke koppeling begint met een API key: een geheime sleutel die je in de Console aanmaakt, één keer te zien krijgt en daarna zelf veilig bewaart. Met die key doe je een eerste aanroep via een officiële SDK of een no-code tool; de Playground in de Console werkt zonder key.
In productie bepalen drie dingen of een koppeling betrouwbaar blijft draaien: rate limits, foutcodes en wisselende uitkomsten bij identieke prompts. Wie de API zakelijk inzet, wil daarnaast weten hoe veilig bedrijfsgegevens zijn en of het zonder programmeerkennis lukt.
Wat is de Claude API?
De Claude API is een programmeerinterface van Anthropic die software rechtstreeks toegang geeft tot de Claude-modellen: een programma stuurt een verzoek naar api.anthropic.com en krijgt het antwoord van het model terug als JSON.
Een API heeft geen chatvenster en geen geheugen tussen twee aanroepen. Je software stuurt bij elk verzoek de gespreksgeschiedenis mee die het model nodig heeft, plus eventueel een systeemprompt met rol en instructies.
Achter de API draaien dezelfde modellen als achter Claude AI in de chat. Wat verschilt, is de manier van aanroepen en de instellingen die je zelf meegeeft, zoals de maximale lengte van een antwoord.
Naast de directe API bij Anthropic is Claude beschikbaar via Amazon Bedrock, Google Cloud en Microsoft Foundry. Facturatie en toegangsbeheer lopen daar via de cloudaanbieder.
Hoe verhoudt de Claude API zich tot andere Claude-producten?
De Claude API is een apart product naast claude.ai en Claude Code, met een eigen account, eigen sleutels en eigen facturatie. Welke van de drie je nodig hebt, hangt af van wat je doet: chatten, code laten schrijven of Claude inbouwen in je eigen software.
Verschil met claude.ai
De Claude API verschilt van claude.ai in de toegang: claude.ai is de chatomgeving met een abonnement, de API loopt via een aparte organisatie in de Claude Console.
Een Pro- of Enterprise-abonnement bevat geen API-gebruik. Volgens de helpdocumentatie van Anthropic bevatten Max- en Team-abonnementen wel een maandelijks API-tegoed, dat je koppelt aan één Console-organisatie en dat aan het einde van elke factuurperiode vervalt. Je gebruikt dat tegoed voor de API en de Playground, niet voor interactief gebruik van Claude Code.
Buiten dat tegoed betaal je vooraf in de Console en rekent Anthropic per token af, waarbij de kosten van de Claude API per model verschillen en uitvoer duurder is dan invoer. Een token is een tekstfragment, vaak een deel van een woord.
Wat in claude.ai werkt, werkt via de API niet altijd identiek. In mijn Python-scripts die de Claude API aanroepen, ontbreekt de context die de interface automatisch meegeeft. Prompts uit de chat stem ik daarom apart af op de systeemprompt, temperature en max_tokens van de API.
Verschil met Claude Code
Claude Code verschilt van de Claude API in het doel: Claude Code is een programmeerassistent die in de terminal en de code-editor bestanden leest, wijzigt en commando’s uitvoert. De API is de bouwsteen waarmee je Claude zelf aanroept vanuit een script, een applicatie of een automatiseringstool.
Voor wie vooral code wil laten schrijven, is Claude Code de directe route en is een eigen API-koppeling overbodig.
Waarvoor gebruik je de Claude API?
De Claude API gebruik je voor taken die vaker terugkomen dan je met de hand wilt prompten, en op plekken waar Claude binnen andere software werkt. Vijf veelvoorkomende toepassingen:
- Sorteren van binnenkomende e-mail of tickets op onderwerp en urgentie, waarna een medewerker alleen de uitzonderingen beoordeelt.
- Uitlezen van facturen, contracten of formulieren en de gegevens als vaste velden doorzetten naar een boekhoud- of CRM-systeem.
- Samenvatten van lange rapportages, notulen of klantbriefings in een vast format, zodat elke samenvatting dezelfde opbouw heeft.
- Draaien van content- en analyseworkflows, zoals een concepttekst op basis van een vaste briefing of een periodieke analyse van exportdata.
- Bouwen van koppelingen in n8n, Make of Zapier, waar Claude een stap vormt tussen twee andere applicaties.
Op mijn VPS draait een workflow waarin Claude via de API Search Console-data analyseert. Met de Claude API bouwde ik ook een content pipeline en een script dat cursus-updates als SQL-statements genereert en vooraf controleert. Elk van die toepassingen voert steeds dezelfde taak uit op wisselende invoer, met een controlestap voordat de uitkomst wordt opgeslagen of gepubliceerd.
Hoe maak je een Claude API key aan?
Om een Claude API key te maken, log je in op de Claude Console en maak je de key aan onder de instellingen van je organisatie. De stappen in de Console:
- Maak een account aan of log in op platform.claude.com, de Claude Console van Anthropic.
- Voeg onder Billing (facturatie) tegoed toe, of koppel vanuit claude.ai het maandtegoed van je Max- of Team-abonnement aan deze organisatie.
- Open Settings > API keys (instellingen, API-sleutels) en klik op Create key (sleutel aanmaken).
- Geef de key een herkenbare naam, kies een vervaltermijn en beperk de key eventueel tot één workspace.
- Kopieer de key direct: de Console toont de volledige sleutel, die begint met sk-ant-, maar één keer.
Een verloren key bekijk je niet opnieuw; je maakt een nieuwe aan en trekt de oude in. Een beheerder maakt de key voor je aan wanneer de knop Create key grijs is, want dan mist je rol in de organisatie de rechten.
Welk type API key kies je?
Een Claude API key kies je op basis van wie of wat de key gebruikt. Anthropic onderscheidt drie typen:
- Persoonlijke key: werkt namens jou en stopt zodra je de organisatie verlaat, bedoeld voor eigen ontwikkel- en testwerk.
- Key voor een serviceaccount: hoort bij een serviceaccount in plaats van een persoon, bedoeld voor productieworkflows en gedeelde koppelingen.
- Workspace-key: een ouder type zonder eigenaar dat blijft werken na vertrek van de maker; Anthropic raadt dit type af.
Voor een automatisering die blijft draaien wanneer een collega vertrekt, is een key voor een serviceaccount de passende keuze.
Hoe bewaar je een API key veilig?
Om een API key veilig te bewaren, zet je hem in een omgevingsvariabele en nooit in de code zelf. De officiële SDK’s lezen de variabele ANTHROPIC_API_KEY automatisch uit.
Een key in een gedeeld document, een Git-repository of de broncode van een website is bruikbaar voor iedereen met toegang, en elk verzoek met die key gaat van jouw tegoed af. Gebruik daarom per toepassing een aparte key, stel een vervaltermijn in en trek een key direct in zodra je vermoedt dat hij gelekt is.
Bij mijn eigen automatiseringen begin ik met drie vragen: welke data erin gaat, waar die terechtkomt en wie erbij kan.
Welk Claude-model gebruik je via de API?
Via de Claude API kies je per aanroep een model uit drie modellijnen: Haiku, Sonnet en Opus. Anthropic positioneert Haiku als het snelste en goedkoopste model, Opus als het model voor complexe taken en Sonnet daartussen. Boven Opus staat Claude Fable, een zwaarder model met extra veiligheidsmaatregelen.
De keuze voor welk Claude-model je inzet, maak je per taak en niet per project. Eén workflow gebruikt vaak een licht model voor het sorteren en een zwaarder model voor de uitzonderingen.
Bij de overstap van Claude Opus 4.6 naar 4.7 merkte ik dat bestaande prompts opnieuw getest en deels herschreven moesten worden om dezelfde kwaliteit te halen. Een nieuw model in een productieworkflow test ik daarom eerst op een kleine sample.
Hoe doe je een eerste aanroep naar de Claude API?
Om een eerste aanroep naar de Claude API te doen, kies je een van drie routes: de Playground in de Console, een officiële SDK of een direct HTTP-verzoek.
De Playground heeft de laagste drempel. Je typt een systeemprompt en een bericht, kiest een model en ziet het antwoord, zonder een regel code.
Anthropic levert officiële SDK’s voor onder meer Python, TypeScript, Java, Go, C#, PHP en Ruby. Een minimale aanroep in Python, na pip install anthropic en met de key in de omgevingsvariabele:
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1000,
messages=[{"role": "user", "content": "Vat deze klacht samen in drie zinnen: ..."}],
)
print(message.content[0].text)Drie velden zijn verplicht: model, max_tokens en messages. Een systeemprompt geef je mee via het veld system, los van de berichten.
Welke knelpunten heeft de Claude API in productie?
De Claude API heeft in productie vier knelpunten die tijdens een losse test zelden opvallen:
- Rate limits en usage tiers: Anthropic begrenst per usage tier het aantal verzoeken en tokens per minuut en het bedrag per maand. Bij bulk-analyses liep ik daar zelf tegenaan; batchverwerking of wachten tussen aanroepen lost het op.
- Foutcodes: 429 betekent een bereikte limiet, 529 een tijdelijk overbelaste API en 500 een interne fout bij Anthropic. De officiële SDK’s proberen 429- en 5xx-fouten standaard twee keer opnieuw; een eigen script zonder retry-logica stopt bij de eerste verstoring.
- Wisselende uitkomsten: dezelfde prompt levert niet altijd hetzelfde antwoord op, ook niet bij een lage temperature. In mijn workflows vang ik dat op met strenge validatie van de uitvoer, zoals een controle op het verwachte JSON-formaat.
- Testkosten: tijdens het bouwen itereer je vaker dan in productie, waardoor de kosten in de bouwfase hoger uitvallen dan verwacht. Een bestedingslimiet per workspace en een test-run op een kleine sample houden dat beheersbaar.
Is de Claude API veilig voor bedrijfsgegevens?
Ja, de Claude API is geschikt voor bedrijfsgegevens, omdat Anthropic volgens zijn privacycentrum invoer en uitvoer van de API standaard niet gebruikt om modellen te trainen. Anthropic treedt daarbij op als verwerker onder de commerciële voorwaarden. De verwerkersovereenkomst (Data Processing Addendum) is automatisch onderdeel van die voorwaarden en hoeft niet apart getekend te worden.
Geschikt betekent nog niet toegestaan. Voor persoonsgegevens heb je onder de AVG een grondslag en afspraken met de verwerker nodig, en het kantoor bepaalt zelf welke gegevens naar een externe dienst gaan. Namen, adressen en identificerende nummers uit de invoer halen voordat een verzoek wordt verstuurd, verkleint het risico.
Kun je de Claude API gebruiken zonder te programmeren?
Ja, de Claude API is bruikbaar zonder programmeerkennis, omdat de Playground en no-code tools zoals n8n, Make en Zapier de technische kant van het verzoek overnemen. In zo’n tool plak je de API key in een koppeling, kies je een model en zet je Claude als stap tussen bijvoorbeeld een mailbox en een spreadsheet.
Een eigen script vraagt wel code. Ik bouw mijn eigen automatiseringen met AI als bouwpartner, en loop daarbij tegen een duidelijke grens aan: eenvoudige tot middelgrote automatiseringen lukken, uitgebreide software met veel samenhangende onderdelen niet.
Hoe leer je automatiseren met de Claude API?
Automatiseren met de Claude API leer je door één terugkerende taak te kiezen, die eerst in de Playground uit te werken en pas daarna een koppeling met een controlestap te bouwen. Eén taak met voorspelbare invoer leert je meer over prompts, limieten en kosten dan een brede automatisering die op tien plekken tegelijk faalt.
Met een API key, wat tegoed en een duidelijke taak heb je alles om te starten. De AI automatisering cursus werkt die route stap voor stap uit tot een werkende automatisering op je eigen werk, zonder dat je vooraf programmeerkennis nodig hebt.
