用途：Claude Agent SDK 用于在应用中程序化地嵌入 Claude Code 智能体运行框架，构建自定义智能体。
主要能力：支持 query() 一次性调用与 ClaudeSDKClient 交互式会话；通过 ClaudeAgentOptions 配置 allowed_tools、permission_mode、cwd、mcp_servers、system_prompt；可用 @tool 与 create_sdk_mcp_server 在进程内定义自定义工具，无需子进程 MCP；支持 PreToolUse/PostToolUse 等钩子对智能体循环做确定性控制；支持子智能体（agents 选项）与会话恢复/分叉；wheel 内置 Claude Code CLI，也可驱动已安装的 CLI。
使用方式：安装 pip install claude-agent-sdk。最小示例：import anyio 与 from claude_agent_sdk import query，在 async 函数中 async for message in query(prompt="What is 2 + 2?") 打印消息，再用 anyio.run(main) 运行。使用前需正确配置模型提供方与 API 密钥，执行 AI 生成代码时建议采用沙箱或权限隔离。
适用场景：需要将 Claude Code 智能体循环嵌入自有应用、定义进程内工具、用钩子控制工具调用生命周期、管理子智能体与会话的工程场景。
限制：资料未提供具体收费、价格、平台支持范围与效果数据；与 agent-configuration、openai-agents-python 等存在生态重叠，SDK 层工程能力为补充定位。参考：https://github.com/anthropics/claude-agent-sdk-python 与 https://docs.claude.com/en/api/agent-sdk/overview。