Claude API 技能

一個開源的 Agent Skill，為 Claude 提供最新的 API 參考資料、SDK 文件，以及使用 Claude API 和 Claude Managed Agents 建構應用程式的最佳實務。

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

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

此技能涵蓋 Messages API 和 Managed Agents 的 8 種程式語言：Python、TypeScript、C#、Go、Java、PHP、Ruby 和 cURL。

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

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

此技能提供的內容

觸發時，此技能會為 Claude 配備：

針對 Messages API：

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

針對 Managed Agents（測試版）：

入門流程： 透過 /claude-api managed-agents-onboard 子指令提供的訪談式逐步引導，用於從頭設定新的 Managed Agent
特定語言的 Managed Agents 文件： 針對 Python、TypeScript、C#、Go、Java、PHP、Ruby 和 cURL 建立持久化代理、啟動工作階段、串流事件，以及處理工具確認
用戶端模式： 無損串流重新連線、processed_at 佇列/已處理閘門、中斷處理、檔案掛載注意事項，以及憑證處理
部署限制： Managed Agents 僅在 Claude API 和 AWS 上的 Claude Platform 上提供（不適用於 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）自動偵測您專案的語言，並載入適當的文件。

語言	Messages API SDK	工具執行器	Managed Agents
Python	是	是（測試版）	是（測試版）
TypeScript	是	是（測試版）	是（測試版）
C#	是	是（測試版）	是（測試版）
Go	是	是（測試版）	是（測試版）
Java	是	是（測試版）	是（測試版）
PHP	是	是（測試版）	是（測試版）
Ruby	是	是（測試版）	是（測試版）
cURL	是	不適用	是（測試版）

如果您的專案使用多種語言，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-8

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

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

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

此技能處理：

模型 ID 替換，包括所有支援語言中的型別化 SDK 常數（Model.CLAUDE_OPUS_4_7 → Model.CLAUDE_OPUS_4_8），並在編輯前將每個檔案分類為呼叫者、模型定義者或不透明字串參考
雲端平台偵測，保留平台特定的模型 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"}
預填替換，在適用的情況下將助理訊息預填模式轉換為結構化輸出
測試版標頭清理，移除在目標模型上已正式發布的標頭（例如 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.8 和 Claude Opus 4.7 上的程式設計和代理使用案例建議 xhigh）
提示行為調整，標記在目標模型上可能表現不同的長度控制、工具觸發、子代理和指令遵循提示
靜默預設處理，當推理內容在 Claude Opus 4.8 和 Claude Opus 4.7 上呈現給使用者時，重新選擇啟用思考摘要（thinking.display: "summarized"）
拒絕後備設定，在讀取回應內容之前新增 stop_reason: "refusal" 處理，並在目標為 Claude Fable 5 時設定後備重試路徑（伺服器端 fallbacks 參數、SDK 拒絕後備中介軟體，或後備額度重試），以及更新針對早期預覽版格式編寫的後備程式碼

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

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

設定 Managed Agent

若要從頭建立新的 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-4-8 and re-tune effort

入門新的 Managed Agent：

/claude-api managed-agents-onboard

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

後續步驟

Agent Skills 概述

了解 Agent Skills 的運作方式和漸進式揭露模型

用戶端 SDK

瀏覽所有支援語言的官方 Anthropic SDK

技能儲存庫

探索 GitHub 上的公開 Anthropic 技能儲存庫

Was this page helpful?

Claude API 技能

一個開源的 Agent Skill，為 Claude 提供最新的 API 參考資料、SDK 文件，以及使用 Claude API 和 Claude Managed Agents 建構應用程式的最佳實務。

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

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

此技能涵蓋 Messages API 和 Managed Agents 的 8 種程式語言：Python、TypeScript、C#、Go、Java、PHP、Ruby 和 cURL。

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

此技能提供的內容

觸發時，此技能會為 Claude 配備：

針對 Messages API：

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

針對 Managed Agents（測試版）：

入門流程： 透過 /claude-api managed-agents-onboard 子指令提供的訪談式逐步引導，用於從頭設定新的 Managed Agent
特定語言的 Managed Agents 文件： 針對 Python、TypeScript、C#、Go、Java、PHP、Ruby 和 cURL 建立持久化代理、啟動工作階段、串流事件，以及處理工具確認
用戶端模式： 無損串流重新連線、processed_at 佇列/已處理閘門、中斷處理、檔案掛載注意事項，以及憑證處理
部署限制： Managed Agents 僅在 Claude API 和 AWS 上的 Claude Platform 上提供（不適用於 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）自動偵測您專案的語言，並載入適當的文件。

語言	Messages API SDK	工具執行器	Managed Agents
Python	是	是（測試版）	是（測試版）
TypeScript	是	是（測試版）	是（測試版）
C#	是	是（測試版）	是（測試版）
Go	是	是（測試版）	是（測試版）
Java	是	是（測試版）	是（測試版）
PHP	是	是（測試版）	是（測試版）
Ruby	是	是（測試版）	是（測試版）
cURL	是	不適用	是（測試版）

如果您的專案使用多種語言，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-8

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

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

此技能處理：

模型 ID 替換，包括所有支援語言中的型別化 SDK 常數（Model.CLAUDE_OPUS_4_7 → Model.CLAUDE_OPUS_4_8），並在編輯前將每個檔案分類為呼叫者、模型定義者或不透明字串參考
雲端平台偵測，保留平台特定的模型 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"}
預填替換，在適用的情況下將助理訊息預填模式轉換為結構化輸出
測試版標頭清理，移除在目標模型上已正式發布的標頭（例如 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.8 和 Claude Opus 4.7 上的程式設計和代理使用案例建議 xhigh）
提示行為調整，標記在目標模型上可能表現不同的長度控制、工具觸發、子代理和指令遵循提示
靜默預設處理，當推理內容在 Claude Opus 4.8 和 Claude Opus 4.7 上呈現給使用者時，重新選擇啟用思考摘要（thinking.display: "summarized"）
拒絕後備設定，在讀取回應內容之前新增 stop_reason: "refusal" 處理，並在目標為 Claude Fable 5 時設定後備重試路徑（伺服器端 fallbacks 參數、SDK 拒絕後備中介軟體，或後備額度重試），以及更新針對早期預覽版格式編寫的後備程式碼

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

設定 Managed Agent

若要從頭建立新的 Managed Agent 架構，請呼叫 managed-agents-onboard 子指令：

/claude-api managed-agents-onboard

使用範例

以下是此技能協助 Claude 處理的任務範例：

建構聊天應用程式：

Build a streaming chat UI with the Claude API in TypeScript

遷移現有專案：

/claude-api migrate this codebase to claude-opus-4-8 and re-tune effort

入門新的 Managed Agent：

/claude-api managed-agents-onboard

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

後續步驟

Agent Skills 概述

了解 Agent Skills 的運作方式和漸進式揭露模型

用戶端 SDK

瀏覽所有支援語言的官方 Anthropic SDK

技能儲存庫

探索 GitHub 上的公開 Anthropic 技能儲存庫

Was this page helpful?

此技能提供的內容

技能何時啟動

支援的語言

如何使用此技能

在 Claude Code 中（內建）

從技能儲存庫安裝

遷移至較新的 Claude 模型

設定 Managed Agent

使用範例

後續步驟

此技能提供的內容

技能何時啟動

支援的語言

如何使用此技能

在 Claude Code 中（內建）

從技能儲存庫安裝

遷移至較新的 Claude 模型

設定 Managed Agent

使用範例

後續步驟

此技能提供的內容

技能何時啟動

支援的語言

如何使用此技能

在 Claude Code 中（內建）

從技能儲存庫安裝

遷移至較新的 Claude 模型

設定 Managed Agent

使用範例

後續步驟

此技能提供的內容

技能何時啟動

支援的語言

如何使用此技能

在 Claude Code 中（內建）

從技能儲存庫安裝

遷移至較新的 Claude 模型

設定 Managed Agent

使用範例

後續步驟