claude-api skill 是什麼、怎麼用：Anthropic 官方的 Claude API / SDK 參考 Skill（模型 ID、工具調用、緩存、遷移）

本文根據 anthropics/skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 7.0 萬次；所在倉庫 anthropics/skills 在 GitHub 約 18.0 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

大模型寫「調用大模型」的代碼時有個老毛病：憑訓練時的舊記憶寫，模型 ID 過期、參數名不對、新功能不知道。claude-api 技能就是給 Claude 自己準備的一份最新 API 參考。description 概括的內容包括模型 ID、定價、參數、流式輸出、工具調用、MCP、智能體、緩存、token 計數和模型遷移。

它的觸發條件寫得相當激進：提示裏以任何形式出現 Claude / Anthropic（包括各模型名、SDK 包名）；用戶問到大模型的價格、選型、限制、緩存；或者任務明顯是「大模型形態」的而沒有指定供應商（做智能體、定義工具、RAG、讓模型做摘要分類等），都應在打開目標文件之前先讀它。唯一的跳過條件是當前在處理別家供應商：查詢裏點名了 OpenAI、Gemini 等，或項目裏已經在用它們的 SDK。技能開頭還有一道檢查——發現目標文件用的是非 Anthropic 的 SDK，就停下來問你，而不是擅自改寫。

內容組織上，SKILL.md 給出總覽（該用哪種接入方式、要不要做成智能體、當前模型列表、鑑權、思考與緩存等速查），再按檢測到的項目語言去讀對應目錄下的資料。

怎麼安裝

claude-api 在 anthropics/skills 倉庫裏單獨打成一個同名插件。在 Claude Code 會話中輸入：

text
/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

Claude Code 官方文檔列出的內置技能（Bundled skills）裏已經有 /claude-api，在 Claude Code 裏輸入 /skills 能看到它就不必再裝；倉庫裏的這份主要方便查看內容，或給其他環境使用。

倉庫整體介紹和其他安裝方式，詳見本站《anthropics/skills 是什麼、怎麼安裝：Anthropic 官方 Skills 倉庫（docx / pptx / xlsx / pdf、skill-creator）》。

怎麼用

• 「用 Python 寫一個調用 Claude 的客服問答接口，開流式輸出和提示詞緩存」。
• 「把這個項目從舊的模型 ID 遷移到當前最新的模型」——對應文檔裏列出的遷移類子命令。
• 「我該直接調 Messages API，還是用 Agent SDK / Managed Agents？」——它會按文檔裏的選型說明回答。

目錄裏文件很多（近百個），按語言分成 Python、TypeScript、Go、Java、C#、PHP、Ruby、curl 等子目錄，各含流式、工具調用、文件 API、批處理等專題。

適合誰 / 侷限

適合基於 Claude API 做應用的開發者，以及想讓編程智能體寫 Anthropic SDK 代碼時少出錯的人。它只管 Anthropic 一家的接口；SKILL.md 很長，加載一次會佔用不少上下文；裏面的模型列表標了緩存日期，最終仍以官方 API 文檔為準。

注意事項

• 許可：技能目錄內的 LICENSE.txt 為 Apache-2.0。
• API Key：寫出的代碼需要你自己的 Anthropic API Key，按用量付費，與 Claude 訂閱是兩套計費；密鑰放環境變量，不要寫進倉庫。
• 價格與模型以官方為準：技能裏的定價和模型資訊會滯後，本文不轉述具體數字。
• 不執行腳本：全部是參考資料。