Claude Agent SDK 用于构建自主 AI 智能体，提供 TypeScript 与 Python 两种实现。TypeScript 版本为 v0.2.141，包名 @anthropic-ai/claude-agent-sdk；Python 版本为 v0.2.82，包名 claude-agent-sdk（PyPI）。两套 SDK 都封装 Claude Code CLI，共享下列概念：
用途：以编程方式驱动 Claude 智能体完成任务，支持单次查询与有状态会话。
主要能力：
- 查询：一次性查询 query(options)；Python 另有有状态客户端 ClaudeSDKClient，TypeScript 由 query 管理状态。
- Hooks：PreToolUse、PostToolUse、Stop、SubagentStop、Notification 等。
- 权限：default、acceptEdits、plan、bypassPermissions 等模式，并提供 canUseTool / can_use_tool 回调。
- MCP 服务器：支持 stdio、HTTP、SSE 及 SDK 进程内配置，创建函数为 createSdkMcpServer() 与 create_sdk_mcp_server()。
- 子智能体：通过 AgentDefinition / AgentDefinition dataclass，将任务委派给带限定工具与权限的子智能体。
- 结构化输出：对智能体输出做 JSON Schema 校验。
- 沙箱：基于容器（Docker/Kubernetes）的隔离。
- 会话：捕获、恢复与分叉对话状态。
使用方式：按语言阅读对应参考文件。处理 .ts 文件、TypeScript 导入或 npm/node 时读 SKILL-typescript.md；处理 .py 文件、Python 导入或 pip/python 时读 SKILL-python.md；语言不明确或混合时两者都读。跨语言命名对应：选项类型为 Options 与 ClaudeAgentOptions，工具定义为 tool() 与 @tool 装饰器，钩子注册为 hooks 对象，系统提示为 systemPrompt 与 system_prompt，最大轮次为 maxTurns 与 max_turns，允许工具为 allowedTools 与 allowed_tools，MCP 服务器为 mcpServers 与 mcp_servers。
限制：具体 API 细节、代码示例、选项表与已知问题需查阅语言特定参考文件；本资料未提供收费、价格与平台等更多信息。