用途:Claude Agent SDK 是 Anthropic 官方框架,用于构建可投入生产的 AI 智能体。它在 Messages API 之上提供高层抽象,自动处理智能体循环、工具编排、上下文管理与扩展思考模式。适合需要迭代使用工具的自主智能体、带验证与迭代的智能体工作流、复杂任务分解的子智能体层级,以及接入 MCP(模型上下文协议)服务器的场景;若只需单轮调用、无需工具或需要自定义循环逻辑,则直接使用 Messages API 更合适。
主要能力:自动管理完整的智能体循环(输入处理、模型调用、工具执行、迭代、输出),内置错误处理与重试、上下文压缩与 token 预算跟踪。工具系统提供 bash、read_file、write_file、edit_file、glob、grep 等内置工具,并支持自定义工具(名称、描述、JSON Schema 输入、函数)。支持 MCP 客户端接入标准化工具服务器。权限系统提供允许/禁止工具列表与 strict、permissive 模式。钩子系统包括 PreToolUseHook、PostToolUseHook、PreSubagentStartHook、PostSubagentStopHook,可用于日志、校验与阻断。子智能体可隔离上下文,避免污染父级。
使用方式:Python 安装 pip install claude-agents,TypeScript 安装 npm install @anthropics/agent-sdk。设置环境变量 export ANTHROPIC_API_KEY="your-api-key-here",或在代码中显式传入。基本用法为创建 Agent(指定 model、system),调用 agent.run("任务") 获取 result.response。可传入 tools、allowed_tools、disallowed_tools、hooks、mcp_clients 等参数。
适用场景:文件操作、代码执行、智能体式搜索(收集—行动模式)、子智能体委派、结果自验证、与 Amplihack 框架集成等。
限制:SDK 的智能体循环是固定设计,不适合需要自定义循环逻辑的情况;简单单轮对话无需使用。资料未提供具体收费、价格与平台支持范围等信息。