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.5 | Sonnet 5.5 | Opus 5.5 | Fable 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 / 128K | 1M / 128K | 1M / 128K | 1M / 128K |
| 思考能力 | 適應性,可關閉(≤ 高努力等級) | 適應性;有 between_tools 選項 | 總是開啟 | 總是開啟 |
| API 預設努力等級 | 中等 | 高(Claude Code 中為中等) | 中等 | 高(Claude Code 中為中等) |
| 快速模式 | 無 | 無 | 有 | 有 |
成果不足時的調優順序
- 給模型一種驗證自身工作的方式(測試、建置、呼叫端點的腳本)。這通常比提高努力等級更划算。
- 將努力等級提高一級。
- 向上移動一個模型,並從比在小模型上使用的更低努力等級開始。
備註:
- 努力 ≈ 思考時間、工具呼叫、自我檢查。它會增加延遲。它無法增加模型缺乏的知識 — 這需要更大的模型。
- 超過「高」之後,再提高一級努力等級的成本可能與升級到下一個模型相當。請改為在更大模型上以較低努力等級進行測試。
- 如果成果可自動檢查:所有任務以低努力等級執行,僅對失敗的任務以高努力等級重新執行(根據 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 會顯示通知)。
- 多模型系統: 以最嚴格的模型為基礎構建每個請求,以便步驟可以在不修改程式碼的情況下在不同層級間移動。如果路由很簡單(每個步驟類型對應一個模型),請在程式碼中進行路由,而不是使用模型路由。
採用前先測量
- 抽樣實際任務;為每個任務撰寫成果檢查條件(通過測試、正確的行數…)。
- 對每個候選模型以 2-3 種努力等級分別執行,使用不同的會話(不共享快取)。從每個回應的
usage記錄成本。 - 繪製分數 vs 支出圖。僅在該設定優於所有單一模型點時,才保留多模型設定。
- 在切換前,以實際流量對勝出方案進行影子測試。
在 Claude Code 中快速檢查:透過 /model 在兩個模型上執行一個待辦任務,然後比較 /usage。
如何回答使用者
- 為他們的任務指明模型 + 努力等級,並附上一行來自表格的理由。
- 說明什麼情況會讓他們向上或向下調整。
- 如果他們是透過 API 整合或混用模型,請標記相關的相容性事項。
- 如果成本是考量因素,建議使用上述的測量流程,而不是僅依賴定價表。
來源
主要來源:
- Addy Osmani,"Which Claude model should you build with? Fable, Opus, Sonnet, or Haiku",claude.dev Blog(Anthropic),2026 年 11 月 9 日。
該文章引用的 Anthropic 文件:
- Choosing a model — Claude Platform 文件
- Models overview — 模型 ID、定價、上下文視窗
- Effort — 努力等級及其取捨
- Claude Code model configuration — 別名、
opusplan、ANTHROPIC_DEFAULT_HAIKU_MODEL - Claude Code subagents — 每個代理的
model:和CLAUDE_CODE_SUBAGENT_MODEL