Claude Opus 5への移行

Claude Opus 5は、Claude Opus 4.8から飛躍的に改善されたモデルであり、深い推論、エージェント型タスクおよび長期的タスク、そしてテスト時の計算スケーリングに優れています。動作の違いやモデル固有のプロンプトパターンについては、Claude Opus 5のプロンプティングを参照してください。

Claude Opus 5は、Claude Opus 4.8と同じ価格（入力トークン100万あたり5米ドル、出力トークン100万あたり25米ドル）でそのまま置き換え可能なアップグレードです。Claudeの価格を参照してください。すでにClaude Opus 4.8で動作しているコードに対しては2つの破壊的変更があり、破壊的変更で説明しています。Claude Opus 5は、Claude Opus 4.8と同じ機能セットをサポートしています。これには、1Mトークンの「context window」（コンテキストウィンドウ）（デフォルトであり、ベータヘッダーは不要）、128kの最大出力トークン、アダプティブ思考、「prompt caching」（プロンプトキャッシング）、バッチ処理、Files API、PDFサポート、ビジョン、およびサーバーサイドとクライアントサイドのツールが含まれますが、2つの例外があります。web fetchはClaude Opus 5では利用できず、Priority TierはClaude Opus 5ではサポートされていません。モデルの対応状況については各ツールのページを参照してください。

Claude Opus 4.8からClaude Opus 5への移行

モデル名を更新する

# Opusへの移行
model = "claude-opus-4-8"  # Before
model = "claude-opus-5"  # After

claude-opus-5は日付サフィックスのない固定のモデルIDであり、claude-opus-4-8やclaude-sonnet-5と同じ命名方式です。

破壊的変更

1. 思考がデフォルトでオン： Claude Opus 4.8では、thinkingフィールドのないリクエストは思考なしで実行されますが、Claude Opus 5では、同じリクエストがアダプティブ思考ありで実行されます。max_tokensは引き続き、思考と応答テキストを合わせた総出力に対するハードリミットであるため、Claude Opus 4.8で思考なしで実行していたワークロードについては見直してください。思考トークンは、思考テキストが返されない場合でも出力トークンとして課金されるため、トークンあたりの価格は変わらないものの、Claude Opus 4.8で思考なしで実行していたワークロードは、Claude Opus 5ではリクエストあたりの出力トークンが増える可能性があります。コスト管理を参照してください。以前の動作を維持するには、次の項目で説明するエフォート上限の範囲内でthinking: {type: "disabled"}を渡してください。なお、思考を無効にすると、モデルがツール呼び出しをプレーンテキストとして出力したり、表示される出力に内部XMLタグを含めたりすることが稀にあるため、可能な場合は思考を有効にしたまま低いエフォートレベルを使用することを推奨します。それができない場合の緩和策については、思考を無効にして実行するを参照してください。

   これに伴い、レスポンスの形状も変わります。思考がオンの場合、レスポンスは最初のtextブロックの前に1つ以上のthinkingブロックで始まることがあり、Claude Opus 5ではthinking.displayのデフォルトが"omitted"であるため、これらのブロックはsignatureとともに空のthinkingフィールドを持って届きます。content[0].textのように位置で応答を読み取るコードや、最初のcontent_block_startイベントをテキストとして扱うストリームハンドラーは、これらのレスポンスで壊れます。代わりに、typeフィールドでコンテンツブロックを選択してください。typeが"text"であるブロックからtextを読み取り、ストリームイベントを処理する際はブロックタイプで分岐してください。空のthinkingフィールドの代わりに読みやすい思考の要約を受け取るには、display: "summarized"を設定してください。思考の表示を制御するを参照してください。

   「tool use」（ツール使用）ループを実行している場合は、ツール結果を返す際に、各アシスタントレスポンスのthinkingブロックを、thinkingフィールドが空のブロックも含めて、完全かつ変更せずにAPIに渡し返してください。コンテンツブロックをタイプでフィルタリングしたり再構築したりするのではなく、受け取ったアシスタントメッセージをそのままエコーしてください。APIは、編集、並べ替え、または部分的に削除された思考ブロックを400エラーで拒否します。思考ブロックの保持を参照してください。

2. 思考の無効化はhighエフォートまでに制限： thinking: {type: "disabled"}で引き続き思考をオフにできますが、エフォートレベルがhigh以下の場合に限られます。thinking: {type: "disabled"}とエフォートxhighまたはmaxを組み合わせたリクエストは400エラーを返します。Claude Opus 4.8はこの組み合わせを受け入れるため、移行前に思考を無効にしているリクエストを監査してください。

   このチェックはリクエストごとに適用されます。すべてのリクエストのエフォートと思考の設定は独立して検証されるため、会話内の以前のリクエストが受け入れられていたとしても、思考を無効にしたままエフォートをxhighまたはmaxに上げたリクエストは拒否されます。

   変更前（Claude Opus 4.8では受け入れられ、Claude Opus 5では拒否される）：

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

   

   変更後（Claude Opus 5）、thinkingフィールドを削除して思考を再度有効にするか：

   client.messages.create(
       model="claude-opus-5",
       max_tokens=16000,
       output_config={"effort": "xhigh"},  # thinking is on by default
       messages=[{"role": "user", "content": "..."}],
   )

   

   または思考を無効にしたままエフォートを下げます：

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

   

推奨される変更

これらは必須ではありませんが、体験を向上させます：

1. 能力が重要な作業ではmaxエフォートをテストする： Claude Opus 5は、エフォートレベルのフルセット（low、medium、high、xhigh、max）をサポートしています。トークン消費よりも最大限の能力が重要な場合は、maxエフォートをテストしてください。最も要求の厳しいタスクでは効果を発揮できますが、トークン使用量の増加に対して収穫逓減を示す場合があり、単純なタスクでは考えすぎる傾向があります。xhighまたはmaxエフォートで実行する場合は、モデルが思考し行動する余地を持てるよう、大きなmax_tokensを設定してください。64kトークンから始めて、そこから調整してください。

2. 自動フォールバックを検討する： Claude Opus 5にはサイバーセキュリティ安全分類器が搭載されており、サイバーカテゴリの拒否はClaude Opus 4.8にフォールバックできます。拒否されたリクエストを別のモデルで自動的に再実行するには、"default"モードのfallbacksパラメータ（fallbacks: "default"）を検討してください。これは、手動で管理するモデルリストの代わりに、拒否カテゴリに基づいて推奨されるフォールバックモデルを選択します。サーバーサイドフォールバックはベータ版です。"default"モードにはserver-side-fallback-2026-07-01ベータヘッダーが必要です。拒否とフォールバックを参照してください。

3. より短いプロンプトをキャッシュする： Claude Opus 5でキャッシュ可能なプロンプトの最小長は512トークンで、Claude Opus 4.8の1,024トークンから引き下げられました。Claude Opus 4.8ではキャッシュするには短すぎたプロンプトでも、コードを変更することなくキャッシュエントリを作成できるようになりました。モデルごとの最小値については、プロンプトキャッシングを参照してください。

4. 会話の途中でツールを変更する（ベータ）： 以前のターンでのプロンプトキャッシングのヒットを無効にすることなく、会話のターン間でツールを追加または削除できます。ベータヘッダーmid-conversation-tool-changes-2026-07-01を送信してください。これは、タスクの進行に応じてツールを段階的に公開したり廃止したりするエージェント型ワークロードに役立ちます。これがない場合、ツールリストを変更するとキャッシュされたプレフィックスが無効になります。

5. 長さと冗長性に関するプロンプトを再調整する： Claude Opus 5では、デフォルトの表示される応答や文書成果物がClaude Opus 4.8よりも長くなり、エフォートを下げても思考量は減りますが、表示される応答が確実に短くなるわけではありません。代わりに、簡潔さや目標の長さを明示的にプロンプトで指示してください。応答の長さと冗長性および文書成果物の長さを参照してください。

6. 引き継がれた検証指示を削除し、スコープを制限する： Claude Opus 5は指示されなくても自身の作業を検証するため、以前のモデル向けに調整されたプロンプトから引き継がれた明示的な検証指示やセルフチェック指示は削除してください。残しておくと過剰な検証を引き起こします。範囲の狭いタスクでは、タスクのスコープを明示的に制限してください。マルチエージェントフレームワークでは、Claude Opus 5は以前のモデルよりも積極的に委任するため、どのシナリオで委任が適切かについて明示的なガイダンスを与えるか、サブエージェントの数に上限を設けてください。タスクスコープと過剰な検証およびサブエージェントの生成を制御するを参照してください。

移行チェックリスト

• モデル名をclaude-opus-4-8からclaude-opus-5に更新します。
• thinkingフィールドなしで実行していたワークロードを確認します。これらはClaude Opus 5では思考ありで実行されます。引き続き総出力（思考と応答テキストの合計）に対するハードリミットであるmax_tokensを見直すか、以前の動作を維持するためにエフォートhigh以下でthinking: {type: "disabled"}を渡してください。思考を無効にする場合は、発生しうる出力アーティファクトとそのプロンプトによる緩和策について、思考を無効にして実行するを確認してください。
• content[0].textや、最初のコンテンツブロックがテキストであると想定するストリームハンドラーなど、位置でコンテンツを読み取るレスポンス解析を更新します。思考がオンの場合、thinkingブロックはtextブロックの前に届きます。代わりにtypeでコンテンツブロックを選択してください。
• ツール使用ループを実行している場合は、ツール結果を返す際にthinkingブロックを完全かつ変更せずに渡し返してください。変更されたブロックは400エラーを返します。思考ブロックの保持を参照してください。
• thinkingフィールドを解析するコードが、それを表示用テキストとしてのみ扱っていることを確認します。Claude Opus 5ではthinking.displayのデフォルトはClaude Opus 4.8と同じく"omitted"であるため、思考ブロックは空のthinkingフィールドを持って届きます。読みやすい要約を受け取るにはdisplay: "summarized"を設定してください。思考の表示を制御するを参照してください。
• 思考を無効にしているリクエストを監査します。thinking: {type: "disabled"}とエフォートxhighまたはmaxの組み合わせは400エラーを返し、これはリクエストごとに適用されます。思考を再度有効にするか、エフォートをhigh以下に下げてください。
• effort設定を再評価します。以前のモデル向けに調整された設定を引き継ぐのではなく、独自の評価で新たにエフォートのスイープを実行してください。lowおよびmediumエフォートはコストとレイテンシの制御手段としてテストする価値があり、トークン消費よりも最大限の能力が重要な場合はmaxエフォートをテストしてください。xhighまたはmaxエフォートで実行する場合は、出発点としてmax_tokensを少なくとも64kに引き上げてください。
• キャッシングの最小値付近のプロンプトを確認します。512トークン以上のプロンプトでキャッシュエントリを作成できるようになり、Claude Opus 4.8の1,024トークンから引き下げられました。
• stop_reason: "refusal"を処理し、拒否されたリクエストを推奨されるフォールバックモデルで自動的に再実行するためにfallbacks: "default"（ベータ）を検討してください。
• 組織がPriority Tierのコミットメントを持っている場合は、キャパシティを別途計画してください。Priority TierはClaude Opus 5ではサポートされていませんが、Claude Opus 4.8では引き続き利用できます。
• エージェント型ワークロードでは、タスクバジェット（ベータ）および会話途中でのツール変更（ベータ）を検討してください。
• 長さと冗長性に関するプロンプトを再調整します。Claude Opus 5ではデフォルトの表示される応答や文書成果物が長くなり、エフォートを下げても思考量は減りますが、表示される応答が確実に短くなるわけではありません。簡潔さや目標の長さを明示的にプロンプトで指示してください。応答の長さと冗長性および文書成果物の長さを参照してください。
• 以前のモデル向けに調整されたプロンプトから引き継がれた検証指示やセルフチェック指示を削除し（Claude Opus 5では過剰な検証を引き起こします）、範囲の狭いタスクではタスクスコープを明示的に制限し、マルチエージェントフレームワークではサブエージェントへの委任を誘導または制限してください。タスクスコープと過剰な検証およびサブエージェントの生成を制御するを参照してください。
• 独自のワークロードでコストとレイテンシのベースラインを再測定します。トークンあたりの価格はClaude Opus 4.8から変わりませんが、思考トークンは出力トークンとして課金されるため、思考なしで実行していたワークロードはリクエストあたりの出力トークンが増える可能性があります。

Claude Opus 4.7からClaude Opus 5への移行

Claude Opus 5は、既存のClaude Opus 4.7のプロンプトや評価に対して、同じ価格（入力トークン100万あたり5米ドル、出力トークン100万あたり25米ドル）で、そのままでも優れたパフォーマンスを発揮するはずです。Claude Opus 4.7と同じ機能セットをサポートしており、これには1Mトークンのコンテキストウィンドウ、128kの最大出力トークン、アダプティブ思考、プロンプトキャッシング、バッチ処理、Files API、PDFサポート、ビジョン、およびサーバーサイドとクライアントサイドのツールが含まれますが、2つの例外があります。web fetchはClaude Opus 5では利用できず、Priority TierはClaude Opus 5ではサポートされていません。また、会話途中のシステムメッセージが追加され、拒否の停止詳細が公開ドキュメント化されています。Claude APIおよびGoogle Cloudでは、Claude Opus 5は安定版のcomputer_toolset_20260801ツールセットとしてのコンピュータ使用と、ウェブページ内のタスク向けのブラウザ使用ツールもサポートしていますが、Claude Opus 4.7はどちらもサポートしていません。以前のcomputer_20251124バージョンを使用した既存の統合は、両方のモデルで変更なく引き続き動作します。既存の統合をアップグレードするには、computer_20251124からの移行を参照してください。

モデル名を更新する

# Opusへの移行
model = "claude-opus-4-7"  # Before
model = "claude-opus-5"  # After

破壊的変更

1. 思考がデフォルトでオン： Claude Opus 4.7では、thinkingフィールドのないリクエストは思考なしで実行されますが、Claude Opus 5では、同じリクエストがアダプティブ思考ありで実行されます。max_tokensは引き続き、思考と応答テキストを合わせた総出力に対するハードリミットであるため、Claude Opus 4.7で思考なしで実行していたワークロードについては見直してください。思考トークンは、思考テキストが返されない場合でも出力トークンとして課金されるため、トークンあたりの価格は変わらないものの、Claude Opus 4.7で思考なしで実行していたワークロードは、Claude Opus 5ではリクエストあたりの出力トークンが増える可能性があります。コスト管理を参照してください。以前の動作を維持するには、次の項目で説明するエフォート上限の範囲内でthinking: {type: "disabled"}を渡してください。なお、思考を無効にすると、モデルがツール呼び出しをプレーンテキストとして出力したり、表示される出力に内部XMLタグを含めたりすることが稀にあるため、可能な場合は思考を有効にしたまま低いエフォートレベルを使用することを推奨します。それができない場合の緩和策については、思考を無効にして実行するを参照してください。

   これに伴い、レスポンスの形状も変わります。思考がオンの場合、レスポンスは最初のtextブロックの前に1つ以上のthinkingブロックで始まることがあり、Claude Opus 5ではthinking.displayのデフォルトが"omitted"であるため、これらのブロックはsignatureとともに空のthinkingフィールドを持って届きます。content[0].textのように位置で応答を読み取るコードや、最初のcontent_block_startイベントをテキストとして扱うストリームハンドラーは、これらのレスポンスで壊れます。代わりに、typeフィールドでコンテンツブロックを選択してください。typeが"text"であるブロックからtextを読み取り、ストリームイベントを処理する際はブロックタイプで分岐してください。空のthinkingフィールドの代わりに読みやすい思考の要約を受け取るには、display: "summarized"を設定してください。思考の表示を制御するを参照してください。

   ツール使用ループを実行している場合は、ツール結果を返す際に、各アシスタントレスポンスのthinkingブロックを、thinkingフィールドが空のブロックも含めて、完全かつ変更せずにAPIに渡し返してください。コンテンツブロックをタイプでフィルタリングしたり再構築したりするのではなく、受け取ったアシスタントメッセージをそのままエコーしてください。APIは、編集、並べ替え、または部分的に削除された思考ブロックを400エラーで拒否します。思考ブロックの保持を参照してください。

2. 思考の無効化はhighエフォートまでに制限： thinking: {type: "disabled"}で思考をオフにできますが、エフォートレベルがhigh以下の場合に限られます。thinking: {type: "disabled"}とエフォートxhighまたはmaxを組み合わせたリクエストは400エラーを返します。Claude Opus 4.7はこの組み合わせを受け入れるため、移行前に思考を無効にしているリクエストを監査してください。

   このチェックはリクエストごとに適用されます。すべてのリクエストのエフォートと思考の設定は独立して検証されるため、会話内の以前のリクエストが受け入れられていたとしても、思考を無効にしたままエフォートをxhighまたはmaxに上げたリクエストは拒否されます。

   変更前（Claude Opus 4.7では受け入れられ、Claude Opus 5では拒否される）：

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

   

   変更後（Claude Opus 5）、thinkingフィールドを削除して思考ありで実行するか：

   client.messages.create(
       model="claude-opus-5",
       max_tokens=16000,
       output_config={"effort": "xhigh"},  # thinking is on by default
       messages=[{"role": "user", "content": "..."}],
   )

   

   または思考を無効にしたままエフォートを下げます：

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

   

変更点

以下の項目は破壊的変更ではありません。モデルIDを切り替えた後に確認する価値のある動作の違いを説明しています。

1. サンプリングパラメータ（変更なし）： temperature、top_p、またはtop_kをデフォルト以外の値に設定すると、Claude Opus 4.7と同様に、Claude Opus 5でも400エラーが返されます。ほとんどのSDKは以前のモデルとの互換性のためにこれらのフィールドを引き続き定義しているため、APIがリクエストを拒否するにもかかわらず、これらを設定するコードは型チェックを通過します。Python SDK（v1.0以降）はこれらを定義しておらず、渡すとTypeErrorが発生します。Opus 4.7への移行時にこれらのパラメータを削除した場合、追加の変更は不要です。

2. エフォートのデフォルトはhigh： Claude Opus 5のエフォートパラメータのデフォルトは、Claude APIおよびClaude Codeでhighです。すでにエフォートを明示的に設定している場合、設定は変わりません。

3. エフォートレベルの再調整： 各エフォートレベルの背後にあるトークン割り当ては、Claude Opus 4.7と比較してClaude Opus 5で変更されており、Claude Opus 5はエフォートレベルのフルセット（low、medium、high、xhigh、max）をサポートしています。Claude Opus 4.7向けに調整された設定を引き継ぐのではなく、独自の評価で新たにエフォートのスイープを実行してください。lowおよびmediumエフォートはコストとレイテンシの制御手段としてテストする価値があり、トークン消費よりも最大限の能力が重要な場合はmaxエフォートをテストしてください。xhighまたはmaxエフォートで実行する場合は、モデルが思考し行動する余地を持てるよう、大きなmax_tokensを設定してください。64kトークンから始めて、そこから調整してください。エフォートを参照してください。

4. 1Mコンテキストウィンドウがデフォルト： Claude Opus 5は、ベータヘッダーなし、長文コンテキストの追加料金なしで、デフォルトで1Mトークンのコンテキストウィンドウ全体を提供します。クライアントが古いモデルとの互換性のためにコンテキストウィンドウのベータヘッダーを渡している場合、Claude Opus 5では削除できます。

5. 会話途中のシステムメッセージ： Claude Opus 5は、messages配列内でユーザーターンの直後にrole: "system"メッセージを受け入れます（配置ルールに従います）。最初から適用される指示には、トップレベルのsystemフィールドを使用してください。Claude Opus 4.7はmessages内のrole: "system"を400エラーで拒否します。指示を更新するためにメッセージ履歴全体を再構築するコードパスを維持している場合は、それらを簡素化し、以前のターンでのプロンプトキャッシングのヒットを保持できます。

6. 拒否の停止詳細： 拒否レスポンスのstop_detailsオブジェクト（Claude Opus 4.7以降で利用可能）が公開ドキュメント化されました。モデルがリクエストを拒否した場合、既存のrefusal停止理由に加えて、拒否のカテゴリを識別します。ベータヘッダーは不要で、オプトアウトはありません。停止理由の処理を参照してください。

7. プロンプトキャッシングの最小値の引き下げ： Claude Opus 5でキャッシュ可能なプロンプトの最小長は512トークンで、Claude Opus 4.7よりも低くなっています。Claude Opus 4.7ではキャッシュするには短すぎたプロンプトでも、コードを変更することなくキャッシュエントリを作成できるようになりました。モデルごとの最小値については、プロンプトキャッシングを参照してください。

8. 高速モード： Claude Opus 5は高速モード（リサーチプレビュー）をサポートしています。高速モードはClaude Opus 4.7では利用できず、speed: "fast"を指定したリクエストはエラーを返します。speed: "fast"パラメータとfast-mode-2026-02-01ベータヘッダーは、Claude Opus 5で変更なく動作します。

推奨される変更

これらは必須ではありませんが、体験を向上させます：

1. 自動フォールバックを検討する： Claude Opus 5にはサイバーセキュリティ安全分類器が搭載されており、サイバーカテゴリの拒否はClaude Opus 4.8にフォールバックできます。拒否されたリクエストを別のモデルで自動的に再実行するには、"default"モードのfallbacksパラメータ（fallbacks: "default"）を検討してください。これは、手動で管理するモデルリストの代わりに、拒否カテゴリに基づいて推奨されるフォールバックモデルを選択します。サーバーサイドフォールバックはベータ版です。"default"モードにはserver-side-fallback-2026-07-01ベータヘッダーが必要です。拒否とフォールバックを参照してください。

2. 会話の途中でツールを変更する（ベータ）： 以前のターンでのプロンプトキャッシングのヒットを無効にすることなく、会話のターン間でツールを追加または削除できます。ベータヘッダーmid-conversation-tool-changes-2026-07-01を送信してください。これは、タスクの進行に応じてツールを段階的に公開したり廃止したりするエージェント型ワークロードに役立ちます。これがない場合、ツールリストを変更するとキャッシュされたプレフィックスが無効になります。

3. 長さと冗長性に関するプロンプトを再調整する： Claude Opus 5では、デフォルトの表示される応答や文書成果物が以前のOpusモデルよりも長くなり、エフォートを下げても思考量は減りますが、表示される応答が確実に短くなるわけではありません。代わりに、簡潔さや目標の長さを明示的にプロンプトで指示してください。応答の長さと冗長性および文書成果物の長さを参照してください。

4. 引き継がれた検証指示を削除し、スコープを制限する： Claude Opus 5は指示されなくても自身の作業を検証するため、以前のモデル向けに調整されたプロンプトから引き継がれた明示的な検証指示やセルフチェック指示は削除してください。残しておくと過剰な検証を引き起こします。範囲の狭いタスクでは、タスクのスコープを明示的に制限してください。マルチエージェントフレームワークでは、Claude Opus 5は以前のモデルよりも積極的に委任するため、どのシナリオで委任が適切かについて明示的なガイダンスを与えるか、サブエージェントの数に上限を設けてください。タスクスコープと過剰な検証およびサブエージェントの生成を制御するを参照してください。

移行チェックリスト

• モデル名をclaude-opus-4-7からclaude-opus-5に更新します（またはエイリアスを更新します）。
• thinkingフィールドなしで実行していたワークロードを確認します。これらはClaude Opus 5では思考ありで実行されます。引き続き総出力（思考と応答テキストの合計）に対するハードリミットであるmax_tokensを見直すか、以前の動作を維持するためにエフォートhigh以下でthinking: {type: "disabled"}を渡してください。思考を無効にする場合は、発生しうる出力アーティファクトとそのプロンプトによる緩和策について、思考を無効にして実行するを確認してください。
• content[0].textや、最初のコンテンツブロックがテキストであると想定するストリームハンドラーなど、位置でコンテンツを読み取るレスポンス解析を更新します。思考がオンの場合、thinkingブロックはtextブロックの前に届きます。代わりにtypeでコンテンツブロックを選択してください。
• ツール使用ループを実行している場合は、ツール結果を返す際にthinkingブロックを完全かつ変更せずに渡し返してください。変更されたブロックは400エラーを返します。思考ブロックの保持を参照してください。
• thinkingフィールドを解析するコードが、それを表示用テキストとしてのみ扱っていることを確認します。Claude Opus 5ではthinking.displayのデフォルトはClaude Opus 4.7と同じく"omitted"であるため、思考ブロックは空のthinkingフィールドを持って届きます。読みやすい要約を受け取るにはdisplay: "summarized"を設定してください。思考の表示を制御するを参照してください。
• 思考を無効にしているリクエストを監査します。thinking: {type: "disabled"}とエフォートxhighまたはmaxの組み合わせは400エラーを返し、これはリクエストごとに適用されます。思考を再度有効にするか、エフォートをhigh以下に下げてください。
• Opus 4.7への移行時にサンプリングパラメータを削除した場合、対応は不要です。400リトライパスとともに再度追加した場合は、そのリトライパスを削除してください。
• effort設定を再評価します。Claude Opus 4.7向けに調整された設定を引き継ぐのではなく、独自の評価で新たにエフォートのスイープを実行してください。コストとレイテンシの制御手段としてlowおよびmediumエフォートをテストし、トークン消費よりも最大限の能力が重要な場合はmaxエフォートをテストしてください。xhighまたはmaxエフォートで実行する場合は、出発点としてmax_tokensを少なくとも64kに引き上げてください。
• コンテキストウィンドウのベータヘッダーをすべて削除します。1Mコンテキストウィンドウは、Claude API、Amazon Bedrock、Google Cloud、およびMicrosoft Foundryでデフォルトです。
• 指示を更新するために会話履歴を再構築している場合は、プロンプトキャッシングのヒットを保持するために、会話途中のシステムメッセージへの切り替えを検討してください。
• 停止理由の処理が拒否時にstop_detailsを読み取ることを確認し（Claude Opus 4.7以降で利用可能、現在は公開ドキュメント化済み）、拒否されたリクエストを推奨されるフォールバックモデルで自動的に再実行するためにfallbacks: "default"（ベータ）を検討してください。
• キャッシングの最小値付近のプロンプトを確認します。512トークン以上のプロンプトでキャッシュエントリを作成できるようになりました。
• web fetchを使用している場合は、代替手段を計画してください。Claude Opus 5では利用できません。
• 組織がPriority Tierのコミットメントを持っている場合は、Priority TierがClaude Opus 5ではサポートされていないことに注意してください。
• Claude Opus 4.7で高速モードを使用していた場合、モデルID以外にリクエストの変更は不要です。speed: "fast"とfast-mode-2026-02-01ベータヘッダーはClaude Opus 5で変更なく動作します。
• エージェント型ワークロードでは、タスクバジェット（ベータ）および会話途中でのツール変更（ベータ）を検討してください。
• 長さと冗長性に関するプロンプトを再調整し、以前のモデル向けに調整されたプロンプトから引き継がれた検証指示やセルフチェック指示を削除してください。
• 選択したエフォートレベルでコストとレイテンシのベースラインを再測定します。トークンあたりの価格はClaude Opus 4.7から変わりませんが、思考トークンは出力トークンとして課金されるため、思考なしで実行していたワークロードはリクエストあたりの出力トークンが増える可能性があります。

Claude Opus 4.6以前のOpusモデルからClaude Opus 5への移行

Claude Opus 5は、既存のClaude Opus 4.6のプロンプトや評価に対して、同じ価格でそのままでも優れたパフォーマンスを発揮するはずですが、移行にあたって知っておくべき動作およびAPIの変更がいくつかあります。これらの変更のほとんどはClaude Opus 4.7で有効になりました。さらに2つ、思考がデフォルトでオンになることと、思考の無効化に対するエフォート上限が、Claude Opus 5で有効になります。これらはすべてこのセクションで扱っているため、Claude Opus 4.6から直接移行するコードに対して完全な内容となっています。Claude Opus 5は、Claude Opus 4.6と同じ機能セットをサポートしています。これには以下が含まれます：

• 標準API価格で長文コンテキストの追加料金なしの1Mトークンのコンテキストウィンドウ
• 128kの最大出力トークン
• アダプティブ思考
• プロンプトキャッシング
• バッチ処理
• Files API
• PDFサポート
• ビジョン
• サーバーサイドとクライアントサイドのツール（bash、コード実行、コンピュータ使用、テキストエディタ、ウェブ検索、MCPコネクタ、メモリ）

2つの例外があります。web fetchはClaude Opus 5では利用できず、Priority TierはClaude Opus 5ではサポートされていません。Claude APIおよびGoogle Cloudでは、Claude Opus 5は安定版のcomputer_toolset_20260801ツールセットとしてのコンピュータ使用と、ウェブページ内のタスク向けのブラウザ使用ツールもサポートしていますが、Claude Opus 4.6以前のOpusモデルはどちらもサポートしていません。以前のcomputer_20251124バージョンを使用した既存の統合は、Claude Opus 5で変更なく引き続き動作します。既存の統合をアップグレードするには、computer_20251124からの移行を参照してください。

モデル名を更新する

# Opusへの移行
model = "claude-opus-4-6"  # Before
model = "claude-opus-5"  # After

破壊的変更

1. 拡張思考の削除: thinking: {type: "enabled", budget_tokens: N} は Claude Opus 4.7 以降のモデルではサポートされなくなり、400 エラーを返します。アダプティブ思考（thinking: {type: "adaptive"}）に切り替え、effort パラメータを使用して思考の深さを制御してください。Claude Opus 5 では、アダプティブ思考はデフォルトでオンです。thinking: {type: "adaptive"} は有効であり、thinking フィールドを完全に省略することと同等です（次の項目を参照）。

   変更前（Claude Opus 4.6）:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

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

   変更後（Claude Opus 5）:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   

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

   アダプティブ思考は、プロンプトと effort パラメータによって制御できます。effort レベルの選択を参照してください。

2. 思考がデフォルトでオン: Claude Opus 4.6 および Claude Opus 4.7 では、thinking フィールドのないリクエストは思考なしで実行されます。Claude Opus 5 では、同じリクエストがアダプティブ思考付きで実行されます。max_tokens は引き続き、思考と応答テキストを合わせた総出力に対するハードリミットであるため、思考なしで実行していたワークロードについては見直してください。思考トークンは、思考テキストが返されない場合でも出力トークンとして課金されます。そのため、トークンあたりの価格は変わりませんが、思考なしで実行していたワークロードは Claude Opus 5 ではリクエストあたりの出力トークンが増える可能性があります。コスト管理を参照してください。以前の動作を維持するには、次の項目の effort 上限の範囲内で thinking: {type: "disabled"} を渡してください。なお、思考を無効にすると、モデルがツール呼び出しをプレーンテキストとして出力したり、内部 XML タグを可視出力に含めたりすることが稀にあります。そのため、可能な場合は思考を有効にしたまま低い effort レベルを使用することを推奨します。それができない場合の緩和策については、思考を無効にして実行するを参照してください。

   これに伴い、レスポンスの形状も変わります。思考がオンの場合、レスポンスは最初の text ブロックの前に 1 つ以上の thinking ブロックで始まることがあります。また、Claude Opus 5 では思考コンテンツがデフォルトで省略されるため（このリストの項目 5）、これらのブロックは signature とともに空の thinking フィールドを持って届きます。content[0].text のように位置で応答を読み取るコードや、最初の content_block_start イベントをテキストとして扱うストリームハンドラは、これらのレスポンスで壊れます。代わりに、type フィールドでコンテンツブロックを選択してください。type が "text" のブロックから text を読み取り、ストリームイベントを処理する際はブロックタイプで分岐してください。

   ツール使用ループを実行している場合は、ツール結果を返す際に、各アシスタントレスポンスの thinking ブロックを、thinking フィールドが空のブロックも含めて、完全かつ変更なしで API に渡してください。コンテンツブロックをタイプでフィルタリングしたり再構築したりするのではなく、受信したアシスタントメッセージをそのままエコーしてください。API は、編集、並べ替え、または部分的に削除された思考ブロックを 400 エラーで拒否します。思考ブロックの保持を参照してください。

3. 思考の無効化は high effort までに制限: thinking: {type: "disabled"} で思考をオフにできますが、effort レベルが high 以下の場合に限られます。thinking: {type: "disabled"} と effort xhigh または max を組み合わせたリクエストは、Claude Opus 5 では 400 エラーを返し、これはリクエストごとに適用されます。移行前に思考を無効にしているリクエストを監査してください。思考を再度有効にするか、effort を high 以下に下げてください。

4. サンプリングパラメータの削除: Claude Opus 5 を含む Claude Opus 4.7 以降のモデルで temperature、top_p、または top_k をデフォルト以外の値に設定すると、400 エラーが返されます。Python SDK（v1.0 以降）ではこれらが定義されておらず、渡すと TypeError が発生します。最も安全な移行パスは、これらのパラメータをリクエストペイロードから完全に省略することです。Claude Opus 5 でモデルの動作を誘導するには、プロンプトを使用することが推奨されます。決定性のために temperature = 0 を使用していた場合、以前のモデルでも同一の出力が保証されていたわけではないことに注意してください。

5. 思考コンテンツがデフォルトで省略: 思考ブロックは Claude Opus 4.7 以降のモデルでも引き続きレスポンスストリームに表示されますが、明示的にオプトインしない限り、その thinking フィールドは空になります。これは、要約された思考テキストを返すことがデフォルトだった Claude Opus 4.6 からのサイレントな変更です。要約された思考コンテンツを復元するには、thinking.display を "summarized" に設定してください。

   PythonTypeScriptC#GoJavaPHPRuby

   

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

   Claude Opus 4.7 以降のモデルでは、デフォルトは "omitted" です。製品が推論をユーザーにストリーミングしている場合、新しいデフォルトでは出力が始まる前に長い一時停止として現れます。思考中の可視的な進捗を復元するには、display: "summarized" を設定してください。詳細については、思考表示の制御を参照してください。

6. トークンカウントの更新: Claude Opus 4.7 では新しいトークナイザーが導入され、Claude Opus 5 を含む後続の Opus モデルもこれを使用します。これは幅広いタスクでのパフォーマンス向上に貢献しており、Claude Opus 4.7 より前のモデルと比較して、テキスト処理時におよそ 1 倍から 1.35 倍のトークンを使用する可能性があります（最大約 35% 増、コンテンツによって異なります）。

   /v1/messages/count_tokens は、Claude Opus 5 に対して Claude Opus 4.6 とは異なるトークン数を返します。トークン効率はワークロードの形状によって異なる場合があります。

   プロンプトによる介入、task_budget、および effort は、コストの制御と適切なトークン使用量の確保に役立ちます。これらの制御はモデルの知能とトレードオフになる可能性があります。コンパクショントリガーを含め、max_tokens パラメータを更新して追加の余裕を持たせてください。Claude Opus 5 は、長文コンテキストの追加料金なしで、標準 API 価格で 1M のコンテキストウィンドウを提供します。

7. プリフィルの削除（Opus 4.6 から引き継ぎ）: アシスタントメッセージのプリフィルは、Claude Opus 5 を含む Claude Opus 4.7 以降のモデルで 400 エラーを返します。代わりに、構造化出力、システムプロンプトの指示、または output_config.format を使用してください。

effort レベルの選択

effort パラメータを使用すると、Claude の知能とトークン消費のバランスを調整し、能力と引き換えに速度の向上とコストの削減を得ることができます。Claude Opus 5 はすべての effort レベルをサポートしており、デフォルトは high です。以前のモデル向けに調整した設定を引き継ぐのではなく、独自の評価で新たに effort スイープを実行してください。

• max: 最も要求の厳しいタスクで効果を発揮できますが、トークン使用量の増加に対して収穫逓減を示す場合があり、単純なタスクでは考えすぎる傾向があります。トークン消費よりも最大の能力が重要な場面でテストしてください。
• xhigh: デフォルトよりも深さが必要な、長時間実行されるエージェント作業やコーディング作業向けの拡張された能力です。
• high: デフォルトです。ほとんどのタスクでトークン使用量と知能のバランスを取ります。
• medium: デフォルトからコストを節約する一段階下の設定で、コストとレイテンシの制御としてテストする価値があります。
• low: 最も効率的です。短くスコープが限定されたタスクや、レイテンシに敏感なワークロード向けに確保してください。

xhigh または max effort で実行する場合は、モデルが思考し行動する余地を持てるように大きな max_tokens を設定してください。64k トークンから始めて、そこから調整してください。このモデルでは、effort は以前のどの Opus よりも重要です。アップグレード時には積極的に実験してください。

動作の変更

Claude Opus 4.7 では、Claude Opus 4.6 からいくつかの動作上の違いが導入されました。これらは API の破壊的変更ではありませんが、プロンプトの更新やスキャフォールディングの削除が必要になる場合があります。これらは、このリストに記載された調整とともに Claude Opus 5 に引き継がれます。

1. 応答の長さはユースケースによって異なる: Claude Opus 4.7 は、固定の冗長性をデフォルトとするのではなく、タスクの複雑さの判断に応じて応答の長さを調整します。これは通常、単純な検索では短い回答になり、オープンエンドな分析ではかなり長い回答になることを意味します。

   製品が特定のスタイルや冗長性の出力に依存している場合は、プロンプトを調整する必要があるかもしれません。たとえば、冗長性を減らすには、「Provide concise, focused responses. Skip non-essential context, and keep examples minimal.」を追加してください。特定の種類の過剰な説明が見られる場合は、それを防ぐための的を絞った指示をプロンプトに追加してください。

   Claude が適切なレベルの簡潔さでコミュニケーションする方法を示す肯定的な例は、否定的な例やモデルに何をしないかを伝える指示よりも効果的な傾向があります。Claude Opus 5 では、デフォルトの可視応答と書面の成果物は以前の Opus モデルよりも長くなり、effort を下げると思考量は減りますが、可視応答が確実に短くなるわけではありません。簡潔さや目標の長さを明示的にプロンプトで指示してください。応答の長さと冗長性を参照してください。

2. より文字通りの指示追従: Claude Opus 4.7 は、特に低い effort レベルにおいて、Claude Opus 4.6 よりもプロンプトをより文字通りかつ明示的に解釈します。ある項目の指示を別の項目に暗黙的に一般化することはなく、行っていないリクエストを推測することもありません。この文字通りの解釈の利点は、精度と無駄な動きの減少です。慎重に調整されたプロンプト、構造化抽出、予測可能な動作が求められるパイプラインを持つ API ユースケースでは、一般的にパフォーマンスが向上します。Claude Opus 5 への移行には、プロンプトとハーネスのレビューが特に役立つ場合があります。

3. より直接的なトーン: 新しいモデルではいつものことですが、長文の文章スタイルが変わる可能性があります。Claude Opus 4.7 は、Claude Opus 4.6 のより温かいスタイルと比べて、より直接的で意見がはっきりしており、肯定を前面に出した言い回しが少なく、絵文字も少なくなっています。製品が特定のボイスに依存している場合は、新しいベースラインに対してスタイルプロンプトを再評価してください。

4. エージェントトレースにおける組み込みの進捗更新: Claude Opus 4.7 は、長いエージェントトレース全体を通じて、より定期的で質の高い更新をユーザーに提供します。中間ステータスメッセージを強制するためのスキャフォールディング（「After every 3 tool calls, summarize progress」）を追加している場合は、削除してみてください。Claude Opus 4.7 のユーザー向け更新の長さや内容がユースケースに適切に調整されていないと感じる場合は、これらの更新がどのようなものであるべきかをプロンプトで明示的に説明し、例を提供してください。

5. サブエージェント生成の変更: Claude Opus 4.7 はデフォルトで Claude Opus 4.6 よりも少ないサブエージェントを生成する傾向がありますが、Claude Opus 5 は以前のモデルよりも積極的にサブエージェントに委任します。この動作はプロンプトによってどちらの方向にも制御できます。サブエージェントが望ましい場合について明示的なガイダンスを与えるか、サブエージェントの数に上限を設けてください。サブエージェント生成の制御を参照してください。

6. より厳格な effort 調整: Claude Opus 4.6 から大きく変わった点として、Claude Opus 4.7 は特に低い側で effort レベルを厳格に尊重します。low と medium では、モデルは要求された以上のことを行うのではなく、求められたことに作業のスコープを限定します。

   これはレイテンシとコストには良いことですが、low effort で実行される中程度に複雑なタスクでは、思考不足のリスクがあります。複雑な問題で浅い推論が見られる場合は、プロンプトで回避するのではなく、effort を high または xhigh に上げてください。

   レイテンシのために effort を low に保つ必要がある場合は、的を絞ったガイダンスを追加してください。「This task involves multistep reasoning. Think carefully through the problem before responding.」Claude Opus 4.7 の推奨 effort レベルを参照してください。

7. デフォルトでツール呼び出しが少ない: Claude Opus 4.7 は、Claude Opus 4.6 よりもツールを使用する頻度が低く、推論をより多く使用する傾向があります。これはほとんどの場合、より良い結果をもたらします。

   ツール使用を増やすには、effort 設定を上げてください。high または xhigh の effort 設定では、エージェント検索やコーディングでツール使用が大幅に増加します。また、ツールをいつどのように適切に使用するかについてモデルに明示的に指示するようにプロンプトを調整することもできます。

8. リアルタイムのサイバーセキュリティ保護: Claude Opus 4.7 で新たに追加されたもので、禁止されているトピックや高リスクのトピックを含むリクエストは拒否につながる可能性があります。ペネトレーションテスト、脆弱性調査、レッドチーミングなどの正当なセキュリティ作業については、Cyber Verification Program に申請して制限の緩和をリクエストしてください。申請ルートは Claude へのアクセス方法によって異なります。

9. 高解像度画像のサポート: Claude Opus 4.7 は、高解像度画像をサポートする最初の Claude モデルです。最大画像解像度は長辺 2,576 ピクセルで、以前のモデルの 1,568 ピクセルから引き上げられました。これにより、ビジョンを多用するワークロードで効果が得られ、特にコンピュータ使用、スクリーンショットの理解、ドキュメント分析に価値があります。

   高解像度サポートは自動であり、ベータヘッダーやクライアント側のオプトインは不要です。計画しておくべき点が 2 つあります。

   • フル解像度の画像は、以前のモデルと比べて最大約 3 倍の画像トークンを使用する可能性があります（画像あたり最大 4,784 トークン。以前の上限は画像あたり約 1,600 トークン）。画像を多用するワークロードでは max_tokens とコストの見込みを再計画するか、追加の忠実度が不要な場合は送信前にダウンサンプリングしてください。
   • モデルが返すポインティング座標とバウンディングボックス座標は、Claude Opus 4.7 では実際の画像ピクセルと 1:1 で対応するため、スケールファクターの変換は不要です。

   詳細については、Claude Opus 4.7 での高解像度画像サポートを参照してください。

推奨される変更

これらは必須ではありませんが、体験を向上させます。

1. max_tokens の再評価: Claude Opus 4.7 以降のモデルでは同じテキストでもトークン数が多くなるため、コンパクショントリガーを含め、max_tokens パラメータを更新して追加の余裕を持たせてください。プロンプトによる介入、task_budget、および effort は、コストの制御と適切なトークン使用量の確保に役立ちます。

2. トークン数の見込みの監査: クライアント側でトークンを推定したり、固定のトークン対文字比率を前提としたりするコードパスは、Claude Opus 5 に対して再テストする必要があります。トークンカウントエンドポイントを使用して検証してください。

3. タスクバジェットの採用（ベータ）: Claude Opus 4.7 ではタスクバジェットが導入されました。これらのバジェットにより、思考、ツール呼び出し、ツール結果、最終出力を含む完全なエージェントループに対して Claude が使用できるトークン数を伝えることができます。モデルは進行中のカウントダウンを確認し、それを使用して作業の優先順位を付け、バジェットが消費されるにつれてタスクを適切に終了します。使用するには、ベータヘッダー task-budgets-2026-03-13 を設定し、出力設定に以下を追加してください。

   PythonTypeScriptC#GoJavaPHPRuby

   

   output_config = {
       "effort": "high",
       "task_budget": {"type": "tokens", "total": 128000},
   }

   ユースケースに応じて、さまざまなタスクバジェットを試す必要があるかもしれません。モデルに与えられたタスクバジェットが制限的すぎる場合、モデルはバジェットを制約として参照しながら、タスクをあまり徹底的に完了しない可能性があります。

   速度よりも品質が重要なオープンエンドのエージェントタスクでは、タスクバジェットを設定しないでください。タスクバジェットは、モデルにトークン許容量に合わせて作業のスコープを限定させる必要があるワークロード向けに確保してください。タスクバジェットの最小値は 20k トークンです。

   タスクバジェットはハードキャップではなく、モデルが認識している提案です。max_tokens とは次のように異なります。

   • task_budget: 完全なエージェントループ全体にわたる助言的な上限です。モデルはこれを確認し、ペース配分に使用します。
   • max_tokens: 生成トークンに対するリクエストごとのハードな上限です。モデルには渡されないため、モデルはこれを認識しません。

   モデルに自己調整させたい場合は task_budget を使用し、使用量を制限するハードな上限として max_tokens を使用してください。

4. max または xhigh effort では大きな max_tokens を設定: Claude Opus 4.7 以降のモデルを max または xhigh effort で実行している場合は、モデルがサブエージェントやツール呼び出し全体で思考し行動する余地を持てるように、大きな最大出力トークンバジェットを設定してください。64k トークンから始めて、そこから調整してください。

5. 高解像度が不要な場合は画像をダウンサンプリング: Claude Opus 4.7 以降のモデルは、最大 2576px / 3.75MP の画像をサポートします。高解像度画像はより多くのトークンを使用します。追加の画像忠実度が不要な場合は、トークン使用量の増加を避けるために、Claude に送信する前に画像をダウンサンプリングしてください。画像とビジョンを参照してください。

6. 自動フォールバックの検討: Claude Opus 5 にはサイバーセキュリティ安全分類器が搭載されており、そのサイバーカテゴリの拒否は Claude Opus 4.8 にフォールバックできます。拒否されたリクエストを別のモデルで自動的に再実行するには、"default" モードの fallbacks パラメータ（fallbacks: "default"）を検討してください。これは、手動で管理するモデルリストの代わりに、拒否カテゴリに基づいて推奨フォールバックモデルを選択します。サーバー側フォールバックはベータ版です。"default" モードには server-side-fallback-2026-07-01 ベータヘッダーが必要です。拒否とフォールバックを参照してください。

7. より短いプロンプトのキャッシュ: Claude Opus 5 でキャッシュ可能なプロンプトの最小長は 512 トークンで、以前の Opus モデルよりも低くなっています。キャッシュするには短すぎたプロンプトでも、コードの変更なしでキャッシュエントリを作成できるようになりました。モデルごとの最小値については、プロンプトキャッシングを参照してください。

8. 会話の途中でツールを変更（ベータ）: 以前のターンでのプロンプトキャッシングのヒットを無効にすることなく、会話のターン間でツールを追加または削除できます。ベータヘッダー mid-conversation-tool-changes-2026-07-01 を送信してください。これは、タスクの進行に応じてツールを段階的に公開したり廃止したりするエージェントワークロードに役立ちます。これがない場合、ツールリストを変更するとキャッシュされたプレフィックスが無効になります。

9. 引き継がれた検証指示の削除とスコープの制約: Claude Opus 5 は指示されなくても自身の作業を検証するため、以前のモデル向けに調整されたプロンプトから引き継がれた明示的な検証指示や自己チェック指示は削除してください。残しておくと過剰な検証を引き起こします。狭いタスクでは、タスクのスコープを明示的に制約してください。タスクスコープと過剰検証を参照してください。

移行チェックリスト

• モデル名を claude-opus-4-6 から claude-opus-5 に更新する（またはエイリアスを更新する）。
• リクエストペイロードから temperature、top_p、top_k を削除する。
• thinking: {type: "enabled", budget_tokens: N} を thinking: {type: "adaptive"} と effort パラメータに置き換えるか、thinking フィールドを完全に削除する。Claude Opus 5 ではアダプティブ思考がデフォルトでオンです。
• thinking フィールドなしで実行していたワークロードを見直す。これらは Claude Opus 5 では思考付きで実行されます。総出力（思考と応答テキスト）に対するハードリミットであり続ける max_tokens を見直すか、以前の動作を維持するために effort high 以下で thinking: {type: "disabled"} を渡してください。
• content[0].text や最初のコンテンツブロックがテキストであると仮定するストリームハンドラなど、位置でコンテンツを読み取るレスポンス解析を更新する。思考がオンの場合、thinking ブロックは text ブロックの前に届きます。代わりに type でコンテンツブロックを選択してください。
• ツール使用ループを実行している場合は、ツール結果を返す際に thinking ブロックを完全かつ変更なしで渡す。変更されたブロックは 400 エラーを返します。思考ブロックの保持を参照してください。
• 思考を無効にしているリクエストを監査する。effort xhigh または max での thinking: {type: "disabled"} は 400 エラーを返し、リクエストごとに適用されます。思考を再度有効にするか、effort を high 以下に下げてください。
• アシスタントメッセージのプリフィルをすべて削除する。
• UI で思考コンテンツを表示している場合は、思考の要約に明示的にオプトインする。
• 更新されたトークン化のもとでエンドツーエンドのコストとレイテンシを再ベンチマークする。思考トークンは出力トークンとして課金されるため、思考なしで実行していたワークロードもリクエストあたりの出力トークンが増える可能性があります。
• 更新されたトークン化を考慮して max_tokens を再調整する。
• クライアント側のトークン数推定を再テストする。
• アプリケーションが画像を送信する場合は、高解像度画像サポートに合わせて再計画する（フル解像度画像あたり最大約 3 倍の画像トークン）。追加の忠実度が不要な場合は、送信前にダウンサンプリングしてください。
• モデルからのポインティング座標やバウンディングボックス座標を使用している場合は、スケールファクターの変換を削除する。Claude Opus 4.7 以降のモデルでは、座標は実際の画像ピクセルと 1:1 で対応します。
• 動作の変更（応答の長さ、文字通りの解釈、トーン、進捗更新、サブエージェント、effort 調整、ツールのトリガー、サイバー保護、高解像度画像の処理）についてプロンプトを見直す。
• 既存の長さ制御プロンプトを削除した状態で応答の長さのベースラインを再設定し、その後明示的に調整する。
• xhigh または max effort を使用する場合は、出発点として max_tokens を少なくとも 64k に引き上げる。
• エージェントワークフロー向けに、タスクバジェット（ベータ）と会話途中のツール変更（ベータ）の採用を検討する。
• stop_reason: "refusal" を処理し、拒否されたリクエストを推奨フォールバックモデルで自動的に再実行するために fallbacks: "default"（ベータ）を検討する。
• キャッシュ最小値付近のプロンプトを見直す。Claude Opus 5 では 512 トークン以上のプロンプトでキャッシュエントリを作成できるようになりました。
• web fetch を使用している場合は、代替手段を計画する。Claude Opus 5 では利用できません。
• 組織が Priority Tier のコミットメントを持っている場合、Priority Tier は Claude Opus 5 ではサポートされていないことに注意する。
• 以前のモデル向けに調整されたプロンプトから引き継がれた検証指示や自己チェック指示を削除する。これらは Claude Opus 5 で過剰な検証を引き起こします。
• 製品が正当なセキュリティ作業を行っている場合は、サイバーコンテンツに対する制限緩和へのアクセスのために Cyber Verification Program に申請する。

Claude Opus 4.5 以前からの移行

Claude Opus 4.5、Opus 4.1、またはそれ以前のモデルから Claude Opus 5 に直接移行する場合は、このセクションの前述のすべての変更に加えて、Opus 4.5 から Opus 4.7 の間に有効になった以下の累積的な変更を適用してください。Opus 4.6 から移行する場合は、このセクションの前述の変更だけで十分です。

モデル名の更新

# Opusへの移行
model = "claude-opus-4-5"  # Before
model = "claude-opus-5"  # After

破壊的変更

1. プリフィルの削除は、Claude Opus 4.6 からの移行における破壊的変更で説明されています。

2. ツールパラメータの引用符処理: Claude Opus 4.6 以降のモデルは、ツール呼び出し引数においてわずかに異なる JSON 文字列エスケープを生成する場合があります（たとえば、Unicode エスケープやスラッシュのエスケープの処理が異なる）。ツール呼び出しの input を JSON パーサーを使用せずに生の文字列として解析している場合は、解析ロジックを検証してください。標準の JSON パーサー（json.loads() や JSON.parse() など）は、これらの違いを自動的に処理します。

推奨される変更

これらの変更は、Claude Opus 4.7 以降のモデルでの体験を向上させます。**（Opus 4.7 では必須）**と記された項目は、Opus 4.6 のリリース時にはオプションの推奨事項でしたが、現在は必須です。残りは引き続き推奨事項です。

1. アダプティブ思考への移行（Opus 4.7 では必須）: thinking: {type: "enabled", budget_tokens: N} は Claude Opus 4.7 以降のモデルで 400 エラーを返します。thinking: {type: "adaptive"} に切り替え、effort パラメータを使用して思考の深さを制御してください。Claude Opus 5 では、thinking: {type: "adaptive"} は thinking フィールドを省略することと同等であり、デフォルトでアダプティブ思考付きで実行されます。思考を参照してください。

   cURLBeforeAfterCLITypeScriptC#GoJavaPHPRuby

   

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

   この移行では、client.beta.messages.create から client.messages.create にも移行することに注意してください。アダプティブ思考と effort には、ベータ SDK 名前空間やベータヘッダーは不要です。

2. effort ベータヘッダーの削除: effort パラメータにはベータヘッダーは不要です。リクエストから betas=["effort-2025-11-24"] を削除してください。

3. きめ細かいツールストリーミングのベータヘッダーの削除: きめ細かいツールストリーミングにはベータヘッダーは不要です。リクエストから betas=["fine-grained-tool-streaming-2025-05-14"] を削除してください。

4. インターリーブ思考のベータヘッダーの削除: アダプティブ思考は、Claude Opus 4.7、Opus 4.6、および Sonnet 4.6 でインターリーブ思考を自動的に有効にします。リクエストから betas=["interleaved-thinking-2025-05-14"] を削除してください。このヘッダーは手動の拡張思考を使用する Sonnet 4.6 では引き続き機能しますが、手動モードは非推奨です。

5. output_config.format への移行: 構造化出力を使用している場合は、output_format={...} を output_config={"format": {...}} に更新してください。API は非推奨の output_format パラメータを引き続き受け付けますが、将来のモデルリリースで削除される予定です。Python SDK（v1.0 以降）は、client.beta.messages.create() または count_tokens() で output_format={...} を受け付けません。parse() および stream() ヘルパーの output_format=Model 引数は変更ありません。

Claude 4.1 以前からの移行

Opus 4.1 以前のモデルから Claude Opus 5 に直接移行する場合は、このセクションの前述のすべての変更に加えて、このサブセクションの追加の変更を適用してください。

# Opus 4.1から
model = "claude-opus-4-1-20250805"  # Before
model = "claude-opus-5"  # After

# Sonnet 3.7から
model = "claude-3-7-sonnet-20250219"  # Before
model = "claude-opus-5"  # After

追加の破壊的変更

1. サンプリングパラメータの削除

   Claude Opus 4.7 以降、temperature、top_p、または top_k をデフォルト以外の値に設定すると 400 エラーが返されます。Python SDK（v1.0 以降）ではこれらが定義されておらず、渡すと TypeError が発生します。最も安全な移行パスは、これらのパラメータをリクエストから完全に省略し、プロンプトを使用してモデルの動作を誘導することです。決定性のために temperature = 0 を使用していた場合、同一の出力が保証されていたわけではないことに注意してください。

   PythonTypeScriptC#GoJavaPHPRuby

   

   # 変更前 - Claude 4以降のモデルではエラーになります
   response = client.messages.create(
       model="claude-3-7-sonnet-20250219",
       temperature=0.7,
       top_p=0.9,  # Non-default sampling params return 400 on Opus 4.7
       # ...
   )
   
   # 変更後
   response = client.messages.create(
       model="claude-opus-5",
       # ...
   )

2. ツールバージョンの更新

   最新のツールバージョンに更新してください。undo_edit コマンドを使用しているコードはすべて削除してください。

   PythonTypeScriptC#GoJavaPHPRuby

   

   # 変更前
   tools = [{"type": "text_editor_20250124", "name": "str_replace_editor"}]
   
   # 変更後
   tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]

   • テキストエディタ: text_editor_20250728 と str_replace_based_edit_tool を使用してください。詳細については、テキストエディタツールのドキュメントを参照してください。
   • コード実行: code_execution_20260521 にアップグレードしてください。移行手順については、コード実行ツールのドキュメントを参照してください。

3. refusal 停止理由の処理

   refusal 停止理由を処理するようにアプリケーションを更新してください。

   PythonTypeScriptC#GoJavaPHPRuby

   

   response = client.messages.create(...)
   
   if response.stop_reason == "refusal":
       # 拒否を適切に処理する
       pass

4. model_context_window_exceeded 停止理由の処理

   Claude 4.5 以降のモデルは、要求された max_tokens の制限ではなく、コンテキストウィンドウの制限に達したために生成が停止した場合、model_context_window_exceeded 停止理由を返します。この新しい停止理由を処理するようにアプリケーションを更新してください。

   PythonTypeScriptC#GoJavaPHPRuby

   

   response = client.messages.create(...)
   
   if response.stop_reason == "model_context_window_exceeded":
       # コンテキストウィンドウの上限を適切に処理する
       pass

5. ツールパラメータ処理の検証（末尾の改行）

   Claude 4.5 以降のモデルは、以前は削除されていたツール呼び出し文字列パラメータの末尾の改行を保持します。ツールがツール呼び出しパラメータに対する正確な文字列マッチングに依存している場合は、ロジックが末尾の改行を正しく処理することを検証してください。

6. 動作の変更に合わせたプロンプトの更新

   Claude 4 以降のモデルは、より簡潔で直接的なコミュニケーションスタイルを持ち、明示的な指示を必要とします。最適化のガイダンスについては、プロンプトのベストプラクティスを確認してください。

追加の推奨される変更

• レガシーベータヘッダーの削除: token-efficient-tools-2025-02-19 と output-128k-2025-02-19 を削除してください。すべての Claude 4 以降のモデルにはトークン効率の高いツール使用が組み込まれており、これらのヘッダーは効果がありません。

移行チェックリスト（Claude Opus 4.5 以前から）

• モデルIDを claude-opus-5 に更新する
• Claude Opus 4.6 からの移行における破壊的変更をすべて適用する（拡張思考の削除、思考がデフォルトで有効、思考無効化時のエフォート上限、サンプリングパラメータの削除、思考表示がデフォルトで省略、トークン化の更新）
• 破壊的変更： アシスタントメッセージのプリフィルを削除する（400エラーが返されます）。代わりに構造化出力または output_config.format を使用する
• Opus 4.7 での破壊的変更： thinking: {type: "enabled", budget_tokens: N} を thinking: {type: "adaptive"} とエフォートパラメータの組み合わせに置き換える（Opus 4.7 では400が返されます）
• ツール呼び出しのJSON解析に標準的なJSONパーサーを使用していることを確認する
• effort-2025-11-24 ベータヘッダーを削除する（エフォートパラメータには不要です）
• fine-grained-tool-streaming-2025-05-14 ベータヘッダーを削除する
• interleaved-thinking-2025-05-14 ベータヘッダーを削除する（アダプティブ思考によりインターリーブ思考が自動的に有効になります）
• output_format を output_config.format に移行する（該当する場合）
• Claude 4.1 以前から移行する場合：temperature、top_p、top_k を削除する（デフォルト以外の値は Opus 4.7 で400が返されます）
• Claude 4.1 以前から移行する場合：ツールバージョンを更新する（text_editor_20250728、code_execution_20260521）
• Claude 4.1 以前から移行する場合：refusal 停止理由を処理する
• Claude 4.1 以前から移行する場合：model_context_window_exceeded 停止理由を処理する
• Claude 4.1 以前から移行する場合：末尾の改行に関するツール文字列パラメータの処理を確認する
• Claude 4.1 以前から移行する場合：レガシーベータヘッダー（token-efficient-tools-2025-02-19、output-128k-2025-02-19）を削除する
• プロンプティングのベストプラクティスに従ってプロンプトを見直し、更新する
• 本番環境へのデプロイ前に開発環境でテストする

Claude Sonnet 5 から Claude Opus 5 への移行

Claude Opus 5 と Claude Sonnet 5 は同じAPIサーフェスを共有しています。どちらもデフォルトでアダプティブ思考が有効な状態で動作し、どちらも Claude API と Claude Code においてエフォートパラメータのデフォルトが high であり、どちらもデフォルトで1Mトークンのコンテキストウィンドウと128kの最大出力トークンを提供し、どちらもPriority Tierをサポートしていません。手動の拡張思考とデフォルト以外のサンプリングパラメータは両モデルで400エラーを返し、アシスタントプリフィルも同様です。

モデル名を更新する

model = "claude-sonnet-5"  # Before
model = "claude-opus-5"  # After

変更点

1. 価格： Claude Opus 5 の価格は、入力トークン100万あたり5米ドル、出力トークン100万あたり25米ドルです。Claude Sonnet 5 の価格は、入力／出力トークン100万あたり2／10米ドルです。完全な価格についてはClaude の価格を参照してください。

2. 思考の無効化は high エフォートが上限： Claude Sonnet 5 では、thinking: {type: "disabled"} はどのエフォートレベルでも受け付けられます。Claude Opus 5 では、エフォートレベルが high 以下の場合にのみ受け付けられます。thinking: {type: "disabled"} とエフォート xhigh または max を組み合わせたリクエストは400エラーを返し、これはリクエストごとに適用されます。移行前に、思考を無効化しているリクエストを監査してください。

3. 会話途中のシステムメッセージ： Claude Opus 5 は、messages 配列内でユーザーターンの直後に role: "system" メッセージを受け付けます（配置ルールに従います）。この機能は Claude Sonnet 5 では利用できません。指示を更新するためにメッセージ履歴全体を再構築するコードパスを維持している場合、それらを簡素化し、以前のターンにおけるプロンプトキャッシングのヒットを維持できます。

4. Web fetch は利用不可： web fetch ツールは Claude Sonnet 5 では利用できますが、Claude Opus 5 では利用できません。

移行チェックリスト

• モデル名を claude-sonnet-5 から claude-opus-5 に更新する。
• 思考を無効化しているリクエストを監査する：thinking: {type: "disabled"} とエフォート xhigh または max の組み合わせは Claude Opus 5 で400エラーを返します。思考を再度有効にするか、エフォートを high 以下に下げてください。
• web fetch を使用している場合は、代替手段を計画する：Claude Opus 5 では利用できません。
• Claude Sonnet 5 に対して計測したカウントを再利用するのではなく、Claude Opus 5 に対してトークンカウントを再実行し、自身のワークロードでコストとレイテンシのベースラインを再設定する。トークンあたりの価格が異なります。