用途：面向基于 SDK 的应用，用 TypeScript 或 Python 以编程方式定义智能体，而不是写成 Markdown 文件。适合构建自定义智能体框架、在运行时动态创建智能体、编排多智能体，以及嵌入 Claude 智能体的应用和 CI/CD 任务。
主要能力：通过 ClaudeAgentOptions 传入 agents 映射，每个智能体由 AgentDefinition 描述。AgentDefinition 字段为：description（必填，说明何时调用，充当路由键）、prompt（必填，系统提示内容）、tools（可选，允许的工具；省略则继承父智能体全部工具）、model（可选，取 sonnet、opus、haiku 或 inherit）。父智能体需具备 Task 工具才能调用子智能体。文档示例包含只读的 code-reviewer（限定 Read、Grep、Glob，model 为 opus）与继承全部工具的 test-runner（model 为 sonnet）。
使用方式：TypeScript 从 @anthropic-ai/claude-agent-sdk 导入 query、ClaudeAgentOptions、AgentDefinition；Python 从 claude_agent_sdk 导入 query、ClaudeAgentOptions、AgentDefinition。构造 options 后调用 query，并异步遍历返回消息。
与文件系统智能体的差异：文件系统版位于 .claude/agents/，为带 YAML frontmatter 的 Markdown，自动从目录加载，面向 Claude Code CLI；SDK 版为 TypeScript/Python 对象，在 options 中传入，prompt 为字符串字段，面向自定义 SDK 应用。
限制与说明：若用户可能使用两种方式，可同时提供 Markdown 文件与 SDK 定义以保持兼容；资料未提供安装命令、版本要求、收费信息与更多运行细节。