Cursus
Claude Code 101
3 uur
28.3K
Met de Claude API van Anthropic ga je verder dan alleen chatten met een chatbot. Je krijgt de mogelijkheid om alle capaciteiten van Claude AI in je eigen applicaties te integreren.
Anthropic schokte de AI-wereld met de release van Fable 5, een model zó capabel dat de Amerikaanse overheid kort na de lancering de toegang er tijdelijk toe beperkte. Hoewel het model inmiddels weer beschikbaar is voor gebruikers wereldwijd, is de manier waarop we het gebruiken veranderd.
Anthropic beperkt Fable 5 nu exclusief tot API-toegang op basis van verbruikte credits (met de afschakeling na een korte verlenging van vijf dagen).
Dat betekent dat we opnieuw moeten nadenken over hoe we met AI omgaan. Krachtige modellen en geautomatiseerde codeertools vragen aanzienlijk meer rekenkracht dan consumentenabonnementen met een vast tarief kunnen bieden.
In deze tutorial bereid ik je voor op deze nieuwe realiteit door te laten zien hoe je de Claude API gebruikt.
Ik leer je precies hoe je Claude Code instelt met de Anthropic Developer API. Door vandaag over te stappen op het pay-as-you-go-model, verzeker je jezelf van ononderbroken toegang tot geavanceerde modellen zoals Fable 5, haal je onzichtbare ratelimieten weg en leer je complexe codeersessies rechtstreeks vanuit je terminal draaien.
Als je een snelle naslag zoekt, raad ik de Claude API in Python-cheat sheet aan.
Waarom je de Claude API nodig hebt in plaats van een Claude Pro-abonnement
Voor velen was het maandelijkse Claude Pro-plan van $20 de ideale manier om toegang te krijgen tot topklasse AI. Het bood een vaste prijs en stabiele toegang.
Maar de opkomst van geautomatiseerde codeertools heeft de rekensom volledig veranderd. Agentische workflows vragen veel meer middelen dan een standaardabonnement kan leveren, waardoor de Claude API de enige haalbare optie is voor serieuze developers.
Hieronder staan drie hoofdredenen om het abonnement te laten varen en Claude Code rechtstreeks via de API te gebruiken.
Tokenverbruik door agentische tools
Standaardplannen hebben moeite met tools als Claude Code vanwege de manier waarop deze tools werken.
In tegenstelling tot een simpele webchat moet een geautomatiseerde ontwikkeltool voortdurend ons hele project scannen om te begrijpen waaraan het werkt.
Elke keer dat we een taak geven, doorloopt het meerdere stappen: bestanden lezen, structuren controleren en tests uitvoeren. Dat vereist het heen en weer sturen van enorme hoeveelheden data om de AI op de hoogte te houden van de actuele staat van onze code.
Dit proces verbruikt razendsnel tokens. Met een Pro-abonnement kunnen zulke complexe workflows onze gebruikslimiet van meerdere uren in enkele minuten opsouperen, waardoor ons werk abrupt stilvalt.
Je dagelijkse gebruikscapaciteit beschermen
Claude Pro-accounts gebruiken één gedeelde pool van resources. Als we ons hoofdaccount inzetten voor terminalgebaseerd coderen, snoepen die zware geautomatiseerde taken af van de capaciteit die we hebben voor de browser of mobiele app.
Je wilt niet buitengesloten worden van een simpel gesprek omdat een achtergrondtaak onze limiet heeft geraakt. Door je ontwikkeltools via de Claude API te laten lopen, houd je je professionele codeerwerk volledig gescheiden van je alledaags AI-gebruik.
Exclusieve toegang tot zwaargewichtmodellen
Naarmate Anthropic modellen uitbrengt die specifiek zijn gebouwd voor zware engineering en autonoom werk, zoals Claude Fable 5, stappen ze af van plannen met een vast tarief.
Omdat Fable 5 enorme rekenkracht vereist, heeft Anthropic bevestigd dat dit specifieke model uiteindelijk afrekening per gebruik vereist om de hoge operationele kosten te dekken.
Deze beperking is een voorproefje van de toekomst. Als je vasthoudt aan een consumentenabonnement, verlies je op termijn de toegang tot de krachtigste redeneermodellen van Anthropic, waardoor een Claude API-account een harde voorwaarde wordt om voorop te blijven lopen.
Claude API vs Claude-abonnement
Het verschil tussen een consumentenabonnement en de developer-API draait om een afweging tussen voorspelbare kosten en ononderbroken toegang.
Een Claude-abonnement geeft ons een vast maandelijks tarief.
We kunnen het een tijdlang intensief gebruiken, en uiteindelijk raken we een dynamische gebruikslimiet die afhangt van de serverbelasting. Wanneer Claude Code midden in een project tegen deze onzichtbare muur aanloopt, stopt het volledig met werken.
We moeten dan uren wachten tot onze limiet reset voordat de agent onze code kan afmaken.
De Claude API haalt deze zijwieltjes weg. Er zijn geen limieten per uur, geen gedeelde bandbreedtelimieten en geen wachttijden. Als we willen dat Fable 5 acht uur achter elkaar een enorme codebasis herstructureert, voert de API elke opdracht zonder onderbreking uit.
Die vrijheid brengt echter een belangrijk risico met zich mee: budgetoverschrijdingen. Een abonnement gebruiken kan frustrerend zijn als je de limiet raakt, maar je weet in elk geval precies hoeveel de rekening aan het eind van de maand zal zijn.
Dat is vooral riskant bij dure modellen zoals Fable 5.
Kostenbeheer en budgetcontrole met de Claude API
Er zijn twee manieren waarop we ons budget kunnen beheersen bij gebruik van de API.
De eerste is om ervoor te zorgen dat automatisch herladen uit staat. Automatisch herladen laat Claude automatisch credits kopen wanneer deze op zijn.
Omdat het tokenverbruik bij gebruik van Claude Code zeer onvoorspelbaar is, raad ik sterk af dit in te schakelen.
De tweede is om zorgvuldig te kiezen welk model je gebruikt.
Fable 5 kan uitstekend complexe taken oplossen en ingewikkelde applicaties implementeren. Maar vaak is het overkill voor eenvoudigere klussen.
Zelf gebruik ik graag de goedkopere modellen en schakel ik pas over op duurdere als de goedkopere een taak na meerdere pogingen niet oplossen. Het model dat ik het meest gebruik is eigenlijk Haiku 4.5.
Om het model te kiezen, gebruik je het commando /model.
Stapsgewijze Claude API-installatie (met Fable 5)
Als je op zoek bent naar een speciale Claude Fable 5 API-tutorial, bekijk dan onze aparte gids.
Log om te beginnen in op het Claude-webplatform en stel de betaling in. Open vervolgens een terminal en installeer Claude Code met het commando:
npm install -g @anthropic-ai/claude-codeZodra het is geïnstalleerd, kun je het starten door claude in de terminal te typen. De eerste keer dat het draait, vraagt het om configuratie. Zorg dat je tijdens de setup “API usage billing” selecteert:
Vervolgens opent Claude de browser en vraagt toestemming om ons account te koppelen en een API-sleutel voor ons aan te maken. Klik op “Authorize” en het account wordt automatisch gekoppeld.
Als de installatie is voltooid, kunnen we aan de slag met bouwen in Claude Code:
In mijn geval draait Claude Code al met Fable 5. Als dat niet zo is, kunnen we het model kiezen met het commando /model en Fable 5 uit het menu selecteren.
Claude Code wijzigen van abonnement naar API
Voor wie Claude Code al via een abonnement gebruikte en wil overstappen op API usage billing is het proces eenvoudig.
- Log uit met het commando
/logout. - Start Claude Code opnieuw met het commando
claudeen kies de inlogmethode “Anthropic Console account · API usage billing”.
Als we ooit zonder credits komen te zitten terwijl Claude Code midden in een implementatie zit, stopt het en laat het je weten dat je credits moet toevoegen.
Na het toevoegen van credits, als Claude nog draait, vraag je het simpelweg om door te gaan met een prompt en het pakt de draad weer op. Als het niet draait, gebruik dan het commando claude --continue.
Een real-world project bouwen met de Claude API
De focus van deze tutorial is het instellen van Claude Code met de API, niet een gedetailleerde handleiding over hoe je Claude Code gebruikt.
Wil je er meer over leren, schrijf je dan in voor onze Claude Code 101-cursus.
Projectoverzicht
Het doel van dit project is een Python-app bouwen waarmee gebruikers eenvoudig foto's op hun computer kunnen terugvinden.
Tegenwoordig maken mensen veel foto's, die vaak ongeorganiseerd raken en verspreid over meerdere locaties belanden. Voor mij persoonlijk, als fotograaf, is het vaak een hoofdpijn om maanden later een foto terug te vinden.
Het idee achter de app is dat gebruikers hun foto's kunnen vinden door te beschrijven wat er op staat of door een screenshot of beeldreferentie te geven.
Deze tweede modus is voor mij bijzonder handig omdat ik mijn werk vaak op sociale media post; zo kan ik gewoon een screenshot van de post nemen en het originele bestand in hoge kwaliteit terugvinden.
We zouden Claude Code de projectarchitectuur kunnen laten uitzoeken en de volledige implementatie laten doen. Dat zou waarschijnlijk prima werken.
Maar voor educatieve doeleinden wilde ik de projectarchitectuur zelf definiëren en Claude Code zich laten focussen op de implementatie.
Projectarchitectuur met CLAUDE.md
Om deze app te maken, heb ik een CLAUDE.md-bestand gemaakt met een beschrijving van de architectuur van het project.
Een CLAUDE.md-bestand is een project-specifiek Markdown-configuratiebestand dat Claude Code aan het begin van elke sessie leest om blijvend geheugen op te bouwen van je architectuur, codeerstandaarden en workflowvoorkeuren.
De app heeft twee hoofdonderdelen:
- Een photo-ingestieproces waarmee de gebruiker een map met afbeeldingen kan selecteren, die afbeeldingen omzet naar vectoren en ze opslaat in een vectordatabase.
- Een multimodale invoer waarmee de gebruiker in de database kan zoeken.
Om afbeeldingen naar vectoren te encoden, gebruiken we het CLIP-model. Voor de database gebruiken we ChromaDB, dat lokaal gratis draait.
De intuïtie erachter is dat het CLIP-model is getraind om tekst en beelden om te zetten in vectoren (een numerieke representatie van data), zó dat afbeeldingen die op elkaar lijken of vergelijkbare concepten bevatten dicht bij elkaar op deze kaart terechtkomen, terwijl niet-verwante beelden juist verder uit elkaar worden geplaatst.
Als we een afbeelding willen lokaliseren, zetten we ook de zoekopdracht om in een queryvector en gebruiken we ChromaDB om de vectoren te vinden die het dichtst bij de queryvector liggen.
Wil je meer leren over vectordatabases, bekijk dan deze ChromaDB-tutorial: een stapsgewijze gids.
De prompt
Met de projectarchitectuur vastgelegd in het CLAUDE.md-bestand startte ik een terminal in die map en gaf ik Claude Code met het Fable 5-model de volgende prompt:
Build a desktop graphical app for my photography search engine with Python.
First, plan the application architecture exactly as outlined in the CLAUDE.md file, ensuring the GUI can handle both folder ingestion and searching.
Create a virtual environment, install the necessary dependencies (including customtkinter and raw image processing libraries), and save them to requirements.txt.
Write the application logic, paying special attention to background threading for the ingestion process. Het resultaat
Ik heb de prompt ingediend en Claude Code z'n werk laten doen. Na ongeveer zeven minuten was het klaar.
Ik heb de app uitgevoerd en zo zag het eruit:
Ik heb een paar foto's geüpload die ik dit jaar maakte en ben daarna naar Instagram gegaan om een screenshot te nemen van een post als referentieafbeelding.
Ik heb expres de hele UI meegenomen om het de app lastiger te maken de bronafbeelding te vinden. Dit kreeg ik terug:
Ik moet zeggen: het werkt behoorlijk goed en de interface is precies zoals ik het in gedachten had. Ik heb ook tekstzoek geprobeerd door te zoeken naar foto's van Taipei 101, het hoogste gebouw van Taiwan.
Hier zijn de resultaten:
Claude API-tokenverbruik en kosten in de praktijk
In totaal kostte het maken van dit project $3,65 aan API-tokens. We kunnen een gedetailleerd overzicht van de kosten van een sessie opvragen met het commando /cost:
Opvallend is dat we zien dat er voor een deel van het werk ook claude-haiku-4.5 is gebruikt.
Dit laat zien dat Fable 5 vrij duur is.
Een sessie van zeven minuten op een leeg project kostte ons al $3,65.
Ik kan me dus alleen maar voorstellen wat het kost om Fable 5 te gebruiken op een bestaand project met honderden codebestanden.
Natuurlijk moeten deze kosten in de echte wereld, wanneer je een echte applicatie bouwt die ook inkomsten genereert, anders worden beoordeeld omdat ze dan een investering zijn.
Geavanceerde Claude API-functies die je moet kennen
Overstappen op de API geeft je toegang tot tooling die Claude.ai niet biedt: promptcaching, batchverwerking en toolintegratie.
Als je met Claude Code werkt, hoge volumes API-calls routeert of agentische systemen bouwt die met externe services interacteren, zijn dit de functies die je kosten en latency het meest direct beïnvloeden.
1. Promptcaching (kostenreductie)
Promptcaching slaat statische delen van je contextvenster server-side op tussen API-calls, zodat je niet telkens opnieuw betaalt om dezelfde content te verwerken.
Als je met Claude Code werkt, stuur je waarschijnlijk bij elke call dezelfde grote context mee (een CLAUDE.md-bestand, een samenvatting van de codebase of een lange systeemprompt). Volgens de cachingdocumentatie van Anthropic verlagen gecachte prefixes de inputkosten met tot wel 90% en verkorten ze de time-to-first-token omdat de prefix niet opnieuw hoeft te worden ingelezen.
De eerste aanvraag betaalt de volledige inputprijs. Elke volgende call die dezelfde cacheprefix raakt, wordt tegen het gereduceerde tarief afgerekend.
2. De Batch API (asynchrone verwerking)
De Batch API verwerkt workloads die geen realtime respons nodig hebben.
10.000 supporttickets verwerken, documentatie genereren voor een hele codebase of evals draaien op een grote testset: allemaal geschikt voor batch. Anthropic rekent voor batchverzoeken 50% van de standaard input- en outputtokenkosten, en de volledige job dien je in met één API-call in plaats van dat je zelf een queue moet beheren.
De beperking is dat batchjobs tot 24 uur kunnen duren en resultaten in één keer binnenkomen, niet gestreamd. Prima voor offline pipelines, maar ongeschikt voor alles wat gebruiker-facing is.
3. Toolgebruik en het Model Context Protocol (MCP)
Toolgebruik (soms function calling genoemd) laat Claude externe functies aanroepen tijdens het genereren en de resultaten verwerken in zijn antwoord.
Je definieert beschikbare tools in JSON Schema-formaat; Claude beslist wanneer ze aan te roepen, welke argumenten door te geven en wat te doen met de output. Claude kan dus een database bevragen, een REST API aanroepen of een Python-script draaien zonder dat jij in je prompt het exacte aanroeppunt hoeft te specificeren.
Het Model Context Protocol (MCP) breidt dit uit met een gestandaardiseerde serverinterface: in plaats van tools per project te definiëren, maakt Claude verbinding met een lokale MCP-server die bestandstoegang, code-executie of databasereads aanbiedt.
De Computer Use API werkt anders. Claude interpreteert een screenshot en geeft toetsenbord- en muisgebeurtenissen door, en navigeert zo door interfaces zonder programmatische API-toegang tot de onderliggende applicatie.
Conclusie
Overschakelen naar de Claude API is een noodzakelijke stap om geautomatiseerde ontwikkeltools te draaien, maar het vraagt om een andere manier van projectbeheer.
Fable 5 is onmiskenbaar een uitmuntend codeermodel, in staat om volledig werkende, complexe applicaties te genereren vanuit één enkele prompt.
De redeneerkracht kan een architectonische visie in minuten omzetten in een functionele realiteit, wat ronduit indrukwekkend is.
Maar de Claude API gebruiken voor dit vermogensniveau heeft een prijs. Omdat modellen als Fable 5 zo duur zijn in gebruik, is het cruciaal om strategisch te zijn in je modelkeuze.
Ik raad aan om voor routinetaken te leunen op goedkopere, efficiënte modellen en Fable 5 te reserveren voor échte blokkades of complexe architecturale uitdagingen die diepere redenering vereisen.
Zoals we bij ons project zagen, kunnen de kosten van API-tokens snel oplopen, zelfs voor een relatief eenvoudige applicatie met één bestand. Bescherm je portemonnee door je gebruik goed in de gaten te houden en, nog belangrijker, automatisch opladen uit te schakelen zodat een geautomatiseerde codeersessie niet op hol slaat met je budget.
Wil je meer leren over het Claude-ecosysteem, bekijk dan onze Claude 101-cursus.
