# 策展 · X (Twitter) 🔥🔥🔥🔥

> 作者：ClaudeDevs (@ClaudeDevs) · 平台：X (Twitter) · 日期：2026-04-30

> 原始來源：https://x.com/ClaudeDevs/status/2049575802568839648

## 中文摘要

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.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"}。
- 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：
- /plugin marketplace add anthropics/skills
- /plugin install claude-api@anthropic-agent-skills。

此技能強調效率與精準，透過漸進揭露避免記憶過載，專為 Claude 平台開發者設計，涵蓋從單一請求到狀態 Agent 的全譜需求，特別在 Claude Opus 4.7 等新模型轉移中展現實用性。

## 標籤

Claude Code, Skills, Agent, 開源專案, 功能更新, SDK, Anthropic, Claude