Claude Agent SDK 是 Anthropic 的官方框架，用于构建基于 Claude 的生产级 AI 智能体。它在 Messages API 之上提供高层抽象，自动处理智能体循环、工具编排、上下文管理和扩展思考模式。适用场景：需要迭代使用工具的自主智能体、带验证与迭代的智能体工作流、用于复杂任务分解的子智能体层级、通过 MCP 接入标准化工具，以及钩子、权限、上下文管理等生产模式。若只需简单单轮调用、无需使用工具或需要自定义智能体循环，则不建议使用，可直接调用 Messages API。
语言支持方面，Python 使用 claude-agents 包，TypeScript 使用 @anthropics/agent-sdk 包（Node.js 环境），两者共享核心概念与 API 模式。安装命令为 pip install claude-agents 或 npm install @anthropics/agent-sdk；通过环境变量 ANTHROPIC_API_KEY 或在代码中显式传入完成认证。
主要能力包括：自动智能体循环（输入处理、模型调用、工具执行、迭代、输出）、上下文管理（系统提示、对话历史、工具定义与结果）以及可通过子智能体隔离上下文；内置工具涵盖 bash、read_file、write_file、edit_file、glob、grep，并支持按 JSON Schema 定义自定义工具；支持通过 MCPClient 连接 MCP 服务器；权限系统提供 allowed_tools 白名单、disallowed_tools 黑名单及 strict/permissive 模式；钩子系统包含 PreToolUseHook、PostToolUseHook、PreSubagentStartHook、PostSubagentStopHook，可用于日志、校验与拦截。常见模式有文件操作、代码执行、智能体搜索、子智能体委派、错误处理与自验证。
限制方面，官方资料未提供具体收费与价格信息；部分模型名称、token 预算建议（如简单任务 4K-8K、复杂任务 16K-32K、研究分析 64K-128K、最大上下文 200K 视模型而定）及示例代码需结合具体环境验证。资料提及的 reference.md、examples.md、patterns.md、drift-detection.md 为随附参考文件，本次未提供其内容细节。