Claude Agent SDK je oficiálny framework spoločnosti Anthropic na tvorbu produkčne pripravených AI agentov priamo na modeloch Claude. Namiesto manuálneho programovania tool-slučky agenta poskytuje SDK hotový agent-harness: automatické tool-loops, natívnu MCP integráciu, subagentov, správu sessions a kontextu, ako aj integrovaný systém oprávnení a sandbox. Vznikol 29. septembra 2025 z Claude Code SDK a využíva tú istú sadu nástrojov, ktorá stojí aj za Claude Code.

Tri rýchle odpovede

• Čo to je: Anthropic-natívne SDK (Python a TypeScript), ktoré sprístupňuje Claude managed tool-loops, sessions, sandboxing a subagentov, teda všetko, čo by si inak okolo holého LLM API volania musel postaviť sám.
• Kedy sa hodí: Coding agenti, research agenti a dlhobežiace, viackrokové tasky v stacku, ktorý vedome stavia na modely Claude.
• Na čo treba dbať: Provider-lock na Claude, API ešte v0.x s breaking changes (stav 2026), kód pod Apache 2.0, používanie však pod Anthropic Commercial Terms.

Z Claude Code SDK na Claude Agent SDK

Framework sa pôvodne volal Claude Code SDK a bol technickým základom coding agenta Claude Code. Premenovaním 29. septembra 2025 ho Anthropic vedome pozicionuje širšie: nielen na coding, ale ako všeobecný harness pre agentov s tool-use. Jadrová myšlienka zostáva tzv. „dogfooding": vývojári dostávajú presne tú istú sadu nástrojov a tú istú loop-mechaniku, ktorú Anthropic interne nasadzuje pre Claude Code, teda Read, Write, Edit, Bash, File a Web nástroje.

To je rozhodujúci rozdiel oproti čistému Anthropic Client SDK. Pri Client SDK si agentnú slučku píšeš sám: zavolať model, prijať tool-call, vykonať nástroj, vrátiť výsledok, znova zavolať. Agent SDK preberá presne túto orchestráciu a dopĺňa ju o produkčné stavebné bloky. Anthropic sám v „Building Effective Agents" (december 2024) varuje pred stavaním takýchto slučiek ručne pri netriviálnom využívaní nástrojov, no zároveň odporúča princíp „simplest solution first": kto potrebuje len jedno samostatné API volanie, framework nepotrebuje.

Centrálne stavebné bloky

Tool-use a sada nástrojov Claude Code. SDK prináša osvedčené nástroje File, Bash, Web, ako aj Read/Write/Edit. Agent tým dokáže čítať a zapisovať súbory, vykonávať shell príkazy a získavať web obsah bez toho, aby si tieto nástroje musel sám definovať a zabezpečovať.

Natívna MCP integrácia. Model Context Protocol (MCP) je v Claude Agent SDK natívne zakotvené; MCP servery sa dajú prevádzkovať dokonca in-process. MCP štandardizuje prístup k externým nástrojom, dátovým zdrojom a API. Od odovzdania Linux Foundation Agentic AI Foundation (AAIF) 9. decembra 2025 je protokol vendor-neutral; podľa Anthropic dosiahol v apríli 2026 vyše 110 miliónov mesačných SDK downloadov a viac než 10 000 aktívnych serverov. Pre agentúry to znamená: integrácie postavené raz ako MCP server sú znovupoužiteľné aj mimo ekosystému Anthropic.

Subagenti a sessions. Namiesto klasického graph-modelu (ako pri LangGraph) stavia SDK na subagentov a sessions pre multi-step a deľbu práce. Hlavný agent môže spawnovať špecializovaných subagentov pre čiastkové úlohy; sessions držia kontext naprieč viacerými krokmi. Natívna A2A podpora (Agent-to-Agent protokol) oficiálne neexistuje, čím sa SDK odlišuje od Microsoft Agent Framework, CrewAI či Pydantic AI.

Správa kontextu a oprávnení plus sandbox. SDK spravuje kontext cez session a obsahuje integrovaný systém oprávnení, ako aj sandboxing. V hodnotení production-readiness z výskumu patrí SDK tým k špičke v oblasti security/sandbox. Oprávnenia riadia, ktoré akcie smie agent vykonať, napríklad ktoré súbory sa smú zapisovať alebo ktoré príkazy spustiť, čo je dôležitá páka pre human-in-the-loop a audit požiadavky.

Observability cez hooks. Na rozdiel od LangGraph (LangSmith) alebo Pydantic AI (Logfire) nemá SDK zrelú first-party observability platformu. Pracuje na báze hooks a integruje sa s Anthropic Console. Kto prevádzkuje čisté SDK self-hosting, musí doplniť vlastné štruktúrované logovanie pre traceability a dôkazy relevantné pre EU AI Act.

Zaradenie v ekosystéme Anthropic

Sila SDK spočíva v tesnej väzbe na modely Claude a na MCP. V layer-modeli frameworkov sedí spolu s OpenAI Agents SDK na úrovni agent-runtime/harness, teda vrstva nad čistými provider SDK a s iným charakterom než framework-vrstva (LangGraph, CrewAI, Pydantic AI). Táto blízkosť je výhodou aj obmedzením zároveň: optimalizácia a sada nástrojov sú prispôsobené Claude, zato neexistuje model-swap na GPT, Gemini či lokálne modely.

K rozšíreniu: TypeScript balík zaznamenal podľa sekundárnych zdrojov okolo 1,85 milióna NPM týždenných downloadov (február 2026). S Apple Xcode 26.3 integroval SDK natívne prominentný výrobca. Tieto čísla treba chápať ako momentku a pred každým zverejnením nanovo overiť.

DACH perspektíva: suverenita a licencia

Pre DACH B2B rozhodovateľov sú centrálne dva body. Po prvé dátová rezidencia: priamy Anthropic endpoint sídli v USA. Pre prísne EU/DSGVO požiadavky vedie cesta cez AWS Bedrock (EU región), Google Vertex alebo Azure AI Foundry. Samotné SDK je OSS a spustiteľné lokálne, model endpoint to nie je, preto zaradenie „stredná suverenita" oproti plne self-hostovateľným frameworkom ako n8n (DE vendor), LangGraph alebo Pydantic AI.

Po druhé licencia: kód SDK stojí pod Apache 2.0, používanie modelov Claude však pod Anthropic Commercial Terms, nie pod čistým open-source mindsetom. Toto oddelenie patrí poriadne do každej vendor evaluácie a procurement previerky.

Konkrétny príklad

Predpokladajme, že agentúra stavia research agenta, ktorý pre každú požiadavku prehľadáva interné Markdown dokumenty, vytvorí profil konkurenta a výsledok uloží ako súbor. S Client SDK by tím musel napísať kompletnú tool-loop, ošetrenie chýb a správu kontextu sám, v analýzach tretích strán pre porovnateľných ReAct agentov hrubo 40 až vyše 100 riadkov orchestračného kódu. S Claude Agent SDK sa to redukuje na konfiguráciu:

```python

Pseudokód, Claude Agent SDK (stav 2026, API v0.x)

options = ClaudeAgentOptions(
model="claude-...", # viazané na modely Claude
allowed_tools=["Read", "Write", "Web"],
permission_mode="ask", # human-in-the-loop pri kritických akciách
mcp_servers=[crm_mcp_server], # natívne MCP pripojenie, napr. CRM
setting_sources=[...], # po premenovaní nastaviť explicitne
)

Subagent na čistú rešerš, hlavný agent zhrnie

agent.run("Vytvor profil konkurenta k firme X.")
```

Dôležité pri prechode zo starého pomenovania: ClaudeCodeOptions sa teraz volá ClaudeAgentOptions a setting_sources musí byť od premenovania nastavené explicitne. Tool-loops, spawnovanie rešeršného subagenta, správu kontextu session a dotaz na oprávnenie pred zápisom súboru preberá SDK.

Pre agentúry a B2B

Claude Agent SDK je správnou voľbou vtedy, keď strategické rozhodnutie o modeli aj tak padne na Claude a ťažisko leží na coding, research alebo long-running agentoch. Výrazne skracuje time-to-production cez osvedčený harness a natívne MCP pripojenie. Kto naopak potrebuje model-agnosticitu, natívnu A2A multi-agent komunikáciu, zrelú first-party observability alebo plnú EU suverenitu bez US vendora, mal by zvážiť LangGraph, Pydantic AI alebo n8n. Blck Alpaca pre DACH zákazníkov a zákazníčky vyhodnocuje framework, hosting cestu (Bedrock/Vertex/Azure-EU) a licenčné implikácie spoločne, aby sa z prototypu stala DSGVO-konformná produkčná prevádzka. Všetky údaje o verziách, cenách a rozšírení sú stavom 2026 a treba ich pred štartom projektu nanovo verifikovať.