前言¶

接入 Claude API 的开发者大概都遇到过这类场景：文档里刚学会 thinking: {type: "enabled", budget_tokens: N}，新模型上线后同一参数直接返回 400；流式、工具调用、Prompt Caching、MCP 各自有 beta header 和版本号，翻官方文档要跳转好几个页面；项目里混用 Python、TypeScript、Go 时，SDK 命名和 import 路径又不一样。更麻烦的是，AI 助手往往凭「训练记忆」写代码，模型 ID、定价、参数形状一旦过期，排查成本很高。

Anthropic 在开源 skills 仓库里维护了一个名为 claude-api 的 Agent Skill，并在 Claude Code 中内置。它的定位很直接：把 Messages API、Claude Managed Agents（beta）以及 8 种语言的 SDK 文档打包成可渐进加载的参考，让 AI 在写 Claude 相关代码前先读「当前版本」的说明，而不是猜。

这是什么¶

claude-api 是 Anthropic 出品的开源 Agent Skill，遵循通用 SKILL.md 格式，可在 Claude Code、Cursor 等支持 Agent Skills 的 AI 编程环境中使用。

一句话概括：它是 Claude API / Anthropic SDK 的结构化参考，覆盖模型 ID 与定价、流式响应、工具调用、MCP、Agent 构建、Prompt Caching、Token 计数、模型迁移等主题，并按项目语言自动加载对应文档（Python、TypeScript、C#、Go、Java、PHP、Ruby、cURL）。

官方说明见 Claude API skill 文档与仓库目录 skills/claude-api。

核心功能与亮点¶

1. 覆盖两大 API 面¶

Skill 区分两类使用场景，并给出选型建议：

场景	推荐面	典型用途
分类、摘要、抽取、问答	Messages API（单次调用）	一次请求一次响应
多步流水线、自研工具循环	Messages API + Tool Use	代码侧编排 agent 循环
托管状态、持久化 Agent 配置	Claude Managed Agents（beta）	Anthropic 托管 loop 与会话沙箱

Skill 正文里还区分了四种 Agent 构建方式（手动 loop、SDK Tool Runner、Managed Agents、Claude Agent SDK），避免把不同产品混为一谈。

2. 八语言 SDK 文档，按项目自动匹配¶

Skill 会先扫描项目文件推断语言，再只加载对应子目录（如 python/、typescript/、go/）。若检测到 OpenAI 等其他 SDK 且用户并未要求切换，会提示当前 Skill 产出 Anthropic 代码，避免误改文件。

各语言均支持 Messages API；Python、TypeScript、Java、Go、Ruby、C#、PHP 还支持 beta 版 Tool Runner 与 Managed Agents；cURL 提供原始 HTTP 示例。

3. 渐进式披露，控制上下文体积¶

与 Agent Skills 通用机制一致（见官方概述）：

Level 1：YAML 元数据（name、description）常驻，约百级 token；
Level 2：触发后读取 SKILL.md 正文；
Level 3：按需读取 shared/、各语言 README、迁移指南等附属文件。

因此 Skill 可以 bundled 大量 API 参考，而不会在每次对话里占满上下文。

4. 强调「API 漂移」与模型迁移¶

Skill 内建 API Drift 对照表，例如：Claude 4.6+ 上 budget_tokens 已废弃，应改用 thinking: {type: "adaptive"}；Web Search / Web Fetch 工具类型有 _20260209 等新版本。还提供 /claude-api migrate 子命令，按官方迁移指南批量改模型 ID、beta header、prefill 写法等。

5. 常用能力速查¶

已核实文档中包含以下主题的 Quick Reference（细节在各语言 README 或 shared/ 文件中）：

流式：长输入/长输出默认建议 streaming，可用 SDK 的 get_final_message() 等辅助方法；
工具调用：用户自定义工具、Server Tools（web search、code execution 等）、Tool Runner；
Prompt Caching：前缀匹配、breakpoint 放置、静默失效排查；
Token 计数：POST /v1/messages/count_tokens；
MCP / Agent：Managed Agents 的 Agent → Session 流程、vault 凭证、Skills + MCP 组合；
模型信息：缓存的模型 ID、上下文窗口与定价表，并建议用 Models API 做实时能力查询。

安装与启用¶

Claude Code（内置，无需安装）¶

claude-api 随 Claude Code 一起发布。当项目已 import anthropic / @anthropic-ai/sdk，或你询问 Claude API 相关问题时会自动激活。也可手动输入：

/claude-api

更多说明见 Claude Code Skills 文档。

从 GitHub 仓库安装¶

官方提供的通用安装命令：

npx skills add https://github.com/anthropics/skills --skill claude-api

Claude Code 插件方式¶

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

手动放置（Claude Code 自定义 Skill 目录）¶

若需自行维护副本，Claude Code 支持：

个人：~/.claude/skills/
项目：.claude/skills/

将仓库中 skills/claude-api 目录（含 SKILL.md 及子目录）复制到上述路径即可。Cursor 等工具若支持同名 SKILL.md 规范，也可按各工具约定放入对应 skills 目录（如项目的 .cursor/skills/）。

典型用法示例¶

构建流式聊天（自然语言触发）¶

在已安装 Skill 的环境中直接描述任务，Skill 会加载对应语言文档：

Build a streaming chat UI with the Claude API in TypeScript

模型迁移（子命令）¶

/claude-api migrate everything under src/ to claude-opus-5

也可指定文件范围：

/claude-api migrate apps/api.py and apps/worker.py to claude-opus-5

Skill 会先确认迁移范围，再按 shared/model-migration.md 逐步修改，并在结束时给出需人工验证的检查项。

新建 Managed Agent（子命令）¶

/claude-api managed-agents-onboard

该流程以访谈方式引导：Agent 配置（一次创建）→ Session（每次运行），并生成对应语言的可运行示例代码。Managed Agents 需要 beta header managed-agents-2026-04-01，官方 SDK 会在相关调用中自动设置。

Python 快速调用示例（Skill 推荐写法）¶

Skill 默认建议使用官方 SDK，而非裸 HTTP。以下为 Messages API 常见模式（参数以 Skill 内 {lang}/ 文档为准）：

import anthropic

client = anthropic.Anthropic()

with client.messages.stream(
    model="claude-opus-5",
    max_tokens=4096,
    thinking={"type": "adaptive"},
    messages=[{"role": "user", "content": "Hello"}],
) as stream:
    message = stream.get_final_message()
    print(message.content[0].text)

适用场景与注意事项¶

适合谁用

正在集成 Claude API 或 Anthropic SDK 的应用开发者；
需要在多语言 monorepo 中保持 API 用法一致的后端/全栈团队；
计划从旧模型（如 Opus 4.8）迁移到 Opus 5 / Sonnet 5 的项目；
尝试 Claude Managed Agents（beta）的 Agent 开发者。

不会激活的情况

官方文档明确：若任务与 OpenAI、Gemini 等其他厂商 SDK 相关，或仅为通用编程/数据科学问题，Skill 不会介入。Skill 的 description 里也要求：检测到项目主要使用其他 LLM 提供商时跳过。

使用注意

Managed Agents 平台限制：目前适用于 Claude API 与 Claude Platform on AWS，不支持 Amazon Bedrock、Google Vertex AI、Microsoft Foundry；Skill 会将此类部署路由到 Messages API + Tool Use。
Claude Agent SDK 与 Tool Runner 不同：前者是 Claude Code 打包库（内置 Read/Write/Bash 等），后者是常规 SDK 中的 beta 工具循环辅助；Skill 覆盖前者以外的 API 集成，不替代 Agent SDK 文档。
文档时效：模型表有缓存日期，涉及「某模型是否支持某能力」时，Skill 建议调用 Models API 实时查询。
安全：Skill 来自 Anthropic 官方仓库；从第三方 fork 安装时应审计 SKILL.md 及脚本内容，与安装任意开源工具同理。

小结¶

claude-api Skill 把分散在多份官方文档里的 Claude API 知识收拢成 AI 可执行的参考包：自动识别语言、渐进加载、内置迁移与 Managed Agents 引导，能显著减少「凭记忆写过期 API」的问题。若你已在用 Claude Code，它默认可用；其他环境可从 GitHub 安装或复制 Skill 目录。

官方资源：

Skill 源码：https://github.com/anthropics/skills/tree/main/skills/claude-api
官方介绍：https://platform.claude.com/docs/en/agents-and-tools/agent-skills/claude-api-skill
Agent Skills 总览：https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview

claude-api Skill：Claude API 开发者的随身参考手册

前言¶

这是什么¶

核心功能与亮点¶

1. 覆盖两大 API 面¶

2. 八语言 SDK 文档，按项目自动匹配¶

3. 渐进式披露，控制上下文体积¶

4. 强调「API 漂移」与模型迁移¶

5. 常用能力速查¶

安装与启用¶

Claude Code（内置，无需安装）¶

从 GitHub 仓库安装¶

Claude Code 插件方式¶

手动放置（Claude Code 自定义 Skill 目录）¶

典型用法示例¶

构建流式聊天（自然语言触发）¶

模型迁移（子命令）¶

新建 Managed Agent（子命令）¶

Python 快速调用示例（Skill 推荐写法）¶

适用场景与注意事项¶

小结¶

精选优惠券

claude-api Skill：Claude API 开发者的随身参考手册

前言¶

这是什么¶

核心功能与亮点¶

1. 覆盖两大 API 面¶

2. 八语言 SDK 文档，按项目自动匹配¶

3. 渐进式披露，控制上下文体积¶

4. 强调「API 漂移」与模型迁移¶

5. 常用能力速查¶

安装与启用¶

Claude Code（内置，无需安装）¶

从 GitHub 仓库安装¶

Claude Code 插件方式¶

手动放置（Claude Code 自定义 Skill 目录）¶

典型用法示例¶

构建流式聊天（自然语言触发）¶

模型迁移（子命令）¶

新建 Managed Agent（子命令）¶

Python 快速调用示例（Skill 推荐写法）¶

适用场景与注意事项¶

小结¶

精选优惠券

相关文章