技能包

claude-api:用官方 SDK 接 Claude,先避開已廢棄參數

適合要在專案裡接 Claude API 的人,須走目前語言的官方 Anthropic SDK,預設 claude-opus-5 與 adaptive thinking,且不要再傳會回傳 400 的 budget_tokens。

官方來源 · claude-api

安裝

Call Claude through the official Anthropic SDK for the project's language

適合誰

claude-api 面向提示裡點名 Claude 或 Anthropic、要查模型、參數、串流、工具或快取等參考的人。它是 Claude API / Anthropic SDK 的參考,不是又一個安裝程式。當提示以任何形式點名 Claude/Anthropic 時,應先讀這份說明,不要因為「看起來像一句話」就跳過。

更貼的用法是:你要在現有專案裡新增或改一段呼叫 Claude 的程式,並且專案語言已有官方 Anthropic SDK。說明要求:實作 Claude 功能時,必須透過該語言的官方 SDK 來呼叫。它不適合你只想隨手編一段未指定 SDK 的偽程式、或把頁面路徑當成安裝命令的人。

預設模型寫成 Claude Opus 5,精確字串是 claude-opus-5。稍複雜的請求預設用 adaptive thinking。說明沒有給出安裝命令,若目前助手還不能按這份參考改程式,現有說明到此為止,不要從地址反推技能目錄。

3 分鐘完成第一次嘗試

官方第一次路徑是按參考檢查或改一處呼叫,而不是安裝。說明頁是

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

請只按這一頁的約束做。不要編寫未出現的安裝句,也不要在程式裡寫入金鑰佔位。

前置條件:目前助手已經能按 claude-api 工作,你手頭有一份可丟棄的呼叫片段或空函式,並且本機已有該語言的官方 Anthropic SDK。沒有安裝命令,因此「位置」就是這段專案程式,而不是某個推測出來的技能目錄。

低風險第一次任務:先做唯讀檢查。讓助手看現有呼叫是否走官方 SDK,模型是否為 claude-opus-5,thinking 是否為 adaptive,以及有沒有已廢棄的 budget_tokens。不要先對真實帳號發長請求。成功訊號是助手指出上述四點中任何偏差,並在改程式前停下來讓你確認。

若需要改,只改模型字串和 thinking 形狀:thinking: {type: "adaptive"}。說明寫明在 Claude 4.6+ 上 budget_tokens 已廢棄,在 Opus 4.6 / Sonnet 4.6 會被拒絕並回傳 400。看到寫入提示時先確認沒有把金鑰寫進倉庫。

使用案例

案例一:給專案加一個 Claude 功能。提示點名 Claude/Anthropic 時先讀參考,實作時透過專案語言的官方 Anthropic SDK 呼叫,模型用 claude-opus-5,稍複雜的請求預設 adaptive thinking。適合你已經選定語言、只差把呼叫寫對的時候。說明在現有句子裡只展開了「官方 SDK」這一路徑,沒有寫其它 SDK 名字;因此不要自行換用未點名的封裝。對照頁是

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

案例二:排除會 400 的舊 thinking 參數。在 Claude 4.6+ 上應使用 thinking: {type: "adaptive"};budget_tokens 在 Opus 4.6 / Sonnet 4.6 已廢棄,會被拒絕並回傳 400。適合你剛從舊示例拷了 thinking 設定、請求直接 400 的時候。先只改這一處再決定是否發真實請求。說明沒有列出全部已廢棄欄位,因此只能確認 budget_tokens 這一條。

使用界線

沒有安裝命令:不能把頁面路徑當成安裝程式。觸發界線:提示以任何形式點名 Claude/Anthropic 時先讀,不要當一句話跳過。呼叫界線:實作功能須走專案語言的官方 Anthropic SDK;現有句子沒有展開其它並列方式。模型界線:預設 Claude Opus 5,字串 claude-opus-5;複雜請求預設 adaptive thinking。參數界線:budget_tokens 在點名的 4.6 型號上會 400。金鑰界線:不要編寫金鑰佔位或把金鑰寫進程式。這份參考還涵蓋定價、串流、工具等主題,但現有句子沒有給出這些主題的逐步示例。