claude-agent-sdk

Build autonomous AI agents with Claude Agent SDK. Structured outputs guarantee JSON schema validation, with plugins system and hooks for event-driven workflows. Prevents 14 documented errors.\n\nUse when: building coding agents, SRE systems, security auditors, or troubleshooting CLI not found, structured output validation, session forking errors, MCP config issues, subagent cleanup.

1. Zainstaluj pakiet npm: npm install @anthropic-ai/claude-agent-sdk@0.2.12. 2. Zdefiniuj schemat wyjścia za pomocą Zod lub JSON Schema — na przykład obiekt z polami summary, sentiment i confidence. Jeśli używasz Zod, przekonwertuj schemat na JSON Schema za pomocą biblioteki zod-to-json-schema. 3. Zaimportuj funkcję query z SDK i przygotuj zapytanie do agenta, przekazując prompt oraz opcje zawierające model (np. claude-sonnet-4-5) i parametr outputFormat z definicją schematu. 4. Upewnij się, że używasz beta headera structured-outputs-2025-11-13, aby włączyć walidację strukturyzowanych wyjść. 5. Iteruj po odpowiedziach agenta — gdy otrzymasz wiadomość typu result z polem structured_output, parsuj ją za pomocą zdefiniowanego schematu Zod, aby uzyskać w pełni typizowane dane. 6. Rozwiąż typowe problemy: jeśli napotkasz błędy CLI not found, problemy z konfiguracją MCP lub błędy czyszczenia subagentów, zapoznaj się z dokumentacją SDK dotyczącą systemu pluginów i hooków do obsługi przepływów zdarzeń.