Community程式設計與開發github.com

cestercian/claude-model-picker

為任務、子代理或 API 整合選擇合適的 Claude 模型(Haiku 5.5、Sonnet 5.5、Opus 5.5、Fable 5.2)和努力等級。當使用者詢問該用哪個模型、想降低成本或延遲、正在設定子代理模型、在系統中混用模型,或想將請求從一個 Claude 模型遷移到另一個時使用。

claude-model-picker 是什麼?

這個技能提供了一個系統化方法,根據工作類型、成本考量和成果品質來選擇最佳的 Claude 模型和努力等級。它根據 Anthropic 的官方指引,從 Opus 5.5 中等努力等級的預設推薦開始,並根據具體情況向上下調整:對於範圍明確的日常開發工作降至 Sonnet 5.5,對於分類或萃取等高量簡單任務降至 Haiku 5.5,對於最困難的技術任務(如重大重構、深度研究或協調多個子代理)則升級至 Fable 5.2。該技能還針對成果不足時提供了調優順序(先讓模型自我驗證,再提高努力等級,最後升級模型),詳細的成本計算策略(比較每項完成任務的成本而非每代幣價格),以及在不同模型間轉換時的兼容性注意事項。它支援 Claude Code 和 Anthropic API,並包含了可操作的子代理設定範例和衡量建議,幫助開發者在投入生產前驗證模型選擇。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cestercian/claude-model-picker/tree/HEAD/skills/claude-model-picker

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Claude 模型選擇器

選擇起始模型與努力等級,並根據實際證據進行調整。

此處的每一項建議均源自 Anthropic 已發布的指引 — 請參閱來源。向使用者引用建議時,請附上來源連結。模型陣容與價格會變動:若某一事實至關重要(價格、模型 ID、預設努力等級),請在採用前查閱最新的官方文件。

預設

從 Opus 5.5 中等努力等級開始。 這是 Claude Code 的預設設定,且每代幣成本僅為 Fable 5.2 的一半。只有在有充分理由時才偏離此設定。

  • 向下至 Sonnet 5.5 — 範圍明確的日常工作(修 bug、根據規格開發功能)。僅有明確規格還不夠:遷移與效能相關工作仍可能需要 Opus 或 Fable。
  • 進一步向下至 Haiku 5.5 — 簡單、高量的工作:分類、路由、標記、萃取;低成本的子代理。
  • 向上至 Fable 5.2 — 最困難的技術工作(程式開發、金融、科學)、重大重構/遷移、架構設計、帶領多個子代理、長時間無人值守的執行,或當 Opus 以高努力等級仍無法勝任時。

任務 → 起始點

任務模型努力等級
日常工程、除錯、跨多個 PR 的功能開發Opus 5.5中等 → 高
分類、路由、標記、大量萃取Haiku 5.5中等
搜尋、讀取日誌、彙整摘要的子代理Haiku 或 Sonnet 5.5模型預設
聊天/互動式會話Sonnet 5.5(高量簡單聊天可用 Haiku)低或中等
範圍明確的程式開發(修 bug、規格驅動)Sonnet 5.5中等 → 高
日常文件、簡報、試算表Sonnet 5.5(複雜財務模型或大量來源檔案可用 Opus)高(Claude Code 中為中等)
重複性代理任務(審查、調查、草稿撰寫)Sonnet 5.5中等
電腦使用、視覺密集迴圈Opus 5.5中等
重大重構、架構設計、協調子代理Fable 5.2中等 → 高
深度研究、科學/量化分析Fable 5.2中等 → 高
不確定Opus 5.5中等

模型事實

Haiku 5.5Sonnet 5.5Opus 5.5Fable 5.2
輸入/輸出每 MTok$0.10 / $0.50(≤100K 提示);$0.50 / $2.50(>100K)$2 / $10$4 / $20$8 / $40
快取讀取每 MTok$0.01(≤100K)/ $0.05$0.10$0.20$0.20
延遲最快快中等中等
上下文/最大輸出1M / 128K1M / 128K1M / 128K1M / 128K
思考能力適應性,可關閉(≤ 高努力等級)適應性;有 between_tools 選項總是開啟總是開啟
API 預設努力等級中等高(Claude Code 中為中等)中等高(Claude Code 中為中等)
快速模式無無有有

成果不足時的調優順序

  1. 給模型一種驗證自身工作的方式(測試、建置、呼叫端點的腳本)。這通常比提高努力等級更划算。
  2. 將努力等級提高一級。
  3. 向上移動一個模型,並從比在小模型上使用的更低努力等級開始。

備註:

  • 努力 ≈ 思考時間、工具呼叫、自我檢查。它會增加延遲。它無法增加模型缺乏的知識 — 這需要更大的模型。
  • 超過「高」之後,再提高一級努力等級的成本可能與升級到下一個模型相當。請改為在更大模型上以較低努力等級進行測試。
  • 如果成果可自動檢查:所有任務以低努力等級執行,僅對失敗的任務以高努力等級重新執行(根據 Anthropic 的測試,這在成本和通過率上都優於一律使用高努力等級)。
  • 需要速度又不想犧牲能力:在 Opus 5.5 / Fable 5.2 上開啟快速模式(需付費)。

成本計算

  • 比較每項完成任務的成本,而不是每代幣價格。一個較貴的模型以較低努力等級執行,每項任務的成本可能更低(例如,在困難的基準測試中,Fable 5.2 以高努力等級約為 Opus 5.5 以最大努力等級的一半成本)。
  • 為你工作集中最困難的任務定價;它們會主導支出。
  • 大型上下文每次回合都會重新發送,但主要按快取讀取計費。Fable 和 Opus 共用 $0.20 的快取讀取費率,因此在快取密集的執行中,它們之間的差距主要來自未快取的輸入+輸出。
  • 保持昂貴模型的上下文精簡;將詳細的閱讀工作推給低成本子代理。
  • Haiku 的長提示分級(>100K)是其短提示費率的 5 倍。對於長提示,請比較 Haiku 與 Sonnet 每項完成任務的成本。

混用模型

  • 在自然斷點切換。 提示快取是按模型分別計算的,因此在新模型上的第一個回合會重新支付快取寫入成本。在 Claude Code 中執行 /compact 或以簡短計畫重新開始;在 API 上,以摘要開頭。
  • 思考區塊不會向下傳遞。 Fable 5.2 可以讀取 Opus/Sonnet/Haiku 5.5 的思考區塊;Opus 5.5 可以讀取 Sonnet/Haiku 的;Sonnet 可以讀取 Haiku 的。向下移動(或離開 Fable 5.2)會靜默地丟棄先前的推理。
  • 子代理使用小模型 來執行那些錯誤容易被發現的工作(尋找檔案、執行測試、讀取日誌)。將程式碼編輯和判斷工作保留在主模型上。在 Claude Code 中,在代理檔案中設定 model: haiku / model: sonnet,或使用 CLAUDE_CODE_SUBAGENT_MODEL 作為預設值。
  • 內建的 Explore 子代理現在使用會話模型。為了保持低成本,請定義你自己的 Explore 代理並設定 model: haiku。ANTHROPIC_DEFAULT_HAIKU_MODEL 可固定別名。在 Anthropic API 上,haiku → Haiku 5.5(需要 Claude Code ≥ v2.1.293);在 Bedrock/Vertex/Foundry 上,它仍是 Haiku 4.5。
  • opusplan 在 Opus 上規劃並在 Sonnet 上編輯 — 與上述建議相反。請在採用前先進行測量。
  • 顧問工具(測試版): 低成本執行者諮詢更強大的顧問。目前增益不大(大約相當於提高努力等級的效果)。請先測量諮詢率;檢查允許的配對組合。
  • 領導者 + 工作者 適用於超出單一上下文視窗的大型工作(例如 Opus 領導者帶領平行的 Sonnet 工作者:約便宜 ⅓,分數相同)。對於單一依賴鏈或適合單一上下文的工作則跳過此模式。

低成本子代理範例(.claude/agents/log-reader.md):

---
name: log-reader
description: 讀取測試輸出和日誌,回報每個失敗案例。在測試執行後使用。
tools: Read, Grep, Glob, Bash
model: haiku
---

對於每個失敗,回報檔案名稱、測試名稱和第一個錯誤行。請勿編輯檔案。

遷移/相容性檢查清單

  • Fable 5.2 保留思考區塊: 如果 Fable 思考區塊之前的任何內容(系統提示、工具、先前的訊息)有變更,API 會回傳 400,除非你選擇放棄它。請保持歷史記錄僅限附加。Claude Code / Agent SDK / Managed Agents 會自動處理此情況。
  • 思考能力: Opus 5.5 和 Fable 5.2 無法停用思考能力(會報錯)。請按類型讀取內容區塊 — 回應可能以思考區塊開頭。
  • 強制工具使用: tool_choice: any|tool → 在 Sonnet/Opus 5.5 和 Fable 5.2 上回傳 400。請改用 auto + strict: true 工具 + 提示指令。
  • 電腦使用: 僅透過 computer_toolset_20260801(Claude API、Google Cloud 上的 Google 管理 Claude)。
  • Haiku 4.5 → 5.5: 將 budget_tokens 替換為 effort;放棄非預設的 temperature/top_p/top_k;以使用者回合結束(無助理預填)。
  • 安全降級: 被標記的網路安全請求可能會在 Opus 4.8 上重新執行,生物學請求則在 Opus 5 上執行(Claude Code 會顯示通知)。
  • 多模型系統: 以最嚴格的模型為基礎構建每個請求,以便步驟可以在不修改程式碼的情況下在不同層級間移動。如果路由很簡單(每個步驟類型對應一個模型),請在程式碼中進行路由,而不是使用模型路由。

採用前先測量

  1. 抽樣實際任務;為每個任務撰寫成果檢查條件(通過測試、正確的行數…)。
  2. 對每個候選模型以 2-3 種努力等級分別執行,使用不同的會話(不共享快取)。從每個回應的 usage 記錄成本。
  3. 繪製分數 vs 支出圖。僅在該設定優於所有單一模型點時,才保留多模型設定。
  4. 在切換前,以實際流量對勝出方案進行影子測試。

在 Claude Code 中快速檢查:透過 /model 在兩個模型上執行一個待辦任務,然後比較 /usage。

如何回答使用者

  1. 為他們的任務指明模型 + 努力等級,並附上一行來自表格的理由。
  2. 說明什麼情況會讓他們向上或向下調整。
  3. 如果他們是透過 API 整合或混用模型,請標記相關的相容性事項。
  4. 如果成本是考量因素,建議使用上述的測量流程,而不是僅依賴定價表。

來源

主要來源:

該文章引用的 Anthropic 文件:

相關技能