Claude Code-serie tutorial 2: De relatie tussen Claude Code, Claude Chat en Claude API

1.2 De 'familiebanden' met Claude Chat en API

Veel ontwikkelaars denken bij het eerste horen van Claude Code meteen aan twee andere productvormen: Claude Chat (webchatinterface) en Claude API (programmeerinterface). Ze komen allemaal van Anthropic en gebruiken onderliggend dezelfde Claude-modelfamilie, maar de problemen die ze oplossen en de gebruiksscenario's zijn totaal verschillend.

In deze sectie verduidelijken we de relaties en verschillen tussen deze drie.

Snelle schets van de drie productvormen

Dimensie	Claude Chat	Claude API	Claude Code
Interactiemethode	Webchat in browser	Code-aanroep, retourneert JSON	Terminal commandoregel interactie
Primaire gebruikers	Iedereen (ontwikkelaars, niet-ontwikkelaars)	Ontwikkelaars (bouwen applicaties)	Ontwikkelaars (lokale programmeersamenwerking)
Kernscenario	Vragen beantwoorden, schrijven, documenten analyseren	AI integreren in eigen producten	Direct code wijzigen in projectmap, taken uitvoeren
Contextbron	Handmatig plakken door gebruiker, of bestanden uploaden	Ontwikkelaar geeft parameters mee	Automatisch lezen van lokale codebase, mapstructuur
Kan code uitvoeren?	Nee	Afhankelijk van jouw applicatiecode	Ja, Shell-opdrachten direct uitvoeren
Permanent geheugen?	Enkele sessie, geen langetermijngeheugen	Stateless (ontwikkelaar beheert zelf)	Cross-sessie persistent via `CLAUDE.md`
Gebruikte modellen	Claude Sonnet, Opus	Alle Claude-modellen	Sonnet, Opus, Haiku, etc.

Claude Chat: Flexibele allround adviseur

Claude Chat (via claude.ai) is de meest bekende vorm. Het is een op browser gebaseerde conversatie-interface waarin je PDF's kunt uploaden, codefragmenten plakken, technische oplossingen bespreken, documenten opstellen, etc.

Het voordeel is dat het kant-en-klaar is, geen installatie of configuratie vereist, en geen commandoregelkennis nodig heeft. Je kunt er technische vragen stellen, maar ook een contract laten analyseren of een e-mail laten schrijven.

Maar als programmeertool heeft het een duidelijke beperking: het maakt geen verbinding met je lokale omgeving. Het ziet niet alle bestanden van je project, kan package.json niet lezen om afhankelijkheden te analyseren, en kan geen testopdrachten uitvoeren om te verifiëren of een voorgestelde wijziging daadwerkelijk werkt. Je moet bestandsinhoud stukje bij beetje kopiëren en plakken, en vervolgens de suggesties handmatig in de editor toepassen.

Geschikte scenario's:
- Nieuwe technologieconcepten leren, frameworks vergelijken
- Snel codefragmenten of sjablonen genereren
- Documenten analyseren, technische artikelen schrijven
- Ondersteuning voor niet-ontwikkelaars in dagelijkse werkzaamheden

Claude API: AI-ziel in je product

Claude API is een programmeerinterface voor ontwikkelaars. Je kunt via HTTP-verzoeken prompts naar het Claude-model sturen en tekstantwoorden ontvangen. Het is een programmeerbaar Claude-brein dat je in elke applicatie kunt integreren: een chatbot voor klantenservice, een code-review GitHub App, een geautomatiseerde rapportgenerator...

De API biedt de meeste flexibiliteit, maar betekent ook dat je veel zelf moet regelen:
- Context beheren: je moet ontwerpen hoe je gespreksgeschiedenis, systeemprompts en externe gegevens aan het model doorgeeft.
- Toolaanroepen implementeren: als je het model een actie wilt laten uitvoeren, zoals een database opvragen, moet je toolfuncties definiëren en de Tool Use-verzoeken van het model afhandelen.
- Status onderhouden: de API zelf is stateless, dus het onthouden van context over meerdere gesprekken heen moet je zelf opslaan en beheren.

Geschikte scenario's:
- Bouwen van eigen AI-applicaties of SaaS-producten
- Inbedden van AI-mogelijkheden in bestaande workflows (bijv. automatisch genereren van Release Notes in CI/CD)
- Batchverwerking van grote hoeveelheden data met aangepaste uitvoerformaten
- Geavanceerde behoeften waarbij fijnmazige controle over modelgedrag vereist is

Claude Code: In de terminal gewortelde programmeeragent

Claude Code kan worden gezien als de meest directe en intieme AI-partner voor dagelijkse ontwikkeling. Het draait in de terminal en integreert actief in je ontwikkelomgeving.

In vergelijking met Chat hoeft Claude Code niet handmatig van context te worden voorzien—het leest zelf bestanden, bekijkt de mapstructuur en begrijpt de afhankelijkheden en architectuur van het hele project.

In vergelijking met API heeft Claude Code veel technische praktijken ingebouwd: het beheert automatisch sessiegeheugen, heeft ingebouwde toolaanroepen (bestanden zoeken, opdrachten uitvoeren, Git beheren) en een volwassen configuratiesysteem (CLAUDE.md, .claudeignore enz.). Je hoeft niet vanaf nul een agentsysteem op te bouwen, maar kunt je concentreren op 'samen programmeren'.

Geschikte scenario's:
- Snel onbekende code in een lokaal project begrijpen
- Cross-bestand refactoring, automatisch herstellen van lint-fouten
- Tests genereren en uitvoeren voor validatie, een gesloten cyclus vormen
- Automatiseren van dagelijkse Git-operaties en taakordening
- Realtime code-review feedback willen ontvangen

De bloedband tussen de drie: zelfde brein, andere lichamen

Een beeldspraak:

Claude Chat is als een raadpleegmachine in een bibliotheek: rijk aan informatie, geschikt voor allerlei kennisvragen en documentverwerking, maar het maakt geen verbinding met jouw privéwerkplaats.
Claude API is als een motorenfabriek: levert hoogwaardige motoren (modelmogelijkheden), maar jij bouwt zelf de carrosserie, monteert de wielen en assembleert tot elk gewenst voertuig (applicatie).
Claude Code is als een voor ontwikkelaars gepersonaliseerde bedrijfswagen: standaard uitgerust met allerlei gereedschap—kraanarm (bestandsbewerkingen), schep (opdrachtuitvoering), navigatie (projectperceptie)—je kunt er meteen mee aan de slag.

De verbanden:
- Hetzelfde Claude-model: De Sonnet en Opus in Chat kun je ook in Claude Code kiezen; de modelversies in de API worden stapsgewijs gesynchroniseerd naar de CLI-tool.
- Gedeelde prompttechniek: Of je nu in Chat 'prompt-trucs' ontdekt of via de API systeempromptervaring opdoet, een deel ervan kun je migreren naar de CLAUDE.md-configuratie van Claude Code.
- Stapsgewijze evolutiepaden: Veel teams beginnen met Chat (kleinschalig testen), gaan naar API (maatwerkintegratie) en introduceren ten slotte Claude Code in de lokale ontwikkelingsfase (diepgaande programmeersamenwerking).

Hoe kies je tussen code, chat en API?

Als je alleen een vraag wilt stellen of een document wilt analyseren → Open Claude Chat, dat is de meest efficiënte keuze.

Als je een product of workflow ontwikkelt waarin AI moet worden ingebed → Gebruik Claude API, de programmeerbare motor.

Als je lokaal code schrijft en een partner nodig hebt die direct bestanden kan wijzigen en opdrachten kan uitvoeren → Start Claude Code, het is de collega naast je die verstand heeft van code.

De drie sluiten elkaar niet uit, maar vullen elkaar juist aan. Zelf gebruik ik ze vaak als volgt:

Voordat ik een complexe functie implementeer met Claude Code, bespreek ik eerst het ontwerp in Claude Chat om te verifiëren of de aanpak logisch is;
De uit Chat gedestilleerde ontwerprichtlijnen schrijf ik in het CLAUDE.md-bestand van het project;
Laat Claude Code de implementatie lokaal uitvoeren volgens de richtlijnen, en voeg dit proces via de API automatisch in de CI-pipeline in.