claude-api 技能是一個開源的 Agent Skill,為 Claude 提供詳細、最新的參考資料,用於在兩個 Anthropic 介面上建構應用程式:
它涵蓋 Messages API 和 Managed Agents 的八種程式語言:Python、TypeScript、C#、Go、Java、PHP、Ruby 和 cURL。
此技能隨 Claude Code 一起提供,也可在開源的 Anthropic 技能儲存庫中取得,您可以在任何支援 Agent Skills 的環境中安裝它。
此技能使用漸進式揭露來保持上下文的效率:Claude 只載入與您專案的語言、介面(Messages API 或 Managed Agents)以及手頭特定任務(工具使用、串流、批次等)相關的文件,而不是一次載入所有內容。
觸發時,此技能為 Claude 配備:
針對 Messages API:
針對 Managed Agents(測試版):
/claude-api managed-agents-onboard 子命令提供的訪談式引導,用於從頭開始設定新的 Managed Agentprocessed_at 排隊/已處理閘門、中斷處理、檔案掛載注意事項和憑證處理此技能以兩種方式啟動:
自動啟動發生於:
anthropic、TypeScript/JavaScript 的 @anthropic-ai/sdk)手動呼叫:在任何已安裝此技能的環境中輸入 /claude-api(可選擇附加子命令或文字描述)。
此技能不會針對一般程式設計任務、ML/資料科學工作,或匯入其他 AI SDK(例如 OpenAI)的程式碼啟動。
此技能透過檢查專案檔案(例如,Python 的 requirements.txt、TypeScript 的 tsconfig.json、Go 的 go.mod)自動偵測您專案的語言,並載入適當的文件。
| 語言 | Messages API SDK | 工具執行器 | Managed Agents |
|---|---|---|---|
| Python | 是 | 是(測試版) | 是(測試版) |
| TypeScript | 是 | 是(測試版) | 是(測試版) |
| C# | 是 | 是(測試版) | 是(測試版) |
| Go | 是 | 是(測試版) | 是(測試版) |
| Java | 是 | 是(測試版) | 是(測試版) |
| PHP | 是 | 是(測試版) | 是(測試版) |
| Ruby | 是 | 是(測試版) | 是(測試版) |
| cURL | 是 | 不適用 | 是(測試版) |
如果您的專案使用多種語言,Claude 會詢問適用哪一種。對於不支援的語言(Rust、Swift、C++),此技能提供 cURL/原始 HTTP 範例。
此技能隨 Claude Code 一起提供,無需安裝。當您要求 Claude 協助使用 Claude API 建構某些內容,或當您的專案已匯入 Anthropic SDK 時,此技能會自動啟動。
您也可以直接呼叫它:
/claude-api有關內建技能在 Claude Code 中如何運作的更多資訊,請參閱 Claude Code 技能文件。
此技能的原始碼可在 Anthropic 技能儲存庫中取得。您可以使用 npx 命令安裝它:
npx skills add https://github.com/anthropics/skills --skill claude-api或將其安裝為 Claude Code 外掛程式:
/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skillsClaude API 技能可以在整個程式碼庫中執行 Claude 模型遷移。使用 /claude-api migrate 直接呼叫它:
/claude-api migrate this project to claude-opus-5您也可以預先傳遞特定範圍以跳過範圍確認問題:
/claude-api migrate everything under src/ to claude-opus-5
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-5當範圍不明確時(例如,單純的 /claude-api migrate to claude-opus-5),此技能會在編輯任何檔案之前要求您在整個工作目錄、特定子目錄或明確的檔案清單之間進行選擇。這適用於 Messages API 和 Managed Agents 的呼叫者。
此技能處理:
Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5),並在編輯前將每個檔案分類為呼叫者、模型定義者或不透明字串參考anthropic. 前綴),並跳過在合作夥伴營運平台上不可用功能的變更temperature、top_p 和 top_k,以及將 thinking: {type: "enabled", budget_tokens: N} 轉換為 thinking: {type: "adaptive"}effort-2025-11-24、fine-grained-tool-streaming-2025-05-14、interleaved-thinking-2025-05-14),並從 client.beta.messages.create 切換回 client.messages.createoutput_config.effort 起始點(例如,Claude Opus 5 上的預設 high,以及 Claude Opus 4.8 和 Claude Opus 4.7 上用於編碼和代理使用案例的 xhigh)thinking.display: "summarized")stop_reason: "refusal" 處理,並在目標為 Claude Fable 5 或 Claude Opus 5 時設定回退重試路徑(伺服器端 fallbacks 參數,通常為其 "default" 模式、SDK 拒絕回退中介軟體,或回退額度重試),並更新針對較早預覽版格式撰寫的回退程式碼在編輯時,此技能會內嵌解釋每項變更及其動機。完成後,它會產生需要手動驗證的項目清單(通常是整合測試、長度控制提示調整,以及成本/速率限制重新基準化)。
有關此技能套用的模型特定變更的完整清單,請參閱從 Claude Opus 4.8 遷移到 Claude Opus 5。
若要從頭開始建立新的 Managed Agent 架構,請呼叫 managed-agents-onboard 子命令:
/claude-api managed-agents-onboard此技能會執行一個訪談,引導您了解 Managed Agents 的心智模型(Agent 配置與 Sessions 的區別)、建立代理配置範本、配置環境和工具、設定工作階段迴圈,並為您的語言產生可執行的程式碼。此技能還涵蓋強制性的 Agent(一次)→ Session(每次執行) 流程:model、system 和 tools 存在於代理上,而非工作階段上,且代理應建立一次並透過 ID 參考。
Managed Agents 需要 managed-agents-2026-04-01 測試版標頭,SDK 會自動為所有 client.beta.agents.*、client.beta.environments.*、client.beta.sessions.* 和 client.beta.vaults.* 呼叫設定此標頭。
以下是此技能協助 Claude 處理的任務範例:
建構聊天應用程式:
Build a streaming chat UI with the Claude API in TypeScript遷移現有專案:
/claude-api migrate this codebase to claude-opus-5 and re-tune effort新 Managed Agent 的入門設定:
/claude-api managed-agents-onboard在每種情況下,此技能都會載入相關的特定語言文件,並使用目前的 API 模式和最佳實踐引導 Claude 完成實作。
了解 Agent Skills 的運作方式和漸進式揭露模型
瀏覽所有支援語言的官方 Anthropic SDK
探索 GitHub 上的公開 Anthropic 技能儲存庫
Was this page helpful?