--- title: Claude Fable 5.2およびClaude Mythos 5.2移行ガイド url: https://platform.claude.com/docs/ja/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/ja/build-with-claude/working-with-messages)のコードの移行について説明します。[Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)を使用している場合は、モデル名の更新以外に変更は必要ありません。 Claude Codeにコードの移行を任せる ```text /claude-api migrate このプロジェクトをclaude-fable-5-2に移行してください ``` Claude Managed Agentsのエージェントにアドバイザーがある場合、アドバイザーの`model`も更新が必要な2つ目のモデル名です。エージェントのモデルを変更する際に、これを`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/ja/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/ja/models/fable-5-2/whats-new-fable-5-2)を参照してください。動作の違いやモデル固有のプロンプトパターンについては、[Claude Fable 5.2のプロンプト](https://platform.claude.com/docs/ja/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/ja/build-with-claude/claude-platform-on-aws)、および[Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed)で利用できます。[Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)でも利用できます。[Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed)でも利用できます。[Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)でも利用できます。[Claude Mythos 5.2](https://platform.claude.com/docs/ja/models/mythos-5-2/overview)は同じ機能を備えており、[Cyber Verification Program](https://support.claude.com/en/articles/14604842)などのAnthropicの検証プログラムを通じて検証された組織のみが利用できます。 `claude-fable-5-2`と`claude-mythos-5-2`に共通する基本設定は次のとおりです。 * **思考：** 「[adaptive thinking](https://platform.claude.com/docs/ja/build-with-claude/thinking)」（適応型思考）は常に有効で、Claude Fable 5.1から変更はありません。モデルがいつ、どれだけ思考するかを判断し、[エフォート](https://platform.claude.com/docs/ja/build-with-claude/effort)パラメータが思考の深さを制御します。`thinking: {type: "disabled"}`と手動の拡張思考（`thinking: {type: "enabled", budget_tokens: N}`）はどちらも400エラーを返します。 * **エフォート：** 5つの[エフォート](https://platform.claude.com/docs/ja/build-with-claude/effort)レベルすべてがサポートされており、デフォルトは`high`で、Claude Fable 5.1から変更はありません。[Claude Fable 5.2の推奨エフォートレベル](https://platform.claude.com/docs/ja/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)を参照してください。 * **プリフィル：** アシスタントメッセージの「prefill」（プリフィル）は400エラーを返し、Claude Fable 5.1から変更はありません。代わりにシステムプロンプトの指示を使用してください。 * **サンプリングパラメータ：** Claude Fable 5.1と同様に、`temperature`、`top_p`、`top_k`は省略してください。400エラーを返す値については、[サンプリングパラメータ](https://platform.claude.com/docs/ja/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/ja/manage-claude/cmek)」（カスタマー管理の暗号化キー）、すなわちCMEKを使用する組織では、[構造化出力](https://platform.claude.com/docs/ja/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/ja/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`ベータヘッダーを使用すると、レスポンスの`input_transformations`に、削除された各ブロックが`reason: "organization_binding_mismatch"`とともに一覧表示されます。[思考ブロックはそれを生成したアカウントにとどまる](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#account-bound-thinking)を参照してください。 * **コンテキストウィンドウと出力：** デフォルトで[100万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows)を備え、リクエストごとに最大128kの出力トークンをサポートします。 * **料金：** 入力トークン100万あたり8 USD、出力トークン100万あたり40 USDで、Claude Fable 5.1およびClaude Mythos 5.1の10 USDと50 USDと比べて安価です。プロンプトキャッシュの読み取りはトークン100万あたり0.20 USDで、これらのモデルの0.25 USDと比べて安価です。[料金](https://platform.claude.com/docs/ja/about-claude/pricing)を参照してください。 * **データ保持：** どちらのモデルも30日間のデータ保持が必要で、Anthropicが明示的に承認しない限り「zero data retention」（ゼロデータ保持）、すなわちZDRの取り決めの下では利用できず、Claude Fable 5.1およびClaude Mythos 5.1と同様に対象モデル（Covered Models）に指定されています。Claude APIでは、30日間の保持が設定されていない組織またはワークスペースからのリクエストは400 `invalid_request_error`を返します。ZDRの取り決めがある組織は、Anthropicのアカウントチームに連絡するか、個々のワークスペースで保持を設定してください。プラットフォームごとの詳細については、[モデル固有のデータ保持要件](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)を参照してください。 * **Priority Tier：** どちらのモデルも[Priority Tier](https://platform.claude.com/docs/ja/api/service-tiers#supported-models)ではサポートされていません。 * **高速モード：** どちらのモデルも、Messages APIリクエストで[高速モード](https://platform.claude.com/docs/ja/build-with-claude/fast-mode)をサポートしています。[高速モードの利用可能状況](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#feature-availability)に、各モデルのプラットフォームが記載されています。 2つのモデルの違いは次のとおりです。 * **利用可能性：** Claude APIでは、Claude Fable 5.2はアクセス承認を必要としません。Claude Mythos 5.2は、[Cyber Verification Program](https://support.claude.com/en/articles/14604842)などのAnthropicの検証プログラムを通じて検証された組織のみが利用できます。アクセスをリクエストするには、ユースケースに対応するプログラムに申請するか、Anthropicのアカウントチームに連絡してください。 * **レート制限：** Claude Fable 5.2には、Claude Fable 5.1とClaude Fable 5が共有する統合制限とは別に、独自のレート制限があります。Claude Mythos 5.2は、Claude Mythos 5.1およびClaude Mythos 5と1つの統合制限を共有します。[レート制限](https://platform.claude.com/docs/ja/api/rate-limits#rate-limits)を参照してください。 ## Claude Fable 5.1からClaude Fable 5.2への移行 移行はほぼそのまま置き換えるだけで完了します。APIサーフェス、常に有効な適応型思考、強制ツール選択の制限、拒否の処理、`stop_details`カテゴリ、データ保持要件はすべてClaude Fable 5.1と同じです。Claude Fable 5.2はより安価で、入力トークン100万あたり8 USD、出力トークン100万あたり40 USDです（Claude Fable 5.1では10 USDと50 USD）。コードを壊す可能性のある変更は4つあります。以前のターンへの編集を検出する[プレフィックスチェック](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#prefix-check)は、すべてのアカウントに適用されます。Claude Fable 5.1はClaude Fable 5.2の思考ブロックを読み取れません。以前のコンピュータ使用ツールである`computer_20251124`は、Amazon Bedrock以外のすべてのプラットフォームで400エラーを返します。アドバイザーツールでは、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はAmazon Bedrockでは`anthropic.claude-fable-5-2`で、それ以外のすべてのプラットフォームで`claude-fable-5-2`です。各プラットフォームのIDについては、[Claude Fable 5.2](https://platform.claude.com/docs/ja/models/fable-5-2/overview)のモデルページを参照してください。 ### 破壊的変更 1. **プレフィックスチェックはすべてのアカウントに適用される：** Claude Fable 5.2の各`thinking`ブロックは、Claude Fable 5.1と同様に、それに先行する`system`プロンプト、`tools`、会話履歴に対してのみ有効です。Claude Fable 5.2は、アカウントの作成時期にかかわらず、すべてのアカウントに対してこの[プレフィックスチェック](https://platform.claude.com/docs/ja/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/ja/managed-agents/overview)、または[Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/overview)が会話履歴を管理している場合、何も変わりません。コード自体が`messages`配列を構築している場合は、リクエスト間でコードが行う処理を[プレフィックスチェックの影響を受けるユーザー](https://platform.claude.com/docs/ja/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. ``` 同じリクエストボディで再試行してもエラーは解消されません。本番トラフィックを切り替える前にこれらの編集を見つけるには、[コードがプレフィックスを編集しているかどうかを確認する](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#how-to-tell-whether-your-integration-is-impacted)のチェックを、現在使用しているモデル（Claude Fable 5.1またはClaude Opus 5.5）に対して実行してください。`prefix_mismatch_behavior`を設定するとリクエストがチェックにオプトインされるため、どのアカウントからでも機能します。[保持された思考](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking)に、各パターンの修正方法が記載されています。 本番環境では、不一致がコードのバグのみを意味する場合は、`prefix_mismatch_behavior`をデフォルトの`"error"`のままにしてください。編集を修正する間、影響を受けるブロックを削除してその推論なしで続行するには、`"drop_block"`に設定してください。これは長期的な設定ではなく、一時的な対処として扱ってください。[ブロックを削除すると出力トークンが増加する可能性があります](https://platform.claude.com/docs/ja/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/ja/build-with-claude/refusals-and-fallback)によって会話がClaude Fable 5.2からClaude Fable 5.1を含む別のモデルに移動した場合、APIはそのモデルが読み取れないブロックを削除します。リクエストは成功し、削除された入力トークンは課金されません。その後、モデルはその推論なしで動作するため、切り替え後の最初のターンでコストとレイテンシが増加する可能性があります。`thinking-binding-controls-2026-08-01`ベータヘッダーを使用すると、`input_transformations`に、削除された各ブロックが`reason: "model_binding_mismatch"`とともに一覧表示されます。[会話の途中でのモデルの切り替え](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#switching-models)を参照してください。 3. **`computer_20251124`の代わりにコンピュータ使用ツールセットを使用する：** 型が`computer_20251124`の`tools`エントリは、Amazon Bedrock以外のすべてのプラットフォームで400エラーを返します。代わりに`computer_toolset_20260801`ツールセットを宣言してください。ベータヘッダーを削除し、`name`や表示サイズを指定せずにエントリを送信します。その後、[`computer_20251124`からの移行](https://platform.claude.com/docs/ja/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/ja/agents-and-tools/tool-use/advisor-tool)（ベータ）では、アドバイザーはエグゼキューターと同等以上の能力を持つ必要があります。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/ja/models/fable-5-2/migration-guide#fable-5-2-preserved-thinking)を参照）、`prefix_mismatch_behavior`を`"drop_block"`に設定しない限り400エラーを返します。現在のエグゼキューターを維持してアドバイザーのみを変更するには、アドバイザーの`model`を`claude-fable-5-2`に設定してください。すべてのエグゼキューターモデルがこれを受け入れます。Claude Fable 5.2のアドバイザーはアドバイスを暗号化して返すため、コードでアドバイスのテキストを読み取っている場合は、[結果バリアント](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/advisor-tool#result-variants)を参照してください。同じ組み合わせが[Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)のエージェントのアドバイザーにも適用されるため、エージェントのモデルを変更する際は、そのアドバイザーの`model`をこれら2つのモデルのいずれかに設定してください。[モデルの互換性](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/advisor-tool#model-compatibility)および[セッションにアドバイザーを与える](https://platform.claude.com/docs/ja/managed-agents/multiagent-orchestration#give-the-session-an-advisor)を参照してください。 ### 動作の変更 1. **思考を減らすよう求めるプロンプトの行は、`medium`以上のエフォートでモデルの思考を止めない：** Claude Fable 5.1は通常、「熟考せずに直接回答してください」などの行に従います。Anthropicのテストでは、このような行はClaude Fable 5.2が`medium`以上で思考するのを止めませんでした。これらの行を削除し、エフォートレベルを下げてください。[エフォートを調整する](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#calibrate-effort)を参照してください。 2. **より高いエフォートでは、モデルが自身の作業をレビューするためにサブエージェントを起動することがある：** エージェント型コーディング製品において、`xhigh`や`max`などのより高いエフォートレベルで、AnthropicはClaude Fable 5.2がサブエージェントを使用して自身の作業をレビューすることを確認しました。Claude Fable 5.1は同じタスクでこれを行いませんでした。サブエージェントはセッションのコストの大部分を占める可能性があります。[サブエージェントへの期待を設定する](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#set-expectations-for-subagents)を参照してください。 3. **小さな`max_tokens`ではテキストの余地が残らないことがある：** 思考トークンは`max_tokens`に含まれるため、小さな`max_tokens`のリクエストは、`thinking`ブロックの後、テキストの前に`stop_reason: "max_tokens"`で停止することがあります。通常Claude Fable 5.1の思考を抑えるプロンプトの行は、`medium`以上のエフォートではClaude Fable 5.2の思考を抑えません。そのため、Claude Fable 5.1で小さな`max_tokens`に収めるためにこのような行に依存していたリクエストは、Claude Fable 5.2ではテキストの前にトークンを使い切る可能性があります。思考の余地を残すために`max_tokens`を増やすか、より低い[エフォート](https://platform.claude.com/docs/ja/build-with-claude/effort)レベルを選択してください。 プロンプトを引き継ぐ際に確認すべきその他の動作については、[動作の違い](https://platform.claude.com/docs/ja/models/fable-5-2/whats-new-fable-5-2#behavior-differences)を参照してください。 ### 移行チェックリスト * モデル名を`claude-fable-5-1`から`claude-fable-5-2`に更新します。 * 本番トラフィックを移行する前に[レート制限](https://platform.claude.com/docs/ja/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`ベータヘッダーと`prefix_mismatch_behavior: "drop_block"`を使用してセッションを実行し、`input_transformations`をログに記録して、すべての`prefix_binding_mismatch`エントリを修正します。アカウントがClaude Fable 5.1でチェックに引っかかったことがなくても、これを行ってください。 * 本番環境の`prefix_mismatch_behavior`を選択します。`"error"`（デフォルト）、または編集を修正する間の一時的な対処として`"drop_block"`を選択します。[ブロックを削除すると出力トークンが増加する可能性がある](https://platform.claude.com/docs/ja/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/ja/build-with-claude/preserved-thinking#account-bound-thinking)を参照してください。 * 独自の評価で[エフォートスイープ](https://platform.claude.com/docs/ja/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)を再実行し、コストとレイテンシのベースラインを再設定します。 * 引き継ぐシステムプロンプト、スキル、その他の指示を、[以前のモデル向けに書かれた指示を見直す](https://platform.claude.com/docs/ja/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/ja/models/mythos-5-2/overview)は、[Cyber Verification Program](https://support.claude.com/en/articles/14604842)などのAnthropicの検証プログラムを通じて検証された組織向けの、Claude Fable 5.2に対応するモデルです。モデルIDを切り替える前に、組織がClaude Mythos 5.2にアクセスできることを確認してください。 Claude Mythos 5.2は、Claude Fable 5.2と同様に、すべてのアカウントに対して[プレフィックスチェック](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#prefix-check)を適用します。[`prefix_mismatch_behavior`が未設定の場合](https://platform.claude.com/docs/ja/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/ja/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/ja/build-with-claude/preserved-thinking#switching-models)を参照してください。 [アドバイザーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/advisor-tool)（ベータ）では、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/ja/models/fable-5-2/migration-guide#fable-5-2-advisor-pairs)を参照してください。 Claude Mythos 5.2は、`computer_toolset_20260801`ツールセットを通じてコンピュータ使用をサポートします。型が`computer_20251124`の`tools`エントリは、以前のツールが動作するAmazon Bedrockを除くすべてのプラットフォームで400エラーを返します。[`computer_20251124`の代わりにコンピュータ使用ツールセットを使用する](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-computer-use)を参照してください。 Claude Mythos 5.2の料金は、入力トークン100万あたり8 USD、出力トークン100万あたり40 USDで、Claude Mythos 5.1の10 USDと50 USDと比べて安価です。プロンプトキャッシュの読み取りはトークン100万あたり0.20 USDで、0.25 USDと比べて安価です。 ### モデル名を更新する ```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/ja/build-with-claude/preserved-thinking#account-bound-thinking)を参照してください。 * コード自体が`messages`配列を構築している場合は、[以前のターンを編集すると思考ブロックが無効になる](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-edited-history)のチェックを`claude-mythos-5-2`に対して実行し、すべての`prefix_binding_mismatch`エントリを修正して、会話履歴を追記のみにします（[編集とみなされるもの](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#what-counts-as-an-edit)を参照）。追記のみの履歴は、プロンプトキャッシュを有効な状態に保つことにもつながります。 * `stop_reason: "refusal"`を処理し、レスポンスの内容より先に`stop_details.category`を読み取ります。[拒否とフォールバック](https://platform.claude.com/docs/ja/build-with-claude/refusals-and-fallback)を参照してください。 * エフォートスイープを再実行し、コストとレイテンシのベースラインを再設定します。 * 引き継ぐシステムプロンプト、スキル、その他の指示を、[以前のモデル向けに書かれた指示を見直す](https://platform.claude.com/docs/ja/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/ja/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/ja/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/ja/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`カテゴリをカバーする安全性分類器を実行します。Claude Opus 5.5で見たことのあるカテゴリだけでなく、[拒否カテゴリ表](https://platform.claude.com/docs/ja/build-with-claude/refusals-and-fallback#refusal-response)のすべてのカテゴリを処理してください。拒否されたリクエストを別のモデルで再実行するには、`fallbacks: "default"`を設定してそのカテゴリに対してAnthropicが推奨するモデルで再試行するか、独自の再試行を構築してください。このパラメータはClaude APIおよびClaude Models on Google Cloud (Anthropic managed)でベータ版として提供されており、`server-side-fallback-2026-07-01`ベータヘッダーが必要です。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/ja/build-with-claude/refusals-and-fallback)を参照してください。 5. **料金：** Claude Fable 5.2の料金は、入力トークン100万あたり8 USD、出力トークン100万あたり40 USDで、Claude Opus 5.5は4 USDと20 USDです。プロンプトキャッシュの読み取りは、どちらのモデルもトークン100万あたり0.20 USDです。[料金](https://platform.claude.com/docs/ja/about-claude/pricing)を参照してください。 6. **高速モード：** Claude Fable 5.2は、Claude Opus 5.5と同様に、Claude APIのMessages APIリクエストで[高速モード](https://platform.claude.com/docs/ja/build-with-claude/fast-mode)（`speed: "fast"`）をサポートしています。Claude Fable 5.2の高速モードの料金は入力トークン100万あたり16 USD、出力トークン100万あたり80 USDで、Claude Opus 5.5の高速モードは8 USDと40 USDです。[高速モードの料金](https://platform.claude.com/docs/ja/about-claude/pricing#fast-mode-pricing)を参照してください。 Claude Fable 5.2は、同じ`speed: "fast"`設定で、[Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed)でも高速モードをサポートしています。 Claude Fable 5.2は、同じ`speed: "fast"`設定で、[Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed)でも高速モードをサポートしています。そこでの料金はGoogle Cloudが設定します。[クラウドプラットフォームの料金](https://platform.claude.com/docs/ja/about-claude/pricing#cloud-platform-pricing)を参照してください。 Claude Fable 5.2は、Anthropicでホストされるデプロイメントについて[Microsoft FoundryのClaude](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)でも高速モードをサポートしています。そこでは高速モードは別のモデルです。`claude-fable-5-2-fast`デプロイメントにリクエストを送信し、`speed`は省略してください。 Claude Mythos 5.2も、Claude APIのMessages APIリクエストで、Claude Fable 5.2の高速モードの料金で高速モードをサポートしています。[高速モードの利用可能状況](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#feature-availability)に、Claude Mythos 5.2で高速モードを利用できるすべてのプラットフォームが記載されています。 Claude Managed Agentsでは`speed: "fast"`を削除してください。また、[高速モードの利用可能状況](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#feature-availability)に移行先のモデルが記載されていないプラットフォームやホスティングオプションでも削除してください。 7. **CMEK組織での構造化出力：** [カスタマー管理の暗号化キー](https://platform.claude.com/docs/ja/manage-claude/cmek)を使用する組織では、Claude Opus 5.5は[構造化出力](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs)をサポートしていますが、Claude Fable 5.2はサポートしていません。移行するリクエストから`strict: true`と`output_config.format`を削除し、コード内で出力を検証してください。 8. **デフォルトのエフォートは`high`：** Claude Opus 5.5のデフォルトは`medium`であるため、`effort`を省略したリクエストはClaude Fable 5.2では1レベル高く実行されます。リクエストは成功し、変更はコスト、レイテンシ、結果の違いとしてのみ現れます。`effort`を明示的に設定し、独自の評価で[エフォートスイープ](https://platform.claude.com/docs/ja/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/ja/agents-and-tools/tool-use/advisor-tool)（ベータ）では、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/ja/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/ja/api/rate-limits#rate-limits)を確認します。Claude Fable 5.2のレート制限はClaude Opus 5.5のものとは別であり、各ティアでトークン制限が低くなっています。 * コード自体が`messages`配列を構築している場合は、アカウントがClaude Opus 5.5でチェックに引っかかったことがなくても、[プレフィックスチェックはすべてのアカウントに適用される](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-preserved-thinking)のテストを実行します。 * すべての`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/ja/build-with-claude/preserved-thinking#account-bound-thinking)を参照してください。 * Messages APIリクエストで高速モードを使用している場合は、[高速モードの利用可能状況](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#feature-availability)に移行先のモデルが記載されているプラットフォームやホスティングオプションでのみ`speed: "fast"`を維持します。それらのプラットフォームやホスティングオプションでは、[高速モードの料金](https://platform.claude.com/docs/ja/about-claude/pricing#fast-mode-pricing)に照らしてコストのベースラインを再設定します。その他のすべてのプラットフォームやホスティングオプション、およびClaude Managed Agentsでは、`speed: "fast"`を削除します。`fast-mode-2026-02-01`ベータヘッダーは不要です。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/ja/manage-claude/cmek)を使用する組織では、`strict: true`と`output_config.format`を削除し、コード内で出力を検証します。 * `effort`を明示的に設定します。Claude Fable 5.2のデフォルトは`high`で、Claude Opus 5.5のデフォルトは`medium`であるため、これを省略したリクエストは1レベル高く実行されます。その後、独自の評価で[エフォートスイープ](https://platform.claude.com/docs/ja/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)を再実行し、コストとレイテンシのベースラインを再設定します。 * 引き継ぐシステムプロンプト、スキル、その他の指示を、[以前のモデル向けに書かれた指示を見直す](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)と照らし合わせて確認します。 ## Claude Fable 5からClaude Fable 5.2への移行 APIサーフェス、コンテキストウィンドウと出力の制限、トークナイザー、常に有効な適応型思考、拒否の処理はすべてClaude Fable 5と同じです。以下の変更の一部は、Claude Mythos 5からClaude Mythos 5.2に移行する場合にも適用されます。どの変更が該当するかは、[Claude Mythos 5からClaude Mythos 5.2への移行](https://platform.claude.com/docs/ja/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`を返し、[トークンカウント](https://platform.claude.com/docs/ja/build-with-claude/token-counting)エンドポイントも同様です。エラーメッセージについては、[強制的なツール使用はサポートされていません](https://platform.claude.com/docs/ja/api/errors#forced-tool-use-not-supported)を参照してください。 ツール呼び出しを強制せずに得るには、`tool_choice`を`auto`のままにし、指示の中でツール名を指定します。呼び出しがスキーマに一致するよう、ツールに`strict: true`を設定します。[厳密なツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/strict-tool-use)を参照してください。スキーマに準拠したJSONを得るためだけにツールを強制していた場合は、代わりに[JSON出力](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs#usage)を使用してください。[カスタマー管理の暗号化キー](https://platform.claude.com/docs/ja/manage-claude/cmek)を使用する組織では、[構造化出力](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs)は、Claude Fable 5.2およびClaude Mythos 5.2では利用できません。これには厳密なツール使用とJSON出力の両方が含まれます。その場合は、`auto`と指示を維持し、`strict`を省略して、コード内でツール入力を検証してください。 アプリケーションが現在のターンで特定のツール呼び出しを必要とする場合は、最新の`user`ターンの後に[会話途中のシステムメッセージ](https://platform.claude.com/docs/ja/build-with-claude/mid-conversation-system-messages)を追加します。ツール名を指定し、このターンではその呼び出しが必須であることを伝え、応答をその呼び出しから始めるようClaudeに指示します。以前のターンは変更されないため、それらのプロンプトキャッシュヒットと思考ブロックは有効なままです。[会話途中のシステムメッセージ](https://platform.claude.com/docs/ja/build-with-claude/mid-conversation-system-messages)に、これが利用可能なプラットフォームが記載されています。ツールを呼び出してはならないターンでは、`tool_choice: {"type": "none"}`は引き続き機能します。[ツール使用の強制](https://platform.claude.com/docs/ja/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/ja/build-with-claude/preserved-thinking#prefix-check)をすべてのアカウントに適用します。これらのいずれかが変更された後に思考ブロックを送り返すリクエストは400エラーを返し、同じリクエスト本文で再試行してもエラーは解消されません。 Claude Code、claude.ai、[Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)、または[Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/overview)が会話履歴を管理している場合、何も変わりません。コードが`messages`配列を自ら構築する場合は、履歴を追記のみに保ってください。セッション中は`system`と`tools`を固定します。指示やツールの変更は[会話途中のシステムメッセージ](https://platform.claude.com/docs/ja/build-with-claude/mid-conversation-system-messages)で行い、コンテキストの削減はサーバー側の[コンパクション](https://platform.claude.com/docs/ja/build-with-claude/compaction)または[コンテキスト編集](https://platform.claude.com/docs/ja/build-with-claude/context-editing)で行います。[会話途中のシステムメッセージ](https://platform.claude.com/docs/ja/build-with-claude/mid-conversation-system-messages)に、これが利用可能なプラットフォームが記載されています。[プレフィックスを編集せずに変更を加える](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#replace-prefix-edits)では、一般的な編集ごとの代替手段を紹介しています。 本番トラフィックを切り替える前にこれらの編集を見つけるには、[コードがプレフィックスを編集しているかどうかを確認する](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#how-to-tell-whether-your-integration-is-impacted)のチェックを`claude-fable-5-2`に対して実行してください。本番環境では、不一致がコードのバグのみを意味する場合、`prefix_mismatch_behavior`をデフォルトの`"error"`のままにしてください。編集を修正する間、影響を受けるブロックを破棄してその推論なしで続行するには、`thinking-binding-controls-2026-08-01`ベータヘッダーとともに`"drop_block"`に設定します。これは長期的な設定ではなく、一時的な措置として扱ってください：[ブロックを破棄すると出力トークンが増加する可能性があります](https://platform.claude.com/docs/ja/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/ja/build-with-claude/refusals-and-fallback)によって会話がClaude Fable 5.2からClaude Fable 5を含む別のモデルに移った場合、APIはそのモデルが読み取れないブロックを破棄します。リクエストは成功し、破棄された入力トークンは課金されません。`thinking-binding-controls-2026-08-01`ベータヘッダーを使用すると、`input_transformations`に破棄された各ブロックが`reason: "model_binding_mismatch"`とともに一覧表示されます。[会話途中でのモデル切り替え](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#switching-models)を参照してください。 4. **`computer_20251124`の代わりにcomputer useツールセットを使用してください：** Claude Fable 5.2では、Amazon Bedrockを除くすべてのプラットフォームで、`computer_20251124`タイプの`tools`エントリは400エラーを返します。Claude Fable 5はベータヘッダーとともにこれを受け付けます。[`computer_20251124`の代わりにcomputer useツールセットを使用する](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-computer-use)で説明されているように、代わりに`computer_toolset_20260801`ツールセットを宣言してください。 5. **Claude Fable 5.2のエグゼキューターにはClaude Fable 5.2またはClaude Mythos 5.2のアドバイザーが必要です：** [アドバイザーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/advisor-tool)（ベータ）では、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/ja/models/fable-5-2/migration-guide#fable-5-2-advisor-pairs)を参照してください。 ### その他の変更 * **料金：** 入力トークン100万あたり8 USD、出力トークン100万あたり40 USDで、Claude Fable 5の10 USDおよび50 USDと比較して低くなっています。プロンプトキャッシュの読み取りは100万トークンあたり0.20 USDで、1 USDと比較して低くなっています。[料金](https://platform.claude.com/docs/ja/about-claude/pricing)を参照してください。 * **Priority Tier：** Claude Fable 5.2は[Priority Tier](https://platform.claude.com/docs/ja/api/service-tiers#supported-models)でサポートされていません。Claude Fable 5はサポートされています。組織にPriority Tierのコミットメントがある場合は、キャパシティを別途計画してください。 * **メッセージごとのeffort（ベータ）：** プロンプトキャッシュヒットを失わずに会話の途中でeffortを変更するには、リクエスト間で`output_config.effort`を変更する代わりに、[メッセージごとのeffort](https://platform.claude.com/docs/ja/build-with-claude/effort#change-effort-mid-conversation-beta)の`role: "system"`メッセージを送信してください。そのセクションに、これが利用可能なプラットフォームが記載されています。 ### 移行チェックリスト * モデル名を`claude-fable-5`から`claude-fable-5-2`に更新します。 * 本番トラフィックを移行する前に[レート制限](https://platform.claude.com/docs/ja/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`ターンに記述します。アプリケーションがその呼び出しを必要とする場合は、代わりに[会話途中のシステムメッセージ](https://platform.claude.com/docs/ja/build-with-claude/mid-conversation-system-messages)に記載されているプラットフォームで、会話途中の`role: "system"`メッセージに記述します。[カスタマー管理の暗号化キー](https://platform.claude.com/docs/ja/manage-claude/cmek)を使用する組織では、Claude Fable 5.2で厳密なツール使用とJSON出力を利用できません。その場合は、`{type: "auto"}`と指示を維持し、コード内でツール入力を検証します。 * コードが`messages`配列を自ら構築する場合は、`thinking-binding-controls-2026-08-01`ベータヘッダーと`prefix_mismatch_behavior: "drop_block"`を使用してセッションを実行し、`input_transformations`をログに記録して、すべての`prefix_binding_mismatch`エントリを修正します。モデル切り替え後の`model_binding_mismatch`エントリは想定どおりのものです。 * 履歴を追記のみに保ちます：セッション開始時に`system`と`tools`を固定し、セッション途中の変更は`role: "system"`メッセージで行い、コンテキストの削減はサーバー側で行います。[会話途中のシステムメッセージ](https://platform.claude.com/docs/ja/build-with-claude/mid-conversation-system-messages)に、これが利用可能なプラットフォームが記載されています。 * 本番環境の`prefix_mismatch_behavior`を選択します：`"error"`（デフォルト）、または編集を修正する間の一時的な措置として`"drop_block"`です。[ブロックを破棄すると出力トークンが増加する可能性がある](https://platform.claude.com/docs/ja/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/ja/build-with-claude/preserved-thinking#account-bound-thinking)を参照してください。 * Amazon Bedrock以外の場所で`computer_20251124`を介してcomputer useを使用している場合、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"`メッセージ（ベータ）に移します。 * 組織にPriority Tierのコミットメントがある場合は、キャパシティを別途計画します。 * `stop_reason: "refusal"`を処理し、`stop_details.category`を読み取ります。`fallbacks: "default"`（Claude APIおよびClaude Models on Google Cloud (Anthropic managed)でベータ）を検討してください。 * 独自の評価で[effortスイープ](https://platform.claude.com/docs/ja/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)を再実行し、コストとレイテンシのベースラインを再設定します。 * 引き継ぐシステムプロンプト、スキル、その他の指示を、[以前のモデル向けに書かれた指示を見直す](https://platform.claude.com/docs/ja/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/ja/models/mythos-5-2/overview)は、[Cyber Verification Program](https://support.claude.com/en/articles/14604842)などのAnthropicの検証プログラムを通じて検証された組織向けの、Claude Fable 5.2に相当するモデルです。モデルIDを切り替える前に、組織がClaude Mythos 5.2にアクセスできることを確認してください。 [Claude Fable 5からClaude Fable 5.2への移行](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#migrating-from-claude-fable-5-to-claude-fable-5-2)の変更のうち4つは、記載どおりに適用されます： * [強制ツール選択は400エラーを返します](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-forced-tool-choice)。 * [以前のターンを編集すると思考ブロックが無効になります](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-edited-history)（すべてのアカウントで）。 * [`computer_20251124`の代わりにcomputer useツールセットを使用してください](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-computer-use)。 * Claude Fable 5.2またはClaude Mythos 5.2のエグゼキューターは、[アドバイザーとしてこれら2つのモデルのいずれかが必要です](https://platform.claude.com/docs/ja/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/ja/build-with-claude/preserved-thinking#switching-models)を参照してください。Claude Mythos 5.2の料金は、入力トークン100万あたり8 USD、出力トークン100万あたり40 USDで、Claude Mythos 5の10 USDおよび50 USDと比較して低くなっています。プロンプトキャッシュの読み取りは100万トークンあたり0.20 USDで、1 USDと比較して低くなっています。 ### モデル名を更新する ```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/ja/manage-claude/cmek)を使用する組織では、Claude Mythos 5.2で厳密なツール使用とJSON出力を利用できません。その場合は、`auto`と指示を維持し、コード内でツール入力を検証します。 * Amazon Bedrock以外の場所で`computer_20251124`を介してcomputer useを使用している場合、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/ja/build-with-claude/preserved-thinking#account-bound-thinking)を参照してください。 * コードが`messages`配列を自ら構築する場合は、[以前のターンを編集すると思考ブロックが無効になります](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-edited-history)のチェックを`claude-mythos-5-2`に対して実行し、すべての`prefix_binding_mismatch`エントリを修正して、会話履歴を追記のみに保ちます（[何が編集とみなされるか](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#what-counts-as-an-edit)を参照）。追記のみの履歴は、プロンプトキャッシュを有効な状態に保つことにもつながります。 * `stop_reason: "refusal"`を処理し、応答コンテンツの前に`stop_details.category`を読み取ります。[拒否とフォールバック](https://platform.claude.com/docs/ja/build-with-claude/refusals-and-fallback)を参照してください。 * effortスイープを再実行し、コストとレイテンシのベースラインを再設定します。 * 引き継ぐシステムプロンプト、スキル、その他の指示を、[以前のモデル向けに書かれた指示を見直す](https://platform.claude.com/docs/ja/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/ja/models/opus-5/overview)と同じ[Messages API](https://platform.claude.com/docs/ja/build-with-claude/working-with-messages)および[ツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/overview)のパターンを使用します。100万トークンの「context window」（コンテキストウィンドウ）、128kの最大出力トークン、512トークンの「prompt caching」（プロンプトキャッシング）の最小値、および[会話途中のシステムメッセージ](https://platform.claude.com/docs/ja/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は、[エフォート](https://platform.claude.com/docs/ja/build-with-claude/effort)レベルが`high`以下の場合に`thinking: {type: "disabled"}`を受け付けます。Claude Fable 5.2では、[アダプティブ思考](https://platform.claude.com/docs/ja/build-with-claude/thinking)が常に有効で、`thinking: {type: "disabled"}`はどのエフォートレベルでも400エラーを返します。このフィールドを削除し、より低いエフォートレベルでトークン消費を制御してください。思考を無効にして実行していたワークロードについては、思考と応答テキストの両方をカバーする`max_tokens`を見直してください。そのコードが`content[0].text`のように位置でコンテンツを読み取っている場合は、`thinking`ブロックが先頭に来るため、代わりに`type`でコンテンツブロックを選択してください。 2. **強制ツール選択は400エラーを返します：** Claude Opus 5は`tool_choice`の`any`と`tool`を受け付けます。Claude Fable 5.2は両方を拒否します。代わりに何を送信すべきかについては、[強制ツール選択は400エラーを返します](https://platform.claude.com/docs/ja/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/ja/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/ja/build-with-claude/preserved-thinking#switching-models)を参照してください。 5. **ツール呼び出し間のテキストは思考ブロックで返されます：** Claude Opus 5では、モデルがツール呼び出しの間に書くテキストは`text`ブロックとして返されます。Claude Fable 5.2では、その説明は進捗更新の`thinking`ブロックとして、各ツール呼び出しの前に最大1つ返されます。インターフェースでその説明を表示する場合は、`thinking.display`を`"updates"`（ベータ）に設定すると推論は非表示のまま進捗更新をテキストとして受け取れ、`"summarized"`に設定すると両方を受け取れます。その後、`tool_use`ブロックの間にある空でない`thinking`ブロックを表示します。[ツール呼び出し間の進捗更新](https://platform.claude.com/docs/ja/build-with-claude/thinking#progress-updates)を参照してください。 6. **`computer_20251124`の代わりにcomputer useツールセットを使用してください：** Claude Opus 5は、以前の`computer_20251124`ツールをベータヘッダーとともに受け付けます。Claude Fable 5.2はAmazon Bedrockを除くすべてのプラットフォームで、これに対して400エラーを返します。[`computer_20251124`の代わりにcomputer useツールセットを使用する](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-computer-use)を参照してください。 7. **安全性分類器とフォールバック：** Claude Fable 5.2の安全性分類器は、Claude Opus 5の分類器よりも広範な`stop_details`カテゴリをカバーします。`"bio"`などの追加の`stop_details.category`値を想定してください。[拒否カテゴリの表](https://platform.claude.com/docs/ja/build-with-claude/refusals-and-fallback#refusal-response)にあるすべてのカテゴリを処理してください。拒否されたリクエストを別のモデルで再実行するには、`fallbacks: "default"`を設定するか、独自の再試行を構築します。このパラメータはClaude APIおよびClaude Models on Google Cloud (Anthropic managed)でベータ版として提供されており、`server-side-fallback-2026-07-01`ベータヘッダーが必要です。[拒否、フォールバック、課金](https://platform.claude.com/docs/ja/models/fable-5-2/whats-new-fable-5-2#refusals-fallback-and-billing)に、許可されているフォールバック先が記載されています。 8. **料金：** Claude Fable 5.2の料金は、入力トークン100万あたり8 USD、出力トークン100万あたり40 USDで、Claude Opus 5の5 USDおよび25 USDと比較して高くなっています。プロンプトキャッシュの読み取りは100万トークンあたり0.20 USDで、0.50 USDと比較して低くなっています。[料金](https://platform.claude.com/docs/ja/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/ja/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)を参照してください。 10. **高速モード：** Claude Opus 5は、`fast-mode-2026-02-01`ベータヘッダーとともに、[高速モード](https://platform.claude.com/docs/ja/build-with-claude/fast-mode)（`speed: "fast"`）をリサーチプレビューでサポートしています。Claude Fable 5.2は、Claude APIのMessages APIリクエストでヘッダーなしでこれをサポートしています。ヘッダーを送信するリクエストも引き続き機能します。Claude Fable 5.2の高速モードの料金は、入力トークン100万あたり16 USD、出力トークン100万あたり80 USDで、Claude Opus 5の高速モードは10 USDおよび50 USDです。[高速モードの料金](https://platform.claude.com/docs/ja/about-claude/pricing#fast-mode-pricing)を参照してください。 Claude Fable 5.2は、同じ`speed: "fast"`設定で、[Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed)でも高速モードをサポートしています。 Claude Fable 5.2は、同じ`speed: "fast"`設定で、[Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed)でも高速モードをサポートしています。そこでの料金はGoogle Cloudが設定します。[クラウドプラットフォームの料金](https://platform.claude.com/docs/ja/about-claude/pricing#cloud-platform-pricing)を参照してください。 Claude Fable 5.2は、Anthropicでホストされるデプロイメントについて[Microsoft FoundryのClaude](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)でも高速モードをサポートしています。そこでは高速モードは別のモデルです。`claude-fable-5-2-fast`デプロイメントにリクエストを送信し、`speed`は省略してください。 Claude Mythos 5.2も、Claude APIのMessages APIリクエストで、ヘッダーなしで、Claude Fable 5.2の高速モードの料金で高速モードをサポートしています。[高速モードの利用可能状況](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#feature-availability)に、Claude Mythos 5.2で高速モードを利用できるすべてのプラットフォームが記載されています。 Claude Managed Agentsでは`speed: "fast"`を削除してください。また、[高速モードの利用可能状況](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#feature-availability)に移行先のモデルが記載されていない場合も削除してください。 11. **CMEK組織での構造化出力：** [カスタマー管理の暗号化キー](https://platform.claude.com/docs/ja/manage-claude/cmek)を使用する組織では、Claude Opus 5は[構造化出力](https://platform.claude.com/docs/ja/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/ja/agents-and-tools/tool-use/advisor-tool)（ベータ）では、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/ja/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/ja/api/rate-limits#rate-limits)を確認します。Claude Fable 5.2のレート制限はClaude Opus 5のものとは別で、各ティアのトークン制限が低くなっています。 * `thinking: {type: "disabled"}`の設定をすべて削除します。より低いエフォートレベルでトークン消費を制御し、`max_tokens`を見直し、`type`でコンテンツブロックを選択します。 * 空のものも含め、すべてのターンで`thinking`ブロックを変更せずに送り返します。ツール使用ループでは、ツール結果とともに送り返します。[思考ブロックの保持](https://platform.claude.com/docs/ja/build-with-claude/thinking#preserving-thinking-blocks)を参照してください。 * 強制`tool_choice`（`any`または`tool`）を、`auto`と明示的な指示および`strict: true`ツールの組み合わせ、またはJSON出力に置き換えます。[カスタマー管理の暗号化キー](https://platform.claude.com/docs/ja/manage-claude/cmek)を使用する組織では、Claude Fable 5.2で厳密なツール使用とJSON出力を利用できません。その場合は、`auto`と指示を維持し、コード内でツール入力を検証します。 * コードが`messages`配列を自ら構築する場合は、[以前のターンを編集すると思考ブロックが無効になります](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#fable-5-2-edited-history)のチェックを`claude-fable-5-2`に対して実行し、すべての`prefix_binding_mismatch`エントリを修正して、履歴を追記のみに保ちます。 * Amazon Bedrock以外の場所で`computer_20251124`を介してcomputer useを使用している場合、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/ja/build-with-claude/preserved-thinking#account-bound-thinking)を参照してください。 * インターフェースでツール呼び出し間のテキストを表示する場合は、`thinking.display`を`"updates"`（ベータ）または`"summarized"`に設定し、空でない`thinking`ブロックを表示します。 * すべての`stop_details.category`を処理します。明示的な`fallbacks`リストを設定する場合は、Claude Fable 5.2で許可されているフォールバック先のみを指定します。 * Claude APIのMessages APIリクエストで高速モードを使用している場合は、[高速モードの利用可能状況](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#feature-availability)に移行先のモデルが記載されている場合にのみ`speed: "fast"`を維持します。維持する場合は、[高速モードの料金](https://platform.claude.com/docs/ja/about-claude/pricing#fast-mode-pricing)に照らしてコストのベースラインを再設定します。Claude Managed Agentsでは`speed: "fast"`を削除します。`fast-mode-2026-02-01`ベータヘッダーは不要ですが、これを送信するリクエストも引き続き機能します。 * [カスタマー管理の暗号化キー](https://platform.claude.com/docs/ja/manage-claude/cmek)を使用する組織では、`strict: true`と`output_config.format`を削除し、コード内で出力を検証します。 * 独自の評価で[effortスイープ](https://platform.claude.com/docs/ja/build-with-claude/effort#recommended-effort-levels-for-claude-fable-5-2)を再実行し、コストとレイテンシのベースラインを再設定します。 * 引き継ぐシステムプロンプト、スキル、その他の指示を、[以前のモデル向けに書かれた指示を見直す](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-fable-5-2#review-instructions-written-for-earlier-models)と照らし合わせて確認します。 ## Claude Opus 4.8以前からClaude Fable 5.2への移行 まず、置き換えるモデルIDを`claude-opus-4-8`として、[Claude Opus 5からClaude Fable 5.2への移行](https://platform.claude.com/docs/ja/models/fable-5-2/migration-guide#migrating-from-claude-opus-5-to-claude-fable-5-2)を実施してください。Claude Opus 4.8はClaude Opus 5と同様に以下の特徴を持つため、そのセクションはClaude Opus 4.8上のコードにも記載どおりに適用されます： * `thinking: {type: "disabled"}`、強制ツール選択、`computer_20251124`ツール、および高速モードを受け付けます。 * ツール呼び出し間のテキストを`text`ブロックとして返します。 * zero data retention（ZDR）の取り決めの下で利用できます。 * 料金は入力トークン100万あたり5 USD、出力トークン100万あたり25 USDで、プロンプトキャッシュの読み取りは0.50 USDです。 このセクションでは、Claude Opus 5のセクションでカバーされていない違いを補足します。 ### 変更点 1. **思考を省略したリクエストでも思考が実行されます：** Claude Opus 4.8では、要求しない限り思考はオフです。Claude Fable 5.2では、`thinking`フィールドのないリクエストはアダプティブ思考で実行されます。応答には`text`ブロックの前に`thinking`ブロックが含まれる場合があるため、`content[0].text`を読み取る代わりに`type`でコンテンツブロックを選択してください。ツール使用ループでは、空のものも含め、`thinking`ブロックをツール結果とともに変更せずに送り返してください。思考トークンは出力トークンとして課金され、`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トークンで、Claude Opus 4.8の1,024トークンから引き下げられています。短すぎてキャッシュできなかったプロンプトも、コードを変更することなくキャッシュエントリを作成できるようになります。[プロンプトキャッシング](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching#cache-limitations)を参照してください。 3. **Priority Tierはサポートされていません：** Claude Opus 4.8は[Priority Tier](https://platform.claude.com/docs/ja/api/service-tiers#supported-models)をサポートしています。Claude Fable 5.2はサポートしていません。組織にPriority Tierのコミットメントがある場合は、キャパシティを別途計画してください。 4. **アドバイザーツールからの助言は暗号化されて返されます：** [アドバイザーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/advisor-tool)（ベータ）では、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/ja/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/ja/models/opus-5-5/migration-guide#migration-checklist-from-claude-opus-47)のグループから始めて、ご利用のモデル名が記載されたグループまで進めてください。これらのグループは、削除されたサンプリングパラメータやベータヘッダーなど、Claude Opus 4.8より前に行われたリクエストの変更をカバーしています。そのチェックリストの高速モードの項目は、[高速モードの利用可能状況](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#feature-availability)に移行先のモデルが記載されている場合にのみ適用してください。[カスタマー管理の暗号化キー](https://platform.claude.com/docs/ja/manage-claude/cmek)を使用する組織では、Claude Fable 5.2で構造化出力を利用できないため、そこでは`output_config.format`の項目を適用しないでください。代わりにリクエストから`output_format`を削除し、コード内でJSONを検証してください。 ### 移行チェックリスト * 置き換えるモデルIDを`claude-opus-4-8`として、[Claude Opus 5のチェックリスト](https://platform.claude.com/docs/ja/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トークン以上のプロンプトはキャッシュエントリを作成できます。 * 組織にPriority Tierのコミットメントがある場合は、キャパシティを別途計画します。 * アドバイザーツールを使用していて、コードが助言のテキストを読み取っている場合は、その依存関係を削除します：助言は暗号化された`advisor_redacted_result`ブロックとして届きます。 * Claude Opus 4.8向けに調整された設定を引き継ぐのではなく、独自の評価で新たにeffortスイープを実行します。 * Claude Opus 4.7以前の場合は、ご利用のモデルに対応するClaude Opus 5.5ガイドのチェックリストのグループも適用します。[高速モードの利用可能状況](https://platform.claude.com/docs/ja/build-with-claude/fast-mode#feature-availability)に移行先のモデルが記載されていない限り、高速モードの項目は除外します。[カスタマー管理の暗号化キー](https://platform.claude.com/docs/ja/manage-claude/cmek)を使用する組織では、`output_config.format`の項目も除外し、リクエストから`output_format`を削除します。