Claude Agent SDK: tvorba agentov natívne pre Anthropic

Claude Agent SDK je oficiálny framework spoločnosti Anthropic na tvorbu AI agentov pripravených na produkčné nasadenie priamo na modeloch Claude. Namiesto toho, aby si slučku nástrojov agenta programoval ručne, dostaneš od SDK hotový agentový harness: automatické slučky nástrojov (tool loops), natívnu integráciu MCP, subagentov, správu relácií a kontextu a integrovaný systém oprávnení a sandboxu. Vzniklo 29. septembra 2025 z Claude Code SDK a používa tú istú sadu nástrojov, na ktorej stojí aj Claude Code.

Tri rýchle odpovede

• Čo to je: Anthropic-natívne SDK (Python a TypeScript), ktoré pre Claude poskytuje spravované slučky nástrojov, relácie, sandboxing a subagentov, teda všetko, čo by si inak musel okolo holého volania LLM API postaviť sám.
• Kedy sa hodí: Agenti na programovanie, rešeršní agenti a dlhotrvajúce, viackrokové úlohy v stacku, ktorý vedome stavia na modeloch Claude.
• Na čo si dať pozor: Viazanosť na Claude, API stále vo verzii v0.x s nekompatibilnými zmenami (stav 2026), Python SDK pod licenciou MIT, TypeScript SDK proprietárne, používanie oboch podľa Anthropic Commercial Terms.

Od Claude Code SDK ku Claude Agent SDK

Framework sa pôvodne volal Claude Code SDK a bol technickým základom agenta na programovanie Claude Code. Premenovaním 29. septembra 2025 ho Anthropic zámerne pozicionuje širšie: ako všeobecný harness pre agentov, ktorí používajú nástroje, programovanie je už len jeden z prípadov použitia. Základnou myšlienkou zostáva takzvaný „dogfooding“: vývojári dostávajú presne tú istú sadu nástrojov a ten istý mechanizmus slučky, ktorý Anthropic interne používa pre Claude Code, medzi nimi Read, Write, Edit, Bash, Glob, Grep, WebFetch a WebSearch.

To je rozhodujúci rozdiel oproti samotnému Anthropic Client SDK. Pri Client SDK si slučku agenta píšeš sám: zavolať model, prijať volanie nástroja, vykonať nástroj, vrátiť výsledok, zavolať znova. Agent SDK preberá práve túto orchestráciu a dopĺňa ju o stavebné bloky pre produkciu. Samotný Anthropic v článku „Building Effective Agents“ (december 2024) radí začať priamo s LLM API, pretože mnohé vzory sa dajú zrealizovať v niekoľkých riadkoch kódu. Kto nasadí framework, mal by rozumieť kódu pod ním. Princíp za tým: najprv najjednoduchšie riešenie, viac zložitosti až v prípade potreby. Kto potrebuje len jedno volanie API, framework nepotrebuje; harness ako Agent SDK sa oplatí až pri dlhých, viackrokových reťazcoch nástrojov.

Hlavné stavebné bloky

Používanie nástrojov a sada nástrojov Claude Code. SDK prináša osvedčené nástroje Read, Write, Edit, Bash, Glob, Grep, WebFetch a WebSearch. Agent tak dokáže čítať a zapisovať súbory, spúšťať príkazy shellu a načítavať webový obsah bez toho, aby si tieto nástroje musel sám definovať a zabezpečiť.

Natívna integrácia MCP. Model Context Protocol (MCP) je v Claude Agent SDK natívne zabudovaný; MCP servery môžu dokonca bežať in-process. MCP štandardizuje prístup k externým nástrojom, zdrojom dát a API. Od odovzdania organizácii Linux Foundation Agentic AI Foundation (AAIF) 9. decembra 2025 je protokol nezávislý od dodávateľa; podľa spoločnosti Anthropic dosiahol v apríli 2026 viac ako 110 miliónov mesačných stiahnutí SDK a viac ako 10 000 aktívnych serverov. Pre agentúry to znamená: integrácie, ktoré raz postavíš ako MCP server, môžeš opätovne použiť aj mimo ekosystému Anthropic.

Subagenti a relácie. Namiesto klasického grafového modelu (ako pri LangGraph) stavia SDK na subagentoch a reláciách pre viackrokové procesy a procesy s deľbou práce. Hlavný agent môže pre čiastkové úlohy spúšťať špecializovaných subagentov; relácie držia kontext naprieč viacerými krokmi. Natívna podpora A2A (protokol Agent-to-Agent) oficiálne neexistuje, čím sa SDK odlišuje od Microsoft Agent Framework, CrewAI alebo Pydantic AI.

Správa kontextu a oprávnení plus sandbox. SDK spravuje kontext cez reláciu a obsahuje integrovaný systém oprávnení aj sandboxing. Oprávnenia určujú, ktoré akcie smie agent vykonať, napríklad ktoré súbory smie zapisovať alebo ktoré príkazy smie spúšťať, čo je dôležitá páka pre human-in-the-loop a požiadavky auditu.

Observabilita cez hooky. Na rozdiel od LangGraph (LangSmith) alebo Pydantic AI (Logfire) nemá SDK vyspelú vlastnú platformu na observabilitu. Pracuje na báze hookov a integruje sa s Anthropic Console. Ak SDK prevádzkuješ čisto vo vlastnej réžii (self-hosting), musíš doplniť vlastné štruktúrované logovanie pre dohľadateľnosť a dôkazy relevantné pre EU AI Act.

Zaradenie v ekosystéme Anthropic

Sila SDK spočíva v úzkom prepojení s modelmi Claude a s MCP. Vo vrstvovom modeli frameworkov sedí spolu s OpenAI Agents SDK na úrovni agent runtime/harness, teda o vrstvu vyššie než čisté SDK poskytovateľov a s iným charakterom než vrstva frameworkov (LangGraph, CrewAI, Pydantic AI). Táto blízkosť je výhodou aj obmedzením zároveň: optimalizácia a sada nástrojov sú šité na mieru Claude, zato nie je možná výmena modelu za GPT, Gemini alebo lokálne modely.

K rozšíreniu: TypeScript balík mal podľa štatistiky npm v týždni od 5. do 11. októbra 2026 približne 12,1 milióna stiahnutí, v týždni od 1. do 7. februára 2026 to bolo ešte približne 1,85 milióna. S Apple Xcode 26.3 integroval SDK natívne významný výrobca.

Perspektíva DACH: suverenita a licencia

Pre B2B rozhodovateľov v regióne DACH sú kľúčové dva body. Po prvé dátová rezidencia: priamy endpoint Anthropic sa nachádza v USA. Pri prísnych požiadavkách EÚ a GDPR vedie cesta cez AWS Bedrock (región EÚ), Google Vertex alebo Azure AI Foundry. Kód Python SDK je pod licenciou MIT, balík však obsahuje proprietárne Claude Code CLI. TypeScript SDK je proprietárne ako celok. Obe bežia lokálne, endpoint modelu nie. Odtiaľ zaradenie „stredná suverenita“ v porovnaní s frameworkmi, ktoré môžeš úplne prevádzkovať vo vlastnej réžii, ako n8n (nemecký dodávateľ), LangGraph alebo Pydantic AI.

Po druhé licencia: kód Python SDK je pod licenciou MIT. Balík však podľa README obsahuje pribalené Claude Code CLI a to je podľa svojho licenčného súboru proprietárne (All rights reserved). TypeScript SDK je proprietárne ako celok. Používanie oboch SDK sa riadi Anthropic Commercial Terms of Service, aj keď s nimi prevádzkuješ produkty pre svojich vlastných zákazníkov. Toto rozlíšenie musí byť jasne zachytené v každom hodnotení dodávateľa a v každej kontrole pri obstarávaní.

Konkrétny príklad

Predpokladajme, že agentúra stavia rešeršného agenta, ktorý pri každej požiadavke prehľadá interné dokumenty v Markdowne, vytvorí profil konkurenta a výsledok uloží ako súbor. S Client SDK by tím musel celú slučku nástrojov, ošetrenie chýb a správu kontextu napísať sám, podľa analýz tretích strán pre porovnateľných ReAct agentov zhruba 40 až vyše 100 riadkov orchestračného kódu. S Claude Agent SDK sa to zredukuje na konfiguráciu a jedno volanie (zjednodušený príklad v Pythone, stav október 2026, API v0.x):

```python
import asyncio
from claude_agent_sdk import ClaudeAgentOptions, ClaudeSDKClient

options = ClaudeAgentOptions(
model="claude-...", # viazané na modely Claude
allowed_tools=["Read", "Glob", "Grep", "WebFetch", "WebSearch", "Agent"],
permission_mode="default", # Write nie je vopred povolený
can_use_tool=check_approval, # pred zápisom sa opýta (human-in-the-loop)
mcp_servers={"crm": crm_mcp_server}, # natívne pripojenie MCP, napr. CRM
agents={"research": research_agent}, # subagent len na rešerš
setting_sources=["project"], # načítať len nastavenia projektu a CLAUDE.md
)

async def main():
async with ClaudeSDKClient(options=options) as client:
await client.query("Vytvor profil konkurenta pre firmu X.")
async for message in client.receive_response():
print(message)

asyncio.run(main())
```

Dôležité pri prechode zo starého pomenovania: ClaudeCodeOptions sa teraz volá ClaudeAgentOptions. setting_sources určuje, ktoré súbory s nastaveniami (user, project, local) sa načítajú. Ak hodnotu neuvedieš, SDK podľa referencie pre Python načíta všetky tri; ak ju nastavíš explicitne, musíš zahrnúť "project", aby platili pravidlá projektu a CLAUDE.md. Slučky nástrojov, spustenie rešeršného subagenta, správu kontextu relácie a žiadosť o povolenie pred zápisom súboru preberá SDK.

Pre agentúry a B2B

Claude Agent SDK je správna voľba, keď strategické rozhodnutie o modeli aj tak padne na Claude a ťažisko je v agentoch na programovanie, rešerš alebo dlhotrvajúce úlohy. Vďaka osvedčenému harnessu a natívnemu pripojeniu MCP výrazne skracuje čas do produkčného nasadenia. Kto naopak potrebuje nezávislosť od modelu, natívnu komunikáciu viacerých agentov cez A2A, vyspelú vlastnú observabilitu alebo plnú suverenitu v EÚ bez amerického dodávateľa, mal by preveriť LangGraph, Pydantic AI alebo n8n. Blck Alpaca pre zákazníkov v regióne DACH vyhodnocuje framework, cestu hostingu (Bedrock/Vertex/Azure v EÚ) a licenčné dôsledky spoločne, aby sa z prototypu stala produkčná prevádzka v súlade s GDPR. Všetky údaje o verziách, cenách a rozšírení zodpovedajú stavu v roku 2026 a pred začiatkom projektu ich treba znovu overiť.