註冊
Claude

Claude API 模型 ID 怎麼寫、怎麼查可用模型：dateless 命名、別名區別、Models API 的 lifecycle 和 capabilities

model 參數該填什麼？按官方《Models overview》《Model IDs and versioning》《List Models》講清 Claude 模型 ID 的格式、4.6 之前帶日期與之後不帶日期的區別、別名是什麼，以及用 GET /v1/models 查可用模型、生命週期和能力字段。

NNathaniel bigo··原創首發·AI 輔助撰寫
13 分鐘讀完
資料核對於 2026-11-05 · 依據官方文檔與公開資料整理 其他 帳號
本文根據 Claude 開發者平台官方文檔《Models overview》《Model IDs and versioning》《List Models》整理，資料核對於 2026-11-05。配圖為本站整理的示意圖，不是介面截圖。本站（bigolab.com）不是 Anthropic 官方網站。

適用於誰

  • 寫 Claude API 代碼，不知道 model 該填什麼字符串的人；
  • 看到別人寫 claude-sonnet-4-5-20250929，自己寫 claude-sonnet-5-5，想弄清帶不帶日期有什麼區別的人；
  • 想在程序裏自動列出當前可用模型、判斷某個模型是否支持某項功能的人。

模型之間怎麼選，見 /guides/claude-models-compare 和 /guides/claude-opus-vs-sonnet；基礎調用見 /guides/claude-api-python-quickstart。

結論先說

  1. 每個模型 ID 都是一個固定的版本快照。 官方說，用某個模型 ID 發請求，該 ID 對應的底層模型在整個生命週期內保持不變；更新的版本會以新的 ID 發佈。
  2. 4.6 代及之後用不帶日期的格式： claude-{name}-{major}[-{minor}]，例如 claude-opus-4-8、claude-sonnet-5。大版本發佈（如 Sonnet 5、Opus 5）省略 minor。
  3. 4.6 之前的模型帶快照日期： claude-{name}-{major}-{minor}-{YYYYMMDD}，例如 claude-sonnet-4-5-20250929；Claude API 上它們還有不帶日期的別名（如 claude-sonnet-4-5），指向該小版本最新的帶日期快照。
  4. 不帶日期不等於「永遠最新」。 官方專門澄清：claude-sonnet-4-6 這類 ID 不是別名，它就是那個快照，不會被悄悄換成更新的版本。
  5. 用 Models API 查： GET /v1/models 返回你能用的模型，含生命週期、最大輸入 / 輸出 token 和能力字段。

模型 ID 的兩種寫法

圖：本站根據 Claude 官方文檔：Model IDs and versioning 整理的示意圖

一、當前模型的 ID

官方 Models overview（2026-11-05）的對比表裏，四個當前模型是：

模型Claude API ID定位（官方描述）上下文窗口最大輸出
Claude Fable 5.1claude-fable-5-1高要求推理與長程智能體工作1M tokens128K tokens
Claude Opus 5.5claude-opus-5-5長時間運行的智能體編碼與知識工作1M tokens128K tokens
Claude Sonnet 5.5claude-sonnet-5-5速度與智能的最佳組合1M tokens128K tokens
Claude Haiku 5.5claude-haiku-5-5高吞吐、延遲敏感任務，如分類1M tokens128K tokens

官方還建議：不確定用哪個，大多數工作負載先從 Opus 5.5 開始；要求很高的推理和長程智能體任務，或在更高 effort 下 Opus 5.5 的評測仍不夠時，用 Fable 5.1。表裏另外還給了每個模型的延遲檔位、定價、預設 effort、可靠知識截止時間（均為 2026 年 6 月）和最早退役日期，這些請直接看官方頁面，本文不抄價格。

怎麼寫：

python
import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-5-5",   # 直接填 Claude API ID
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)

二、各平台的寫法不一樣

官方 Model IDs and versioning 頁面說明了其他平台的格式：

  • Amazon Bedrock： 4.6 代及之後是 anthropic.claude-{name}-{major}[-{minor}]，例如 anthropic.claude-opus-5-5（Models overview 表裏的寫法）；官方說 Claude Opus 4.6 是最後一個帶 -v1 後綴的 Bedrock 模型 ID（anthropic.claude-opus-4-6-v1）；4.6 之前的模型是 anthropic.claude-sonnet-4-5-20250929-v1:0 這種帶日期和版本後綴的格式。
  • Google Cloud 上的 Claude（Google 託管）： 4.6 代及之後格式與 Claude API 相同；4.6 之前的模型用 @ 分隔日期，例如 claude-haiku-4-5@20251001。
  • Microsoft Foundry： 預設使用 Claude API 的模型 ID（有別名時用別名），你發送的是部署名。
  • Claude Platform on AWS： 用 Claude API 的模型 ID，不是 Bedrock 風格的 ID。

換平台時，最容易出錯的是把 Bedrock 的 ID 拿去 Claude API 用，或反過來。

三、別名和停用

官方的幾點說明：

  • 別名只是便利指針：官方說 Claude API 上只有 4.6 之前的模型有這種別名；4.6 代及之後的無日期 ID 本身就是固定快照。想要穩定行為，寫完整的、固定的 ID。
  • 每個模型 ID，不論帶不帶日期，都有自己獨立的棄用和退役時間表。官方的 Models overview 裏「Retirement」一行是 Anthropic 對其運營平台的承諾，合作夥伴運營的平台自己定日期。
  • 模型權重對一個 ID 是固定的，但周邊的服務基礎設施（請求路由、安全分類器、採樣邏輯等）可能變化。官方說這偶爾會帶來細微的行為差異，如果你在一個原本穩定的 ID 上發現意外變化，基礎設施更新是最可能的原因。

四、用 Models API 查可用模型

官方說，可以用 Models API 以編程方式查詢模型能力和 token 上限。請求：

bash
curl https://api.anthropic.com/v1/models \
    -H 'anthropic-version: 2026-10-21' \
    -H "Authorization: Bearer $ANTHROPIC_API_KEY"

（這是官方 List Models 頁面的示例，認證頭寫法見頂部 verify 提示，不同官方頁面的示例認證頭不一致，請以對應頁面為準。）

查詢參數：

  • limit：每頁數量，預設 20，範圍 1 到 1000；
  • after_id / before_id：分頁遊標；
  • lifecycle：按生命週期過濾，可取 active、deprecated、retired，最多 3 個。不傳時只返回 active 和 deprecated 的模型，retired 只有明確請求才會出現。

另外官方列了可選請求頭 anthropic-workspace-id：僅在你的憑據能操作多個工作區時才需要。

返回的每個模型（ModelInfo）有這些字段：

  • id、display_name、created_at；
  • lifecycle：active（可用、對新用戶開放、沒有退役計劃）、deprecated（對已有權限的組織仍可調用，但即將退役，不再對新用戶開放）、retired（不再可用，調用會失敗，仍在目錄裏作為歷史記錄）；
  • deprecated_at、retires_at：棄用與退役時間，可能為 null；
  • max_input_tokens、max_tokens；
  • line：模型所屬系列，如 haiku、sonnet、opus、fable、mythos，或 null。官方提醒：做模型選擇器分組時讀 line，不要從 id 推斷，Anthropic 以後可能增加新的系列；
  • capabilities：能力對象，每項都有 supported 布爾值。

capabilities 裏有用的幾項（官方列出）： batch（是否支持批量接口）、citations（是否支持引用）、image_input、pdf_input、structured_outputs、effort、thinking、context_management，以及 server_tools（是否接受聯網搜尋和代碼執行工具）。

幾個官方特別提醒的細節：

  • server_tools.web_search.supported 和 server_tools.code_execution.supported 為 true，表示模型接受該工具的至少一個版本，不一定每個版本；
  • 即使工具被支持，你的組織設定仍可能讓請求失敗，比如管理員關閉了聯網搜尋；
  • thinking.types.disabled.supported 為 false 表示模型會以 400 拒絕 thinking: {type: "disabled"}。官方舉例：Sonnet 5.5 的這一項報告為 false。

用法舉例：發請求前，程序先查某個模型 capabilities.citations.supported，再決定是否開啟引用，見 /guides/claude-api-citations；聯網搜尋與代碼執行見 /guides/claude-api-web-search-tool 和 /guides/claude-api-code-execution-tool。

model 寫錯或模型不可用時先查什麼

圖：本站根據官方文檔整理的示意圖

常見問題

Q：Python SDK 裏有對應方法嗎？

官方 API reference 的 models/list 方法對應這個接口；SDK 裏的具體寫法請看官方 SDK 文檔，本文不替它寫。

Q：我用的老模型 ID 還能用多久？

看 Models API 返回的 lifecycle、deprecated_at、retires_at，以及官方的 Model deprecations 頁面。已退役的模型請求會失敗。

Q：怎麼從舊模型遷移？

官方 Models overview 裏提到：如果你在 Opus 5 或更早的版本上，可以看官方的 Opus 5.5 遷移指南。

Q：調用報 404 或模型不存在？

先用 Models API 確認該 ID 你的帳號下是否可用，再檢查拼寫和平台格式。其他 API 報錯見 /guides/claude-api-error-429-rate-limit 與 /guides/claude-api-error-529-overloaded。

相關教學

參考資料

  • Claude 開發者平台文檔：Models overview — https://platform.claude.com/docs/en/models/overview
  • Claude 開發者平台文檔：Model IDs and versioning — https://platform.claude.com/docs/en/about-claude/models/model-ids-and-versions
  • Claude 開發者平台文檔：List Models — https://platform.claude.com/docs/en/api/models/list

Nathaniel 的更多內容

  1. 01

    Claude Personal Finance 是什麼：連銀行帳戶問花銷、怎麼開、只讀權限、誰能用、怎麼解除

    Claude 的 Personal Finance（beta）通過 Plaid 只讀連接你的銀行、信用卡、貸款和投資帳戶，在一頁裏看餘額和花銷並用自然語言提問。本文按官方幫助頁講誰能用（僅美國、Pro/Max/Ultra）、連接與解除步驟、Claude 能看什麼，以及它做不到的事。

    Claude0
  2. 02

    Claude Code 離開一小時回來對話被「壓縮」了：Idle compaction 是什麼、條件、怎麼關

    Claude Code 的 idle compaction 會在你離開約一小時後，把 200K token 以上的長對話先壓縮成摘要，下一條消息就不用重新處理整段歷史。本文按官方文檔講觸發條件、看到什麼提示、用 /config 或 idleCompaction 關閉、調閾值，以及恢復舊對話的用量警告。

    Claude0
  3. 03

    ChatGPT Computer History 是什麼：Mac 桌面端的活動記憶怎麼開、怎麼暫停和清除、誰能用

    Computer History 是 ChatGPT macOS 桌面應用裏預設關閉的可選功能，把你在應用和網站裏的活動整理成記憶和時間線，供 ChatGPT 與 Codex 引用。本文按官方文檔講怎麼開、記錄什麼不記錄什麼、怎麼暫停與清除、數據存哪、誰能用，以及提示注入風險。

    ChatGPTCodex0
  4. 04

    Codex 輸入框出現灰色建議：Composer predictions 是什麼、Tab 接受、怎麼關、誰能用

    Codex 桌面 App 的 Composer predictions（beta）會在 Codex 回完後，根據當前對話在輸入框裏給出下一條消息的建議，按 Tab 接受、不會自動發送。本文按官方幫助頁講誰能用、哪些線程支持、怎麼關、算不算額度，以及沒出現時怎麼查。

    ChatGPTCodex0
  5. 05

    ChatGPT 私隱中心（Privacy Center）在哪裏：私隱設定入口、三大分類和哪些套餐有

    ChatGPT 的 Privacy Center 把記憶、廣告、位置、臨時對話、鎖定對話、兩步驗證、模型改進、數據導出和刪號等入口集中到一頁。本文按官方幫助頁講怎麼打開、三大分類各有什麼、哪些套餐有，以及它不會替你改任何設定。

    ChatGPT0
  6. 06

    Claude Code 處理大倉庫：怎麼讓它只看需要的目錄（子目錄 CLAUDE.md、claudeMdExcludes、deny 規則）

    倉庫太大，Claude Code 總在讀無關文件、讀進別的包的規則？本文按官方大倉庫指南講：從哪個目錄啟動、子目錄 CLAUDE.md、claudeMdExcludes、Read 的 deny 規則、worktree.sparsePaths、additionalDirectories，以及一份合併後的配置示例。

    Claude0

同產品的其他教學

  1. 01

    Claude Code 在 CI 裏跑：從本機 claude -p 到 GitHub Actions 的完整例子（自動審 PR、控成本）

    一條線走完 Claude Code 的 CI 用法：先在本機用 claude --bare -p 配 --json-schema 跑通，再寫進 GitHub Actions 用 claude-code-action@v1 自動審 PR，最後加上 --max-turns、超時、並發限制來控成本，並附上常見故障的排查順序。

    Claude0
  2. 02

    Claude Code 自定義 subagent 實例：測試員、調試員、只讀調研員、只讀數據庫員怎麼寫

    四個可直接改的 subagent 實例：跑測試的 test-runner、找根因的 debugger、只讀調研員、用 PreToolUse hook 限成只讀 SQL 的 db-reader；講 tools、disallowedTools、model、maxTurns 怎麼配，怎麼點名調用。

    Claude0
  3. 03

    Claude Code 的 CLAUDE.md 模板：前端、後端、數據分析各一份，附拆分與自檢方法

    直接拿去改的三份 CLAUDE.md 模板（前端、後端、數據分析），每份都控制在官方建議的 200 行以內；再講怎麼用 .claude/rules 的 paths 拆出專屬規則、用 @ 導入長文檔，以及用 /context all 和 /doctor prompt-audit 檢查是否生效。

    Claude0
  4. 04

    Claude Code 自己寫一個插件並發布到 marketplace：plugin.json、marketplace.json、validate 到團隊安裝的完整流程

    想把自己寫的 Skill、Hook 打包給團隊用？按 Claude Code 官方 Plugins 文檔，從目錄結構、plugin.json、claude plugin validate，到寫 marketplace.json、推到 Git、讓同事一條命令安裝，再到版本更新，走完一遍完整流程。

    Claude0
  5. 05

    Claude Code 寫一個會自動觸發的 Skill：從需求到觸發，用 description、when_to_use 和 paths 控制它什麼時候出場

    寫好的 Skill 總是不觸發，或者什麼都觸發？本文按 Claude Code 官方「Extend Claude with skills」走一遍完整實例：把「改數據庫遷移前先檢查」寫成一個會自動出場的 Skill，包含 description、when_to_use、paths、附帶腳本、觸發測試和評估。

    Claude0
  6. 06

    Claude Code 配 Sentry MCP 排查線上報錯：添加命令、瀏覽器授權、貼 issue 連結修 bug 和插件子智能體

    線上報錯只能手動複製堆棧給 Claude Code？Sentry 官方提供 MCP 服務，可以讓它直接讀 issue、堆棧和 trace。本文按 Claude Code 官方 MCP 文檔和 Sentry MCP 官方說明，講添加命令、/mcp 授權、典型排查流程、插件方式和自託管注意事項。

    Claude0

0 條評論

登入 後參與評論

還沒有評論，來搶沙發～