别再翻文档了：Anthropic 官方把 Claude API 最新用法打包进这个 Skill

别再翻文档了：Anthropic 官方把 Claude API 最新用法打包进这个 Skill

每次你 copy 一段 Claude API 旧代码，结果模型名报错、thinking 参数失效、WebSearch 的 tool type 不认——我就知道，你踩到了 API drift 的坑。

Anthropic 官方仓库 anthropics/skills 里藏着一个极其实用的 Skill：claude-api。它本质上是一份活的 Claude API 速查手册，专门帮你避开 2025–2026 年间那些已经悄悄改掉的行为。

为什么值得装？

这个 Skill 的触发条件写得非常克制：只要 prompt 里出现 Claude、Anthropic、Opus、Sonnet、Haiku、@anthropic-ai 这些关键词，它就会自动加载。然后它会先做一件很重要的事——检查你的目标文件里有没有混进 OpenAI/Gemini/Llama 的导入。如果有，它会直接拦住你，要求你先声明“这篇代码到底要用谁家的 SDK”。

这一点对有迁移经验的开发者太重要了。很多人把 Claude SDK 和 OpenAI 兼容接口混着用，线上调试时才发现默认模型根本不是 Opus，而是偷偷 fallback 到了 gpt-4o。

最实用的三块内容

1. 模型选择与默认值
Skill 直接帮你锁定 Claude Opus 4.8，而且明确写死：复杂任务默认用 thinking: {type: "adaptive"}。如果你还在用老写法 thinking: {type: "enabled", budget_tokens: N}，在 Opus 4.6+ 上会直接 400——Skill 会提前拦住你。

2. Tool Use / Server Tools 的命名
Claude 在 2025–2026 把 web_search / web_fetch 的 tool type 统一升级了。Skill 里列出了最新版本 web_search_20260209、web_fetch_20260209，省得你去翻 changelog。

3. SDK 代码不能靠猜
Skill 反复强调：函数名、类名、命名空间必须来自官方文档，不能从 OpenAI 的 cURL 形状推断。它甚至会先做 grep，如果项目里有 import openai，立刻切换上下文。

适用场景

• 正在写 Claude / Anthropic SDK 的工程
• 需要搭建 MCP Server 并与 Claude API 对接
• 帮团队统一模型调用规范，减少“为什么本地能跑”的扯皮
• 给 AI 编程助手加一份“Claude 专用守则”

怎么用？

claude-api 只是 anthropics/skills 官方仓库里的一个 Skill。你只需要在 Claude Code 里注册这个仓库：

/plugin marketplace add anthropics/skills

然后在项目里启用它，遇到和 Claude API 相关的问题时它会自动介入。你也可以在 anthropics/skills 直接读 claude-api/SKILL.md，内容完全开源，按 MIT 协议可自由参考。

如果你还在用 curl 直接调 /v1/messages，这篇 Skill 建议你先停一下：把模型名、thinking、tool schema 这些都过一遍，很可能已经有字段悄悄地不兼容了。

GitHub：https://github.com/anthropics/skills/tree/main/skills/claude-api

GitHub: https://github.com/anthropics/skills/tree/main/skills/claude-api