Claude API 技能

claude-api 技能是一個開源的 Agent Skill，為 Claude 提供詳細且最新的參考資料，用於在兩個 Anthropic 介面上建構應用程式：

• Messages API： 用於單次請求、串流聊天、工具使用、批次處理、提示快取、結構化輸出以及自訂代理迴圈的主要介面。
• Claude Managed Agents（beta）： 由 Anthropic 託管的介面，用於伺服器管理的有狀態代理，具備 Anthropic 託管的工具執行、持久化的代理設定，以及每個工作階段獨立的沙箱。

它涵蓋 Messages API 與 Managed Agents 的八種程式語言：Python、TypeScript、C#、Go、Java、PHP、Ruby 與 cURL。

此技能隨附於 Claude Code，也可在開源的 Anthropic 技能儲存庫中取得，您可以將其安裝在任何支援 Agent Skills 的環境中。

此技能使用「progressive disclosure」（漸進式揭露）機制來維持上下文的效率：Claude 只會載入與您專案的語言、介面（Messages API 或 Managed Agents）以及當前特定任務（工具使用、串流、批次等）相關的文件，而不是一次載入所有內容。

此技能提供的內容

觸發時，此技能會為 Claude 提供：

針對 Messages API：

• 特定語言的 SDK 文件： 針對您專案語言的安裝、快速入門、常見模式與錯誤處理
• 工具使用指引： 函式呼叫的特定語言範例與概念基礎，包括可用時的 beta 工具執行器（tool runner）
• 串流模式： 建構聊天 UI 與處理增量顯示的實作細節
• 批次處理： 以 50% 成本進行離線批次處理
• 提示快取： 前綴穩定性設計、斷點放置，以及靜默失效因素稽核
• 模型遷移： 遷移至較新 Claude 模型的逐步指引（包括 Claude Opus 5 與 Claude Fable 5.1 上的重大變更與行為變化）
• 目前的模型資訊： 模型 ID、上下文視窗大小與定價
• 常見陷阱： 關於在整合 API 時避免常見錯誤的詳細指引

針對 Managed Agents（beta）：

• 上線流程： 以訪談驅動的逐步引導，從零開始設定新的 Managed Agent，可透過 /claude-api managed-agents-onboard 子命令使用
• 特定語言的 Managed Agents 文件： 針對 Python、TypeScript、C#、Go、Java、PHP、Ruby 與 cURL，建立持久化代理、啟動工作階段、串流事件，以及處理工具確認
• 用戶端模式： 無損串流重新連線、processed_at 已排入佇列／已處理閘門、中斷處理、檔案掛載注意事項，以及憑證處理
• 部署限制： Managed Agents 僅在 Claude API 與 Claude Platform on AWS 上提供（不在 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 上提供）。此技能會將其他部署導向 Messages API 與工具使用。

技能何時啟動

此技能以兩種方式啟動：

自動啟動發生於：

• 您的程式碼匯入了 Anthropic SDK（Python 為 anthropic，TypeScript/JavaScript 為 @anthropic-ai/sdk）
• 您請 Claude 協助使用 Claude API、Anthropic SDK 或 Managed Agents 建構、除錯或最佳化某些內容
• 您在檔案中新增、修改或調整 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-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 的呼叫端。

此技能會處理：

• 模型 ID 替換，包括所有支援語言中的型別化 SDK 常數（Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5），並在編輯前將每個檔案分類為呼叫端、模型定義者或不透明字串參照
• 雲端平台偵測，保留平台特定的模型 ID 格式（例如 Amazon Bedrock 上的 anthropic. 前綴），並跳過合作夥伴營運平台上不可用功能的變更
• 重大參數變更，例如為 Claude Opus 4.8 與 Claude Opus 4.7 移除 temperature、top_p 與 top_k，並將 thinking: {type: "enabled", budget_tokens: N} 轉換為 thinking: {type: "adaptive"}
• 預填替換，在適用時將助理訊息預填模式轉換為結構化輸出
• Beta 標頭清理，移除目標模型不需要的 beta 標頭（例如 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 5 上的預設值 high，以及 Claude Opus 4.8 與 Claude Opus 4.7 上針對程式設計與代理使用情境的 xhigh）
• 提示行為調整，標記在目標模型上行為可能不同的長度控制、工具觸發、子代理與指令遵循提示
• 靜默預設值處理，當推理內容在 Claude Opus 4.8 與 Claude Opus 4.7 上呈現給使用者時，重新選擇啟用思考摘要（thinking.display: "summarized"）
• 拒絕回退設定，當目標為 Claude Fable 5.1、Claude Fable 5 或 Claude Opus 5 時，在讀取回應內容之前加入 stop_reason: "refusal" 處理，並設定回退重試路徑（伺服器端 fallbacks 參數，通常使用其 "default" 模式、SDK 拒絕回退中介軟體，或回退額度重試），並更新針對早期預覽形式撰寫的回退程式碼

在編輯過程中，此技能會在行內說明每項變更及其動機。完成後，它會產生一份需要手動驗證的項目清單（通常為整合測試、長度控制提示調整，以及成本／速率限制的重新基準化）。

如需此技能所套用之模型特定變更的完整清單，請參閱從 Claude Opus 4.8 遷移至 Claude Opus 5 與遷移至 Claude Fable 5.1。

設定 Managed Agent

若要從零開始建立新的 Managed Agent 骨架，請呼叫 managed-agents-onboard 子命令：

/claude-api managed-agents-onboard

此技能會執行一段訪談，引導您了解 Managed Agents 的心智模型（Agent 設定與 Session 的差異）、以範本建立代理設定、設定環境與工具、建立工作階段迴圈，並為您的語言產出可執行的程式碼。此技能也涵蓋必要的 Agent（一次）→ Session（每次執行） 流程：model、system 與 tools 存在於代理上，絕不在工作階段上，且代理應只建立一次並以 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-5 and re-tune effort

上線新的 Managed Agent：

/claude-api managed-agents-onboard

在每種情況下，此技能都會載入相關的特定語言文件，並使用目前的 API 模式與最佳實務引導 Claude 完成實作。

後續步驟