Claude Agent SDK

Claude Agent SDK 是 Anthropic 把 Claude Code 智能体循环跑在你自己进程里的库。2026-08-17 复核：文档在 platform.claude.com/docs/en/agent-sdk/overview。Python 是 anthropics/claude-agent-sdk-python（7,910 stars，MIT）。TypeScript 是 anthropics/claude-agent-sdk-typescript（1,702 stars）。它不是 pip install anthropic，也不是 github.com/anthropics/anthropic-sdk-python。那个 Messages 客户端是另一套 SDK。

如果要交互式 CLI，对比 Claude Code；如果要 OpenAI 的智能体库，对比 OpenAI Agents SDK；如果要个人 $0 的编辑器智能体而不是库，对比 Cline。

核心功能

• 库，不是 Messages 客户端：文档写 Agent SDK 提供与 Claude Code 相同的工具、智能体循环和上下文管理，语言是 Python 和 TypeScript。
• 安装智能体包：pip install claude-agent-sdk 和 npm install @anthropic-ai/claude-agent-sdk。不要把旧的 from anthropic import Anthropic 片段当入门路径。
• 会话、MCP、子智能体、hooks：活概览列出会话、流式、MCP、工具搜索、子智能体、skills、插件、权限、hooks、checkpoint 和 OpenTelemetry。以打开的页面为准，不要把 Sonnet 4.5 冻成唯一模型。
• 托管 vs 进程内：Anthropic 还卖 CLI 和托管智能体。用文档对照表，不要把这个 SDK 说成唯一官方智能体产品。

适用场景

• 要把 Claude Code 嵌进应用、需要进程内循环的人。
• 误装了 anthropic、需要正确仓库的人。
• 看完官方对照表后对比 Agent SDK 和 CLI 的团队。

局限：我们没有为这个 SDK 编造公开美元席。模型 token 按 Anthropic 平台计费。GitHub 上 TypeScript 的 license 字段是空的，不要替它发明 SPDX。

定价方案

SDK 仓库开源。模型使用走 Anthropic API。

如果旧页还指向 anthropic-sdk-python 和 client.messages.create，以本表为准。

快速开始

1. 读 概览。
2. 安装 claude-agent-sdk（Python）或 @anthropic-ai/claude-agent-sdk（TypeScript）。
3. 如果要终端界面而不是库，再核对 Claude Code。
4. 不要为这个产品执行 pip install anthropic。

常见问题

这是官方 Anthropic Python SDK 吗？

不是。那是 anthropic-sdk-python。本产品是 claude-agent-sdk。

还叫 Claude Code SDK 吗？

文档现在叫 Agent SDK。循环仍是作为库的 Claude Code 循环。

会永远包含 Sonnet 4.5 吗？

不会。以活的模型列表为准。不要把 4.5 冻成目录。

替代方案

• Claude Code：交互式 Anthropic 智能体。
• OpenAI Agents SDK：OpenAI 的智能体库。
• Cline：个人 $0 的 VS Code/CLI 智能体。

使用技巧

1. 引用 claude-agent-sdk 和 7,910 stars。
2. 不要把 website 指到 anthropic-sdk-python。
3. 先核对 TypeScript license，再把两个仓库都写成 MIT。

总结

Claude Agent SDK 是 Anthropic 的进程内 Claude Code 库，不是 Messages Python 客户端。从 概览 起步，再决定 Claude Code 是否已经覆盖你要的界面。