Claude Platform Docs
モデルと料金Claude Opus 5.5

Claude Opus 5.5 移行ガイド

この移行ガイドを参考に、以前のOpusモデルまたはClaude Sonnet 5からClaude Opus 5.5に切り替えてください。Claude Opus 5.5を有効にするためのガイダンスには、エラーを返すリクエスト設定、すべてのレスポンスに含まれる思考ブロック、および移行元モデルごとのチェックリストが含まれます。

Claude Code

Claude Codeにコードの移行を任せる

/claude-api migrate このプロジェクトをclaude-opus-5-5に移行してください

このページでは、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6以前のOpusモデル、またはClaude Sonnet 5からClaude Opus 5.5へ移行する際のコード変更を示します。すべての読者は、Claude Opus 5.5へのすべてのリクエストが満たす必要がある要件とすべてのレスポンスで思考を処理するを確認する必要があります。その後、現在使用しているモデルのセクションに進んでください。各セクションの最初の文に、該当する他のセクションが記載されています。移行チェックリストには、移行元モデルごとにすべての変更点がまとめられています。

Claude Opus 5.5はClaude Opus 5よりも低コストです（入力/出力100万トークンあたり$4 / $20 USD、Claude Opus 5は$5 / $25 USD。Claudeの料金を参照）。機能のサポートについては、Claude Opus 5.5の新機能を参照してください。動作の違いやモデル固有のプロンプトパターンについては、Claude Opus 5.5へのプロンプトを参照してください。

Claude Opus 5.5へのすべてのリクエストが満たす必要がある要件

どのモデルから移行する場合でも、claude-opus-5-5へのリクエストは以下を満たす必要があります。設定が拒否されると記載されている項目では、APIは400エラーを返します。

  • モデルID： 日付サフィックスのない固定モデルIDであるclaude-opus-5-5を使用してください。Amazon Bedrock、Claude Platform on AWS、Claude Models on Google Cloud (Anthropic managed)、Claude Models on Google Cloud (Google managed)、およびMicrosoft Foundryでは、各プラットフォームのモデルIDを使用してください。提供状況を参照してください。
  • 思考： thinkingフィールドを送信しないか、同等であるthinking: {"type": "adaptive"}を送信してください。「adaptive thinking」（適応型思考）は常に有効です。thinking: {"type": "disabled"}および手動の思考予算（thinking: {"type": "enabled", "budget_tokens": N}）は拒否されます。思考の変更前と変更後を参照してください。
  • エフォート： 思考の深さは「effort parameter」（エフォートパラメータ）で制御します。これは思考の深さを制御する唯一のリクエストパラメータです。5つのレベル（low、medium、high、xhigh、max）すべてがサポートされており、デフォルトはmediumです。Claude Opus 5.5の推奨エフォートレベルを参照してください。
  • ツール選択： tool_choiceには{"type": "auto"}（デフォルト）または{"type": "none"}を使用してください。{"type": "any"}または{"type": "tool", "name": "..."}によるツール呼び出しの強制は拒否されます。ツール選択の変更前と変更後を参照してください。
  • サンプリングパラメータ： temperature、top_p、top_kは省略してください。モデルの動作を誘導するにはプロンプトを使用してください。
  • プリフィル： messagesをプリフィルされたアシスタントターンで終わらせないでください。拒否されます。代わりに「structured outputs」（構造化出力）またはシステムプロンプトの指示を使用してください。
  • コンピュータ使用： コンピュータ使用はcomputer_toolset_20260801ツールセットとして宣言してください。Amazon Bedrockでは、computer_20251124も動作します。コンピュータ使用の破壊的変更を参照してください。
  • コンテキストウィンドウ： コンテキストウィンドウ用のベータヘッダーは不要です。100万トークンのコンテキストウィンドウがデフォルトであり、古いモデル向けに送信されたヘッダーは効果がありません。

次のリクエストは、リストのすべての項目を満たしています。エフォートが設定されており、thinkingフィールドはありません。例でテキストを出力する箇所では、thinkingブロックが先頭に来るため、タイプによってテキストブロックを見つけています。

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

for block in response.content:
    if block.type == "text":
        print(block.text)

すべてのレスポンスで思考を処理する

思考はすべてのClaude Opus 5.5リクエストで実行されるため、すべてのレスポンスはthinkingブロックで始まる可能性があり、max_tokensは思考とテキストの両方を対象とします。コードがすでに思考を有効にして実行されている場合、項目1〜3はおそらく対応済みです。項目4と5を確認してください。以前のいずれかのモデルで思考なしで実行されていた場合は、各項目が変更点となります。

  1. max_tokensは思考とテキストの両方を対象とする: Claude Opus 4.8以前のOpusモデルでは、thinkingフィールドのないリクエストは思考なしで実行されます。Claude Opus 5とClaude Sonnet 5はthinking: {"type": "disabled"}を受け付けます。Claude Opus 5.5では、すべてのリクエストが適応型思考で実行されます。max_tokensは引き続き、思考とレスポンステキストを合わせた総出力に対するハードリミットであるため、思考なしで実行されていたワークロードでは見直してください。思考トークンは、思考テキストが返されない場合でも出力トークンとして課金されるため、そのようなワークロードではリクエストあたりの出力トークンが増える可能性があります。コスト管理を参照してください。思考に費やすトークンを減らすには、エフォートレベルを下げてください。xhighまたはmaxエフォートで実行する場合は、モデルが思考して行動する余地を持てるよう、大きなmax_tokensを設定してください。64kトークンから始めて調整してください。プロンプトが思考なしでの実行向けに調整されていた場合は、思考無効化を前提に書かれたプロンプトを参照してください。

  2. レスポンスは思考ブロックで始まる: レスポンスは、最初のtextブロックの前に1つ以上のthinkingブロックで始まる場合があります。content[0].textや、最初のcontent_block_startイベントをテキストとして扱うストリームハンドラーなど、位置によって応答を読み取るコードは、これらのレスポンスで動作しなくなります。代わりにtypeフィールドでコンテンツブロックを選択してください。typeが"text"であるブロックからtextを読み取り、ストリームイベントを処理する際はブロックタイプで分岐してください。

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

  4. 思考テキストはデフォルトで省略される: thinking.displayのデフォルトは"omitted"であるため、thinkingブロックはsignatureとともに空のthinkingフィールドで届きます。thinkingフィールドは表示用テキストとしてのみ扱ってください。代わりに読みやすい要約を受け取るには、thinking.displayを"summarized"に設定してください:

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

    製品が推論をユーザーにストリーミングする場合、デフォルトでは出力が始まる前に長い一時停止が発生するように見えます。思考中に進捗を表示するにはdisplay: "summarized"を設定してください。思考表示の制御を参照してください。

  5. ツール呼び出し間のテキストは思考ブロックで届く: モデルがツール呼び出しの間に書く短いメモはthinkingブロックとして返され、デフォルトの表示設定では空になります。ツール呼び出し間のテキストは思考ブロックで返されるを参照してください。

移行元モデル別の移行チェックリスト

グループを上から順に進め、現在のモデルが記載されたグループで止めてください。そこまでのすべての項目が該当します。Claude Opus 5を使用している場合は、最初のグループがリスト全体です。Claude Sonnet 5を使用している場合は、最初のグループと最後のグループを適用してください。

すべての移行元モデル

  • モデルIDをclaude-opus-5-5に更新します。
  • thinking: {"type": "disabled"}およびthinking: {"type": "enabled", ...}を削除し、代わりにエフォートレベルを選択します。
  • effortを明示的に設定します。デフォルトはmediumですが、Claude Opus 5のデフォルトはhighです。
  • tool_choiceのタイプanyおよびtoolを、autoと厳格なツール使用または構造化出力の組み合わせに置き換えます。
  • 以前のバージョンのコンピュータ使用ツールを使用している場合は、代わりにcomputer_toolset_20260801（ベータヘッダーなし）を宣言し、ツールセットに合わせてエージェントループを更新します。Amazon Bedrockでは、computer_20251124も動作します。
  • ルーターやフォールバックによって会話がClaude Opus 5.5から別のモデルに移る可能性がある場合、そのモデルはClaude Opus 5.5の思考ブロックなしで実行されることを想定してください（Claude API上のClaude Fable 5.1およびClaude Mythos 5.1は例外で、思考ブロックを保持します）。Claude Opus 5.5自体は、Claude Opus 5、以前のOpus、Sonnet、Haikuモデル、そしてClaude APIおよびClaude Models on Google Cloud (Google managed)ではClaude Sonnet 5.5およびClaude Haiku 5.5からの思考を読み取りますが、Claude FableまたはClaude Mythosモデルからの思考は読み取りません。
  • コンテンツブロックはtypeで読み取り、ツール使用ループではthinkingブロックを変更せずに返してください。
  • インターフェースがツール呼び出しの間のテキストをレンダリングする場合は、display: "updates"（ベータ）または"summarized"を設定し、空でないthinkingブロックをレンダリングしてください。
  • コードが会話の途中で以前のターン、systemプロンプト、またはtoolsを編集する場合は、保持された思考に従ってください。
  • stop_reason: "refusal"を処理し、フォールバックを設定してください。
  • 選択したエフォートレベルでコストとレイテンシのベースラインを取り直してください。
  • コードで思考を無効にしていた場合は、思考と応答テキストの両方を対象とするmax_tokensを見直してください。xhighまたはmaxエフォートでは、64kから始めてください。すべての応答で思考を処理するを参照してください。

Claude Opus 4.8以前

  • thinkingフィールドなしで実行されていたワークロードを見直します。Claude Opus 5.5ではそれらは思考ありで実行され、思考を無効にすることはできません。総出力（思考とレスポンステキスト）に対するハードリミットであるmax_tokensを見直し、思考を減らしたい箇所ではeffortを下げます。思考トークンは出力トークンとして課金されるため、これらのワークロードではリクエストあたりの出力トークンが増える可能性があります。
  • thinkingフィールドを解析するコードが、それを表示用テキストとしてのみ扱っていることを確認します。読みやすい要約を受け取るにはdisplay: "summarized"を設定します。
  • キャッシュの最小値付近のプロンプトを見直します。512トークン以上のプロンプトはキャッシュエントリを作成できます。
  • 組織にPriority Tierのコミットメントがある場合は、キャパシティを別途計画します。Priority TierはClaude Opus 5.5ではサポートされていません。
  • xhighまたはmaxエフォートで実行する場合は、出発点としてmax_tokensを少なくとも64kに引き上げます。
  • エージェント型ワークロードでは、タスク予算（ベータ）と会話途中のツール変更（ベータ）を検討します。

Claude Opus 4.7以前

  • 以前のモデル向けに調整された設定を引き継ぐのではなく、独自の評価でエフォートのスイープを新たに実行します。
  • コンテキストウィンドウ用のベータヘッダーをすべて削除します。
  • 指示を更新するために会話履歴を再構築している場合は、プロンプトキャッシュのヒットを維持するために、会話途中のシステムメッセージへの切り替えを検討します。
  • 停止理由の処理で、拒否時にstop_detailsを読み取っていることを確認します。
  • Claude Opus 4.7では拒否される高速モードを使用したい場合は、Claude APIリクエストでspeed: "fast"を設定します。Claude Opus 5.5ではベータヘッダーは不要です。

Claude Opus 4.6以前

  • リクエストペイロードからtemperature、top_p、top_kを削除します。
  • thinking: {"type": "enabled", "budget_tokens": N}をthinking: {"type": "adaptive"}とeffortパラメータの組み合わせに置き換えるか、thinkingフィールドを完全に削除します。適応型思考は常に有効です。
  • UIで思考内容を表示する場合は、思考の要約を明示的にオプトインします。
  • 更新されたトークン化の下で、エンドツーエンドのコストとレイテンシを再ベンチマークします。
  • 圧縮のトリガーを含め、更新されたトークン化を考慮してmax_tokensを再調整します。
  • クライアント側のトークン数の見積もりを再テストします。
  • アプリケーションが画像を送信する場合は、高解像度画像のサポート（フル解像度画像1枚あたり最大約3倍の画像トークン）に合わせて予算を見直します。追加の忠実度が不要な場合は、送信前にダウンサンプリングしてください。
  • モデルからポインティングやバウンディングボックスの座標を取得している場合は、スケール係数の変換を削除します。Claude Opus 4.7以降のモデルでは、座標は実際の画像ピクセルと1:1です。
  • Claude Opus 4.7から始まった動作の変更を確認します。
  • 製品が正当なセキュリティ業務を行っている場合は、サイバー関連コンテンツの制限を緩和したアクセスのためにCyber Verification Programに申請します。

Claude Opus 4.5以前

  • アシスタントメッセージのプリフィルをすべて削除します。Claude Opus 4.6ではすでに拒否されます。
  • ツール呼び出しのJSON解析で標準のJSONパーサーを使用していることを確認します。
  • client.beta.messages.create()からclient.messages.create()に移行します。適応型思考とエフォートにはベータ名前空間は不要です。
  • effort-2025-11-24ベータヘッダーを削除します（effortパラメータには不要です）。
  • fine-grained-tool-streaming-2025-05-14ベータヘッダーを削除します。
  • interleaved-thinking-2025-05-14ベータヘッダーを削除します（適応型思考ではインターリーブ思考が自動的に有効になります）。
  • output_formatをoutput_config.formatに移行します（該当する場合）。

Claude 4.1以前

  • ツールのバージョンを更新します（text_editor_20250728、code_execution_20260521）。
  • refusal停止理由を処理します。
  • model_context_window_exceeded停止理由を処理します。
  • ツールの文字列パラメータにおける末尾の改行の処理を確認します。
  • token-efficient-tools-2025-02-19およびoutput-128k-2025-02-19ベータヘッダーを削除します。
  • プロンプトのベストプラクティスに従ってプロンプトを見直し、更新します。

Claude Sonnet 5のみ

  • 指示を更新するために会話履歴を再構築している場合は、プロンプトキャッシュのヒットを維持するために、会話途中のシステムメッセージへの切り替えを検討します。
  • キャッシュの最小値付近のプロンプトを見直します。512トークン以上のプロンプトはキャッシュエントリを作成できます。

Claude Opus 5からClaude Opus 5.5への移行

まず、Claude Opus 5.5へのすべてのリクエストが満たす必要がある要件とすべてのレスポンスで思考を処理するに対応してください。このセクションの変更は、すべての移行元モデルで必要です。これらは、Claude Opus 5.5が拒否するリクエスト設定と、それに伴うレスポンスの変更です。このセクションのチェックリストは、移行チェックリストの最初のグループです。

モデル名を更新する

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

claude-opus-5-5は日付サフィックスのない固定モデルIDで、claude-opus-5と同じ命名方式です。Amazon Bedrock、Claude Platform on AWS、Claude Models on Google Cloud (Anthropic managed)、Claude Models on Google Cloud (Google managed)、Microsoft Foundryでは、そのプラットフォームのモデルIDを使用してください。提供状況を参照してください。

破壊的変更

各変更については、Claude Opus 5.5の新機能の破壊的変更で説明されています。このセクションでは、それぞれのコード変更を示します。

思考は無効にできない

thinking: {"type": "disabled"}とthinking: {"type": "enabled", "budget_tokens": N}はどちらも400エラーを返します（"thinking.type.disabled" is not supported for this model.または"thinking.type.enabled" is not supported for this model.）。thinkingフィールドを削除し、エフォートレベルを選択してください。トークンを節約するために思考を無効にしていた場合は、より低いレベルを使用してください。その後、レスポンスはthinkingブロックで始まるため、コンテンツブロックをtypeで選択し、ツール結果とともにthinkingブロックを変更せずに返してください。思考は無効にできないを参照してください。

変更前。Claude Opus 5はこのリクエストを受け付けますが、Claude Opus 5.5は400エラーで拒否します:

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

変更後:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    output_config={"effort": "low"},  # thinking is always on; effort is the control
    messages=[{"role": "user", "content": "..."}],
)

強制的なツール使用はサポートされない

tool_choiceのタイプanyとtoolは、トークンカウントエンドポイントを含め、400エラーを返します（tool_choice: type "tool" and "any" are not supported for this model.）。厳格なツール使用または構造化出力とともにautoを使用し、ツールが適用される場面をプロンプトで伝えてください。厳格なツール使用はJSON Schemaのサブセットを受け付けるため、strict: trueを追加する前に各ツールのinput_schemaを確認してください。スキーマ内のすべてのオブジェクトでadditionalProperties: falseを設定する必要があります。JSON Schemaの制限を参照してください。強制的なツール使用はサポートされないを参照してください。

変更前。Claude Opus 5はこのリクエストを受け付けますが、Claude Opus 5.5は400エラーで拒否します:

client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    tools=tools,
    tool_choice={"type": "tool", "name": "get_weather"},
    messages=[{"role": "user", "content": "What's the weather in Paris?"}],
)

変更後:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    # strict tool use（厳密なツール使用）：すべての呼び出しがツールの input_schema に一致します
    tools=[{**tool, "strict": True} for tool in tools],
    tool_choice={"type": "auto"},
    messages=[
        {
            "role": "user",
            "content": "What's the weather in Paris? Use the get_weather tool.",
        }
    ],
)

思考ブロックはモデルと会話に紐付けられる

Claude APIでは、Claude Fable 5.1とClaude Mythos 5.1がClaude Opus 5.5の思考ブロックを読み取ります。それ以外のモデルは読み取りません。会話をClaude Opus 5.5から他のモデルへ移すルーターやフォールバックでは、それらのターンは思考ブロックなしで実行されます。逆方向については、Claude Opus 5.5は、Claude Opus 5、以前のOpus、Sonnet、Haikuモデル、さらにClaude APIおよびClaude Models on Google Cloud (Google managed)ではClaude Sonnet 5.5とClaude Haiku 5.5の思考ブロックを読み取りますが、Claude FableモデルやClaude Mythosモデルの思考ブロックは読み取りません。ブロックが有効なままになるよう、会話は追記のみ（会話の途中でsystemプロンプト、tools、または以前のメッセージを編集しない）に保ってください。Claude Code、claude.ai、Claude Managed Agents、およびClaude Agent SDKはすでにそのようにしています。2026年8月31日00:00 UTC以降に作成されたアカウントでは、Claude APIおよびクラウドプラットフォームにおいて、そのような編集の後に思考ブロックを再送し、かつthinking.block_binding.prefix_mismatch_behaviorを未設定のままにしたリクエストは400エラーになります。追記のみの統合ではコードの変更は不要です。思考ブロックはモデルと会話に紐付けられていますおよび保持された思考を参照してください。

一部のコンピュータ使用ツールのバージョンはサポートされていません

Claude Opus 5.5は、computer_toolset_20260801ツールセットを通じてコンピュータ使用をサポートします。Amazon Bedrockでは、Claude Opus 5.5はcomputer-use-2025-11-24ベータヘッダー付きのcomputer_20251124ツールも受け付けます。Claude Opus 5.5は、受け付けないコンピュータ使用ツールのバージョン（Claude API上のcomputer_20251124など）に対して400エラーを返します。computer_20250124はどのプラットフォームでも受け付けません。Claude APIでは、エラーメッセージは'claude-opus-5-5' does not support tool types: computer_20251124.で始まり、続いてモデルが受け付けるツールタイプが列挙されます。

ツールセットを使用している統合では変更は不要です。computer_20251124の統合をツールセットに移行するには、ベータヘッダーを削除し、nameや表示サイズを指定せずにcomputer_toolset_20260801エントリを送信してください。エージェントループでは、ターン内のすべてのメンバーtool_useブロックを処理し、すべての結果でtoolset_nameをエコーしてください。アクションはinput.actionからではなく、各ブロックのnameから読み取ってください。computer_20251124からの移行に、エージェントループの変更点が記載されています。

変更前。Claude Opus 5はこのリクエストを受け付けますが、Claude Opus 5.5はClaude API上で400エラーを返して拒否します：

client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    betas=["computer-use-2025-11-24"],
    tools=[
        {
            "type": "computer_20251124",
            "name": "computer",
            "display_width_px": 1024,
            "display_height_px": 768,
        }
    ],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

変更後:

client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    # ベータヘッダーは不要です。ツールセットのエントリには name や表示サイズを指定しません
    tools=[{"type": "computer_toolset_20260801"}],
    messages=[{"role": "user", "content": "Open the display settings."}],
)

ツール呼び出し間のテキストは思考ブロックで返される

Claude Opus 5では、モデルがツール呼び出しの間に書くテキストはtextブロックとして返されます。Claude Opus 5.5では、Claude Fable 5.1と同様に、そのナレーションは進捗更新のthinkingブロックとして、各ツール呼び出しの前に最大1つ返されます。thinking.displayがデフォルトの"omitted"の場合、そのthinkingフィールドは空です。リクエストが失敗することはありませんが、そのテキストを進捗更新としてユーザーにストリーミングするアプリケーションは、ツール呼び出しの間に何も表示されなくなります。更新を復元するには、thinkingブロックから読み取り、テキストを返すdisplay値を設定してください。"updates"（ベータ、thinking-display-updates-2026-08-18ヘッダー）は推論を非表示にしたまま進捗更新を返し、"summarized"は両方を混在させて返します。その後、空でない各thinkingブロックを、それに続くtool_useブロックの前に表示し、アシスタントターンの残りの部分とともにブロックを変更せずに返してください。ユーザー向けの進捗更新を参照してください。

安全性分類器とフォールバック

Claude Opus 5.5は、stop_detailsカテゴリとともにstop_reason: "refusal"を返すことがあります。その分類器はClaude Opus 5よりも広範なカテゴリを対象としているため、"cyber"や"reasoning_extraction"に加えて"bio"などのstop_details.category値を想定してください。拒否カテゴリの表を参照してください。拒否を処理し、サーバー側フォールバックまたは独自のリトライを構成してください（サーバー側フォールバックは"reasoning_extraction"で拒否されたリクエストをリトライしません。その拒否はそのまま返されます）。拒否とフォールバックおよびセーフガードによる拒否を参照してください。

  1. エフォートのスイープを再実行する。 Claude Opus 5.5ではエフォートが唯一の思考制御であり、そのデフォルトはmediumです（Claude Opus 5のデフォルトはhigh）。そのため、effortを省略したリクエストはmediumで実行されるようになります。品質が維持される場合はレベルを下げ、最も要求の厳しい作業ではレベルを上げてください。エフォートを参照してください。
  2. モデル固有のプロンプト指示を再評価する。 Claude Opus 5の動作に合わせて調整された指示は、もはや不要かもしれません。Claude Opus 5.5へのプロンプトを参照してください。思考を無効にして実行していた場合は、思考無効化を前提に書かれたプロンプトも参照してください。
  3. 本番トラフィックを切り替える前に、開発環境でテストする。

Claude Opus 4.8からClaude Opus 5.5への移行

まず、Claude Opus 5.5へのすべてのリクエストが満たす必要がある要件、すべてのレスポンスで思考を処理する、およびClaude Opus 5からClaude Opus 5.5への移行に対応してください。置き換えるモデルIDとしてclaude-opus-4-8を使用してください。最後のセクションは、Claude Opus 4.8上のコードにもそのまま当てはまります。Claude Opus 4.8は、Claude Opus 5と同様に次のとおりだからです:

  • thinking: {"type": "disabled"}、強制的なツール選択、およびcomputer_20251124ツールを受け付けます。
  • ツール呼び出し間のテキストをtextブロックとして返します。
  • デフォルトでhighエフォートです。

このセクションでは、Claude Opus 4.8とClaude Opus 5の間で変更された点を補足します。チェックリストについては、移行チェックリストの最初の2つのグループを参照してください。

変更点

  1. 思考を省略していたリクエストでも思考が実行される: Claude Opus 4.8では、要求しない限り思考はオフです。Claude Opus 5.5では、thinkingフィールドのないリクエストは思考ありで実行されるため、すべてのレスポンスで思考を処理するのすべての項目がそのコードにとっての変更点となります。コードでthinkingフィールドを一度も送信していなかった場合、思考の変更前と変更後で削除するものはありません。

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

  3. Priority Tierはサポートされない: Priority TierはClaude Opus 5.5ではサポートされていませんが、Claude Opus 4.8では引き続き利用できます。組織にPriority Tierのコミットメントがある場合は、キャパシティを別途計画してください。

これらは必須ではありませんが、エクスペリエンスが向上します:

  1. タスク予算を検討する（ベータ）： エージェント型のワークロードでは、「task budgets」（タスク予算）によって、完全なエージェントループに使用できるトークン数をモデルに伝えます。これには task-budgets-2026-03-13 ベータヘッダーが必要です。

  2. 会話途中でのツール変更を検討する（ベータ）： 「mid-conversation tool changes」（会話途中でのツール変更）を使用すると、以前のターンにおけるプロンプトキャッシングのキャッシュヒットを無効にすることなく、会話のターン間でツールを追加または削除できます。tools 配列自体を変更すると、キャッシュされたプレフィックスが無効になります。Claude API、Claude Platform on AWS、および Claude Models on Google Cloud (Anthropic managed) では、inline-tools-2026-09-15 ベータヘッダーを送信してください。mid-conversation-tool-changes-2026-07-01 ヘッダーは、参照によってツールを指定する変更については、Claude API、Amazon Bedrock、Claude Platform on AWS、Claude Models on Google Cloud (Anthropic managed)、および Claude Models on Google Cloud (Google managed) で機能します。

Claude Opus 4.7からClaude Opus 5.5への移行

まず、Claude Opus 5.5へのすべてのリクエストが満たす必要がある要件、すべてのレスポンスで思考を処理する、Claude Opus 5からClaude Opus 5.5への移行、およびClaude Opus 4.8からClaude Opus 5.5への移行に対応してください。置き換えるモデルIDとしてclaude-opus-4-7を使用してください。これらのセクションは、Claude Opus 4.7上のコードにもそのまま当てはまります。Claude Opus 4.8と同様に、Claude Opus 4.7はthinking: {"type": "disabled"}、強制的なツール選択、およびcomputer_20251124ツールを受け付けます。デフォルトでhighエフォートであり、要求しない限り思考なしで実行されます。

このセクションでは、Claude Opus 4.7以降に変更された点を補足します。コードがClaude Opus 4.6以前で動作している場合は、このセクションの後にClaude Opus 4.6以前のOpusモデルからClaude Opus 5.5への移行に進んでください。そこでは、Claude Opus 4.7で有効になった破壊的変更を補足しています。チェックリストについては、移行チェックリストの最初の3つのグループを参照してください。

変更点

これらの項目は、前のセクションの破壊的変更に新たな破壊的変更を加えるものではありませんが、モデルIDを切り替えた後に確認する価値があります。

  1. エフォートレベルの再調整： 各エフォートレベルの背後にあるトークン割り当ては、Claude Opus 4.7 と比較して Claude Opus 5.5 で変更されています。デフォルトは medium であり、Claude Opus 4.7 のデフォルトは high です。Claude Opus 4.7 向けに調整された設定を引き継ぐのではなく、独自の評価で改めてエフォートの比較検証を実行してください。エフォートを参照してください。

  2. 1Mコンテキストウィンドウがデフォルト： Claude Opus 5.5 は、ベータヘッダーなしでデフォルトで 1M トークンの完全な「context window」（コンテキストウィンドウ）を提供します。古いモデルとの互換性のためにクライアントがコンテキストウィンドウのベータヘッダーを渡している場合は、それを削除してください。

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

  4. 拒否の停止詳細： モデルがリクエストを拒否した場合、Claude Opus 5.5 は refusal 停止理由とともに、拒否のカテゴリを示す stop_details オブジェクトを返します。Claude Opus 4.7 も同じオブジェクトを返すため、これが問題になるのは、停止理由の処理がまだそれを読み取っていない場合のみです。ベータヘッダーは不要で、オプトアウトはありません。停止理由の処理がまだそれを読み取っていない場合は、停止理由の処理を参照してください。Claude Opus 5.5 はより多くのカテゴリで拒否します。安全性分類器とフォールバックを参照してください。

  5. 高速モード： Claude Opus 5.5 は、Claude API で「fast mode」（高速モード）をサポートしています。高速モードは Claude Opus 4.7 では利用できず、speed: "fast" を指定したリクエストはエラーを返します。リクエストで speed: "fast" を設定してください。Claude Opus 5.5 ではベータヘッダーは不要です。

  6. コンピューター使用ツールセットとブラウザ使用ツール： Claude Opus 5.5 は、computer_toolset_20260801 ツールセットとしての「computer use」（コンピューター使用）と、Webページ内のタスク向けのブラウザ使用ツールをサポートしています。Claude Opus 4.7 はどちらもサポートしていません。computer_20251124 の統合をツールセットに移行するには、コンピューター使用の破壊的変更を参照してください。

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

まず、それより前のすべてのセクションをページ順に確認してください。対象は、Claude Opus 5.5へのすべてのリクエストが満たす必要がある要件、すべてのレスポンスで思考を処理する、およびClaude Opus 5、Claude Opus 4.8、Claude Opus 4.7の各セクションです。これらのセクションは、Claude Opus 4.6上のコードにそのまま適用されます。Claude Opus 4.6はClaude Opus 4.7と同様に、thinking: {"type": "disabled"}、強制ツール選択、およびcomputer_20251124ツールを受け付けます。デフォルトのエフォートはhighで、要求しない限り思考なしで実行されます。Claude Opus 4.5以前のOpusモデルもthinking: {"type": "disabled"}と強制ツール選択を受け付け、要求しない限り思考なしで実行されるため、これらのセクションはそれらのモデルにも適用されます。

このセクションでは、Claude Opus 4.7で変更された点を追加で説明します。置き換えるモデルIDはclaude-opus-4-6です。2つのサブセクションでは、それ以前に変更された点を、Claude Opus 4.5以前およびClaude 4.1以前を使用している読者向けに追加で説明します。チェックリストについては、移行チェックリストの、ご使用のモデルが記載されているグループまでを参照してください。

破壊的変更

  1. 拡張思考の削除： thinking: {"type": "enabled", "budget_tokens": N}は、Claude Opus 4.7以降のモデルではサポートされなくなり、400エラーを返します。適応型思考（thinking: {"type": "adaptive"}）に切り替え、effortパラメータを使用して思考の深さを制御してください。Claude Opus 5.5では、適応型思考は常にオンです。thinking: {"type": "adaptive"}は有効であり、thinkingフィールドを完全に省略した場合と同等です。

    変更前（Claude Opus 4.6）：

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

    変更後（Claude Opus 5.5）。モデルID、thinking、output_configの行が異なります：

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

    適応型思考は、プロンプトとeffortパラメータによって調整できます。effortパラメータは、モデルの推論量を制御する手段として思考バジェットに代わるものです。budget_tokensの値を変換するのではなく、独自の評価でエフォートのスイープを実行してください。エフォートレベルの表では各レベルをいつ使用すべきかを説明しており、Claude Opus 5.5の推奨エフォートレベルではこのモデルについて説明しています。

  2. サンプリングパラメータの削除： temperature、top_p、top_kを省略してください。Claude Opus 5.5でモデルの動作を導くには、プロンプトを使用することが推奨されます。決定性のためにtemperature = 0を使用していた場合、以前のモデルでもそれが同一の出力を保証したことはなかった点に注意してください。

  3. 思考コンテンツがデフォルトで省略される： Claude Opus 4.7以降のモデルでも、思考ブロックは引き続きレスポンスストリームに表示されますが、明示的にオプトインしない限り、そのthinkingフィールドは空になります。これはClaude Opus 4.6からのサイレントな変更であり、Claude Opus 4.6ではデフォルトで要約された思考テキストが返されていました。これを元に戻すには、すべてのレスポンスで思考を処理するの項目4を参照してください。

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

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

    コンパクションのトリガーを含め、max_tokensパラメータを更新して追加の余裕を確保し、クライアント側でトークンを見積もるコードパスや、トークンと文字の比率を固定と仮定しているコードパスを再テストしてください。検証にはトークンカウントエンドポイントを使用してください。プロンプトによる介入、task_budget、およびeffortはコストの制御に役立ちますが、これらの制御はモデルの知性とトレードオフになる場合があります。

  5. プリフィルの削除（Claude Opus 4.6ですでに適用済み）： アシスタントメッセージのプリフィルは、Claude Opus 5.5を含むClaude Opus 4.6以降のOpusモデルで400エラーを返すため、これはClaude Opus 4.5以前から移行する場合にのみ変更となります。代わりに構造化出力またはシステムプロンプトの指示を使用してください。

動作の変更

Claude Opus 4.7では、APIの破壊的変更ではない、Claude Opus 4.6からの動作上の違いが導入されました。次の3つはコードやスキャフォールディングに影響します：

  1. エージェントトレースにおける組み込みの進捗更新： Claude Opus 4.7は、長いエージェントトレース全体を通じて、より定期的で質の高い更新をユーザーに提供します。中間ステータスメッセージを強制するためのスキャフォールディング（「ツール呼び出し3回ごとに進捗を要約する」など）を追加している場合は、削除を試してみてください。Claude Opus 5.5では、これらの更新はthinkingブロックで届きますが、デフォルトのthinking.displayでは空になります。これらを受け取るには、ツール呼び出し間のテキストは思考ブロックで返されるを参照してください。長さや内容を調整するには、ユーザー向けの進捗更新を参照してください。

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

  3. 高解像度画像のサポート： Claude Opus 4.7は、高解像度画像をサポートする最初のClaudeモデルです。最大画像解像度は長辺2,576ピクセルで、以前のモデルの1,568ピクセルから向上しています。これにより、ビジョンを多用するワークロードでの改善が可能になり、特にコンピューター使用、スクリーンショットの理解、ドキュメント分析において価値があります。

    高解像度のサポートは自動的に適用され、ベータヘッダーやクライアント側のオプトインは不要です。計画すべき点が2つあります：

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

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

プロンプト側の違いについては、Claude Opus 5.5のプロンプティングおよびプロンプティングのベストプラクティスを参照してください。

Claude Opus 4.5以前からの移行

Claude Opus 4.5、Claude Opus 4.1、またはそれ以前のモデルからClaude Opus 5.5に直接移行する場合は、このページを最初から読んでください。まず、それより前のすべてのセクションをページ順に確認してください。次に、このセクションの前半にあるClaude Opus 4.6からの移行における破壊的変更を確認してください。その後、Claude Opus 4.5からClaude Opus 4.7までの間に適用された、以下の累積的な変更を適用してください。Claude Opus 4.1以前を使用している場合は、このサブセクションの後にClaude 4.1以前からの移行に進んでください。

破壊的変更

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

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

最初の項目はClaude Opus 5.5では必須であり、残りは推奨事項です。

  1. 適応型思考への移行（必須）： thinking: {"type": "enabled", "budget_tokens": N}は、Claude Opus 4.7以降のモデルで400エラーを返します。変更前と変更後の例は、Claude Opus 4.6からの移行における破壊的変更の項目1にあります。この移行では、client.beta.messages.create()からclient.messages.create()への移行も行います。適応型思考とエフォートには、ベータSDKの名前空間やベータヘッダーは必要ありません。

  2. エフォートのベータヘッダーを削除： effortパラメータにはベータヘッダーは必要ありません。リクエストからeffort-2025-11-24ベータを削除してください。

  3. 細粒度ツールストリーミングのベータヘッダーを削除： 細粒度ツールストリーミングにはベータヘッダーは必要ありません。リクエストからfine-grained-tool-streaming-2025-05-14ベータを削除してください。

  4. インターリーブ思考のベータヘッダーを削除： 適応型思考では、適応型思考をサポートするすべてのモデルでインターリーブ思考が自動的に有効になります。リクエストからinterleaved-thinking-2025-05-14ベータを削除してください。

  5. output_config.formatへの移行： 構造化出力を使用している場合は、output_format={...}をoutput_config={"format": {...}}に更新してください。output_formatパラメータは非推奨であり、将来削除される予定です。それでも使用する場合は、structured-outputs-2025-11-13ベータヘッダーを追加してください。これがない場合、APIは400エラーを返します。Python SDK（v1.0以降）は、client.beta.messages.create()またはcount_tokens()でoutput_format={...}を受け付けません。parse()およびstream()ヘルパーのoutput_format=Model引数は変更されていません。

Claude 4.1以前からの移行

Claude Opus 4.1以前のモデルからClaude Opus 5.5に直接移行する場合は、まずClaude Opus 4.5以前からの移行のすべてを適用してください。そのサブセクションはそれより前のすべてのセクションから始まるため、実質的にこのページを最初から読むことになります。その後、このサブセクションの追加の変更を適用してください。

追加の破壊的変更

  1. サンプリングパラメータを削除する： サンプリングパラメータの削除で説明しています。

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

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

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

# 変更後
tools = [{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
    • テキストエディタ： text_editor_20250728とstr_replace_based_edit_toolを使用してください。詳細はテキストエディタツールのドキュメントを参照してください。
    • コード実行： code_execution_20260521にアップグレードしてください。移行手順についてはコード実行ツールのドキュメントを参照してください。
    • コンピュータ使用： Claude Opus 5.5が受け付けないcomputer_20250124の代わりに、computer_toolset_20260801ツールセットを使用してください。Amazon Bedrockでは、computer_20251124も動作します。コンピュータ使用の破壊的変更を参照してください。

  3. refusal停止理由を処理する

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

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

if response.stop_reason == "refusal":
    # 拒否を適切に処理します
    pass

  4. model_context_window_exceeded停止理由を処理する

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

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

if response.stop_reason == "model_context_window_exceeded":
    # コンテキストウィンドウの上限に適切に対処します
    pass

  5. ツールパラメータの処理を確認する（末尾の改行）

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

  6. 動作の変更に合わせてプロンプトを更新する

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

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

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

Claude Opus 5.5へのすべてのリクエストが満たす必要がある要件、すべてのレスポンスで思考を処理する、およびClaude Opus 5からClaude Opus 5.5への移行を確認してください。置き換えるモデルIDとしてclaude-sonnet-5を使用してください。最後のセクションはClaude Sonnet 5上のコードにそのまま適用されます。なぜなら、Claude Sonnet 5はClaude Opus 5と同様に、次の特徴を持つからです：

  • デフォルトで思考がオンの状態で実行され、thinking: {"type": "disabled"}を受け付けます（Claude Sonnet 5の場合は任意のエフォートレベルで）。
  • 強制ツール選択とcomputer_20251124ツールを受け付けます。
  • ツール呼び出し間のテキストをtextブロックとして返します。
  • デフォルトのエフォートはhighです。

手動の拡張思考、サンプリングパラメータ、およびアシスタントのプリフィルは、どちらのモデルでも400エラーを返すため、これらについては何も変わりません。Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6の各セクションにある必須の変更は、いずれも該当しません。

変更点

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

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

このページは役に立ちましたか？