Claude API 技能把模型 id、价格、参数、流式、工具调用、缓存这些容易过时的东西钉在一个地方，让 Agent 别凭记忆写代码。

写调用大模型的代码，最容易错的地方不是语法，是参数：模型名写错、缓存标记放错位置、工具调用返回后没校验。这个技能的定位很偏执：只要你的提示词里出现 Claude / Anthropic / Sonnet / Haiku 这类词，或者任务本身是 LLM 相关（工具调用、结构化输出、缓存、限流），Agent 必须先读它，不许直接写代码。

基本信息

项目内容
技能名称claude-api
适用平台支持 Agent Skills 的客户端（Claude Code、Claude 系列、兼容 Skills 的 Agent）
安装方式拷入客户端 skills 目录；或从 anthropics/skills 仓库按 README 安装
仓库或市场地址https://github.com/anthropics/skills/tree/main/skills/claude-api
包含能力模型 id 与定价、参数与流式、工具调用、MCP、缓存、token 计数、迁移说明

核心能力

按语言分目录。 技能里按 Python、TypeScript、Go、Java、C# 等分了子目录，每个目录下是该语言 SDK 的实际写法。它明确要求：不许把从 curl 推出来的参数套到其他语言 SDK 上。这一条能避免绝大多数“看起来对、跑起来报错”的代码。

默认值写死在技能里。 例如默认模型用 claude-opus-5-5，复杂任务默认开 adaptive thinking，长输入长输出默认开流式。你不需要每次在提示词里重复这些，Agent 读技能就知道团队默认怎么调。

强制区分 SDK 与原生 HTTP。 技能要求：有官方 SDK 的语言必须用 SDK，只有用户明确要 curl/REST 时才写 HTTP。同时禁止回退到 OpenAI 兼容层。对维护长期项目的人，这条能避开一大类技术债。

API 漂移清单。 它单列了一节「你的训练记忆可能已过期」，把 2025–2026 年间改过的常见写法列出来对照。模型名、思考参数、工具调用结构这些变动频繁的东西，靠模型默认记忆写基本会错。

供应商隔离。 技能会先扫描目标文件里有没有 import openai、gpt-4、langchain_openai 这类标记；发现就停下来问你，而不是默默把文件改成 Anthropic 写法。

使用上手

  1. 把 skills/claude-api 目录拷入你客户端的 skills 目录。
  2. 确认客户端支持 Skills（不支持的话，效果等于把一份大型参考文档粘进上下文）。
  3. 先跑一个最小任务：「用 Python 调 Claude 写一个带工具调用的问答脚本」。
  4. 看它选的模型与参数是否符合预期；不符合就直接说“默认用 XX”。
  5. 写生产代码时，把缓存、重试、超时这三项单独提一句让它实现，技能里有对应写法。
  6. 如果你项目里已有 OpenAI 代码，先告诉它“这是混合项目”，避免它强行改供应商。

优点与不足

优点是把易过时的知识从模型记忆里抽出来，变成可更新的文件；语言分目录、强制用 SDK，代码质量比“让它自己猜”高很多；有漂移清单与供应商隔离，长期项目友好。不足是它也依赖官方文档同步，更新跟不上时仍会错；技能内容长，对小上下文窗口的模型是负担；只解决 Claude 一家，多供应商项目需要另配技能。

适合谁

适合写生产级 LLM 应用的开发者；适合团队想统一模型调用规范、避免每个人一套写法；适合正在从其他供应商迁到 Claude 的项目。不适合只是偶尔调用一次 API 写脚本的人。

获取与授权

项目说明
获取方式GitHub anthropics/skills → skills/claude-api，下载整个目录
安装拷入 skills 目录；部分客户端需在配置里声明启用
依赖无额外依赖，纯文档 + 示例代码；实际运行需对应语言 SDK
授权目录内 LICENSE.txt 单独约定，以仓库文件为准

技能内容会随官方文档更新，其中的模型 id 与价格以 Anthropic 官网为准。

本文属于「技能」分类的 AI 资源专栏，更多评测见分类页。