Claude Agent SDK
Claude Agent SDK (voorheen Claude Code SDK)
Door Dennis Claassen · Laatst bijgewerkt feb 2026Simpele Uitleg
De Claude Agent SDK is een library waarmee je je eigen productie-AI-agents bouwt op dezelfde basis als Claude Code: dezelfde tools, agent loop en contextbeheer, programmeerbaar in Python en TypeScript. In plaats van de API zelf te bedienen, laat je Claude autonoom bestanden lezen, commando’s draaien en code aanpassen.
Technische Definitie
De Claude Agent SDK (in september 2025 hernoemd van Claude Code SDK) is Anthropic’s library voor het bouwen van agents bovenop de harness die Claude Code aandrijft. Je roept query() aan met een prompt en options, waarna de SDK zelf de tool-loop afhandelt: Claude kiest een tool, de SDK voert hem uit, en het resultaat gaat terug het model in tot de taak klaar is. Ingebouwde tools zijn onder andere Read, Write, Edit, Bash, Glob, Grep, WebSearch en WebFetch. De SDK ondersteunt hooks (PreToolUse, PostToolUse, SessionStart, e.a.), subagents, MCP-servers, fijnmazige permissions en hervatbare sessies. De TypeScript-package (@anthropic-ai/claude-agent-sdk) bundelt een native Claude Code-binary als optionele dependency; de Python-package (claude-agent-sdk) vereist Python 3.10 of nieuwer.
Waarom Dit Belangrijk Is
Wie agentic functionaliteit in eigen software wil, stond tot voor kort voor de keuze: alles zelf bouwen bovenop de kale API (eigen tool-loop, eigen bestandstoegang, eigen contextbeheer) of vastzitten aan een dichtgetimmerd platform. De Claude Agent SDK geeft developers en CTO’s de complete agent-harness van Claude Code als bouwsteen, draaiend in je eigen proces en infrastructuur. Je houdt volledige controle over orchestratie, tooltoegang en permissions, terwijl Claude de tool-executie autonoom afhandelt. Voor teams betekent dit dat een werkende interne agent (support, research, codeonderhoud) een kwestie van uren tot dagen is in plaats van een maandenlang custom-bouwtraject.
Hoe Het Werkt
Het kernpatroon is de query-functie. In Python: `async for message in query(prompt="Fix de bug in auth.py", options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]))`. In TypeScript hetzelfde via `query({ prompt, options: { allowedTools } })`. Onder de motorkap draait de agent loop: (1) Claude ontvangt de prompt, (2) kiest een tool zoals Read of Bash, (3) de SDK voert de tool uit binnen je permissions, (4) het resultaat gaat terug het model in, (5) dit herhaalt tot de taak af is. Je breidt dit uit met hooks (eigen code op vaste momenten in de levenscyclus), subagents (gespecialiseerde sub-agents voor deeltaken), MCP-servers (koppeling met databases, browsers, API’s) en sessies (context vasthouden, hervatten of forken). De SDK laadt desgewenst ook Claude Code’s bestandsconfiguratie uit .claude/ en CLAUDE.md.
Use Cases
Interne research- en kennisagent
Een team bouwt met de SDK een agent die met WebSearch en WebFetch het web afzoekt, bronnen samenvat en een rapport met bronvermelding oplevert. Draait in het eigen proces, op de eigen infrastructuur, zonder dat je de tool-loop zelf hoeft te schrijven.
Geautomatiseerd codeonderhoud in CI/CD
In een CI-pipeline draait een agent die met Read, Glob, Grep en Edit lint-fouten oplost, tests bijwerkt of vertalingen toevoegt en een pull request opent. De SDK is hiervoor de aangewezen vorm; de CLI is meer voor interactief dagelijks werk.
Support-agent in eigen software
Een SaaS-bedrijf bouwt een agent die klantvragen begrijpt, via een MCP-server de eigen database raadpleegt en acties uitvoert. Met permissions stel je precies in welke tools de agent mag gebruiken, met escaleerpaden naar een mens.
E-mail- of notitie-assistent
Omdat de harness niet codespecifiek is, draaien er ook niet-technische agents op: e-mailassistenten, notitie-agents en samenvattings-tools. Anthropic hernoemde de SDK in 2025 juist om die bredere toepassing te benadrukken.
Voorbeelden
Minimale bug-fix-agent (Python)
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
async for message in query(
prompt="Find and fix the bug in auth.py",
options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),
):
print(message)
asyncio.run(main())Read-only analyse-agent met permissions
options=ClaudeAgentOptions(allowed_tools=["Read", "Glob", "Grep"])
Subagent voor een deeltaak
Veelgemaakte Fouten
Denken dat het hetzelfde is als de gewone Claude-API
Met de Anthropic Client SDK (de kale API) schrijf je de tool-loop zelf: je stuurt prompts en voert tools handmatig uit. Met de Agent SDK handelt Claude de tool-executie autonoom af, inclusief ingebouwde tools als Read, Bash en Edit. Dat scheelt je het hele orchestratiewerk.
De Python-package installeren op een oude Python-versie
De Python-package vereist Python 3.10 of nieuwer (docs, juni 2026). Krijg je `No matching distribution found for claude-agent-sdk`, dan is je interpreter ouder dan 3.10. Check met `python3 --version`.
Aannemen dat eindgebruikers met je Claude-account kunnen inloggen
Anthropic staat het in beginsel niet toe dat agents gebouwd op de Agent SDK claude.ai-login of -limieten aan eigen klanten aanbieden. Gebruik API-key-authenticatie (of providers als Bedrock, Vertex, Azure) voor producten die je aan klanten levert (docs, juni 2026).
Permissions overslaan en de agent alles laten doen
Zonder ingestelde permissions kan een agent met Bash- en Edit-toegang onbedoeld bestanden of systemen aanpassen. Bepaal vooraf met allowed_tools welke tools zijn voorgekeurd en welke goedkeuring vereisen.
Tools Die Dit Gebruiken
Veelgestelde Vragen
Wat is het verschil tussen de Claude Agent SDK en Claude Code?
Is dit hetzelfde als de Claude Code SDK?
Wat kost de Claude Agent SDK en zijn er limieten?
Welke programmeertalen ondersteunt de SDK?
Kan ik mijn eigen databronnen en tools koppelen?
Draait de agent op mijn eigen servers of bij Anthropic?
Wil je deze term in de praktijk leren toepassen?