1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | claude-api-anthropics-skills | — |
| 项目自述名称 | claude-api（SKILL.md 内 name 字段，/claude-api 调用） |
SKILL.md |
| 作者/维护者 | Anthropic（anthropics/skills 官方仓库） |
GitHub API |
| 来源链接 | https://github.com/anthropics/skills/tree/main/skills/claude-api | — |
| 许可证 | Apache License 2.0（子目录内含独立 LICENSE.txt） | GitHub 仓库文件 |
| GitHub Stars / Forks | 所属合集仓库 160,817★ / 18,976 forks（合集仓库 stars 不计给单个 skill，见第 6 章说明） | GitHub API |
| 最新版本 | 无独立版本号，随仓库滚动更新；本子目录最近一次改动 2026-07-01 | GitHub API（commits） |
| 安装方式 | Claude Code 内置零安装；或 npx skills add／插件市场安装 |
官方文档 |
2. 功能介绍与亮点
claude-api 为 Claude 在构建基于 Claude API / Anthropic SDK 的应用时，提供权威、随时更新的参考资料，覆盖两大官方接口：Messages API（单次请求、流式对话、工具调用、批处理、prompt caching、结构化输出）与 Managed Agents（beta）（Anthropic 托管的有状态 Agent 服务）。技能支持 Python、TypeScript、C#、Go、Java、PHP、Ruby、cURL 共 8 种语言，采用渐进式披露（progressive disclosure），按项目语言与具体任务只加载相关文档分片，避免占满上下文。
核心亮点：
- 官方出品，Claude Code 内置：随 Claude Code 直接分发，无需任何安装即可自动触发
/claude-api migrate一键模型迁移：自动识别模型 ID 替换、破坏性参数变更（如thinking从enabled+budget_tokens改为adaptive）、beta header 清理、effort 等级校准等十余项细节，并给出需人工复核的清单- “API Drift” 专章：主动列出训练先验容易过时的高频陷阱（如 PHP 参数命名规则变化），提醒不要凭记忆写代码
- 第三方生产落地验证：已被 CodeRabbit、JetBrains、Resolve AI、Warp 集成到各自产品中（详见第 8 章）
3. 适用场景
固定分类：工程效率与代码质量
- 使用 Claude API / Anthropic SDK 开发 LLM 应用的工程师（覆盖 8 种主流语言）
- 需要把旧版本 Claude 模型迁移到新模型的团队
- 想上手 Managed Agents（服务端托管有状态 Agent）的开发者
- 希望避免因训练数据过时而写出错误 API 调用代码的中级开发者
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方内置，零安装自动触发
- Codex：未验证——SKILL.md 遵循开放的 Agent Skills 格式，理论上可通过
npx skills add安装到任何兼容该规范的环境，但未见 Codex 官方适配说明 - OpenClaw：未验证——抓取材料中未提及
- Hermes Agent：未验证——抓取材料中未提及
（仅基于已抓取材料判断，未为兼容性单独发起搜索）
5. 推荐理由
Claude/Anthropic API 的模型 ID、参数、beta header 在过去一年多次变更，许多开发者训练先验或旧代码示例已经过时，直接沿用会在新模型上遇到 400 错误或行为偏差。claude-api 不是静态文档，而是会主动检测项目语言、识别常见“过时先验”陷阱、并能一键执行迁移的实操工具——已被 CodeRabbit、JetBrains、Resolve AI、Warp 等公司在各自生产工具链中采用，证明确实解决了真实痛点。作为 Claude Code 内置技能，用户零安装即可获得该能力，在同类候选中“开箱即用”程度最高。
6. 评分
| 维度 | 分数 |
|---|---|
| 受欢迎程度 | 10 |
| 可用性 | 10 |
| 安全性 | 9 |
| 综合评分 | 9.7 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行 | 无——子目录内 88 个文件全部为 .md/.txt 文档，无可执行脚本 |
| ② 运行时联网外发 | 仅在本地文档未覆盖时，按 shared/live-sources.md 中列出的官方 Anthropic/SDK 仓库地址执行 WebFetch，不上传用户代码或数据，外联目标透明且限定为官方文档源 |
| ③ API key/凭据 | 技能本身不要求任何凭据；用户实际调用 Claude API 时需自备 Anthropic API Key，这是使用该 API 的固有前提，非技能引入的额外风险 |
| ④ 可疑指令 | 抓取的 578 行 SKILL.md 全文及目录结构未见 prompt injection 或隐藏指令迹象 |
| ⑤ 作者信誉 | Anthropic 官方仓库，信誉最高档；已获 CodeRabbit / JetBrains / Resolve AI / Warp 验证采用 |
| ⑥ License | 子目录内含独立 Apache License 2.0 全文，权责清晰 |
| ⑦ 维护时间 | 本子目录最近一次改动为 2026-07-01（运行前 13 天），活跃维护 |
安全性未给满分的原因：含条件触发的 WebFetch 外联行为（尽管目标限定为官方文档源），故落在 9 档而非 10 档。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 来源 | 受欢迎程度证据 | 目标场景 |
|---|---|---|---|---|
| claude-api（本次推荐） | Claude API/SDK 权威参考 + 自动化模型迁移 | anthropics/skills 官方 | 官方出品 + CodeRabbit/JetBrains/Resolve AI/Warp 生产采用 | 用 Claude API 构建应用的工程师 |
| webapp-testing | 用 Playwright 测试本地 Web 应用 | anthropics/skills 官方（同仓库不同子目录） | 官方出品 | 需要浏览器自动化测试的工程师 |
| skill-codex | 让 Claude Code 委托 Codex CLI 处理任务 | skills-directory/skill-codex | 1,367★，第三方 | 想双模型协作的用户 |
| autoreview | 结构化代码评审收尾工作流 | openclaw/agent-skills 官方（同仓库不同子目录） | 所属仓库 885★，OpenClaw 官方 | OpenClaw 生态代码评审 |
| codex-skills-library（testing） | Codex 测试类技能集合 | proflead/codex-skills-library | 118★，第三方 | Codex CLI 测试相关任务 |
差异化：其余候选要么聚焦单一垂直问题（webapp-testing 测浏览器、autoreview 做代码评审收尾），要么是规模较小的第三方工具（skill-codex / codex-skills-library，star 数与官方背书均不及 claude-api）。claude-api 是唯一横跨 8 种编程语言、覆盖“日常调用—架构选型—版本迁移”全生命周期，且拿到多家知名开发工具公司公开采用背书的选项，厚度与权威性明显领先。
8. 用户评价
以下 3 条评价均亲自抓取自 Anthropic 官方博客 claude.com/blog/claude-api-skill（发布于 2026-04-29），受访者均为对应公司在职负责人具名发言：
- JetBrains（Denis Shiryaev，AI 开发工具生态负责人）：“该技能能自动更新模型引用、把手动配置的 thinking 参数迁移为 adaptive、清理过时参数与 beta header，并给出合适的 effort 等级建议。”
- Warp（Zach Lloyd，创始人兼 CEO）：“内置 Claude API 技能后，这些知识已经就位，工程师得以保持心流、更快交付。”
- CodeRabbit（Erik Thorelli，开发者体验负责人）：“Claude API 技能让 Claude 随 SDK 变化保持最新认知，构建 Agent 的开发者因此在代码评审阶段遇到的意外更少。”
9. 其他补充
- 支持渐进式披露：按项目语言与具体任务（工具调用/流式/批处理等）只加载相关文档分片，避免一次性占满上下文
migrate子命令覆盖模型 ID 替换、云平台专属格式保留（如 Bedrock 的anthropic.前缀）、破坏性参数变更、prefill 转 structured outputs、beta header 清理、effort 校准、拒绝回退（refusal fallback）配置等十余项具体改动，完成后给出需人工复核的清单（集成测试、长度控制 prompt 调优、成本/限流重新基线化）
10. 安装使用方式
- Claude Code 用户：已内置，无需安装；涉及 Claude API/SDK 的任务会自动触发，也可直接输入
/claude-api手动调用 - 其他支持 Agent Skills 规范的环境：
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-api migrate this project to claude-opus-4-8 - 安装后无需重启；仅当代码中出现 Anthropic SDK 导入、或用户明确提及 Claude/Anthropic 相关任务时自动触发，不会误触发到 OpenAI 等其他厂商代码
11. 注意事项
- 该技能面向“用 Claude API 写代码”场景，若项目已明确使用 OpenAI/Gemini 等其他厂商 SDK，技能会主动跳过，不应被误认为通用 LLM 开发教程
- Managed Agents（beta）功能目前仅在 Claude API 与 Claude Platform on AWS 上可用，不支持 Amazon Bedrock / Google Vertex AI / Microsoft Foundry，部署在这些平台的团队需改用 Messages API + tool use 方案
- 与 Codex / OpenClaw / Hermes Agent 的兼容性未经验证；技能格式虽遵循开放的 Agent Skills 规范、理论上可移植，实际兼容性仍需自行验证