Claude 开发者生态全景

版本与时效声明

本文对应的版本：anthropic（Python）1.12.1、@anthropic-ai/sdk（TS）0.132.1、claude-agent-sdk（Python）0.2.164、@anthropic-ai/claude-agent-sdk（TS）0.3.293。TS 版 Agent SDK 的版本号与 Claude Code CLI 同步，这一版对应 Claude Code v2.1.293¹。以上均为 2026-10-08 在 PyPI、npm 和 GitHub 上看到的最新版本。
Managed Agents 处于 beta 阶段，请求头为 managed-agents-2026-04-01²。
资料截至 2026-10-09。Claude 的模型和 API 更新很频繁，本文不随官方同步更新，请对照 Claude 开发者文档和 Release notes 使用。

本文要点

Anthropic 的开发者产品可以分成四层：Claude API（Messages API）→ 客户端 SDK（7 种语言，外加 ant CLI）→ Claude Agent SDK（把 Claude Code 当作库来用）→ Claude Managed Agents（托管的 harness）。
一个最容易混淆的点：Tool Runner 和 Claude Agent SDK 不是一回事。前者是客户端 SDK 里的循环辅助工具，只循环你自己定义的工具；后者是带内置工具的完整 harness。
一个经常被忽视的重点：一切都通过 POST /v1/messages 实现。工具调用、结构化输出、服务端工具都只是这个端点上的功能，而不是独立的 API³。

1. 产品地图#

产品	是什么	运行在哪	状态	本专题笔记
Messages API	`POST /v1/messages`，无状态，每次请求都要带上完整历史⁴	Anthropic，或者 Bedrock、Vertex、Foundry 等平台	GA	3.2 Anthropic 客户端 SDK 与 Messages API
客户端 SDK	Python、TypeScript、C#、Go、Java、PHP、Ruby	你的进程	GA⁵	3.2
`ant` CLI	命令行工具，适合写 shell 脚本或交互使用	你的终端	GA⁵	—
Tool Runner	客户端 SDK 中的 beta 辅助工具，自动执行“请求、执行工具、循环”这一过程	你的进程	beta⁶	3.2
Claude Agent SDK	把 Claude Code 当作库使用：内置工具、权限、会话、hooks、subagents、MCP	你的进程，内部会启动 `claude` CLI 子进程	Python 0.2.x / TS 0.3.x⁷	3.3 Claude Agent SDK
Claude Code CLI	交互式的终端编码 agent；用 `-p` 参数可以无头运行	你的终端	GA⁷	—
Claude Managed Agents	托管的 agent harness 加沙箱，核心概念是 agent、environment、session、events	Anthropic 托管；沙箱也可以自托管	beta，2026-04-08 公测⁸	3.4 Claude Managed Agents

Anthropic 官方对这四者的区分⁷：

你想要	用	你得到什么
在自己的 Python 或 TS 应用里嵌入 Claude Code 的 agent，跑在你自己运营的进程中	Agent SDK	一个运行 Claude Code 二进制的库，带内置工具、权限、会话、hooks 等能力
在终端里做交互式开发，或者执行一次性任务	Claude Code CLI	终端界面
在自己的代码里直接调用 Claude API	Client SDK	直接访问 API；工具循环自己写，或者交给 beta 的 tool runner
让 Anthropic 来托管 agent	Managed Agents	托管的 harness，会话运行在 Anthropic 管理的云端沙箱，或你自托管的沙箱中

2. 四种构建 Agent 的方式#

方式	你需要写什么	可用的工具	适合什么情况
① 手写循环	`while stop_reason == "tool_use"` 循环	只有你自己定义的	想完全掌控循环（见 1.2 Tool Calling 与 Agent Loop 原理）
② Tool Runner	只写工具函数	只有你自己定义的	自定义工具，又不想手写循环
③ Managed Agents	agent 配置，以及你的工具返回的结果	托管沙箱里的 bash、文件工具、代码执行，加上 Skills、MCP 和你的工具	希望 Anthropic 运行循环并托管工作区
④ Agent SDK	一段 prompt 加若干选项	内置的 Read、Write、Edit、Bash、Glob、Grep、WebSearch、WebFetch 等，加上 MCP 和 subagents	想要一个开箱即用的编码或文件系统 agent，部署在自己的基础设施上

这张表是笔者根据官方文档的对比整理的，依据包括 Agent SDK overview⁷、Tool Runner⁶ 和 Managed Agents overview²。

核心区别：谁提供 harness，谁负责部署

①、②、④ 的部署都由你负责。其中 ② 只提供循环，④ 提供完整的 harness。
只有 ③ 是 harness 和部署都交给 Anthropic。

3. Messages API 的能力地图#

Anthropic 的设计思路是一个端点，加上很多功能。工具调用和输出约束都是 POST /v1/messages 的功能，而不是单独的 API³。

功能对应的官方文档入口：

工具：Tool use
推理：Adaptive thinking
缓存：Prompt caching
结构化输出：Structured outputs

4. 演进时间线#

时间线出处：MCP⁹；Agent SDK 更名¹⁰；其余节点都来自官方 release notes⁸。

这条线的脉络：

先定标准：推出 MCP，统一工具接入的方式。
再补 API 能力：服务端工具、文件、记忆、上下文编辑、skills、结构化输出。
然后开放 harness：Claude Code SDK 演变为 Agent SDK。
最后提供托管运行：Managed Agents。

5. 模型阵容（2026-10）#

模型	API ID	官方定位	价格（输入 / 输出，每百万 token）	默认 effort
Claude Fable 5.1	`claude-fable-5-1`	高难度推理与长程 agent 任务	$10 / $50	`high`
Claude Opus 5.5	`claude-opus-5-5`	长时间运行的 agent 编码与知识工作	$4 / $20	`medium`
Claude Sonnet 5.5	`claude-sonnet-5-5`	速度与智能的最佳平衡	$2 / $10	`high`
Claude Haiku 5.5	`claude-haiku-5-5`	高吞吐、对延迟敏感的任务，如分类、抽取、路由	起价 $0.10 / $0.50	`medium`

以上来自官方 Models overview¹¹。另外几个要点：

四个模型都有 1M token 上下文窗口；
Fable 5.1 和 Opus 5.5 的 thinking 始终开启（adaptive）；
官方建议大多数场景从 Claude Opus 5.5 开始¹¹。

2026 年 API 的几处“漂移”

如果你记忆中的写法来自 2025 年或更早，请注意以下变化：

thinking：新模型改用 thinking: {type: "adaptive"}，用 effort 控制推理深度。旧的 budget_tokens 写法在 Opus 4.6 和 Sonnet 4.6 上已废弃，在更新的模型上直接返回 400¹²⁸。
结构化输出：用 output_config.format，旧参数 output_format 已废弃¹³。
Assistant prefill：新一代模型不再支持在最后一条 assistant 消息中预填内容，请改用结构化输出或系统提示词⁸。

6. 平台：Claude 不只在 Anthropic 自家的 API 上#

同一个模型可以通过多个平台访问：

Claude API（第一方）
Claude Platform on AWS（由 Anthropic 运营，用 AWS 计费和 IAM 鉴权）
Amazon Bedrock
Google Cloud Vertex AI
Microsoft Foundry

以上来自 Models overview 中的模型 ID 表¹¹。各平台上可用的功能并不完全相同。例如 Managed Agents 文档中明确提到，它在 Claude Platform on AWS 上可用，但功能与会话行为有差异²。使用前请查阅官方的平台可用性说明。

7. 阅读顺序#

小结#

一个端点（Messages API），加三种循环形态（手写、Tool Runner、Agent SDK），再加一个托管选项（Managed Agents），这就是 Claude 开发者生态的骨架。
Agent SDK 的特殊之处在于，它直接把 Anthropic 自家产品（Claude Code）的 harness 开放给开发者，内置工具、权限、会话、hooks 都是现成的。
学习路径建议：先手写一次 Messages API 的循环，再用 Tool Runner，然后学 Agent SDK，最后了解 Managed Agents。

参考资料#

注释与出处#

anthropics/claude-agent-sdk-typescript，CHANGELOG.md（0.3.293：“Updated to parity with Claude Code v2.1.293”），https://github.com/anthropics/claude-agent-sdk-typescript/blob/799dc78749f5568e2965699c6ed4d2542031082d/CHANGELOG.md ↩
Anthropic，Claude Managed Agents overview，https://platform.claude.com/docs/en/managed-agents/overview ↩ ↩² ↩³
Anthropic，Tool use with Claude，https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview ↩ ↩²
Anthropic，Working with the Messages API，https://platform.claude.com/docs/en/build-with-claude/working-with-messages ↩
Anthropic，SDKs, CLI, and libraries（列出 7 种语言的客户端 SDK 和 ant CLI），https://platform.claude.com/docs/en/cli-sdks-libraries/overview ↩ ↩²
Anthropic，Tool Runner (SDK)，https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner ↩ ↩²
Anthropic，Agent SDK overview（Compare the Agent SDK to other Claude tools 一节），https://code.claude.com/docs/en/agent-sdk/overview ↩ ↩² ↩³ ↩⁴
Anthropic，Release notes（2025-05-22、2025-09-17、2025-09-29、2025-10-16、2025-11-14、2026-02-05、2026-04-08、2026-09 各条目），https://platform.claude.com/docs/en/release-notes/overview ↩ ↩² ↩³ ↩⁴
Anthropic，Introducing the Model Context Protocol（2024-11-25），https://www.anthropic.com/news/model-context-protocol ↩
Anthropic Engineering，Building agents with the Claude Agent SDK（2025-09-29，文中写道 “we're renaming the Claude Code SDK to the Claude Agent SDK”），https://www.anthropic.com/engineering/building-agents-with-the-claude-agent-sdk ↩
Anthropic，Models overview（Compare models 表），https://platform.claude.com/docs/en/about-claude/models/overview ↩ ↩² ↩³
Anthropic，Adaptive thinking，https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking ↩
Anthropic，Structured outputs，https://platform.claude.com/docs/en/build-with-claude/structured-outputs ↩