遷移指南 - Claude Platform Docs

本指南涵蓋 Messages API 程式碼的遷移。如果您使用 Claude Managed Agents，除了更新模型名稱外，無需進行其他變更。

使用 Claude API skill 自動化您的遷移。 在 Claude Code 中，執行 /claude-api migrate 以呼叫內建的 Claude API skill。它適用於本頁面上的任何目標模型：

/claude-api migrate this project to claude-opus-4-8

此 skill 會套用模型 ID 替換，並視需要在您的程式碼庫中套用破壞性參數變更、prefill 替換，以及針對目標模型的 effort 校準，然後產生一份需要手動驗證的項目檢查清單。在編輯任何檔案之前，它會要求您確認遷移範圍（整個工作目錄、子目錄或特定檔案清單）。此 skill 也會偵測 Amazon Bedrock、Vertex AI、Claude Platform on AWS 和 Microsoft Foundry 用戶端，並針對每個平台調整模型 ID 格式和功能變更。

從 Claude Mythos Preview 遷移至 Claude Mythos 5

Claude Mythos 5 是 Claude Mythos Preview（僅限邀請的研究預覽版）的存取受限後繼版本。如需具有相同功能的正式發布模型，請參閱 Claude Fable 5。

遷移大多可直接替換。Claude Mythos 5 使用與 Claude Mythos Preview 相同的 Messages API 和相同的工具使用模式，且由於兩個模型使用相同的 tokenizer，token 數量大致不變。需要檢查的主要變更是不再提供的功能（列於下一節）以及思考輸出。

關於 Claude Mythos Preview 的停用時程，請參閱模型棄用。

更新您的模型名稱

model = "claude-mythos-preview"  # Before
model = "claude-mythos-5"  # After

Claude Mythos 5 不提供的功能

擴展思考與思考 token 預算： 手動擴展思考（thinking: {type: "enabled", budget_tokens: N}）在 claude-mythos-5 上不受支援，會回傳 400 錯誤。自適應思考始終啟用：模型會在每個請求中自行決定何時思考以及思考多少，且不需要 thinking 設定。thinking: {type: "disabled"} 會回傳錯誤。budget_tokens 沒有直接的替代方案：思考是自適應的，而 effort 參數是獨立的輸出層級控制，而非思考預算。

之前（Claude Mythos Preview）：

Token 計數與計費

claude-mythos-5 使用與 claude-mythos-preview 相同的 tokenizer（隨 Claude Opus 4.7 引入的 tokenizer）。從 claude-mythos-preview 遷移時，token 數量大致不變。與 Claude Opus 4.7 之前的模型相比，相同內容的 token 化結果可能多出約 30%，視內容和工作負載型態而異。

對於 claude-mythos-5，/v1/messages/count_tokens 回傳的值與 claude-mythos-preview 相比大致不變。請在您自己的工作負載上重新建立成本和延遲基準。

遷移檢查清單

將模型名稱從 claude-mythos-preview 更新為 claude-mythos-5。
移除手動擴展思考設定（thinking: {type: "enabled", budget_tokens: N}）。自適應思考始終啟用，且不需要 thinking 欄位。
移除任何 thinking: {type: "disabled"} 設定。在 claude-mythos-5 上停用思考會回傳錯誤。
移除 budget_tokens。它沒有直接的替代方案：思考是自適應的，而 effort 參數是獨立的輸出層級控制，而非思考預算。
確認任何解析 thinking 欄位的程式碼僅將其視為顯示文字，並在同一模型上繼續對話時原封不動地傳回思考區塊。在 claude-mythos-5 上，thinking.display 預設為 "omitted"，與 Claude Mythos Preview 相同；設定 display: "summarized" 以接收可讀的摘要。請參閱。

從 Claude Opus 4.8 遷移至 Claude Fable 5

Claude Fable 5 是 Anthropic 最強大的廣泛發布模型，在 Claude API、Claude Platform on AWS、Amazon Bedrock、Vertex AI 和 Microsoft Foundry 上正式提供。

遷移大多可直接替換。Claude Fable 5 使用與 Claude Opus 4.8 相同的 Messages API 和相同的工具使用模式。它預設支援相同的 1M token 上下文視窗和相同的 128k 最大輸出 token。由於兩個模型使用相同的 tokenizer，token 數量大致不變。

需要檢查的主要變更是始終啟用的自適應思考、思考輸出、安全分類器拒絕以及定價。遷移前涵蓋定價和資料保留；變更內容涵蓋其餘部分。

遷移前

Claude Fable 5 的定價為每百萬輸入 token $10、每百萬輸出 token $50，而 Claude Opus 4.8 為 $5 和 $25。詳情請參閱 Claude 定價。

Claude Fable 5 需要 30 天資料保留，且在「zero data retention」（零資料保留），即 ZDR 安排下不提供；它被指定為 Covered Model（受管模型）。若組織的資料保留設定不符合此要求，其請求會回傳 400 invalid_request_error。具有 ZDR 安排的組織應聯絡其 Anthropic 客戶團隊以討論資料保留設定；Claude Opus 4.8 在 ZDR 下仍可使用。或者，您可以按工作區設定資料保留；請參閱模型特定的資料保留要求。在 Amazon Bedrock、Vertex AI 和 Microsoft Foundry 上，資料保留由各平台管理。

如果您的程式碼在 Claude Opus 4.7 或更早版本上，請先套用從 Claude Opus 4.7 遷移至 Claude Opus 4.8，對於早於 Claude Opus 4.7 的模型，請套用 Claude Opus 4.7 遷移步驟。這些章節涵蓋本節不再重複的破壞性變更（取樣參數被拒絕、手動擴展思考被拒絕、prefill 移除、新 tokenizer）。

更新您的模型名稱

model = "claude-opus-4-8"  # Before
model = "claude-fable-5"  # After

變更內容

本節中的項目描述在您替換模型 ID 後值得檢查的 API 和行為差異。

自適應思考始終啟用： 自適應思考是 claude-fable-5 上唯一的思考模式。模型會在每個請求中自行決定何時思考以及思考多少，且不需要 thinking 設定。thinking: {type: "disabled"} 會回傳錯誤。使用 effort 參數來控制思考深度。

需要檢查的行為變更：在 Claude Opus 4.8 上，沒有 thinking 欄位的請求會在不思考的情況下執行；在 claude-fable-5 上，相同的請求會以自適應思考執行。max_tokens 仍是總輸出（思考加上回應文字）的硬性限制，因此對於在 Claude Opus 4.8 上不使用思考執行的工作負載，請重新檢視此設定。請參閱成本控制。

之前（Claude Opus 4.8）：

遷移檢查清單

如果您的組織具有零資料保留（ZDR）安排，請在遷移前確認資格。claude-fable-5 需要 30 天資料保留，否則會回傳 400 invalid_request_error。請參閱模型特定的資料保留要求。
將模型名稱從 claude-opus-4-8 更新為 claude-fable-5。
移除任何 thinking: {type: "disabled"} 設定。在 claude-fable-5 上停用思考會回傳錯誤，且沒有 thinking 欄位的請求會以自適應思考執行。
如果您在先前的遷移中已移除手動擴展思考和 assistant prefill，則無需採取任何動作：兩者在 claude-fable-5 上仍不受支援。
確認任何解析 thinking 欄位的程式碼僅將其視為顯示文字，並在同一模型上繼續對話時原封不動地傳回思考區塊。在 claude-fable-5 上，thinking.display 預設為 "omitted"，與 Claude Opus 4.8 相同；設定以接收可讀的摘要。請參閱。

從 Claude Opus 4.7 遷移至 Claude Opus 4.8

Claude Opus 4.8 是 Anthropic 最強大的 Opus 層級模型。它建立在 Claude Opus 4.7 之上。

Claude Opus 4.8 在現有的 Claude Opus 4.7 提示和評估上應具有強大的開箱即用效能。對於已在 Claude Opus 4.7 上執行的程式碼，沒有破壞性的 API 變更。它支援與 Claude Opus 4.7 相同的功能集，包括 1M token 上下文視窗、128k 最大輸出 token、自適應思考、提示快取、批次處理、Files API、PDF 支援、視覺，以及完整的伺服器端和用戶端工具集。它還新增了對話中系統訊息，並公開記錄了拒絕停止詳情。

如果您的程式碼在 Claude Opus 4.6 或更早版本上，在升級至 Claude Opus 4.8 之前，也請套用下方的 Claude Opus 4.7 遷移步驟。這些步驟包含破壞性變更（取樣參數被拒絕、手動擴展思考被拒絕、新 tokenizer），而僅 4.8 升級本身並未涵蓋這些變更。

在 Microsoft Foundry 上，Claude Opus 4.8 在發布時具有 200k token 的上下文視窗。1M 上下文視窗適用於 Claude API、Amazon Bedrock 和 Vertex AI。請參閱 Microsoft Foundry 中的 Claude。

更新您的模型名稱

# Opus 遷移
model = "claude-opus-4-7"  # Before
model = "claude-opus-4-8"  # After

變更內容

這些不是破壞性變更。在 Claude Opus 4.7 上執行的程式碼在 Claude Opus 4.8 上無需變更即可繼續運作。以下項目描述在您替換模型 ID 後值得檢查的行為差異。

取樣參數（不變）： 在 Claude Opus 4.8 上將 temperature、top_p 或 top_k 設為非預設值會回傳 400 錯誤，與 Claude Opus 4.7 相同。SDK 請求類型仍定義這些欄位以與早期模型相容，因此設定它們的程式碼可通過類型檢查，但 API 會在伺服器端拒絕該請求。如果您在遷移至 Opus 4.7 時已移除這些參數，則無需進一步變更。
Effort 預設為 high： 在 Claude Opus 4.8 上，effort 參數的預設值在所有介面上均為 high，包括 Claude Code 和 Messages API。如果您已明確設定 effort，您的設定不會改變。對於程式編寫和高自主性工作，請明確設定 xhigh。請根據您的延遲和成本預算重新評估您的 effort 設定。
1M 上下文視窗為預設值： Claude Opus 4.8 預設提供完整的 1M token 上下文視窗，無需 beta 標頭且無長上下文加價。如果您的用戶端為了與舊模型相容而傳遞上下文視窗 beta 標頭，您可以在 Claude Opus 4.8 上移除它。
對話中系統訊息： Claude Opus 4.8 接受在 messages 陣列中緊接在 user 回合之後的 role: "system" 訊息（須遵守）。對於從一開始就適用的指令，請使用頂層欄位。早期模型（包括 Claude Opus 4.7）會以 400 錯誤拒絕中的。如果您維護的程式碼路徑會重建完整訊息歷史以更新指令，您可以簡化它們並保留先前回合的命中。

遷移檢查清單

將模型名稱從 claude-opus-4-7 更新為 claude-opus-4-8（或更新別名）。
如果您在 Opus 4.7 遷移期間已移除取樣參數，則無需採取任何動作。如果您以 400 重試路徑重新加入它們，請移除該重試路徑。
重新評估您的 effort 設定。所有介面上的預設值均為 high；對於程式編寫和高自主性工作，請明確設定 xhigh。
移除任何上下文視窗 beta 標頭。1M 上下文視窗在 Claude API、Amazon Bedrock 和 Vertex AI 上為預設值（Microsoft Foundry 上為 200k）。
如果您重建對話歷史以更新指令，請考慮改用對話中系統訊息以保留提示快取命中。
確認您的停止原因處理會在拒絕時讀取 stop_details（自 Claude Opus 4.7 起提供；現已公開記錄）。
在您選擇的 effort 層級上重新建立成本和延遲基準。

遷移至 Claude Opus 4.7

Claude Opus 4.7 具有高度自主性，在長期代理工作、知識工作、視覺任務和記憶任務上表現出色。

Claude Opus 4.7 在現有的 Claude Opus 4.6 提示和評估上應具有強大的開箱即用效能，且維持相同的每 MTok $5 / $25 定價，但在遷移時有一些行為和 API 變更值得了解。它支援與 Claude Opus 4.6 相同的功能集，包括：

1M token 上下文視窗，採用標準 API 定價，無長上下文加價
128k 最大輸出 token
自適應思考
提示快取
批次處理
Files API
PDF 支援
視覺
完整的伺服器端和用戶端工具集（bash、程式碼執行、電腦使用、文字編輯器、、、、）

更新您的模型名稱

# Opus 遷移
model = "claude-opus-4-6"  # Before
model = "claude-opus-4-7"  # After

破壞性變更

擴展思考已移除： thinking: {type: "enabled", budget_tokens: N} 在 Claude Opus 4.7 或更新的模型上不再受支援，會回傳 400 錯誤。請改用自適應思考（thinking: {type: "adaptive"}），並使用 effort 參數來控制思考深度。自適應思考在 Claude Opus 4.7 上預設為關閉：沒有 thinking 欄位的請求會在不思考的情況下執行，與 Opus 4.6 的行為一致。請明確設定 thinking: {type: "adaptive"} 以啟用它。

之前（Claude Opus 4.6）：

選擇 effort 層級

Effort 參數允許您調整 Claude 的智能與 token 花費之間的平衡，以能力換取更快的速度和更低的成本。對於程式編寫和代理使用案例，請從新的 xhigh effort 層級開始，對於大多數對智能敏感的使用案例，請使用至少 high 的 effort。嘗試其他 effort 層級以進一步調整 token 使用和智能：

max： Max effort 在某些使用案例中可帶來效能提升，但可能因 token 使用增加而出現報酬遞減。此設定有時也可能容易過度思考。請針對需要高智能的任務測試 max effort。
xhigh（新增）： Extra high effort 是大多數程式編寫和代理使用案例的最佳設定。
high： 此設定在 token 使用和智能之間取得平衡。對於大多數對智能敏感的使用案例，請使用至少 high 的 effort。
medium： 適合需要減少 token 使用同時在智能上有所取捨的成本敏感使用案例。
low： 保留給簡短、範圍明確的任務，以及對延遲敏感但對智能不敏感的工作負載。

對於此模型而言，effort 比任何先前的 Opus 都更為重要。升級時請積極嘗試調整它。

行為變更

Claude Opus 4.7 與 Claude Opus 4.6 相比有幾項行為差異，這些差異並非 API 的重大變更，但可能需要更新提示或移除鷹架（scaffolding）。

回應長度因使用案例而異： Claude Opus 4.7 會根據其判斷任務的複雜程度來校準回應長度，而非預設使用固定的詳細程度。這通常意味著簡單查詢會得到較短的答案，而開放式分析則會得到更長的回應。

如果您的產品依賴特定的輸出風格或詳細程度，您可能需要調整提示。例如，若要降低詳細程度，可新增：「提供簡潔、聚焦的回應。略過非必要的背景資訊，並將範例保持在最少。」如果您發現特定類型的過度解釋，請在提示中新增針對性的指示以防止這些情況。

展示 Claude 如何以適當簡潔程度進行溝通的正面範例，往往比告訴模型不該做什麼的負面範例或指示更有效。
更字面化的指令遵循： Claude Opus 4.7 比 Claude Opus 4.6 更字面且明確地解讀提示，特別是在較低的 effort 層級下。它不會默默地將一個項目的指令推廣到另一個項目，也不會推斷您未提出的請求。這種字面化的好處是精確性更高且減少反覆。對於具有精心調整提示、結構化擷取以及需要可預測行為的管線等 API 使用案例，它通常表現更佳。在遷移至 Claude Opus 4.7 時，審查提示和測試框架（harness）可能特別有幫助。
更直接的語氣： 與任何新模型一樣，長篇寫作的文體風格可能會有所變化。Claude Opus 4.7 更直接且更有主見，相較於 Claude Opus 4.6 較溫暖的風格，它較少使用以肯定為導向的措辭，也較少使用表情符號。如果您的產品依賴特定的語氣，請根據新的基準重新評估風格提示。
代理軌跡中的內建進度更新： Claude Opus 4.7 在長時間的代理軌跡中會向使用者提供更規律、更高品質的更新。如果您已新增鷹架來強制產生中間狀態訊息（「每 3 次工具呼叫後，總結進度」），請嘗試移除它。如果您發現 Claude Opus 4.7 面向使用者的更新在長度或內容上未能很好地校準至您的使用案例，請在提示中明確描述這些更新應該是什麼樣子，並提供範例。
預設產生較少的子代理： Claude Opus 4.7 預設傾向於產生較少的子代理。然而，此行為可透過提示來引導；請向 Claude Opus 4.7 明確說明何時需要子代理。

建議變更

這些並非必要，但會改善您的使用體驗：

重新評估 max_tokens： 由於相同的文字在 Claude Opus 4.7 上會產生更高的 token 計數，請更新您的 max_tokens 參數以提供額外的餘裕，包括壓縮觸發器。提示介入、task_budget 和 effort 可協助控制成本並確保適當的 token 使用。
稽核 token 計數預期： 任何在用戶端估算 token 或假設固定 token 對字元比率的程式碼路徑，都應針對 Claude Opus 4.7 重新測試。使用 Token 計數端點進行驗證。
採用 task budgets（beta）： Claude Opus 4.7 引入了 task budgets（任務預算）。這些預算讓您告知 Claude 在完整的代理迴圈中有多少 token 可用，包括思考、工具呼叫、工具結果和最終輸出。模型會看到持續遞減的倒數計時，並利用它來排定工作優先順序，並在預算消耗時優雅地完成任務。若要使用，請設定 beta 標頭 task-budgets-2026-03-13 並將以下內容新增至您的輸出設定：

遷移檢查清單

將模型名稱從 claude-opus-4-6 更新為 claude-opus-4-7（或更新別名）。
從請求酬載中移除 temperature、top_p 和 top_k。
將 thinking: {type: "enabled", budget_tokens: N} 替換為 thinking: {type: "adaptive"} 加上 effort 參數。
移除任何助理訊息預填。
如果您的 UI 顯示思考內容，請明確選擇加入思考摘要。
在更新的 tokenization 下重新基準測試端對端成本和延遲。
重新調整 max_tokens 以因應更新的 tokenization。
重新測試任何用戶端 token 計數估算。

從 Opus 4.5 或更早版本遷移至 Claude Opus 4.7

如果您從 Claude Opus 4.5、Opus 4.1（已棄用）或更早的模型直接遷移至 Claude Opus 4.7，請套用上述所有 Opus 4.7 變更，加上本節中在 Opus 4.5 和 Opus 4.7 之間生效的累積變更。如果您從 Opus 4.6 遷移，您只需要上述 Opus 4.7 章節。

更新您的模型名稱

# Opus 遷移
model = "claude-opus-4-5"  # Before
model = "claude-opus-4-7"  # After

重大變更

移除預填已在上述 Opus 4.7 重大變更中涵蓋。
工具參數引號處理： Claude Opus 4.6 及更新的模型在工具呼叫引數中可能產生略有不同的 JSON 字串跳脫（例如，Unicode 跳脫或正斜線跳脫的不同處理方式）。如果您將工具呼叫 input 解析為原始字串而非使用 JSON 解析器，請驗證您的解析邏輯。標準 JSON 解析器（如 json.loads() 或 JSON.parse()）會自動處理這些差異。

建議變更

這些變更會改善您在 Opus 4.7 上的體驗。標記為**（Opus 4.7 上必要）**的項目在 Opus 4.6 推出時是選用建議，但現在是強制性的；其餘項目仍為建議。

遷移至 adaptive thinking（Opus 4.7 上必要）： thinking: {type: "enabled", budget_tokens: N} 在 Claude Opus 4.7 上會回傳 400 錯誤。請切換至 thinking: {type: "adaptive"} 並使用 effort 參數來控制思考深度。請參閱 Adaptive thinking。

從 Claude 4.1 或更早版本遷移

如果您從 Opus 4.1（已棄用）或更早的模型直接遷移至 Claude Opus 4.7，請套用本指南頂部的 Claude Opus 4.7 變更和上述累積變更，加上本節中的額外變更。

# 來自 Opus 4.1
model = "claude-opus-4-1-20250805"  # Before
model = "claude-opus-4-7"  # After

# 來自 Sonnet 3.7
model = "claude-3-7-sonnet-20250219"  # Before
model = "claude-opus-4-7"  # After

額外的重大變更

移除取樣參數

從 Claude 3.x 模型遷移時，這是一項重大變更。

從 Claude Opus 4.7 開始，將 temperature、top_p 或 top_k 設定為任何非預設值將回傳 400 錯誤。最安全的遷移路徑是從請求中完全省略這些參數，並使用提示來引導模型的行為。如果您之前使用 temperature = 0 來追求確定性，請注意它從未保證完全相同的輸出。

額外的建議變更

移除舊版 beta 標頭： 移除 token-efficient-tools-2025-02-19 和 output-128k-2025-02-19。所有 Claude 4+ 模型都內建 token 高效工具使用，這些標頭沒有作用。

遷移檢查清單（從 Opus 4.5 或更早版本）

將模型 ID 更新為 claude-opus-4-7
套用所有 Opus 4.7 重大變更（移除擴展思考、移除取樣參數、預設省略思考顯示、更新的 tokenization）
重大變更： 移除助理訊息預填（回傳 400 錯誤）；改用結構化輸出或 output_config.format
Opus 4.7 上的重大變更： 將 thinking: {type: "enabled", budget_tokens: N} 替換為 thinking: {type: "adaptive"} 加上 effort 參數（在 Opus 4.7 上回傳 400）
驗證工具呼叫 JSON 解析使用標準 JSON 解析器
移除 effort-2025-11-24 beta 標頭（effort 現已 GA）
移除 fine-grained-tool-streaming-2025-05-14 beta 標頭
移除 interleaved-thinking-2025-05-14 beta 標頭（adaptive thinking 會自動啟用 interleaved thinking）

遷移至 Claude Sonnet 4.6

Claude Sonnet 4.6 結合了強大的智慧與快速的效能，具備改進的代理搜尋能力，並在搭配網頁搜尋或網頁擷取使用時提供免費的程式碼執行。它非常適合日常程式編寫、分析和內容任務。

如需完整的功能概覽，請參閱模型概覽。

Sonnet 4.6 定價為每百萬輸入 token $3，每百萬輸出 token $15。詳情請參閱 Claude 定價。

更新您的模型名稱：

# 來自 Sonnet 4.5
model = "claude-sonnet-4-5"  # Before
model = "claude-sonnet-4-6"  # After

重大變更

從 Sonnet 4.5 遷移時

不再支援預填助理訊息

從 Sonnet 4.5 或更早版本遷移時，這是一項重大變更。

在 Sonnet 4.6 上預填助理訊息會回傳 400 錯誤。請改用結構化輸出、系統提示指令或 output_config.format。

常見的預填使用案例與遷移方式：
- 控制輸出格式（強制 JSON/YAML 輸出）：使用結構化輸出或具有 enum 欄位的工具來進行分類任務。
- 消除前言（移除「以下是...」等措辭）：在系統提示中新增直接指示：「直接回應，不要有前言。不要以『以下是...』、『根據...』等措辭開頭。」
- 避免不當拒絕： Claude 現在在適當拒絕方面表現更好。在使用者訊息中清楚提示而不使用預填應該就足夠了。
- 延續（恢復中斷的回應）：將延續移至使用者訊息：「您先前的回應被中斷，結尾為 [previous_response]。請從中斷處繼續。」

從 Claude 3.x 遷移時

更新取樣參數

從 Claude 3.x 模型遷移時，這是一項重大變更。

僅使用 temperature 或 top_p 其中之一，不要同時使用兩者。
更新工具版本

從 Claude 3.x 模型遷移時，這是一項重大變更。

更新至最新的工具版本（text_editor_20250728、code_execution_20250825）。移除任何使用 undo_edit 命令的程式碼。
處理 refusal 停止原因

更新您的應用程式以處理 refusal 停止原因。
針對行為變更更新您的提示

建議變更

移除 fine-grained-tool-streaming-2025-05-14 beta 標頭： Fine-grained tool streaming 在 Sonnet 4.6 上現已 GA，不再需要 beta 標頭。
將 output_format 遷移至 output_config.format： output_format 參數已棄用。請改用 output_config.format。

從 Sonnet 4.5 遷移

考慮從 Sonnet 4.5 遷移至 Sonnet 4.6，後者以相同的價格提供更高的智慧。

Sonnet 4.6 預設的 effort 層級為 high，與沒有 effort 參數的 Sonnet 4.5 不同。從 Sonnet 4.5 遷移至 Sonnet 4.6 時，請考慮調整 effort 參數。如果未明確設定，您可能會在預設 effort 層級下遇到較高的延遲。

如果您未使用擴展思考

如果您在 Sonnet 4.5 上未使用擴展思考，您可以在 Sonnet 4.6 上繼續不使用它。您應該明確將 effort 設定為適合您使用案例的層級。在 low effort 且停用思考的情況下，您可以預期相對於未使用擴展思考的 Sonnet 4.5 有相似或更好的效能。

如果您正在使用擴展思考

如果您在 Sonnet 4.5 上使用帶有 budget_tokens 的擴展思考，它在 Sonnet 4.6 上仍可運作但已棄用。請遷移至搭配 effort 參數的 adaptive thinking。

遷移至 adaptive thinking

Adaptive thinking 是 Sonnet 4.6 上 budget_tokens 的建議替代方案。它特別適合以下工作負載模式：

自主多步驟代理： 將需求轉換為可運作軟體的程式編寫代理、資料分析管線，以及模型在多個步驟中獨立執行的錯誤尋找。Adaptive thinking 讓模型能夠校準每個步驟的推理，在較長的軌跡中保持正確方向。對於這些工作負載，請從 high effort 開始。如果延遲或 token 使用量是考量因素，請降低至 medium。
電腦使用代理： Sonnet 4.6 使用 adaptive 模式在電腦使用評估中達到同類最佳的準確度。
雙峰工作負載： 混合簡單和困難任務，adaptive 會在簡單查詢上跳過思考，並在複雜查詢上深入推理。

使用 adaptive thinking 時，請在您的任務上評估 medium 和 high effort。正確的層級取決於您的工作負載在品質、延遲和 token 使用量之間的權衡。

如果您在使用 adaptive thinking 時發現行為不一致或品質退化，請先嘗試降低 effort 設定或使用 max_tokens 作為硬性限制。帶有 budget_tokens 的擴展思考在 Sonnet 4.6 上仍可運作，但已棄用且不再建議使用。

遷移期間保留 budget_tokens

如果您在遷移期間需要暫時保留 budget_tokens，約 16k token 的預算可為較困難的問題提供餘裕，而不會有 token 使用失控的風險。此設定已棄用，將在未來的模型版本中移除。

程式編寫和代理使用案例

對於代理程式編寫、前端設計、工具密集型工作流程和複雜的企業工作流程，請從 medium effort 開始。如果您發現延遲過高，請考慮將 effort 降低至 low。如果您需要更高的智慧，請考慮將 effort 提高至 high 或遷移至 Opus 4.7。

聊天和非程式編寫使用案例

對於聊天、內容生成、搜尋、分類和其他非程式編寫任務，請從搭配擴展思考的 low effort 開始。如果您需要更深入的處理，請將 effort 提高至 medium。

Sonnet 4.6 遷移檢查清單

將模型 ID 更新為 claude-sonnet-4-6
重大變更： 移除助理訊息預填；改用結構化輸出或 output_config.format
重大變更： 驗證工具參數 JSON 解析能處理跳脫差異
重大變更： 將工具版本更新至最新（text_editor_20250728、code_execution_20250825）；不支援舊版本（如果從 3.x 遷移）
重大變更： 移除任何使用 undo_edit 命令的程式碼（如適用）
重大變更： 更新取樣參數，僅使用 temperature 或 top_p 其中之一，不要同時使用兩者（如果從 3.x 遷移）
在您的應用程式中處理新的 refusal 停止原因
移除 beta 標頭（現已 GA）

遷移至 Claude Sonnet 4.5

Claude Sonnet 4.5 結合了強大的智慧與快速的效能，非常適合日常程式編寫、分析和內容任務。

如需完整的功能概覽，請參閱模型概覽。

Sonnet 4.5 定價為每百萬輸入 token $3，每百萬輸出 token $15。詳情請參閱 Claude 定價。

更新您的模型名稱：

# 來自 Sonnet 3.7
model = "claude-3-7-sonnet-20250219"  # Before
model = "claude-sonnet-4-5-20250929"  # After

重大變更

這些重大變更適用於從 Claude 3.x Sonnet 模型遷移時。

更新取樣參數

從 Claude 3.x 模型遷移時，這是一項重大變更。

僅使用 temperature 或 top_p 其中之一，不要同時使用兩者。
更新工具版本

從 Claude 3.x 模型遷移時，這是一項重大變更。

更新至最新的工具版本（text_editor_20250728、code_execution_20250825）。移除任何使用 undo_edit 命令的程式碼。
處理 refusal 停止原因

更新您的應用程式以處理 refusal 停止原因。
針對行為變更更新您的提示

Sonnet 4.5 遷移檢查清單

將模型 ID 更新為 claude-sonnet-4-5-20250929
**重大變更：**將工具版本更新至最新版本（text_editor_20250728、code_execution_20250825）；不支援舊版本（若從 3.x 遷移）
**重大變更：**移除任何使用 undo_edit 命令的程式碼（如適用）
**重大變更：**更新取樣參數，僅使用 temperature 或 top_p 其中之一，不可同時使用兩者（若從 3.x 遷移）
在您的應用程式中處理新的 refusal 停止原因
依照提示最佳實踐檢視並更新提示
考慮為複雜的推理任務啟用擴展思考
在部署至生產環境前，先於開發環境中進行測試

遷移至 Claude Haiku 4.5

Claude Haiku 4.5 是速度最快且最智慧的 Haiku 模型，具備接近前沿的效能，為互動式應用程式和大量處理作業提供優質的模型品質。

如需完整的功能概述，請參閱模型概述。

Haiku 4.5 的定價為每百萬個輸入 token 1 美元，每百萬個輸出 token 5 美元。詳情請參閱 Claude 定價。

更新您的模型名稱：

# 來自 Haiku 3.5
model = "claude-3-5-haiku-20241022"  # Before
model = "claude-haiku-4-5-20251001"  # After

**檢視新的速率限制：**Haiku 4.5 的速率限制與 Haiku 3.5 是分開的。詳情請參閱速率限制文件。

若要在程式編寫和推理任務上獲得顯著的效能提升，請考慮使用 thinking: {type: "enabled", budget_tokens: N} 啟用擴展思考。

擴展思考會影響提示快取的效率。

擴展思考在 Claude 4.6 模型中已被棄用，並在 Claude Opus 4.7 中移除。若使用較新的模型，請改用自適應思考。

**探索新功能：**請參閱模型概述，了解上下文感知、更大的輸出容量（64k token）、更高的智慧程度以及更快的速度等詳細資訊。

重大變更

以下重大變更適用於從 Claude 3.x Haiku 模型遷移的情況。

更新取樣參數

從 Claude 3.x 模型遷移時，這是一項重大變更。

僅使用 temperature 或 top_p 其中之一，不可同時使用兩者。
更新工具版本

從 Claude 3.x 模型遷移時，這是一項重大變更。

更新至最新的工具版本（text_editor_20250728、code_execution_20250825）。移除任何使用 undo_edit 命令的程式碼。
處理 refusal 停止原因

更新您的應用程式以處理 refusal 停止原因。
針對行為變更更新您的提示

Haiku 4.5 遷移檢查清單

將模型 ID 更新為 claude-haiku-4-5-20251001
**重大變更：**將工具版本更新至最新版本（text_editor_20250728、code_execution_20250825）；不支援舊版本
**重大變更：**移除任何使用 undo_edit 命令的程式碼（如適用）
**重大變更：**更新取樣參數，僅使用 temperature 或 top_p 其中之一，不可同時使用兩者
在您的應用程式中處理新的 refusal 停止原因
檢視並調整以符合新的速率限制（與 Haiku 3.5 分開）
依照提示最佳實踐檢視並更新提示
考慮為複雜的推理任務啟用擴展思考
在部署至生產環境前，先於開發環境中進行測試

取得協助

查看 API 文件以取得詳細規格
檢視模型功能以進行效能比較
檢視 API 版本說明以了解 API 更新
若您在遷移過程中遇到任何問題，請聯絡支援團隊

client.messages.create(
    model="claude-mythos-preview",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[{"role": "user", "content": "..."}],
)

client.messages.create(
    model="claude-opus-4-8",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)

client.messages.create(
    model="claude-fable-5",
    max_tokens=16000,
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "..."}],
)

display: "summarized"

system

messages

role: "system"

client.messages.create(
    model="claude-opus-4-6",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 10000},
    messages=[{"role": "user", "content": "..."}],
)

client.messages.create(
    model="claude-opus-4-7",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},  # or "max", "xhigh", "medium", "low"
    messages=[{"role": "user", "content": "..."}],
)

思考內容預設省略： 在 Claude Opus 4.7 上，思考區塊仍會出現在回應串流中，但除非您明確選擇加入，否則其 thinking 欄位為空。這是相對於 Claude Opus 4.6 的靜默變更，後者的預設行為是回傳摘要的思考文字。若要在 Claude Opus 4.7 上恢復摘要的思考內容，請將 thinking.display 設為 "summarized"：

thinking = {
    "type": "adaptive",
    "display": "summarized",
}

在 Claude Opus 4.7 上預設為 "omitted"。如果您的產品會將推理過程串流給使用者，新的預設值會表現為輸出開始前的長時間停頓；設定 display: "summarized" 以在思考期間恢復可見的進度。詳情請參閱擴展思考。

response = client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=16000,
    thinking={"type": "enabled", "budget_tokens": 32000},
    betas=["interleaved-thinking-2025-05-14"],
    messages=[{"role": "user", "content": "Your prompt here"}],
)

# 之前 - 這在 Claude 4+ 模型中會產生錯誤
response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    temperature=0.7,
    top_p=0.9,  # Non-default sampling params return 400 on Opus 4.7
    # ...
)

# 之後
response = client.messages.create(
    model="claude-opus-4-7",
    # ...
)

更新工具版本

從 Claude 3.x 模型遷移時，這是一項重大變更。

更新至最新的工具版本。移除任何使用 undo_edit 命令的程式碼。

# 之前
tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]

# 之後
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

文字編輯器： 使用 text_editor_20250728 和 str_replace_based_edit_tool。詳情請參閱文字編輯器工具文件。
程式碼執行： 升級至 code_execution_20250825。遷移說明請參閱程式碼執行工具文件。

處理 refusal 停止原因

更新您的應用程式以處理 refusal 停止原因：

response = client.messages.create(...)

if response.stop_reason == "refusal":
    # 適當地處理拒絕情況
    pass

處理 model_context_window_exceeded 停止原因

Claude 4.5+ 模型在生成因達到上下文視窗限制而停止時（而非達到請求的 max_tokens 限制），會回傳 model_context_window_exceeded 停止原因。更新您的應用程式以處理此新的停止原因：

response = client.messages.create(...)

if response.stop_reason == "model_context_window_exceeded":
    # 適當處理上下文視窗限制
    pass

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=8192,
    output_config={"effort": "low"},
    messages=[{"role": "user", "content": "Your prompt here"}],
)

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=64000,
    thinking={"type": "adaptive"},
    output_config={"effort": "medium"},
    messages=[{"role": "user", "content": "Your prompt here"}],
)

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=16384,
    thinking={"type": "enabled", "budget_tokens": 16384},
    output_config={"effort": "medium"},
    betas=["interleaved-thinking-2025-05-14"],
    messages=[{"role": "user", "content": "Your prompt here"}],
)

response = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=8192,
    thinking={"type": "enabled", "budget_tokens": 16384},
    output_config={"effort": "low"},
    betas=["interleaved-thinking-2025-05-14"],
    messages=[{"role": "user", "content": "Your prompt here"}],
)

fine-grained-tool-streaming-2025-05-14

從 Claude Mythos Preview 遷移至 Claude Mythos 5

更新您的模型名稱

Claude Mythos 5 不提供的功能

Token 計數與計費

遷移檢查清單

從 Claude Opus 4.8 遷移至 Claude Fable 5

遷移前

更新您的模型名稱

變更內容

遷移檢查清單

從 Claude Opus 4.7 遷移至 Claude Opus 4.8

更新您的模型名稱

變更內容

遷移檢查清單

遷移至 Claude Opus 4.7

更新您的模型名稱

破壞性變更

選擇 effort 層級

行為變更

建議變更

遷移檢查清單

從 Opus 4.5 或更早版本遷移至 Claude Opus 4.7

更新您的模型名稱

重大變更

建議變更

從 Claude 4.1 或更早版本遷移

額外的重大變更

額外的建議變更

遷移檢查清單（從 Opus 4.5 或更早版本）

遷移至 Claude Sonnet 4.6

重大變更

從 Sonnet 4.5 遷移時

從 Claude 3.x 遷移時

建議變更

從 Sonnet 4.5 遷移

如果您未使用擴展思考

如果您正在使用擴展思考

遷移至 adaptive thinking

遷移期間保留 budget_tokens

程式編寫和代理使用案例

聊天和非程式編寫使用案例

Sonnet 4.6 遷移檢查清單

遷移至 Claude Sonnet 4.5

重大變更

Sonnet 4.5 遷移檢查清單

遷移至 Claude Haiku 4.5

重大變更

Haiku 4.5 遷移檢查清單

取得協助

從 Claude Mythos Preview 遷移至 Claude Mythos 5

更新您的模型名稱

Claude Mythos 5 不提供的功能

Token 計數與計費

遷移檢查清單

從 Claude Opus 4.8 遷移至 Claude Fable 5

遷移前

更新您的模型名稱

變更內容

遷移檢查清單

從 Claude Opus 4.7 遷移至 Claude Opus 4.8

更新您的模型名稱

變更內容

遷移檢查清單

遷移至 Claude Opus 4.7

更新您的模型名稱

破壞性變更

選擇 effort 層級

行為變更

建議變更

遷移檢查清單

從 Opus 4.5 或更早版本遷移至 Claude Opus 4.7

更新您的模型名稱

重大變更

建議變更

從 Claude 4.1 或更早版本遷移

額外的重大變更

額外的建議變更

遷移檢查清單（從 Opus 4.5 或更早版本）

遷移至 Claude Sonnet 4.6

重大變更

從 Sonnet 4.5 遷移時

從 Claude 3.x 遷移時

建議變更

從 Sonnet 4.5 遷移

如果您未使用擴展思考

如果您正在使用擴展思考

Sonnet 4.6 遷移檢查清單

遷移至 Claude Sonnet 4.5

重大變更

Sonnet 4.5 遷移檢查清單

遷移至 Claude Haiku 4.5

重大變更

Haiku 4.5 遷移檢查清單

取得協助