用途：Claude Agent SDK 用于构建可自主读文件、运行命令、搜索网页、编辑代码的 AI 智能体，提供与 Claude Code 相同的工具与智能体循环，可用 Python 和 TypeScript 编程。原名 Claude Code SDK，现更名为 Claude Agent SDK。
安装：TypeScript 使用 npm install @anthropic-ai/claude-agent-sdk；Python 使用 uv add claude-agent-sdk 或 pip install claude-agent-sdk。TypeScript 版内置原生 Claude Code 二进制，无需单独安装。需设置 ANTHROPIC_API_KEY，也支持 Bedrock、Vertex AI、Azure。
主要能力：核心是智能体循环（接收提示→评估→调用工具→观察结果→重复→返回结果）。入口有 query() 与 Python 的 ClaudeSDKClient；前者适合一次性任务与 CI/CD，后者支持多轮会话与中断。可配置模型、effort、最大轮次、预算上限、权限模式、允许/禁止工具、系统提示、工作目录、MCP 服务器、子智能体、钩子、结构化输出、思考模式、文件检查点、插件、技能与会话存储。内置工具包括 Read、Write、Edit、Bash、Monitor、Glob、Grep、WebSearch、WebFetch、Agent、AskUserQuestion、TodoWrite、ToolSearch。
使用方式：通过 options 配置权限模式（default、acceptEdits、dontAsk、plan、bypassPermissions，TypeScript 另有 auto），用 allowedTools 自动批准工具，用 disallowedTools 彻底禁止。钩子可拦截 PreToolUse、PostToolUse 等事件，实现阻止、修改输入、注入上下文或自动批准。子智能体通过 agents 定义，拥有独立上下文窗口。自定义工具通过进程内 MCP 服务器创建，命名格式为 mcp__{server_name}__{tool_name}。外部 MCP 支持 stdio、sse、http、sdk 传输。会话支持继续、恢复与分叉，存储在 ~/.claude/projects 下。
适用场景：一次性任务、CI/CD、交互式应用、聊天机器人、多租户隔离环境等。
限制：allowedTools 只自动批准列出的工具，不会阻止其他工具；要阻止需用 disallowedTools。MCP 工具默认不自动批准，需加入 allowedTools。会话持久化的是对话而非文件系统，文件快照需用文件检查点。恢复会话时工作目录必须匹配。子智能体嵌套最多 5 层。具体收费、价格与效果资料暂未提供。