Claude API-handleiding: prijzen, installatie en je eerste verzoek

Om je eerste Claude API-verzoek te doen, maak je een Claude Console-sleutel aan, sla je deze op in een omgevingsvariabele, roep je het Messages-eindpunt aan en lees je de geretourneerde gebruik velden, en bereken de kosten van de tokens. Deze handleiding leidt je door dit proces aan de hand van de huidige model-ID’s en prijzen, gecontroleerd op 8 september 2026.

Als je eenmaal het API-traject begrijpt, is de volgende vraag in hoeverre je dagelijkse werkzaamheden daadwerkelijk een aangepaste integratie vereisen. Voor onderzoek, schrijven, programmeren en creatieve productie, GlobalGPT biedt een voordeligere manier om Claude te gebruiken in combinatie met GPT-5.6 Sol, Gemini 3 Pro, Kimi K3 en andere toonaangevende modellen. Met één abonnement worden de modellen en een uitgebreide set AI-tools in één dashboard samengebracht, zodat het werk van idee tot eindresultaat kan verlopen zonder dat het over verschillende diensten hoeft te worden verdeeld. Wanneer u AI in uw ontwikkelomgeving wilt integreren, verbindt de GlobalGPT CLI diezelfde werkruimte met uw terminal en bestaande productietools.

Probeer Claude Opus 5 eens

Wat is de Claude API?

De Claude API is de ontwikkelaarsinterface van Anthropic waarmee vanuit een applicatie, script of backend-service gestructureerde verzoeken naar Claude-modellen kunnen worden verzonden. Je verstuurt berichten naar een HTTPS-eindpunt en ontvangt een gestructureerd antwoord met daarin gegenereerde inhoud en metagegevens, zoals het model, de reden voor het stoppen en het tokengebruik.

Claude API versus Claude.ai-abonnementen

API-toegang en Claude.ai-abonnementen zijn bedoeld voor verschillende doeleinden. Met een Claude.ai-abonnement krijgt iemand toegang tot het chatproduct van Anthropic. De API biedt ontwikkelaars toegang via de Claude Console, waarbij afzonderlijke facturering plaatsvindt op basis van gebruik. In het Helpcentrum van Anthropic staat vermeld dat Claude Pro geen gebruik van de Console-API omvat.

Als je meer informatie wilt over het bredere onderscheid tussen consumentenabonnementen, de Claude-code en tokenfacturering, raadpleeg dan onze volledige Prijsgids voor Claude. Het belangrijkste punt in deze handleiding is simpel: maak het API-account aan en zorg voor de financiering ervan, los van elk Claude.ai-abonnement.

Het vijfstappenplan voor een eerste verzoek

1. Maak een API-sleutel aan in de Claude-console.
2. Bewaar het in de ANTHROPIC_API_KEY omgevingsvariabele.
3. Stuur een verzoek naar https://api.anthropic.com/v1/messages.
4. Lees de teruggestuurde inhoud en gebruik object.
5. Vermenigvuldig elke tokencategorie met het bijbehorende tarief per miljoen tokens.

Prijzen voor de Claude API en huidige model-ID’s

Anthropic geeft API-prijzen weer in Amerikaanse dollar per miljoen tokens, vaak afgekort als MTok. Invoer en uitvoer worden apart gefactureerd. Bij prompt-caching gelden aparte tarieven voor schrijfbewerkingen van vijf minuten, schrijfbewerkingen van één uur en het ophalen van gegevens uit de cache; voor een betrouwbare schatting moeten deze categorieën dus apart worden gehouden.

Huidige modellen en exacte API-ID's

Welk model moet je voor deze tutorial gebruiken?

De officiële Quickstart die werd gebruikt claude-opus-5 op het moment dat deze handleiding werd gecontroleerd, dus in de onderstaande cURL- en Python-voorbeelden wordt dezelfde ID gebruikt. Beschouw Opus als uitgangspunt voor de tutorial en kies vervolgens het productiemodel op basis van de werklast, kwaliteitseisen, latentie en het budget. Model-ID’s en de levenscyclusstatus kunnen veranderen, dus controleer de pagina’s ‘Modellen’ en ‘Verouderde functies’ nogmaals voordat je code met een lange levensduur in productie neemt.

Wat je nodig hebt voordat je je eerste aanvraag indient

Maak een Claude Console-account en een API-sleutel aan

Open de Claude-console, maak de juiste organisatie aan of selecteer deze, en maak een API-sleutel aan. Anthropic waarschuwt dat een nieuwe sleutel slechts één keer wordt weergegeven; sla deze daarom op in een goedgekeurde geheimenbeheerder of op een andere veilige locatie zodra deze verschijnt. Plaats de sleutel niet in een screenshot, een gedeeld document, een openbare repository of in JavaScript aan de browserzijde.

Sla de sleutel op in een omgevingsvariabele

In de voorbeelden wordt ervan uitgegaan dat de variabele ANTHROPIC_API_KEY. Voer de werkelijke waarde alleen in je eigen terminal of in je systeem voor het beheer van geheimen in. Het onderstaande commando leest de waarde zonder deze op het scherm weer te geven en exporteert deze vervolgens voor de huidige shell-sessie:

read -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY

Omgevingsvariabelen verminderen het risico op onbedoelde blootstelling, maar vormen geen volledige strategie voor het beheer van geheimen. Productietoepassingen moeten de richtlijnen van het hostingplatform volgen met betrekking tot de opslag van geheimen en de toegangscontrole.

Controleer de factuur en kies een veilige testlimiet

De facturering voor API-gebruik staat los van de abonnementen op Claude.ai. Volgens Anthropic betalen de meeste organisaties hun gebruikskrediet vooraf, terwijl organisaties met maandelijkse facturering hierop een uitzondering vormen. Controleer of je Console-account API-verzoeken kan versturen, en houd het eerste verzoek vervolgens beperkt door max_tokens: 128. Dat veld beperkt de gegenereerde output; het reserveert of garandeert geen 128 gefactureerde output-tokens.

Verzend je eerste Claude API-verzoek met cURL

cURL is handig om de opbouw van het verzoek direct te bekijken. In het onderstaande voorbeeld wordt gebruikgemaakt van het Messages-eindpunt, het inhoudstype JSON, de API-sleutel in de header, de versie-header van Anthropic, de geverifieerde Quickstart-model-ID en één gebruikersbericht.

Voordat je een van beide voorbeelden uitvoert, moet je je eigen API-sleutel toevoegen en controleren of API-facturering is ingeschakeld voor de organisatie. De code volgt het door Anthropic gedocumenteerde verzoekformaat en heeft de lokale syntaxiscontroles doorstaan, maar er is hier geen reactie van een live-account opgenomen.

curl https://api.anthropic.com/v1/messages \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data '{
    "model": "claude-opus-5",
    "max_tokens": 128,
    "messages": [{
 "role": "user",
 "content": "Geef in één zin uitleg over wat een API is."
    }]
  }'

Wat elke header en elk JSON-veld doet

Als het commando een foutmelding geeft, controleer dan eerst de HTTP-status en het fouttype voordat je het verzoek aanpast. Fouten met betrekking tot authenticatie en facturering vereisen een aanpassing aan het account, terwijl onjuist opgebouwde JSON of een ongeldige model-ID een aanpassing van het verzoek vereisen.

Hetzelfde verzoek verzenden met de Python SDK

Installeer de officiële Anthropic SDK

python -m pip install anthropic

Gebruik een virtuele omgeving als dat deel uitmaakt van je normale Python-werkstroom. De SDK leest ANTHROPIC_API_KEY uit de omgeving wanneer anthropic.Anthropic() wordt aangemaakt zonder expliciete sleutel.

Voer het overeenkomstige Python-verzoek uit

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=128,
    messages=[
 {
 "role": "user",
 "content": "Geef in één zin uitleg over wat een API is.",
 }
    ],
)

for block in message.content:
    if block.type == "text":
 print(block.text)

print(message.usage)

Lees de teruggestuurde tekst op een veilige manier

Een berichtreactie kan uit meer dan één inhoudsblok bestaan, dus in het voorbeeld wordt het type van elk blok gecontroleerd voordat de tekst wordt weergegeven. In echte toepassingen moet het verzoek-ID ook beschikbaar blijven voor ondersteuning en logboekregistratie, zonder dat het openbaar wordt gemaakt; het geretourneerde model en de reden voor de stopzetting moeten worden vastgelegd en API-fouten moeten expliciet worden afgehandeld.

Laat de controle op inhoudsblokken ook staan als je een kort tekstantwoord verwacht. Dit maakt het gemakkelijker om het voorbeeld uit te breiden wanneer een antwoord uit meerdere blokken bestaat, en bij het afdrukken message.usage geeft je de cijfers die je nodig hebt voor de onderstaande kostenberekening.

Hoe u het verbruik afleest en de kosten berekent

Zoek de reactietekst, het model, de reden voor het afbreken en het verzoek-ID

Het responscontract van de Messages API bevat gegenereerde inhoud, het model dat het verzoek heeft verwerkt en een reden voor afbreking. De HTTP-respons bevat ook een verzoek-ID waarmee de Anthropic-ondersteuning een probleem kan traceren. Noteer ID’s zorgvuldig; publiceer ze niet samen met inhoud of inloggegevens van klanten.

Het gebruik van input-, output- en cache-tokens achterhalen

De gebruik Het object rapporteert de tokencategorieën die nodig zijn voor kostenanalyse. Let in ieder geval op input- en output-tokens. Wanneer prompt-caching wordt gebruikt, moet u cache-schrijfbewerkingen van vijf minuten, cache-schrijfbewerkingen van één uur en cache-leesbewerkingen apart houden, omdat deze verschillende tarieven hebben. Het eindpunt ‘Token Counting’ van Anthropic kan het aantal invoertokens vóór een verzoek schatten, maar de schatting kan enigszins afwijken van het uiteindelijke invoerverbruik en heeft zijn eigen tarieflimieten.

Het gebruik van tokens omzetten in geschatte kosten

Bereken elke categorie afzonderlijk en tel vervolgens de resultaten bij elkaar op. In een planningsvoorbeeld waarbij gebruik wordt gemaakt van Claude Opus 5 tegen standaard wereldwijde tarieven, kosten 1.000 niet-gecachete invoertokens 1.000 × $5 / 1.000.000 = $0,005, terwijl 300 output-tokens kosten 300 × $25 / 1.000.000 = $0,0075. Het geschatte totaal bedraagt $0.0125. Vervang deze voorbeelden van het aantal tokens door de gebruik waarden uit je eigen antwoord.

Claude API-prijscalculator

Gebruik de calculator om het model, het aantal verzoeken, de tokencategorieën, de factureringswijze en de regio voor inferentie aan te passen. Bij batchverwerking worden in aanmerking komende gebruikskosten berekend tegen 50% van de standaardtarieven. Bij inferentie uitsluitend in de VS wordt een factor van 1,1 toegepast op alle token-categorieën voor in aanmerking komende Claude 4.6+-modellen; Claude Haiku 4.5 komt niet in aanmerking, waardoor die combinatie een niet-ondersteunde status oplevert.

De offerte dient als hulpmiddel bij de planning en is geen factuur. Belastingen, valutaconversie, onderhandelde voorwaarden, Fast Mode, kosten voor servertools en accountspecifieke voorwaarden zijn hierin niet inbegrepen. Prijzen en voorwaarden kunnen veranderen; raadpleeg daarom nogmaals de officiële prijspagina voordat u een aankoopbeslissing neemt of een beslissing over de architectuur neemt.

De bovenstaande calculator geeft een overzicht van de kostenopbouw van programmeerbare, op verbruik gebaseerde Claude API-aanroepen. Voor dagelijkse werkzaamheden waarbij gebruik wordt gemaakt van verschillende modellen en AI-mogelijkheden, GlobalGPT biedt een ander soort meerwaarde: met één abonnement worden meerdere gangbare modellen en tools in één dashboard samengebracht, waardoor de kosten beter te voorspellen zijn en onderzoek, schrijven, programmeren en creatief werk niet meer verspreid zijn over afzonderlijke abonnementen en versnipperde interfaces. De CLI brengt hetzelfde platform naar terminalgebaseerde ontwikkeling en de productietools die je al gebruikt. Onze gids voor op één plek met meerdere AI-modellen werken laat zien hoe het bredere platform in elkaar zit.

Veelvoorkomende Claude API-fouten en oplossingen

Begin met de HTTP-status en het fouttype Anthropic, en bekijk vervolgens het verzoek zonder de sleutel vrij te geven. De officiële betekenis beperkt het zoekgebied; de waarschijnlijke oorzaak hangt nog steeds af van je account, het gekozen model, de vorm van het verzoek en het verkeer.

Een veilige volgorde voor het opsporen van fouten

1. Registreer de status, het fouttype, het tijdstempel en het verzoek-ID, zonder de API-sleutel te registreren.
2. Controleer het eindpunt, de headers, de JSON-syntaxis, de model-ID en de limiet voor de verzoekgrootte.
3. Controleer de facturatiegegevens van de organisatie, de machtigingen, de headers voor het limietbeheer en de huidige levenscyclus van het model.
4. Probeer alleen fouten opnieuw die redelijkerwijs van tijdelijke aard kunnen zijn, met behulp van een begrensde exponentiële backoff en jitter.
5. Als de fout blijft optreden, beperk het verzoek dan tot het kleinste reproduceerbare geval voordat u contact opneemt met de helpdesk.

De officiële SDK's van Anthropic proberen bij verbindingsfouten, 429-responsen en 5xx-responsen standaard twee keer opnieuw verbinding te maken. De herprobeerlogica op applicatieniveau moet nog steeds worden beperkt en er moet rekening worden gehouden met idempotentie, vooral wanneer een verzoek tools of een andere externe actie kan activeren.

Hoe de kosten van de Claude-API te beheersen

Stel conservatieve uitvoerlimieten in

Begin met de kleinste max_tokens waarde die nog steeds een bruikbaar antwoord kan opleveren. Meet het daadwerkelijke gebruik van de uitvoer voordat je dit verhoogt. Kortere prompts kunnen helpen, maar het verwijderen van instructies die herpogingen, fouten of onbruikbare uitvoer voorkomen, kan in totaal meer kosten.

Gebruik prompt-caching en Batch alleen wanneer deze geschikt zijn

• Gebruik prompt-caching wanneer een aanzienlijk deel van het promptvoorvoegsel zich herhaalt en de levensduur van de cache aansluit bij de workflow.
• Gebruik Batch voor taken die asynchroon kunnen worden uitgevoerd; voor in aanmerking komend gebruik van Batch geldt een tarief van 50% volgens de standaardtarieven.
• Houd het schrijven en lezen van de cache in de rapportage gescheiden, zodat de besparing zichtbaar is in plaats van dat er alleen maar van wordt uitgegaan.
• Pas de ‘alleen VS’-conclusie alleen toe wanneer de woonplaatsvereiste de tokenprijsfactor van 1,1x rechtvaardigt en het geselecteerde model in aanmerking komt.

Gebruik, tarieflimieten en bestedingslimieten bijhouden

Houd het aantal verzoeken, de model-ID, het gebruik van invoer en uitvoer, de cachecategorieën, het aantal herhalingspogingen en de fouten bij. Stel waarschuwingen of bestedingslimieten in die voor uw organisatie beschikbaar zijn, maar ga er niet vanuit dat het niveau of de limiet van een ander account ook voor uw account geldt. Onze uitgebreidere handleiding over Claude-abonnementen, API-kosten en limieten omvat de bredere factureringskanalen.

Volgende stappen na uw eerste aanvraag

Kies de juiste aanpak voor je volgende project

Voor een toepassing kun je verdergaan met de officiële Messages API-referentie van Anthropic, de richtlijnen voor streaming, de documentatie over het gebruik van tools, de pagina’s over de levenscyclus van modellen en je eigen logboek- en evaluatieplan. Leg bewust een modelstrategie vast, pak fouten aan voordat je verkeer toevoegt en bereken de kosten op basis van het waargenomen gebruik in plaats van alleen op basis van de lengte van de prompts.

Als programmeren je belangrijkste toepassing is, dan is onze gids over Claude AI gebruiken voor codering behandelt praktische manieren om van een interactieve programmeeropdracht over te stappen naar een herhaalbare ontwikkelingsworkflow.

Wanneer een werkruimte met meerdere modellen de betere keuze is

Directe API-toegang is de juiste keuze wanneer je integratie op codeniveau, facturering aan ontwikkelaars, metagegevens van verzoeken of officiële platforminstellingen nodig hebt. Als je interactief wilt schrijven, onderzoek wilt doen, plannen wilt maken of resultaten van verschillende aanbieders wilt vergelijken zonder een applicatie te bouwen, is een multimodale werkruimte wellicht praktischer.

Veelgestelde vragen

Is de Claude API gratis?

Er wordt hier geen algemene gratis API-quota beloofd. Het gebruik van de Claude-API wordt apart in rekening gebracht via de Claude Console, en volgens Anthropic betalen de meeste organisaties het gebruik met vooraf betaalde tegoeden; organisaties die maandelijks worden gefactureerd vormen hierop een uitzondering. Raadpleeg de actuele Console en de officiële prijsinformatie voor uw organisatie voordat u verzoeken verstuurt.

Hoe krijg ik een Claude API-sleutel?

Maak in de Claude-console een sleutel aan voor de betreffende organisatie. Anthropic waarschuwt dat de nieuwe sleutel slechts één keer wordt weergegeven, dus bewaar deze veilig zodra deze verschijnt. Laad de sleutel via een omgevingsvariabele aan de serverzijde of via een geheimbeheerder, en maak deze nooit zichtbaar in browsercode, schermafbeeldingen of een openbare repository.

Welk Claude-model-ID moet ik gebruiken?

In deze handleiding wordt gebruikgemaakt van claude-opus-5 omdat dat het model was in de officiële Quickstart van Anthropic, zoals gecontroleerd op 8 september 2026. Kies het model dat bij uw werklast en budget past, en controleer de pagina’s ‘Modellen’ en ‘Verouderde modellen’ van Anthropic nogmaals, aangezien model-ID’s, aliassen en de levenscyclusstatus kunnen veranderen.

Welk eindpunt gebruikt de Claude-API?

Het eerste verzoek in deze handleiding maakt gebruik van het Messages-eindpunt op https://api.anthropic.com/v1/messages. Het verstuurt JSON met de headers `content-type`, `x-api-key` en `anthropic-version`. Anthropic biedt ook andere API-mogelijkheden, dus raadpleeg de referentiepagina voor de bewerking die u implementeert.

Zijn er API-tegoedpunten inbegrepen bij Claude Pro?

In het Helpcentrum van Anthropic staat vermeld dat Claude Pro geen gebruik via de Claude Console omvat. Een Claude.ai-abonnement en API-facturering zijn afzonderlijke producten. Stel API-facturering in de Console in voor verzoeken van ontwikkelaars en maak gebruik van onze Prijsgids voor Claude voor een bredere vergelijking van de plannen.

Hoeveel kost één Claude API-verzoek?

De kosten zijn afhankelijk van het gekozen model, het aantal invoertokens, het aantal uitvoertokens, het aantal schrijfbewerkingen in de cache, het aantal leesbewerkingen in de cache, de batchmodus en het in aanmerking komende geografische gebied voor inferentie. Bereken elke categorie door het aantal verzoeken te vermenigvuldigen met het aantal tokens en vervolgens met het effectieve tarief per miljoen tokens, en dit resultaat te delen door één miljoen; tel vervolgens de categorieën bij elkaar op. Gebruik de bovenstaande calculator voor een schatting.

Waarom krijg ik een 401-foutmelding?

Een 401 is een authenticatiefout. Controleer of de API-sleutel bestaat, nog steeds actief is, bij de juiste organisatie hoort en de server bereikt in de x-api-key koptekst. Druk de sleutel niet af en deel deze niet tijdens het opsporen van fouten. Herhaalde pogingen zullen een ontbrekende of ongeldige inloggegeven niet herstellen.

Waarom krijg ik een 429-foutmelding?

Een 429-foutmelding betekent dat het verzoek de snelheidslimiet heeft overschreden. Limieten kunnen per organisatie en gebruiksniveau verschillen, dus controleer de geretourneerde headers met betrekking tot de snelheidslimiet en raadpleeg de huidige Console of documentatie. Beperk het aantal gelijktijdige verzoeken, houd je aan de wachttijden voor herhalingspogingen en maak gebruik van een begrensde exponentiële backoff met jitter in plaats van dezelfde reeks verzoeken onmiddellijk te herhalen.

Opmerking over de herkomst en versheid: Model-ID’s, prijzen, API-gedrag en ondersteuningsbeleid zijn op 8 september 2026 getoetst aan de officiële documentatie van Anthropic. Raadpleeg de actuele model- en prijspagina’s voordat u het systeem in productie neemt, en voer vervolgens de voorbeelden uit met uw eigen Claude Console-sleutel, factureringsinstellingen en accounttoegang.