@ClaudeDevs：Claude Code 內建「Claude API skill」，提供開源 Agent 技能支援模型遷移與 Managed Agents 設定。 「Cla…

Claude Code 內建「Claude API skill」，提供開源 Agent 技能支援模型遷移與 Managed Agents 設定。 「Claude API skill」是 Anthropic 推出的開源 Agent 技能，內建於 Claude Code 中，為開發者提供最新 API 參考文件、SDK 文件與最佳實作，專注於 Messages API 與 Claude Managed Agents (beta)。它涵蓋多語言支援，並透過漸進式揭露僅載入相關文件，確保記憶效率，適用於模型遷移、prompt caching 等功能整合。 支援範圍與語言 技能針對兩個 Anthropic 平台表面提供詳細支援： Messages API：單次請求、串流聊天、工具使用、批次處理、prompt caching、結構化輸出與自訂 Agent 迴圈。 Claude Managed Agents (beta)：伺服器管理狀態 Agent，包含 Anthropic 託管工具執行、持久 Agent 設定與每會話容器。 語言支援細節： Messages API：8 種語言，包括 Python、TypeScript、Java、Go、Ruby、C#、PHP 與 cURL。 Managed Agents：7 種語言，包括 Python、TypeScript、Java、Go、Ruby、PHP 與 cURL（C目前不支援）。 技能自動偵測專案語言（如透過 requirements.txt 辨識 Python、tsconfig.json 辨識 TypeScript、go.mod 辨識 Go），多語言專案時會詢問選擇；不支援語言（如 Rust、Swift、C++）則提供 cURL/raw HTTP 範例。 技能提供的內容 針對 Messages API，技能裝備 Claude 以下資源： 語言特定 SDK 文件：安裝、快速入門、常見模式與錯誤處理。 工具使用指南：函數呼叫範例、概念基礎與 beta 工具執行器。 串流模式：建置聊天 UI 與增量顯示實作。 批次處理：離線批次以 50% 成本執行。 Prompt caching：前綴穩定設計、斷點放置與無聲失效審核。 模型遷移：逐步指南至新 Claude 模型，包括 Claude Opus 4.7 的重大變更與行為轉移。 當前模型資訊：模型 ID、context window 大小與定價。 常見陷阱：整合 API 時避免頻繁錯誤的詳細指引。 針對 Managed Agents (beta)： 入門流程：透過 /claude-api managed-agents-onboard 子指令的訪談式引導，從零設定新 Agent。 語言特定文件：建立持久 Agent、啟動會話、串流事件與工具確認，涵蓋 Python、TypeScript 等。 Client 模式：無損串流重連、processed_at 佇列/處理閘道、中斷處理、檔案掛載注意事項與憑證處理。 部署限制：僅限 Anthropic 第一方（不支援 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry），技能會將第三方部署導向 Messages API + 工具使用。 啟用機制 技能以兩種方式啟用： 自動啟用：程式碼匯入 Anthropic SDK（如 Python 的 anthropic、TypeScript 的 @anthropic-ai/sdk）；請求 Claude 協助建置、除錯或最佳化 Claude API、Anthropic SDK 或 Managed Agents；新增、修改或調整 Claude 功能（如 prompt caching、工具使用、批次、檔案、引用、記憶）或模型參照。 手動呼叫：在安裝環境輸入 /claude-api（可加子指令或描述）。 技能不會針對一般程式撰寫、機器學習/資料科學工作或其他 AI SDK（如 OpenAI）啟用，確保專注性。 在 Claude Code 中的使用 技能預載於 Claude Code，無需安裝。匯入 Anthropic SDK 或請求 Claude API 協助時自動啟用，也可直接呼叫： /claude-api：一般啟用。 /claude-api migrate：審核程式庫，逐步更新模型名稱、prompt 與 effort 設定至新模型（如 Opus 4.7）。 /claude-api managed-agents-onboard：依使用案例設定 Managed Agent，並提供後續監控與除錯記憶。 自然語言請求如「Add prompt caching with the Claude API」亦可觸發技能，自動套用最佳實作。技能完全開源，涵蓋 7 種語言 Claude SDK 與 CLI，也相容 CodeRabbit、JetBrains、Resolve AI 與 Warp。詳細運作見部落格：https://claude.com/blog/claude-api-skill。 模型遷移功能 執行 /claude-api migrate（如 /claude-api migrate this project to claude-opus-4-7）可跨程式庫遷移 Claude 模型，處理範圍不明時會確認整個工作目錄、子目錄或特定檔案清單（如 /claude-api migrate src/ 下一切至 claude-opus-4-7，或指定 apps/api.py 和 apps/worker.py）。 具體處理項目： 模型 ID 替換：包括類型 SDK 常數（如 Model.CLAUDEOPUS46 → Model.CLAUDEOPUS47），分類檔案為呼叫者、模型定義者或不透明字串參照後編輯。 重大參數變更：移除 Claude Opus 4.7 的 temperature、topp、topk；將 thinking: {type: "enabled", budget_tokens: N} 轉為 thinking: {type: "adaptive"}。 Prefill 替換：將 assistant-message prefill 模式轉為結構化輸出。 Beta 標頭清理：移除目標模型已 GA 的標頭（如 effort-2025-11-24、fine-grained-tool-streaming-2025-05-14、interleaved-thinking-2025-05-14），從 client.beta.messages.create 切回 client.messages.create。 Effort 校準：推薦 output_config.effort 起點（如 Claude Opus 4.7 的 coding 與 Agentic 程式開發用 xhigh）。 Prompt 行為調整：標記長度控制、工具觸發、子 Agent 與指令遵循 prompt，可能在新模型行為不同。 無聲預設處理：Claude Opus 4.7 推理表面化使用者時，選擇回歸 thinking.display: "summarized"。 編輯時內嵌解釋變更動機，完成後產生手動驗證清單（如整合測試、長度控制 prompt 調整、成本/速率限制重新基準）。 Managed Agents 設定流程 執行 /claude-api managed-agents-onboard 啟動訪談，引導 Managed Agents 心智模型（Agent 設定 vs. 會話），模板 Agent 設定、環境與工具、會話迴圈，並產生可執行程式碼。強調強制流程：Agent（一次）→ 會話（每次執行），模型、系統與工具置於 Agent 而非會話，Agent 應一次建立並以 ID 參照。 Managed Agents 需 managed-agents-2026-04-01 beta 標頭，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-4-7 and re-tune effort。 新 Managed Agent 入門：/claude-api managed-agents-onboard。 每次載入相關語言文件，依當前 API 模式與最佳實作引導實作。 安裝與開源存取 技能源碼位於 Anthropic skills repository，可用 npx 安裝： npx skills add https://github.com/anthropics/skills --skill claude-api。 作為 Claude Code plugin： /plu…