Claude API 写代码别再凭记忆了——Anthropic 官方这个 Skill 才是活字典

用了半年 Claude API，突然发现你写的代码里好多参数都是过期的——比如还在用 thinking: {type: "enabled", budget_tokens: 4096}，结果线上直接被 400 拒了。兄弟，Anthropic 官方刚刚把这个 Skill 升级到支持 Claude Opus 5 了，这份「写 Claude 代码的活字典」你不收藏一下？

它藏在 anthropics/skills 仓库（166k stars）的 skills/claude-api/ 子目录里——不是那种「调用方法 demo」级别的 demo，而是一个针对 Claude API 完整工作流的官方 Spec。我把它当 skill 用了一周，最大的感受是：它强制你按 Anthropic 的最佳实践写代码，连「混用 OpenAI shim」都明令禁止。

它解决了什么真实问题

训练数据里关于 Claude API 的记忆严重滞后。SKILL.md 里直接列了一张「API Drift」表，把 2025–2026 改过的形状写死：

• thinking 参数从 enabled + budget_tokens 变成 adaptive，在 Fable 5/Sonnet 5/Opus 5 上传 budget_tokens 直接 400。
• Web search 工具版本从 web_search_20250305 升到 web_search_20260209，每个模型支持的不一样。
• PHP 的命名参数是 camelCase（maxTokens）而不是 snake_case（max_tokens），嵌套数组里的 key（taskBudget、skillID）更是一言难尽——必须照抄样例，不能批量转换。

这些坑你要是不知道，写出来的代码本地跑没问题，一上线就炸。

Skill 怎么用

SKILL.md 头部有完整的触发条件：只要 prompt 里出现 Claude/Anthropic/Fable/Opus/Sonnet/Haiku，或者用户问 LLM 的定价、模型选择、限额、缓存、agent/MCP/tool-definition/RAG/工具调用——它都会强制介入，要求先读这份 skill 再开干。甚至配了一个 grep 黑名单：项目里出现 openai、langchain_openai、google.generativeai 任何一个就立刻停下来问你——「这是非 Anthropic 项目，确认要切到 Claude 吗？」

内置 8 种语言的支持目录（python/、typescript/、go/、java/、php/、ruby/、csharp/、curl/）以及 shared/ 通用资料，每个子目录都是针对该语言 SDK 的速查表。还支持 /claude-api migrate 这种子命令——会自动跑一遍模型迁移流程。

谁该立刻装上

所有要把 Claude 接进生产项目的同学——尤其是：

• 正打算升级到 Opus 5 / Sonnet 5 的，怕线上踩 400；
• 多语言团队，PHP/Go/Java 这类非 Python 项目需要 SDK 速查；
• 写了几个月 Claude 代码，想确认自己没把过期 API 留在生产里的；
• 用 Claude Code 做开发、希望模型能「按官方套路」写代码而不是凭训练记忆瞎猜的。

把它挂到 Claude Code 当 plugin marketplace（/plugin marketplace add anthropics/skills），或者在 Claude.ai/API 直接 mention 就行。装上之后你会发现——模型写出来的 Claude API 代码，可信度直接上一档。

👉 仓库地址：https://github.com/anthropics/skills/tree/main/skills/claude-api

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