Claude Agent SDK 用于构建可自主使用计算机的 AI 智能体（代理），提供 Python（3.10+）与 TypeScript（Node 18+）两个版本。仓库：Python 见 https://github.com/anthropics/claude-agent-sdk-python ，TypeScript 见 https://github.com/anthropics/claude-agent-sdk-typescript 。安装命令为 pip install claude-agent-sdk 与 npm install @anthropic-ai/agent-sdk。
核心架构是反馈循环：收集上下文、执行动作、验证结果、重复迭代，直至任务完成。执行机制有优先级：自定义工具用于重复性主流程，bash 用于探索性一次性操作，代码生成用于可校验的结构化输出（推荐 TypeScript 以便获得 lint 反馈），MCP 用于第三方集成。工具命名格式为 mcp__{server_name}__{tool_name}。
主要能力包括：自定义工具（SDK MCP，进程内运行，无子进程开销）；钩子（PreToolUse/PostToolUse/Stop 生命周期回调，可校验、修改或拒绝工具调用）；权限系统（default、plan、acceptEdits、bypassPermissions 四种模式，并可用 canUseTool 动态控制）；子代理（独立上下文，可并行与隔离）；上下文管理（优先用 bash 与文件系统导航做代理式搜索，自动压缩消息）；验证模式（基于规则优先，其次视觉反馈截图与 LLM 评判）。
用法要点：Python 使用 async_ 与 continue_ 避免关键字冲突；系统提示需设置 setting_sources=["project"] 或 ["user", "project"]；目录需通过 add_dirs 显式添加；支持会话恢复与 fork、预算控制（如 budget={"usd": 5.00}）。从已弃用的 claude-code-sdk 迁移时，包名改为 claude-agent-sdk，Python 类型由 ClaudeCodeOptions 改为 ClaudeAgentOptions。
适用场景：需要计算机访问、带验证循环的迭代工作流、多步骤任务、自定义工具集成、需要权限控制与安全审计的代理。限制与注意：简单 API 调用、无工具访问需求、纯对话、强实时流式响应场景不建议使用；需验证工具输入、限制文件系统范围、设预算并记录工具调用日志，切勿硬编码 API 密钥。具体价格与更多细节本文档暂未提供。