前言¶

接入 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 推薦寫法）¶

適用場景與注意事項¶

小結¶

精选优惠券

相關文章