Claude API 技能

claude-api 技能是一個開源代理技能，為 Claude 提供詳細的、最新的參考資料，用於在兩個 Anthropic 平台上構建應用程式：

• Messages API — 用於單一請求、串流聊天、工具使用、批次處理、提示快取、結構化輸出和自訂代理迴圈的主要平台。
• Claude 託管代理（測試版） — 一個第一方平台，用於伺服器管理的有狀態代理，具有 Anthropic 託管的工具執行、持久代理配置和每個會話容器。

它涵蓋 Messages API 的 8 種程式設計語言（Python、TypeScript、Java、Go、Ruby、C#、PHP 和 cURL）以及託管代理的 7 種語言（Python、TypeScript、Java、Go、Ruby、PHP 和 cURL — 目前不支援 C#）。

該技能與 Claude Code 捆綁在一起，也可在開源 Anthropic 技能儲存庫中獲得，您可以在任何支援代理技能的環境中安裝它。

該技能使用漸進式揭露來保持上下文效率：Claude 只載入與您的專案語言、平台（Messages API 或託管代理）和手邊特定任務（工具使用、串流、批次等）相關的文件，而不是一次載入所有內容。

技能提供的內容

觸發時，該技能為 Claude 提供：

對於 Messages API：

• 特定語言的 SDK 文件： 安裝、快速入門、常見模式和您的專案語言的錯誤處理
• 工具使用指導： 函式呼叫的特定語言範例和概念基礎，包括可用的測試版工具執行器
• 串流模式： 構建聊天 UI 和處理增量顯示的實現細節
• 批次處理： 以 50% 成本進行離線批次處理
• 提示快取： 前綴穩定性設計、斷點放置和無聲失效稽核
• 模型遷移： 遷移到較新 Claude 模型的逐步指導（包括 Claude Opus 4.7 上的重大變更和行為轉變）
• 當前模型資訊： 模型 ID、上下文視窗大小和定價
• 常見陷阱： 與 API 整合時避免頻繁錯誤的詳細指導

對於託管代理（測試版）：

• 入職流程： 一個訪談驅動的逐步指南，用於從頭開始設定新的託管代理，可透過 /claude-api managed-agents-onboard 子命令獲得
• 特定語言的託管代理文件： 為 Python、TypeScript、Java、Go、Ruby、PHP 和 cURL 建立持久代理、啟動會話、串流事件和處理工具確認
• 用戶端模式： 無損串流重新連接、processed_at 佇列/已處理閘道、中斷處理、檔案掛載陷阱和認證處理
• 部署限制： 託管代理僅限第一方（在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 上不可用）— 該技能將第三方部署路由到 Messages API + 工具使用

技能何時啟動

該技能以兩種方式啟動：

自動啟動發生在：

• 您的程式碼匯入 Anthropic SDK（Python 為 anthropic，TypeScript/JavaScript 為 @anthropic-ai/sdk）
• 您要求 Claude 幫助使用 Claude API、Anthropic SDK 或託管代理構建、除錯或最佳化某些內容
• 您在檔案中新增、修改或調整 Claude 功能（提示快取、自適應思考、壓縮、工具使用、批次、檔案、引用、記憶體）或模型參考

手動呼叫透過在安裝了該技能的任何環境中輸入 /claude-api（帶有可選的子命令或散文）。

該技能不會為一般程式設計任務、ML/資料科學工作或匯入其他 AI SDK（例如 OpenAI）的程式碼啟動。

支援的語言

該技能透過檢查專案檔案（例如，Python 的 requirements.txt、TypeScript 的 tsconfig.json、Go 的 go.mod）自動檢測您的專案語言，並載入適當的文件。

如果您的專案使用多種語言，Claude 會詢問哪一種適用。對於不支援的語言（Rust、Swift、C++），該技能提供 cURL/原始 HTTP 範例。

如何使用該技能

在 Claude Code 中（捆綁）

該技能與 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-skills

遷移到較新的 Claude 模型

Claude API 技能可以在整個程式碼庫中執行 Claude 模型遷移。使用 /claude-api migrate 直接呼叫它：

/claude-api migrate this project to claude-opus-4-7

您也可以預先傳遞特定範圍以跳過範圍確認問題：

/claude-api migrate everything under src/ to claude-opus-4-7
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-4-7

當範圍不明確時（例如，裸露的 /claude-api migrate to claude-opus-4-7），該技能會要求您在編輯任何檔案之前在整個工作目錄、特定子目錄或明確檔案清單之間進行選擇。這適用於 Messages API 和託管代理呼叫者。

該技能處理：

• 模型 ID 交換，包括所有支援語言中的型別 SDK 常數（Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7），並在編輯前將每個檔案分類為呼叫者、模型定義者或不透明字串參考
• 重大參數變更，例如為 Claude Opus 4.7 移除 temperature、top_p 和 top_k，以及將 thinking: {type: "enabled", budget_tokens: N} 轉換為 thinking: {type: "adaptive"}
• 預填替換，將助手訊息預填模式轉換為結構化輸出（如適用）
• 測試版標頭清理，移除在目標模型上為 GA 的標頭（例如，effort-2025-11-24、fine-grained-tool-streaming-2025-05-14、interleaved-thinking-2025-05-14）並從 client.beta.messages.create 切換回 client.messages.create
• ，為目標模型推薦 起點（例如，Claude Opus 4.7 上的編碼和代理使用案例為 ）

在編輯時，該技能會內聯解釋每項變更及其動機。完成後，它會產生需要手動驗證的項目清單（通常是整合測試、長度控制提示調整和成本/速率限制重新基準化）。

有關該技能應用的完整模型特定變更清單，請參閱遷移到 Claude Opus 4.7。

設定託管代理

要從頭開始搭建新的託管代理，請呼叫 managed-agents-onboard 子命令：

/claude-api managed-agents-onboard

該技能執行一個訪談，引導您完成託管代理心智模型（代理配置與會話），為代理配置建立範本，配置環境和工具，設定會話迴圈，並為您的語言發出可執行程式碼。該技能也涵蓋強制性的**代理（一次）→ 會話（每次執行）**流程 — model、system 和 tools 位於代理上，永遠不在會話上，代理應該建立一次並按 ID 參考。

託管代理需要 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-4-7 and re-tune effort

入職新的託管代理：

/claude-api managed-agents-onboard

在每種情況下，該技能都會載入相關的特定語言文件，並使用當前 API 模式和最佳實踐引導 Claude 完成實現。

後續步驟