用途：使用官方 Claude Agent SDK for Python 构建生产级 AI 智能体，支持一次性查询与交互式对话，以及批量处理等自主工作流。
主要能力：提供 query() 与 ClaudeSDKClient 两种 API 模式；可通过 ClaudeAgentOptions 配置 system_prompt、cwd、model、permission_mode；支持通过 @tool 装饰器与 create_sdk_mcp_server 定义自定义 MCP 工具；支持 allowed_tools / disallowed_tools 与 can_use_tool 回调进行权限控制；可用 setting_sources 加载 user/project/local 级 CLAUDE.md 上下文；支持 PreToolUse 等 hooks、AgentDefinition 智能体委派以及异常处理（CLIConnectionError、CLINotFoundError、ProcessError）。
使用方式：安装依赖 pip install claude-agent-sdk 或 uv pip install claude-agent-sdk；安装 Claude CLI 使用 npm install -g claude-code，可用 claude-code --version 验证；配置环境变量 ANTHROPIC_API_KEY，或通过 CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX 接入 Bedrock / Vertex AI。
适用场景：代码审查智能体、交互式聊天或 REPL、批处理分析、CI/CD 自动化脚本、带自定义工具与权限管控的自主智能体。
限制与注意事项：生产环境应避免 bypassPermissions；需处理 CLI 未找到与连接异常；未配置 setting_sources 时不会加载项目上下文；不要在同一工作流混用 query() 与 ClaudeSDKClient；注意清理客户端连接。资料未提供定价、性能指标与平台兼容细节。