--- title: Claude Fable 5.2 與 Claude Mythos 5.2 遷移指南 url: https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide description: 透過本遷移指南，從 Claude Fable 5.1、Claude Mythos 5.1、Claude Opus 5.5，或更早的 Claude Fable、Claude Mythos 或 Claude Opus 模型切換至 Claude Fable 5.2 與 Claude Mythos 5.2。啟用 Claude Fable 5.2 與 Claude Mythos 5.2 的指引包含模型 ID、破壞性變更及遷移檢查清單。 --- 本指南涵蓋遷移 [Messages API](https://platform.claude.com/docs/zh-TW/build-with-claude/working-with-messages) 程式碼的相關內容。如果您使用 [Claude Managed Agents](https://platform.claude.com/docs/zh-TW/managed-agents/overview)，除了更新模型名稱之外，不需要進行任何其他變更。 讓 Claude Code 為您遷移程式碼 ```text /claude-api migrate 將此專案遷移至 claude-fable-5-2 ``` 如果您的 Claude Managed Agents 代理具有顧問，則該顧問的 `model` 是第二個需要更新的模型名稱：在變更代理的模型時，請將其設定為 `claude-fable-5-2` 或 `claude-mythos-5-2`。請參閱 [Claude Fable 5.2 執行者需要 Claude Fable 5.2 或 Claude Mythos 5.2 顧問](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-advisor-pairs)。 以下各節說明如何從 Claude Fable 5.1、Claude Mythos 5.1、Claude Opus 5.5，或更早的 Claude Fable、Claude Mythos 或 Claude Opus 模型遷移至 Claude Fable 5.2 或 Claude Mythos 5.2。關於變更內容本身，請參閱 [Claude Fable 5.2 的新功能](https://platform.claude.com/docs/zh-TW/models/fable-5-2/whats-new-fable-5-2)。關於行為差異與特定模型的提示模式，請參閱[為 Claude Fable 5.2 撰寫提示](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-fable-5-2)。 Claude Fable 5.2 可在 Claude API、[Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws) 和 [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-models-on-google-cloud/anthropic-managed) 上使用。它也可在 [Amazon Bedrock](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock) 上使用。它也可在 [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-models-on-google-cloud/google-managed) 上使用。它也可在 [Microsoft Foundry](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry) 上使用。[Claude Mythos 5.2](https://platform.claude.com/docs/zh-TW/models/mythos-5-2/overview) 具有相同的功能，且僅供通過 Anthropic 驗證計畫（例如 [Cyber Verification Program](https://support.claude.com/en/articles/14604842)）驗證的組織使用。 `claude-fable-5-2` 與 `claude-mythos-5-2` 共用的基準設定： * **思考：**「[Adaptive thinking](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking)」（自適應思考）始終開啟，與 Claude Fable 5.1 相同。模型會決定何時思考以及思考多少，而 [effort](https://platform.claude.com/docs/zh-TW/build-with-claude/effort)（投入程度）參數則控制思考的深度。`thinking: {type: "disabled"}` 與手動擴展思考（`thinking: {type: "enabled", budget_tokens: N}`）都會傳回 400 錯誤。 * **Effort：**支援全部五個 [effort](https://platform.claude.com/docs/zh-TW/build-with-claude/effort) 等級，預設值為 `high`，與 Claude Fable 5.1 相同。請參閱 [Claude Fable 5.2 的建議 effort 等級](https://platform.claude.com/docs/zh-TW/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)。 * **預填：**預填助理訊息會傳回 400 錯誤，與 Claude Fable 5.1 相同。請改用系統提示指示。 * **取樣參數：**請省略 `temperature`、`top_p` 和 `top_k`，與 Claude Fable 5.1 相同。關於會傳回 400 錯誤的值，請參閱[取樣參數](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking#sampling-parameters)。 * **工具選擇：**支援 `{type: "auto"}`（預設值）與 `{type: "none"}`。使用 `{type: "any"}` 或 `{type: "tool", name: "..."}` 強制進行工具呼叫會傳回 400 錯誤，與 Claude Fable 5.1 相同。 * **結構化輸出：**在使用「[customer-managed encryption keys](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)」（客戶管理加密金鑰），即 CMEK 的組織中，兩個模型都無法使用[結構化輸出](https://platform.claude.com/docs/zh-TW/build-with-claude/structured-outputs)，與 Claude Fable 5.1 相同。這包含嚴格工具使用與 JSON 輸出。如果您的請求在該處設定了 `strict: true` 或 `output_config.format`，請將其移除，並在您的程式碼中驗證輸出。 * **跨模型保留思考：**在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Fable 5.2 與 Claude Mythos 5.2 可以讀取彼此的思考區塊，以及來自其他模型（包括 Claude Opus 5.5、Claude Sonnet 5.5 和 Claude Haiku 5.5）的思考區塊。沒有任何其他模型能讀取它們的區塊。完整清單請參閱[在對話中途切換模型](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#switching-models)。 * **綁定帳戶的思考：**來自 Claude Fable 5.2 與 Claude Mythos 5.2 的思考區塊僅在產生它們的帳戶或與其連結的帳戶中有效。當其他帳戶傳送這些區塊之一時，API 會在模型接收之前捨棄該區塊，而請求會成功。在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，若使用 `thinking-binding-controls-2026-08-01` beta 標頭，回應會在 `input_transformations` 中以 `reason: "organization_binding_mismatch"` 列出每個被捨棄的區塊。請參閱[思考區塊綁定在產生它們的帳戶](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#account-bound-thinking)。 * **上下文視窗與輸出：**預設為 [1M token 上下文視窗](https://platform.claude.com/docs/zh-TW/build-with-claude/context-windows)，每個請求最多可輸出 128k 個 token。 * **定價：**每百萬輸入 token 8 美元，每百萬輸出 token 40 美元，而 Claude Fable 5.1 與 Claude Mythos 5.1 分別為 10 美元與 50 美元。提示快取讀取為每百萬 token 0.20 美元，而這些模型為 0.25 美元。請參閱[定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing)。 * **資料保留：**兩個模型都需要 30 天資料保留，除非經 Anthropic 明確授權，否則無法在「zero data retention」（零資料保留），即 ZDR 安排下使用，並被指定為涵蓋模型（Covered Models），與 Claude Fable 5.1 和 Claude Mythos 5.1 相同。在 Claude API 上，來自未啟用 30 天保留的組織或工作區的請求會傳回 400 `invalid_request_error`。具有 ZDR 安排的組織應聯絡其 Anthropic 客戶團隊，或為個別工作區設定保留。各平台的詳細資訊請參閱[特定模型的資料保留要求](https://platform.claude.com/docs/zh-TW/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)。 * **Priority Tier：**兩個模型都不支援 [Priority Tier](https://platform.claude.com/docs/zh-TW/api/service-tiers#supported-models)。 * **快速模式：**兩個模型都在 Messages API 請求中支援[快速模式](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode)。[快速模式的可用性](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#feature-availability)列出了每個模型適用的平台。 兩個模型的不同之處： * **可用性：**在 Claude API 上，Claude Fable 5.2 不需要存取核准。Claude Mythos 5.2 僅供通過 Anthropic 驗證計畫（例如 [Cyber Verification Program](https://support.claude.com/en/articles/14604842)）驗證的組織使用。若要申請存取權，請申請涵蓋您使用案例的計畫，或聯絡您的 Anthropic 客戶團隊。 * **速率限制：**Claude Fable 5.2 擁有自己的速率限制，與 Claude Fable 5.1 和 Claude Fable 5 共用的合併限制分開。Claude Mythos 5.2 與 Claude Mythos 5.1 和 Claude Mythos 5 共用一個合併限制。請參閱[速率限制](https://platform.claude.com/docs/zh-TW/api/rate-limits#rate-limits)。 ## 從 Claude Fable 5.1 遷移至 Claude Fable 5.2 遷移大致上可以直接替換。API 介面、始終開啟的自適應思考、強制工具選擇限制、拒絕處理、`stop_details` 類別以及資料保留要求都與 Claude Fable 5.1 相同。Claude Fable 5.2 的成本較低：每百萬輸入 token 8 美元，每百萬輸出 token 40 美元，而 Claude Fable 5.1 分別為 10 美元與 50 美元。有四項變更可能會破壞您的程式碼。用於捕捉對較早輪次所做編輯的「[prefix check](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#prefix-check)」（前綴檢查）適用於每個帳戶。Claude Fable 5.1 無法讀取 Claude Fable 5.2 的思考區塊。較早的電腦使用工具 `computer_20251124` 會傳回 400 錯誤，Amazon Bedrock 以外的所有平台皆是如此。使用顧問工具時，Claude Fable 5.2 執行者只接受 Claude Fable 5.2 或 Claude Mythos 5.2 作為其顧問。 ### 更新您的模型名稱 ```python model = "claude-fable-5-1" # Before model = "claude-fable-5-2" # After ``` 模型 ID 在所有平台上都是 `claude-fable-5-2`，但 Amazon Bedrock 除外，其 ID 為 `anthropic.claude-fable-5-2`。各平台的 ID 請參閱 [Claude Fable 5.2](https://platform.claude.com/docs/zh-TW/models/fable-5-2/overview) 模型頁面。 ### 破壞性變更 1. **前綴檢查適用於每個帳戶：**來自 Claude Fable 5.2 的每個 `thinking` 區塊僅在對照其之前的 `system` 提示、`tools` 與對話歷史時有效，與 Claude Fable 5.1 相同。Claude Fable 5.2 會對每個帳戶強制執行此[前綴檢查](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#prefix-check)，無論帳戶建立時間為何。Claude Fable 5.1 預設對 2026 年 8 月 31 日當天或之後建立的帳戶強制執行。因此，在較舊的帳戶上，於 Claude Fable 5.1 上通過的請求可能會在 Claude Fable 5.2 上失敗。 如果您的對話歷史是由 Claude Code、claude.ai、[Claude Managed Agents](https://platform.claude.com/docs/zh-TW/managed-agents/overview) 或 [Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/overview) 管理，則對您而言沒有任何變化。如果您的程式碼自行建構 `messages` 陣列，請將其在請求之間所做的操作與[前綴檢查會影響誰](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#who-is-affected)中的清單進行比較。在這些編輯之一之後將思考區塊傳回的請求會傳回 400 錯誤： ```text wrap messages.5.content.0: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block". That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header. ``` 重試相同的請求主體並不會清除此錯誤。若要在切換正式環境流量之前找出這些編輯，請針對您目前使用的模型（Claude Fable 5.1 或 Claude Opus 5.5）執行[檢查您的程式碼是否編輯了前綴](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#how-to-tell-whether-your-integration-is-impacted)中的檢查。此檢查可在任何帳戶上運作，因為設定 `prefix_mismatch_behavior` 會讓請求選擇加入此檢查。[保留思考](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking)提供了每種模式的修正方式。 在正式環境中，如果不符只可能代表您程式碼中的錯誤，請將 `prefix_mismatch_behavior` 保留為其預設值 `"error"`。若要在修正編輯期間捨棄受影響的區塊並在沒有該推理的情況下繼續，請將其設定為 `"drop_block"`。請將此視為權宜之計，而非長期設定：[捨棄區塊可能會增加輸出 token](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#drop-block-cost)。 2. **Claude Fable 5.1 無法讀取 Claude Fable 5.2 的思考區塊：**在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Fable 5.2 可以讀取 Claude Fable 5.1 的區塊，因此從 `claude-fable-5-1` 移至 `claude-fable-5-2` 的對話會保留其先前的推理。反方向則不然，Claude Fable 5.1 無法讀取 Claude Fable 5.2 的區塊。如果路由器切換、用戶端重試或[分類器拒絕備援](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback)將對話從 Claude Fable 5.2 移至其他模型（包括 Claude Fable 5.1），API 會捨棄該模型無法讀取的區塊。請求會成功，且您不會因被捨棄的輸入 token 而被計費。模型接著會在沒有該推理的情況下運作，這可能會提高切換後第一個輪次的成本與「latency」（延遲）。若使用 `thinking-binding-controls-2026-08-01` beta 標頭，`input_transformations` 會以 `reason: "model_binding_mismatch"` 列出每個被捨棄的區塊。請參閱[在對話中途切換模型](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#switching-models)。 3. **使用電腦使用工具集取代 `computer_20251124`：**類型為 `computer_20251124` 的 `tools` 項目會傳回 400 錯誤，Amazon Bedrock 以外的所有平台皆是如此。請改為宣告 `computer_toolset_20260801` 工具集：移除 beta 標頭，並在不含 `name` 或顯示尺寸的情況下傳送該項目。接著依照[從 `computer_20251124` 遷移](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124)中的說明，為該工具集更新您的代理迴圈。在 Amazon Bedrock 上，舊版工具的運作方式與在 Claude Fable 5.1 上相同。 4. **Claude Fable 5.2 執行者需要 Claude Fable 5.2 或 Claude Mythos 5.2 顧問：**使用[顧問工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool)（目前處於 beta 階段）時，顧問的能力必須至少與執行者相當。Claude Fable 5.2 或 Claude Mythos 5.2 執行者只接受 Claude Fable 5.2 或 Claude Mythos 5.2 作為其顧問，任何其他顧問（包括 Claude Fable 5.1 和 Claude Mythos 5.1）都會傳回 400 `invalid_request_error`。變更執行者的模型 ID 時，請將顧問工具定義中的 `model` 設定為 `claude-fable-5-2` 或 `claude-mythos-5-2`。變更顧問的 `model` 屬於對 `tools` 的編輯，因此請在新的對話中進行此變更。在變更後將先前思考區塊傳回的請求將無法通過前綴檢查（請參閱[前綴檢查適用於每個帳戶](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-preserved-thinking)）並傳回 400 錯誤，除非您將 `prefix_mismatch_behavior` 設定為 `"drop_block"`。若要保留目前的執行者而只變更顧問，請將顧問的 `model` 設定為 `claude-fable-5-2`：每個執行者模型都接受它。Claude Fable 5.2 顧問會以加密形式傳回其建議，因此如果您的程式碼會讀取建議文字，請參閱[結果變體](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool#result-variants)。相同的配對也適用於 [Claude Managed Agents](https://platform.claude.com/docs/zh-TW/managed-agents/overview) 代理的顧問，因此在變更代理的模型時，請將該顧問的 `model` 設定為這兩個模型之一。請參閱[模型相容性](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool#model-compatibility)與[為工作階段提供顧問](https://platform.claude.com/docs/zh-TW/managed-agents/multiagent-orchestration#give-the-session-an-advisor)。 ### 行為變更 1. **要求減少思考的提示行，無法阻止模型在 `medium` 及以上 effort 時進行思考：**Claude Fable 5.1 通常會遵循像「直接回答，不要深思」這樣的提示行。在 Anthropic 的測試中，這類提示行無法阻止 Claude Fable 5.2 在 `medium` 及以上等級時進行思考。請移除這些提示行並降低 effort 等級。請參閱[校準 effort](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#calibrate-effort)。 2. **在較高 effort 下，模型可能會啟動子代理來審查自己的工作：**在一個代理式程式設計產品中，於較高的 effort 等級（例如 `xhigh` 和 `max`）下，Anthropic 觀察到 Claude Fable 5.2 會使用子代理來審查自己的工作。Claude Fable 5.1 在相同任務上並不會這樣做。子代理可能佔一個工作階段成本的很大一部分。請參閱[為子代理設定預期](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#set-expectations-for-subagents)。 3. **過小的 `max_tokens` 可能沒有空間容納文字：**思考 token 會計入 `max_tokens`，因此 `max_tokens` 較小的請求可能會在 `thinking` 區塊之後、任何文字之前以 `stop_reason: "max_tokens"` 停止。通常能讓 Claude Fable 5.1 不進行思考的提示行，並無法讓 Claude Fable 5.2 在 `medium` 及以上 effort 時不進行思考。因此，在 Claude Fable 5.1 上仰賴此類提示行以符合較小 `max_tokens` 的請求，在 Claude Fable 5.2 上可能會在產生任何文字之前就用盡 token。請提高 `max_tokens` 以保留思考空間，或選擇較低的 [effort](https://platform.claude.com/docs/zh-TW/build-with-claude/effort) 等級。 關於在沿用提示時需要檢查的其他行為，請參閱[行為差異](https://platform.claude.com/docs/zh-TW/models/fable-5-2/whats-new-fable-5-2#behavior-differences)。 ### 遷移檢查清單 * 將模型名稱從 `claude-fable-5-1` 更新為 `claude-fable-5-2`。 * 在移轉正式環境流量之前，請檢查您的[速率限制](https://platform.claude.com/docs/zh-TW/api/rate-limits#rate-limits)。Claude Fable 5.2 擁有自己的速率限制，與 Claude Fable 5.1 和 Claude Fable 5 共用的限制分開。 * 如果您在 Amazon Bedrock 以外的任何平台上透過 `computer_20251124` 進行電腦使用，Claude Fable 5.2 會針對該工具傳回 400 錯誤。請改為宣告 `computer_toolset_20260801`，並為該工具集更新您的代理迴圈。 * 如果您使用顧問工具並以 Claude Fable 5.2 作為執行者，請將顧問的 `model` 設定為 `claude-fable-5-2` 或 `claude-mythos-5-2`。 * 如果您的程式碼自行建構 `messages` 陣列，請使用 `thinking-binding-controls-2026-08-01` beta 標頭與 `prefix_mismatch_behavior: "drop_block"` 執行一個工作階段，記錄 `input_transformations`，並修正每個 `prefix_binding_mismatch` 項目。即使您的帳戶在 Claude Fable 5.1 上從未觸發此檢查，也請這樣做。 * 選擇正式環境的 `prefix_mismatch_behavior`：`"error"`（預設值），或在修正編輯期間作為權宜之計的 `"drop_block"`，因為[捨棄區塊可能會增加輸出 token](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#drop-block-cost)。請監控 400 錯誤或 `input_transformations` 項目。 * 在每個輪次中持續原封不動地傳回 `thinking` 區塊，包括空的區塊。如果路由器或備援機制可能將對話從 Claude Fable 5.2 移至 Claude Fable 5.1，請預期 Claude Fable 5.1 會在沒有 Claude Fable 5.2 區塊的情況下執行。 * 如果您透過不同的帳戶重播已儲存的對話，請透過產生該對話的帳戶或與其連結的帳戶來重播每個對話。API 會捨棄由其他帳戶產生的 Claude Fable 5.2 思考區塊。請參閱[思考區塊綁定在產生它們的帳戶](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#account-bound-thinking)。 * 在您自己的評估上重新執行 [effort 掃描](https://platform.claude.com/docs/zh-TW/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)，並重新建立成本與延遲的基準。 * 對照[檢視為早期模型撰寫的指示](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)，檢查您沿用的系統提示、技能及其他指示。 ## 從 Claude Mythos 5.1 遷移至 Claude Mythos 5.2 [Claude Mythos 5.2](https://platform.claude.com/docs/zh-TW/models/mythos-5-2/overview) 是 Claude Fable 5.2 的對應模型，供通過 Anthropic 驗證計畫（例如 [Cyber Verification Program](https://support.claude.com/en/articles/14604842)）驗證的組織使用。在切換模型 ID 之前，請確認您的組織具有 Claude Mythos 5.2 的存取權。 Claude Mythos 5.2 會對每個帳戶強制執行[前綴檢查](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#prefix-check)，與 Claude Fable 5.2 相同。[未設定 `prefix_mismatch_behavior` 時](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#enforcement)說明了 Claude Mythos 5.1 已在哪些情況下傳回此錯誤。在 Amazon Bedrock 上，Claude Mythos 5.2 會針對已編輯之較早輪次傳回 400 錯誤，而 Claude Mythos 5.1 在該平台上會接受此類請求。如果您的程式碼會編輯較早的輪次，請參閱[編輯較早的輪次會使思考區塊失效](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-edited-history)以了解需要變更的內容及測試方式，並針對 `claude-mythos-5-2` 執行測試。 在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Mythos 5.2 可以讀取 Claude Mythos 5.1 的思考區塊，因此從 `claude-mythos-5-1` 移至 `claude-mythos-5-2` 的對話會保留其先前的推理。反方向則不然，Claude Mythos 5.1 無法讀取 Claude Mythos 5.2 的區塊：API 會捨棄這些區塊，而請求會成功。請參閱[在對話中途切換模型](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#switching-models)。 使用[顧問工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool)（目前處於 beta 階段）時，Claude Mythos 5.2 執行者只接受 Claude Mythos 5.2 或 Claude Fable 5.2 作為其顧問。Claude Mythos 5.1 或 Claude Fable 5.1 顧問會傳回 400 錯誤。請參閱 [Claude Fable 5.2 執行者需要 Claude Fable 5.2 或 Claude Mythos 5.2 顧問](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-advisor-pairs)。 Claude Mythos 5.2 透過 `computer_toolset_20260801` 工具集支援電腦使用。類型為 `computer_20251124` 的 `tools` 項目會傳回 400 錯誤，但 Amazon Bedrock 除外，舊版工具在該平台上可運作。請參閱[使用電腦使用工具集取代 `computer_20251124`](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-computer-use)。 Claude Mythos 5.2 的費用為每百萬輸入 token 8 美元、每百萬輸出 token 40 美元，而 Claude Mythos 5.1 分別為 10 美元與 50 美元。提示快取讀取為每百萬 token 0.20 美元，而先前為 0.25 美元。 ### 更新您的模型名稱 ```python model = "claude-mythos-5-1" # Before model = "claude-mythos-5-2" # After ``` ### 遷移檢查清單 * 將模型名稱從 `claude-mythos-5-1` 更新為 `claude-mythos-5-2`。 * 如果您在 Amazon Bedrock 以外的任何平台上透過 `computer_20251124` 進行電腦使用，Claude Mythos 5.2 會針對該工具傳回 400 錯誤。請改為宣告 `computer_toolset_20260801`，並為該工具集更新您的代理迴圈。 * 如果您使用顧問工具並以 Claude Mythos 5.2 作為執行者，請將顧問的 `model` 設定為 `claude-mythos-5-2` 或 `claude-fable-5-2`。 * 在每個輪次中持續原封不動地傳回 `thinking` 區塊，包括空的區塊。 * 如果您透過不同的帳戶重播已儲存的對話，請透過產生該對話的帳戶或與其連結的帳戶來重播每個對話。API 會捨棄由其他帳戶產生的 Claude Mythos 5.2 思考區塊。請參閱[思考區塊綁定在產生它們的帳戶](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#account-bound-thinking)。 * 如果您的程式碼自行建構 `messages` 陣列，請針對 `claude-mythos-5-2` 執行[編輯較早的輪次會使思考區塊失效](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-edited-history)中的檢查，修正每個 `prefix_binding_mismatch` 項目，並讓對話歷史保持僅附加（請參閱[什麼算是編輯](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#what-counts-as-an-edit)）。僅附加的歷史也能讓提示快取保持有效。 * 處理 `stop_reason: "refusal"`，並在讀取回應內容之前先讀取 `stop_details.category`。請參閱[拒絕與備援](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback)。 * 重新執行您的 effort 掃描，並重新建立成本與延遲的基準。 * 對照[檢視為早期模型撰寫的指示](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)，檢查您沿用的系統提示、技能及其他指示。 ## 從 Claude Opus 5.5 遷移至 Claude Fable 5.2 Claude Fable 5.2 使用與 [Claude Opus 5.5](https://platform.claude.com/docs/zh-TW/models/opus-5-5/overview) 相同的 Messages API 與工具使用模式。兩個模型都始終以自適應方式思考，並會針對強制工具選擇傳回 400 錯誤，因此您請求中的這些部分可以直接沿用。當您將流量或備援路徑移至 Claude Fable 5.2 時，適用以下差異。 ### 更新您的模型名稱 ```python model = "claude-opus-5-5" # Before model = "claude-fable-5-2" # After ``` ### 變更內容 1. **必須啟用資料保留：**Claude Fable 5.2 需要 30 天資料保留，除非經 Anthropic 明確授權，否則無法在零資料保留（ZDR）安排下使用。如果您的組織或工作區在 ZDR 下執行 Claude Opus 5.5，請在切換之前為工作區啟用 30 天保留，或聯絡您的 Anthropic 客戶團隊。否則，在 Claude API 上，每個傳送至 Claude Fable 5.2 的請求都會傳回 400 `invalid_request_error`。請參閱[特定模型的資料保留要求](https://platform.claude.com/docs/zh-TW/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)。 2. **前綴檢查適用於每個帳戶：**Claude Opus 5.5 預設對 2026 年 8 月 31 日當天或之後建立的帳戶強制執行前綴檢查。Claude Fable 5.2 則會對每個帳戶強制執行，無論帳戶建立時間為何。如果您的帳戶較舊且您的程式碼會編輯較早的輪次，在 Claude Opus 5.5 上可運作的請求將在 Claude Fable 5.2 上失敗。若要在切換之前進行測試，請參閱[前綴檢查適用於每個帳戶](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-preserved-thinking)。 3. **Claude Opus 5.5 無法讀取 Claude Fable 5.2 的思考區塊：**從 Claude Fable 5.2 移至 Claude Opus 5.5 的對話會保留其文字與工具呼叫，但切換後的輪次會在沒有 Claude Fable 5.2 推理的情況下執行。API 會在模型接收之前捨棄這些區塊，請求會成功，且被捨棄的區塊不會被計費。請預期切換後第一個輪次的成本與延遲會較高。反方向則是，在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Fable 5.2 可以讀取 Claude Opus 5.5 的思考區塊，因此從 `claude-opus-5-5` 移至 `claude-fable-5-2` 的對話會保留其先前的推理。 4. **安全分類器與備援：**Claude Fable 5.2 執行的安全分類器涵蓋與 Claude Fable 5.1 相同的 `stop_details` 類別。請處理[拒絕類別表](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback#refusal-response)中的每個類別，而不僅限於您在 Claude Opus 5.5 上見過的類別。若要在另一個模型上重新執行被拒絕的請求，請設定 `fallbacks: "default"`，它會在 Anthropic 針對該類別建議的模型上重試；或建構您自己的重試機制。該參數在 Claude API 和 Claude Models on Google Cloud (Anthropic managed) 上處於 beta 階段，且需要 `server-side-fallback-2026-07-01` beta 標頭。Claude Fable 5.2 允許的備援目標為 Claude Opus 4.8（`claude-opus-4-8`）與 Claude Opus 5（`claude-opus-5`）。伺服器端備援不會重試因 `"reasoning_extraction"` 而被拒絕的請求。該拒絕會直接傳回給您。備援模型不會收到 Claude Fable 5.2 的思考區塊。請參閱[拒絕與備援](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback)。 5. **定價：**Claude Fable 5.2 的費用為每百萬輸入 token 8 美元、每百萬輸出 token 40 美元，而 Claude Opus 5.5 分別為 4 美元與 20 美元。兩個模型的提示快取讀取皆為每百萬 token 0.20 美元。請參閱[定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing)。 6. **快速模式：**Claude Fable 5.2 在 Claude API 上的 Messages API 請求中支援[快速模式](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode)（`speed: "fast"`），與 Claude Opus 5.5 相同。Claude Fable 5.2 的快速模式費用為每百萬輸入 token 16 美元、每百萬輸出 token 80 美元，而 Claude Opus 5.5 在快速模式下分別為 8 美元與 40 美元。請參閱[快速模式定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing#fast-mode-pricing)。 Claude Fable 5.2 也在 [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-models-on-google-cloud/anthropic-managed) 上支援快速模式，使用相同的 `speed: "fast"` 設定。 Claude Fable 5.2 也在 [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-models-on-google-cloud/google-managed) 上支援快速模式，使用相同的 `speed: "fast"` 設定。該平台上的價格由 Google Cloud 設定。請參閱[雲端平台定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing#cloud-platform-pricing)。 Claude Fable 5.2 也在 [Microsoft Foundry 中的 Claude](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry) 上針對託管於 Anthropic 的部署支援快速模式。在該平台上，快速模式是一個獨立的模型：請將請求傳送至 `claude-fable-5-2-fast` 部署，並省略 `speed`。 Claude Mythos 5.2 也在 Claude API 上的 Messages API 請求中支援快速模式，並採用 Claude Fable 5.2 的快速模式價格。[快速模式的可用性](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#feature-availability)列出了 Claude Mythos 5.2 提供快速模式的每個平台。 在 Claude Managed Agents 中，請移除 `speed: "fast"`。在[快速模式的可用性](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#feature-availability)未列出您要移至之模型的任何平台或託管選項上，也請將其移除。 7. **CMEK 組織中的結構化輸出：**在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，Claude Opus 5.5 支援[結構化輸出](https://platform.claude.com/docs/zh-TW/build-with-claude/structured-outputs)，而 Claude Fable 5.2 則不支援。請從您移轉的請求中移除 `strict: true` 與 `output_config.format`，並在您的程式碼中驗證輸出。 8. **預設 effort 為 `high`：**Claude Opus 5.5 的預設值為 `medium`，因此省略 `effort` 的請求在 Claude Fable 5.2 上會以高一個等級執行。請求會成功，而此變更只會以不同的成本、延遲與結果呈現。請明確設定 `effort`，然後在您自己的評估上重新執行 [effort 掃描](https://platform.claude.com/docs/zh-TW/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)。 9. **Claude Fable 5.2 執行者需要 Claude Fable 5.2 或 Claude Mythos 5.2 顧問：**使用[顧問工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool)（目前處於 beta 階段）時，Claude Opus 5.5 執行者接受多種顧問，其中包括 Claude Opus 5.5 與 Claude Fable 5.1。Claude Fable 5.2 執行者只接受 Claude Fable 5.2 或 Claude Mythos 5.2，任何其他顧問都會傳回 400 錯誤。變更執行者的模型時，請將顧問的 `model` 設定為 `claude-fable-5-2` 或 `claude-mythos-5-2`。請參閱 [Claude Fable 5.2 執行者需要 Claude Fable 5.2 或 Claude Mythos 5.2 顧問](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-advisor-pairs)。 ### 遷移檢查清單 * 如果您的組織具有 ZDR 安排，請優先為工作區啟用 30 天保留，或與您的 Anthropic 客戶團隊確認資格。 * 將模型 ID 從 `claude-opus-5-5` 更新為 `claude-fable-5-2`。 * 在移轉正式環境流量之前，請檢查您的[速率限制](https://platform.claude.com/docs/zh-TW/api/rate-limits#rate-limits)。Claude Fable 5.2 的速率限制與 Claude Opus 5.5 的分開，且各層級的 token 限制較低。 * 如果您的程式碼自行建構 `messages` 陣列，請執行[前綴檢查適用於每個帳戶](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-preserved-thinking)中的測試，即使您的帳戶在 Claude Opus 5.5 上從未觸發此檢查。 * 處理每個 `stop_details.category`。如果您設定了明確的 `fallbacks` 清單，請只列出 Claude Fable 5.2 允許的目標。 * 如果路由器或備援機制將對話從 Claude Fable 5.2 移至 Claude Opus 5.5，請預期切換後的輪次會在沒有 Claude Fable 5.2 思考區塊的情況下執行。 * 如果您透過不同的帳戶重播已儲存的對話，請透過產生該對話的帳戶或與其連結的帳戶來重播每個對話。API 會捨棄由其他帳戶產生的 Claude Fable 5.2 思考區塊。請參閱[思考區塊綁定在產生它們的帳戶](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#account-bound-thinking)。 * 如果您在 Messages API 請求中使用快速模式，請僅在[快速模式的可用性](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#feature-availability)列出您要移至之模型的平台或託管選項上保留 `speed: "fast"`。在這些平台與託管選項上，請依照[快速模式價格](https://platform.claude.com/docs/zh-TW/about-claude/pricing#fast-mode-pricing)重新建立成本基準。在所有其他平台或託管選項上，以及在 Claude Managed Agents 中，請移除 `speed: "fast"`。您不需要 `fast-mode-2026-02-01` beta 標頭。在 Claude API 上，傳送該標頭的請求仍可正常運作。 Microsoft Foundry 中的 Claude 是例外：在該平台上，請移除 `speed: "fast"`，並將請求傳送至 `claude-fable-5-2-fast` 部署。 * 如果您使用顧問工具並以 Claude Fable 5.2 作為執行者，請將顧問的 `model` 設定為 `claude-fable-5-2` 或 `claude-mythos-5-2`。 * 在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，請移除 `strict: true` 與 `output_config.format`，並在您的程式碼中驗證輸出。 * 明確設定 `effort`：Claude Fable 5.2 的預設值為 `high`，而 Claude Opus 5.5 的預設值為 `medium`，因此省略此參數的請求會以高一個等級執行。接著在您自己的評估上重新執行 [effort 掃描](https://platform.claude.com/docs/zh-TW/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)，並重新建立成本與延遲的基準。 * 對照[檢視為早期模型撰寫的指示](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)，檢查您沿用的系統提示、技能及其他指示。 ## 從 Claude Fable 5 遷移至 Claude Fable 5.2 API 介面、上下文視窗與輸出限制、tokenizer（分詞器）、始終開啟的自適應思考以及拒絕處理都與 Claude Fable 5 相同。以下部分變更也適用於從 Claude Mythos 5 移至 Claude Mythos 5.2 的情況。[從 Claude Mythos 5 遷移至 Claude Mythos 5.2](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#migrating-from-claude-mythos-5-to-claude-mythos-5-2) 說明了是哪些變更。 ### 更新您的模型名稱 ```python model = "claude-fable-5" # Before model = "claude-fable-5-2" # After ``` ### 破壞性變更 1. **強制工具選擇會傳回 400 錯誤：** Claude Fable 5 接受 `tool_choice` 的 `auto`、`none`、`any` 和 `tool`。在 `claude-fable-5-2` 上，`{type: "any"}` 和 `{type: "tool", name: "..."}` 會傳回 400 `invalid_request_error`，[token 計數](https://platform.claude.com/docs/zh-TW/build-with-claude/token-counting)端點也是如此。錯誤訊息請參閱[不支援強制工具使用](https://platform.claude.com/docs/zh-TW/api/errors#forced-tool-use-not-supported)。 若要在不強制的情況下取得工具呼叫，請將 `tool_choice` 保持為 `auto`，並在您的指示中指名該工具。在工具上設定 `strict: true`，讓呼叫符合您的結構描述。請參閱[嚴格工具使用](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/strict-tool-use)。如果您強制使用工具只是為了取得符合結構描述的 JSON，請改用 [JSON 輸出](https://platform.claude.com/docs/zh-TW/build-with-claude/structured-outputs#usage)。在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，[結構化輸出](https://platform.claude.com/docs/zh-TW/build-with-claude/structured-outputs)不適用於 Claude Fable 5.2 或 Claude Mythos 5.2。這包括嚴格工具使用和 JSON 輸出。在該情況下，請保留 `auto` 和指示，省略 `strict`，並在您的程式碼中驗證工具輸入。 如果您的應用程式需要在當前回合進行特定的工具呼叫，請在最新的 `user` 回合之後附加一則[對話中途系統訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages)。指名該工具，說明此回合必須進行該呼叫，並告訴 Claude 以該呼叫作為回應的開頭。較早的回合保持不變，因此其提示快取命中和思考區塊仍然有效。[對話中途系統訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages)列出了支援此功能的平台。對於不得呼叫工具的回合，`tool_choice: {"type": "none"}` 仍然有效。請參閱[強制工具使用](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/define-tools#forcing-tool-use)。 2. **編輯較早的回合會使思考區塊失效，適用於所有帳戶：** Claude Fable 5 不會檢查較早的回合是否有變更。在 Claude Fable 5.2 上，每個 `thinking` 區塊僅相對於其之前的 `system` 提示、`tools` 和訊息有效。Claude Fable 5.2 對所有帳戶強制執行此[前綴檢查](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#prefix-check)。在上述任何內容變更後仍送回思考區塊的請求會傳回 400 錯誤，且以相同的請求本文重試也無法解決。 如果您的對話歷史由 Claude Code、claude.ai、[Claude Managed Agents](https://platform.claude.com/docs/zh-TW/managed-agents/overview) 或 [Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/overview) 管理，則對您沒有任何變化。如果您的程式碼自行建構 `messages` 陣列，請讓歷史保持僅附加（append-only）。在工作階段中固定 `system` 和 `tools`。使用[對話中途系統訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages)進行指示和工具變更，並使用伺服器端[壓縮](https://platform.claude.com/docs/zh-TW/build-with-claude/compaction)或[上下文編輯](https://platform.claude.com/docs/zh-TW/build-with-claude/context-editing)來修剪上下文。[對話中途系統訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages)列出了支援此功能的平台。[在不編輯前綴的情況下進行變更](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#replace-prefix-edits)提供了每種常見編輯的替代做法。 若要在切換正式環境流量之前找出這些編輯，請針對 `claude-fable-5-2` 執行[檢查您的程式碼是否編輯了前綴](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#how-to-tell-whether-your-integration-is-impacted)中的檢查。在正式環境中，如果不符只可能代表您的程式碼有錯誤，請將 `prefix_mismatch_behavior` 保持為預設值 `"error"`。若要在修正編輯期間捨棄受影響的區塊並在沒有該推理的情況下繼續，請搭配 `thinking-binding-controls-2026-08-01` beta 標頭將其設為 `"drop_block"`。請將此視為權宜之計，而非長期設定：[捨棄區塊可能會增加輸出 token](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#drop-block-cost)。 3. **Claude Fable 5 無法讀取 Claude Fable 5.2 的思考區塊：** 在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Fable 5.2 可以讀取 Claude Fable 5 的區塊，因此從 `claude-fable-5` 移轉到 `claude-fable-5-2` 的對話會保留其先前的推理。反方向而言，Claude Fable 5 無法讀取 Claude Fable 5.2 的區塊。如果路由器切換、用戶端重試或[分類器拒絕備援](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback)將對話從 Claude Fable 5.2 移至其他模型（包括 Claude Fable 5），API 會捨棄該模型無法讀取的區塊。請求會成功，且您不會因被捨棄的輸入 token 而被計費。搭配 `thinking-binding-controls-2026-08-01` beta 標頭時，`input_transformations` 會列出每個被捨棄的區塊，並附上 `reason: "model_binding_mismatch"`。請參閱[在對話中途切換模型](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#switching-models)。 4. **使用電腦操作工具集取代 `computer_20251124`：** 在 Claude Fable 5.2 上，類型為 `computer_20251124` 的 `tools` 項目在 Amazon Bedrock 以外的所有平台上會傳回 400 錯誤。Claude Fable 5 搭配其 beta 標頭時可接受此工具。請改為宣告 `computer_toolset_20260801` 工具集，如[使用電腦操作工具集取代 `computer_20251124`](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-computer-use) 所述。 5. **Claude Fable 5.2 執行者需要 Claude Fable 5.2 或 Claude Mythos 5.2 顧問：** 使用[顧問工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool)（目前處於 beta 階段）時，Claude Fable 5.2 執行者僅接受 Claude Fable 5.2 或 Claude Mythos 5.2 作為其顧問。Claude Fable 5 執行者可接受的其他顧問（例如 Claude Fable 5 和 Claude Opus 5.5）會傳回 400 錯誤。變更執行者的 `model` 時，請將顧問的 `model` 設為 `claude-fable-5-2` 或 `claude-mythos-5-2`。請參閱 [Claude Fable 5.2 執行者需要 Claude Fable 5.2 或 Claude Mythos 5.2 顧問](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-advisor-pairs)。 ### 其他變更 * **定價：** 每百萬輸入 token 8 美元，每百萬輸出 token 40 美元，相較之下 Claude Fable 5 為 10 美元和 50 美元。「Prompt cache」（提示快取）讀取為每百萬 token 0.20 美元，相較之下為 1 美元。請參閱[定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing)。 * **Priority Tier：** Claude Fable 5.2 不支援 [Priority Tier](https://platform.claude.com/docs/zh-TW/api/service-tiers#supported-models)。Claude Fable 5 則支援。如果您的組織有 Priority Tier 承諾，請另行規劃容量。 * **每則訊息的 effort（beta）：** 若要在對話中途變更 effort 而不失去提示快取命中，請傳送一則[每則訊息的 effort](https://platform.claude.com/docs/zh-TW/build-with-claude/effort#change-effort-mid-conversation-beta) `role: "system"` 訊息，而不是在請求之間變更 `output_config.effort`。該章節列出了支援此功能的平台。 ### 遷移檢查清單 * 將模型名稱從 `claude-fable-5` 更新為 `claude-fable-5-2`。 * 在移轉正式環境流量之前，請檢查您的[速率限制](https://platform.claude.com/docs/zh-TW/api/rate-limits#rate-limits)。Claude Fable 5.2 有自己的速率限制，與 Claude Fable 5.1 和 Claude Fable 5 共用的速率限制分開。 * 將強制 `tool_choice`（`{type: "any"}` 或 `{type: "tool", ...}`）替換為 `{type: "auto"}` 加上明確的指示和 `strict: true` 工具，或改用 JSON 輸出。將指示放在 `user` 回合中。當您的應用程式需要該呼叫時，請改為放在對話中途的 `role: "system"` 訊息中（適用於[對話中途系統訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages)列出的平台）。在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，嚴格工具使用和 JSON 輸出不適用於 Claude Fable 5.2。在該情況下，請保留 `{type: "auto"}` 和指示，並在您的程式碼中驗證工具輸入。 * 如果您的程式碼自行建構 `messages` 陣列，請搭配 `thinking-binding-controls-2026-08-01` beta 標頭和 `prefix_mismatch_behavior: "drop_block"` 執行一個工作階段，記錄 `input_transformations`，並修正每個 `prefix_binding_mismatch` 項目。模型切換後出現 `model_binding_mismatch` 項目是預期中的情況。 * 讓歷史保持僅附加：在工作階段開始時固定 `system` 和 `tools`，使用 `role: "system"` 訊息進行工作階段中途的變更，並在伺服器端修剪上下文。[對話中途系統訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages)列出了支援此功能的平台。 * 選擇正式環境的 `prefix_mismatch_behavior`：`"error"`（預設值），或在修正編輯期間以 `"drop_block"` 作為權宜之計，因為[捨棄區塊可能會增加輸出 token](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#drop-block-cost)。監控 400 錯誤或 `input_transformations` 項目。 * 在每個回合中持續原封不動地送回 `thinking` 區塊，包括空白的區塊。如果路由器或備援可能將對話從 Claude Fable 5.2 移至 Claude Fable 5，請預期 Claude Fable 5 會在沒有 Claude Fable 5.2 區塊的情況下執行。 * 如果您透過不同的帳戶重播已儲存的對話，請透過產生該對話的帳戶或與其連結的帳戶重播每則對話。API 會捨棄由其他帳戶產生的 Claude Fable 5.2 思考區塊。請參閱[思考區塊綁定在產生它們的帳戶](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#account-bound-thinking)。 * 如果您在 Amazon Bedrock 以外的任何地方透過 `computer_20251124` 使用電腦操作，Claude Fable 5.2 會針對該工具傳回 400 錯誤。請改為宣告 `computer_toolset_20260801`，並針對該工具集更新您的代理程式迴圈。 * 如果您以 Claude Fable 5.2 作為執行者來使用顧問工具，請將顧問的 `model` 設為 `claude-fable-5-2` 或 `claude-mythos-5-2`。 * 如果您在請求之間變更 effort，請在您的平台支援的情況下，將該變更移至每則訊息的 effort `role: "system"` 訊息（目前處於 beta 階段）。 * 如果您的組織有 Priority Tier 承諾，請另行規劃容量。 * 處理 `stop_reason: "refusal"` 並讀取 `stop_details.category`。考慮使用 `fallbacks: "default"`（在 Claude API 和 Claude Models on Google Cloud (Anthropic managed) 上處於 beta 階段）。 * 在您自己的評估上重新執行您的 [effort 掃描](https://platform.claude.com/docs/zh-TW/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)，並重新建立成本和延遲的基準。 * 對照[檢視為早期模型撰寫的指示](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)，檢查您沿用的系統提示、技能和其他指示。 ## 從 Claude Mythos 5 遷移至 Claude Mythos 5.2 [Claude Mythos 5.2](https://platform.claude.com/docs/zh-TW/models/mythos-5-2/overview) 是 Claude Fable 5.2 的對應模型，適用於透過 Anthropic 驗證計畫（例如 [Cyber Verification Program](https://support.claude.com/en/articles/14604842)）驗證的組織。在切換模型 ID 之前，請確認您的組織可以存取 Claude Mythos 5.2。 [從 Claude Fable 5 遷移至 Claude Fable 5.2](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#migrating-from-claude-fable-5-to-claude-fable-5-2) 中的四項變更可直接適用： * [強制工具選擇會傳回 400 錯誤](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-forced-tool-choice)。 * [編輯較早的回合會使思考區塊失效](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-edited-history)（適用於所有帳戶）。 * [使用電腦操作工具集取代 `computer_20251124`](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-computer-use)。 * Claude Fable 5.2 或 Claude Mythos 5.2 執行者[需要以這兩個模型之一作為其顧問](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-advisor-pairs)。 在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Mythos 5.2 可以讀取 Claude Mythos 5 的思考區塊，因此從 `claude-mythos-5` 移轉到 `claude-mythos-5-2` 的對話會保留其先前的推理。反方向而言，Claude Mythos 5 無法讀取 Claude Mythos 5.2 的區塊：API 會捨棄這些區塊，且請求會成功。請參閱[在對話中途切換模型](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#switching-models)。Claude Mythos 5.2 的費用為每百萬輸入 token 8 美元、每百萬輸出 token 40 美元，相較之下 Claude Mythos 5 為 10 美元和 50 美元。提示快取讀取為每百萬 token 0.20 美元，相較之下為 1 美元。 ### 更新您的模型名稱 ```python model = "claude-mythos-5" # Before model = "claude-mythos-5-2" # After ``` ### 遷移檢查清單 * 將模型名稱從 `claude-mythos-5` 更新為 `claude-mythos-5-2`。 * 將強制 `tool_choice`（`any` 或 `tool`）替換為 `auto` 加上明確的指示和 `strict: true` 工具，或改用 JSON 輸出。在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，嚴格工具使用和 JSON 輸出不適用於 Claude Mythos 5.2。在該情況下，請保留 `auto` 和指示，並在您的程式碼中驗證工具輸入。 * 如果您在 Amazon Bedrock 以外的任何地方透過 `computer_20251124` 使用電腦操作，Claude Mythos 5.2 會針對該工具傳回 400 錯誤。請改為宣告 `computer_toolset_20260801`，並針對該工具集更新您的代理程式迴圈。 * 如果您以 Claude Mythos 5.2 作為執行者來使用顧問工具，請將顧問的 `model` 設為 `claude-mythos-5-2` 或 `claude-fable-5-2`。 * 在每個回合中持續原封不動地送回 `thinking` 區塊，包括空白的區塊。 * 如果您透過不同的帳戶重播已儲存的對話，請透過產生該對話的帳戶或與其連結的帳戶重播每則對話。API 會捨棄由其他帳戶產生的 Claude Mythos 5.2 思考區塊。請參閱[思考區塊綁定在產生它們的帳戶](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#account-bound-thinking)。 * 如果您的程式碼自行建構 `messages` 陣列，請針對 `claude-mythos-5-2` 執行[編輯較早的回合會使思考區塊失效](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-edited-history)中的檢查，修正每個 `prefix_binding_mismatch` 項目，並讓對話歷史保持僅附加（請參閱[什麼算是編輯](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#what-counts-as-an-edit)）。僅附加的歷史也能讓提示快取保持有效。 * 處理 `stop_reason: "refusal"`，並在讀取回應內容之前讀取 `stop_details.category`。請參閱[拒絕與備援](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback)。 * 重新執行您的 effort 掃描，並重新建立成本和延遲的基準。 * 對照[檢視為早期模型撰寫的指示](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)，檢查您沿用的系統提示、技能和其他指示。 ## 從 Claude Opus 5 遷移至 Claude Fable 5.2 Claude Fable 5.2 使用與 [Claude Opus 5](https://platform.claude.com/docs/zh-TW/models/opus-5/overview) 相同的 [Messages API](https://platform.claude.com/docs/zh-TW/build-with-claude/working-with-messages) 和「[tool use](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/overview)」（工具使用）模式。1M token 的「context window」（上下文視窗）、128k 最大輸出 token、512 token 的提示快取最小值，以及[對話中途系統訊息](https://platform.claude.com/docs/zh-TW/build-with-claude/mid-conversation-system-messages)都會延續。預填和取樣參數的限制也是如此。當您將流量或備援路徑移至 Claude Fable 5.2 時，以下差異適用。 ### 更新您的模型名稱 ```python model = "claude-opus-5" # Before model = "claude-fable-5-2" # After ``` ### 變更內容 1. **無法停用思考：** Claude Opus 5 在 [effort](https://platform.claude.com/docs/zh-TW/build-with-claude/effort) 等級為 `high` 或更低時接受 `thinking: {type: "disabled"}`。在 Claude Fable 5.2 上，[自適應思考](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking)始終開啟，且 `thinking: {type: "disabled"}` 在任何 effort 等級都會傳回 400 錯誤。請移除該欄位，並以較低的 effort 等級控制 token 用量。對於在停用思考下執行的工作負載，請重新檢視 `max_tokens`，它涵蓋思考加上回應文字。如果該程式碼依位置讀取內容（例如 `content[0].text`），請改為依 `type` 選取內容區塊，因為 `thinking` 區塊會排在最前面。 2. **強制工具選擇會傳回 400 錯誤：** Claude Opus 5 接受 `tool_choice` 的 `any` 和 `tool`。Claude Fable 5.2 兩者都拒絕。改為傳送的內容請參閱[強制工具選擇會傳回 400 錯誤](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-forced-tool-choice)。 3. **編輯較早的回合會使思考區塊失效，適用於所有帳戶：** Claude Opus 5 不會檢查較早的回合是否有變更。Claude Fable 5.2 會對所有帳戶進行檢查。如果您的程式碼在請求之間編輯較早的訊息、重建 `system` 或 `tools`，或在用戶端進行壓縮，Claude Fable 5.2 會拒絕該請求或捨棄無效的思考區塊。需要變更的內容及測試方式請參閱[編輯較早的回合會使思考區塊失效](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-edited-history)。 4. **Claude Opus 5 無法讀取 Claude Fable 5.2 的思考區塊：** 在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Fable 5.2 可以讀取 Claude Opus 5 的區塊，因此從 `claude-opus-5` 移轉到 `claude-fable-5-2` 的對話會保留其先前的推理。反方向而言，Claude Opus 5 無法讀取 Claude Fable 5.2 的區塊。從 Claude Fable 5.2 移至 Claude Opus 5 的對話，在切換後的回合中會在沒有 Claude Fable 5.2 推理的情況下執行。API 會在模型接收之前捨棄這些區塊，請求會成功，且被捨棄的區塊不會計費。請參閱[在對話中途切換模型](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#switching-models)。 5. **工具呼叫之間的文字會在思考區塊中傳回：** 在 Claude Opus 5 上，模型在工具呼叫之間撰寫的文字會以 `text` 區塊傳回。在 Claude Fable 5.2 上，該敘述會以進度更新 `thinking` 區塊傳回，每個工具呼叫之前最多一個。如果您的介面會呈現該敘述，請將 `thinking.display` 設為 `"updates"`（目前處於 beta 階段）以文字形式接收進度更新，同時保持推理隱藏；或設為 `"summarized"` 以同時接收兩者。然後呈現 `tool_use` 區塊之間的非空白 `thinking` 區塊。請參閱[工具呼叫之間的進度更新](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking#progress-updates)。 6. **使用電腦操作工具集取代 `computer_20251124`：** Claude Opus 5 搭配其 beta 標頭時接受較早的 `computer_20251124` 工具。Claude Fable 5.2 在 Amazon Bedrock 以外的所有平台上會針對該工具傳回 400 錯誤。請參閱[使用電腦操作工具集取代 `computer_20251124`](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-computer-use)。 7. **安全分類器與備援：** Claude Fable 5.2 的安全分類器涵蓋的 `stop_details` 類別範圍比 Claude Opus 5 的分類器更廣。請預期會出現額外的 `stop_details.category` 值，例如 `"bio"`。請處理[拒絕類別表](https://platform.claude.com/docs/zh-TW/build-with-claude/refusals-and-fallback#refusal-response)中的每個類別。若要在另一個模型上重新執行被拒絕的請求，請設定 `fallbacks: "default"`，或建構您自己的重試機制。該參數在 Claude API 和 Claude Models on Google Cloud (Anthropic managed) 上處於 beta 階段，且需要 `server-side-fallback-2026-07-01` beta 標頭。[拒絕、備援與計費](https://platform.claude.com/docs/zh-TW/models/fable-5-2/whats-new-fable-5-2#refusals-fallback-and-billing)列出了允許的備援目標。 8. **定價：** Claude Fable 5.2 的費用為每百萬輸入 token 8 美元、每百萬輸出 token 40 美元，相較之下 Claude Opus 5 為 5 美元和 25 美元。提示快取讀取為每百萬 token 0.20 美元，相較之下為 0.50 美元。請參閱[定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing)。 9. **需要資料保留：** Claude Fable 5.2 需要 30 天的資料保留，除非經 Anthropic 明確授權，否則無法在「zero data retention」（零資料保留），即 ZDR 安排下使用。Claude Opus 5 可在 ZDR 下使用。在 Claude API 上，來自沒有 30 天保留的組織或工作區的請求會傳回 400 `invalid_request_error`。請參閱[特定模型的資料保留要求](https://platform.claude.com/docs/zh-TW/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)。 10. **快速模式：** Claude Opus 5 支援[快速模式](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode)（`speed: "fast"`），目前為研究預覽，需使用 `fast-mode-2026-02-01` beta 標頭。Claude Fable 5.2 在 Claude API 上的 Messages API 請求中支援快速模式，無需該標頭。傳送該標頭的請求仍可正常運作。Claude Fable 5.2 的快速模式費用為每百萬輸入 token 16 美元、每百萬輸出 token 80 美元，相較之下 Claude Opus 5 在快速模式下為 10 美元和 50 美元。請參閱[快速模式定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing#fast-mode-pricing)。 Claude Fable 5.2 也在 [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-models-on-google-cloud/anthropic-managed) 上支援快速模式，使用相同的 `speed: "fast"` 設定。 Claude Fable 5.2 也在 [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-models-on-google-cloud/google-managed) 上支援快速模式，使用相同的 `speed: "fast"` 設定。該平台上的價格由 Google Cloud 設定。請參閱[雲端平台定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing#cloud-platform-pricing)。 Claude Fable 5.2 也在 [Microsoft Foundry 中的 Claude](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry) 上針對託管於 Anthropic 的部署支援快速模式。在該平台上，快速模式是一個獨立的模型：請將請求傳送至 `claude-fable-5-2-fast` 部署，並省略 `speed`。 Claude Mythos 5.2 也在 Claude API 上的 Messages API 請求中支援快速模式，無需該標頭，並採用 Claude Fable 5.2 的快速模式價格。[快速模式的可用性](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#feature-availability)列出了 Claude Mythos 5.2 提供快速模式的每個平台。 在 Claude Managed Agents 中，請移除 `speed: "fast"`。如果[快速模式的可用性](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#feature-availability)未列出您要移至的模型，也請將其移除。 11. **CMEK 組織中的結構化輸出：** 在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，Claude Opus 5 支援[結構化輸出](https://platform.claude.com/docs/zh-TW/build-with-claude/structured-outputs)，而 Claude Fable 5.2 不支援。請從您移轉的請求中移除 `strict: true` 和 `output_config.format`，並在您的程式碼中驗證輸出。 12. **Claude Fable 5.2 執行者需要 Claude Fable 5.2 或 Claude Mythos 5.2 顧問：** 使用[顧問工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool)（目前處於 beta 階段）時，Claude Opus 5 執行者接受多種顧問，其中包括 Claude Opus 5 和 Claude Fable 5.1。Claude Fable 5.2 執行者僅接受 Claude Fable 5.2 或 Claude Mythos 5.2，任何其他顧問都會傳回 400 錯誤。變更執行者的 `model` 時，請將顧問的 `model` 設為 `claude-fable-5-2` 或 `claude-mythos-5-2`。請參閱 [Claude Fable 5.2 執行者需要 Claude Fable 5.2 或 Claude Mythos 5.2 顧問](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-advisor-pairs)。 ### 遷移檢查清單 * 如果您的組織有 ZDR 安排，請先為工作區啟用 30 天保留，或向您的 Anthropic 客戶團隊確認資格，再進行其他步驟。 * 將模型 ID 從 `claude-opus-5` 更新為 `claude-fable-5-2`。 * 在移轉正式環境流量之前，請檢查您的[速率限制](https://platform.claude.com/docs/zh-TW/api/rate-limits#rate-limits)。Claude Fable 5.2 的速率限制與 Claude Opus 5 的分開，且每個層級的 token 限制較低。 * 移除任何 `thinking: {type: "disabled"}` 設定。以較低的 effort 等級控制 token 用量，重新檢視 `max_tokens`，並依 `type` 選取內容區塊。 * 在每個回合中原封不動地送回 `thinking` 區塊，包括空白的區塊。在工具使用迴圈中，請將它們與工具結果一起送回。請參閱[保留思考區塊](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking#preserving-thinking-blocks)。 * 將強制 `tool_choice`（`any` 或 `tool`）替換為 `auto` 加上明確的指示和 `strict: true` 工具，或改用 JSON 輸出。在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，嚴格工具使用和 JSON 輸出不適用於 Claude Fable 5.2。在該情況下，請保留 `auto` 和指示，並在您的程式碼中驗證工具輸入。 * 如果您的程式碼自行建構 `messages` 陣列，請針對 `claude-fable-5-2` 執行[編輯較早的回合會使思考區塊失效](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#fable-5-2-edited-history)中的檢查，修正每個 `prefix_binding_mismatch` 項目，並讓歷史保持僅附加。 * 如果您在 Amazon Bedrock 以外的任何地方透過 `computer_20251124` 使用電腦操作，Claude Fable 5.2 會針對該工具傳回 400 錯誤。請改為宣告 `computer_toolset_20260801`，並針對該工具集更新您的代理程式迴圈。 * 如果您以 Claude Fable 5.2 作為執行者來使用顧問工具，請將顧問的 `model` 設為 `claude-fable-5-2` 或 `claude-mythos-5-2`。 * 如果路由器或備援將對話從 Claude Fable 5.2 移至 Claude Opus 5，請預期切換後的回合會在沒有 Claude Fable 5.2 思考區塊的情況下執行。 * 如果您透過不同的帳戶重播已儲存的對話，請透過產生該對話的帳戶或與其連結的帳戶重播每則對話。API 會捨棄由其他帳戶產生的 Claude Fable 5.2 思考區塊。請參閱[思考區塊綁定在產生它們的帳戶](https://platform.claude.com/docs/zh-TW/build-with-claude/preserved-thinking#account-bound-thinking)。 * 如果您的介面會呈現工具呼叫之間的文字，請將 `thinking.display` 設為 `"updates"`（目前處於 beta 階段）或 `"summarized"`，並呈現非空白的 `thinking` 區塊。 * 處理每個 `stop_details.category`。如果您設定明確的 `fallbacks` 清單，請僅指名 Claude Fable 5.2 允許的目標。 * 如果您在 Claude API 上的 Messages API 請求中使用快速模式，請僅在[快速模式的可用性](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#feature-availability)列出您要移至的模型時保留 `speed: "fast"`。如果您保留它，請依照[快速模式價格](https://platform.claude.com/docs/zh-TW/about-claude/pricing#fast-mode-pricing)重新建立成本基準。在 Claude Managed Agents 中，請移除 `speed: "fast"`。您不需要 `fast-mode-2026-02-01` beta 標頭，而傳送該標頭的請求仍可正常運作。 * 在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，請移除 `strict: true` 和 `output_config.format`，並在您的程式碼中驗證輸出。 * 在您自己的評估上重新執行您的 [effort 掃描](https://platform.claude.com/docs/zh-TW/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)，並重新建立成本和延遲的基準。 * 對照[檢視為早期模型撰寫的指示](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)，檢查您沿用的系統提示、技能和其他指示。 ## 從 Claude Opus 4.8 或更早版本遷移至 Claude Fable 5.2 首先，請以 `claude-opus-4-8` 作為您要替換的模型 ID，依序完成[從 Claude Opus 5 遷移至 Claude Fable 5.2](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#migrating-from-claude-opus-5-to-claude-fable-5-2)。該章節可直接適用於 Claude Opus 4.8 上的程式碼，因為 Claude Opus 4.8 與 Claude Opus 5 一樣： * 接受 `thinking: {type: "disabled"}`、強制工具選擇、`computer_20251124` 工具和快速模式。 * 將工具呼叫之間的文字以 `text` 區塊傳回。 * 可在零資料保留（ZDR）安排下使用。 * 費用為每百萬輸入 token 5 美元、每百萬輸出 token 25 美元，提示快取讀取為 0.50 美元。 本章節補充 Claude Opus 5 章節未涵蓋的差異。 ### 變更內容 1. **省略思考的請求也會執行思考：** 在 Claude Opus 4.8 上，除非您要求，否則思考是關閉的。在 Claude Fable 5.2 上，沒有 `thinking` 欄位的請求會以自適應思考執行。回應可能在 `text` 區塊之前包含 `thinking` 區塊，因此請依 `type` 選取內容區塊，而不是讀取 `content[0].text`。在工具使用迴圈中，請將 `thinking` 區塊原封不動地與工具結果一起送回，包括空白的區塊。思考 token 會以輸出 token 計費，且 `max_tokens` 涵蓋思考加上回應文字。請重新檢視 `max_tokens`，並在您希望減少思考的地方降低 `effort`。在 Claude API 和 Claude Models on Google Cloud (Google managed) 上，Claude Fable 5.2 可以讀取較早 Claude Opus 4.8 回合的思考區塊，因此移轉到 `claude-fable-5-2` 的對話會保留該推理。 2. **較低的提示快取最小值：** Claude Fable 5.2 上的最小可快取提示長度為 512 token，低於 Claude Opus 4.8 上的 1,024 token。先前因過短而無法快取的提示現在可以建立快取項目，無需變更程式碼。請參閱[提示快取](https://platform.claude.com/docs/zh-TW/build-with-claude/prompt-caching#cache-limitations)。 3. **不支援 Priority Tier：** Claude Opus 4.8 支援 [Priority Tier](https://platform.claude.com/docs/zh-TW/api/service-tiers#supported-models)。Claude Fable 5.2 不支援。如果您的組織有 Priority Tier 承諾，請另行規劃容量。 4. **顧問工具的建議會以加密形式傳回：** 使用[顧問工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool)（目前處於 beta 階段）時，Claude Opus 4.8 執行者可以搭配以純文字傳回建議的顧問，例如 Claude Opus 4.8。Claude Fable 5.2 執行者僅接受的顧問（Claude Fable 5.2 和 Claude Mythos 5.2）會以加密形式傳回建議，即 `advisor_redacted_result` 區塊，因此您的用戶端無法讀取其文字。如果您的程式碼會讀取建議文字，請移除該相依性。請參閱[結果變體](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/advisor-tool#result-variants)。 如果您的程式碼位於 Claude Opus 4.7 或更早版本，也請套用 Claude Opus 5.5 指南遷移檢查清單中的部分內容。請從 [Claude Opus 4.7 或更早版本](https://platform.claude.com/docs/zh-TW/models/opus-5-5/migration-guide#migration-checklist-from-claude-opus-47)群組開始，一路套用到指名您模型的群組為止。這些群組涵蓋在 Claude Opus 4.8 之前所做的請求變更，例如移除的取樣參數和 beta 標頭。請僅在[快速模式的可用性](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#feature-availability)列出您要移至的模型時，套用該檢查清單的快速模式項目。在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，結構化輸出不適用於 Claude Fable 5.2，因此請勿在該處套用 `output_config.format` 項目。請改為從您的請求中移除 `output_format`，並在您的程式碼中驗證 JSON。 ### 遷移檢查清單 * 以 `claude-opus-4-8` 作為您要替換的模型 ID，依序完成 [Claude Opus 5 檢查清單](https://platform.claude.com/docs/zh-TW/models/fable-5-2/migration-guide#migration-checklist-fable-5-2-from-opus-5)。 * 檢閱在沒有 `thinking` 欄位下執行的工作負載。在 Claude Fable 5.2 上它們會以思考執行，因此請重新檢視 `max_tokens`，在您希望減少思考的地方降低 `effort`，並依 `type` 選取內容區塊。 * 檢查任何剖析 `thinking` 欄位的程式碼是否僅將其視為顯示文字。將 `thinking.display` 設為 `"summarized"` 以接收可讀的摘要。 * 檢閱接近快取最小值的提示：512 token 以上的提示可以建立快取項目。 * 如果您的組織有 Priority Tier 承諾，請另行規劃容量。 * 如果您使用顧問工具且您的程式碼會讀取建議文字，請移除該相依性：建議會以加密的 `advisor_redacted_result` 區塊送達。 * 在您自己的評估上執行全新的 effort 掃描，而不是沿用針對 Claude Opus 4.8 調整的設定。 * 在 Claude Opus 4.7 或更早版本上，也請套用 Claude Opus 5.5 指南中適用於您模型的檢查清單群組。除非[快速模式的可用性](https://platform.claude.com/docs/zh-TW/build-with-claude/fast-mode#feature-availability)列出您要移至的模型，否則請略過快速模式項目。在使用[客戶管理加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織中，也請略過 `output_config.format` 項目，並從您的請求中移除 `output_format`。