Claude Sonnet 5.5への移行

このガイドでは、Claude Sonnet 5、Claude Sonnet 4.6、Claude Sonnet 4.5、Claude Sonnet 4、Claude 3.7 Sonnet、またはClaude Haiku 4.5からClaude Sonnet 5.5へ移行する際のコード変更を説明します。最初の2つのセクションを読んだ後、現在のモデルに対応するセクションまで読み進めてください。移行チェックリストには、すべての変更が移行元モデルごとに記載されています。

Claude Sonnet 5.5の料金はClaude Sonnet 5と同じです。Claudeの料金を参照してください。「context window」（コンテキストウィンドウ）と出力の上限については、Claude Sonnet 5.5モデルページを参照してください。機能とプロンプトについては、Claude Sonnet 5.5の新機能およびClaude Sonnet 5.5へのプロンプトを参照してください。

Claude Sonnet 5.5にリクエストを送信する

このリクエストは、記載どおりのままClaude Sonnet 5.5で動作します。「effort」（エフォート）レベルを設定し、SDKのタブではブロックタイプごとに応答を読み取ります。400エラーを返す次の5つの設定は含まれていません：「thinking budget」（思考予算）、サンプリングパラメータ、アシスタントのプリフィル、強制ツール選択、thinking: {"type": "disabled"}。

client = anthropic.Anthropic()

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

print(f"Stop reason: {response.stop_reason}")
for block in response.content:
    if block.type == "text":
        print(block.text)

思考はデフォルトで実行される

Claude Sonnet 5.5では、thinkingフィールドのないリクエストは、thinking: {"type": "adaptive"}と同様に「adaptive thinking」（適応型思考）で実行されます。Claude Sonnet 4.6以前のモデルおよびClaude Haiku 4.5では、そのようなリクエストは思考なしで実行されていました。事前の思考なしで引き続き実行するには、事前の思考をオフにするを参照してください。

レスポンス内の思考を処理する

思考なしで実行されていたコードには、3つの項目すべてが必要です。Claude Sonnet 5からのコードには、おそらく最初の2つがすでに含まれています。

• コンテンツブロックをtypeで読み取ります。 レスポンスはthinkingブロックで始まる場合があるため、content[0].textを読み取るコードは動作しなくなります。
• thinkingブロックを変更せずに返します。 ツール使用ループでは、空のブロックも含めて返してください。思考ブロックの保持を参照してください。
• max_tokensを見直します。 これは思考とテキストの両方をカバーし、思考トークンは出力トークンとして課金されます。コスト管理を参照してください。

思考テキストはデフォルトで省略されます。thinkingブロックは、空のthinkingフィールドとsignatureを伴って届きます。読み取り可能な要約を取得するには、display: "summarized"を設定します。これはClaude Sonnet 4.6以前のモデルおよびClaude Haiku 4.5でのデフォルトです。思考表示の制御を参照してください。

事前の思考をオフにする

Claude Sonnet 5.5で事前の思考をオフにするには、thinking: {"type": "between_tools"}を送信します。これは最も低い思考設定です。ツール呼び出し間の進捗更新は、引き続き要約テキスト付きのthinkingブロックとして返されます。ツールがない場合、レスポンスにはテキストのみが含まれます。Claude Sonnet 5では代わりにthinking: {"type": "disabled"}で思考をオフにし、それ以前のモデルはデフォルトで思考なしで実行されます。Claude Sonnet 5.5では、disabledは400 invalid_request_errorを返します：

"thinking.type.disabled" is not supported for this model. Use "thinking.type.between_tools" for the lowest thinking setting, or "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

between_toolsは、Claude Sonnet 5.5を提供するすべてのプラットフォームで、ベータヘッダーなしで動作します。low、medium、highのエフォートで受け付けられます。xhighまたはmaxでは400エラーを返します。これらのレベルで実行するには、適応型思考を使用します：thinkingフィールドを省略するか、thinking: {"type": "adaptive"}を送信してください。between_toolsは他のフィールドを受け付けません：display、budget_tokens、またはblock_bindingを一緒に送信すると400エラーが返されます。サーバー側フォールバックでは、Claude Sonnet 5にフォールバックしたbetween_toolsリクエストは、そこでthinking: {"type": "disabled"}として実行されます。

between_toolsでは、会話の途中でエフォートを変更できません：有効なレベルと異なるメッセージごとのoutput_config.effortは400エラーを返します。ターンごとにエフォートを変えるには、適応型思考を使用してください。プロンプトのガイダンスについては、事前の思考なしでの実行を参照してください。

between_toolsを定義していないSDKバージョンでは、PythonとTypeScriptの例は型チェックに失敗します。SDKを更新するか、C#、Go、Javaの例のように値を生のJSONとして渡してください。

変更前（Claude Sonnet 5）：

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

変更後（Claude Sonnet 5.5）：

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

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

グループを上から順に進め、ご使用のモデル名が記載されたグループで終了してください。Claude Haiku 4.5の場合は、「Claude Sonnet 4以前」を除くすべてのグループを適用し、「Claude Haiku 4.5のみ」で終了します。

すべての移行元モデル

• モデルIDをclaude-sonnet-5-5に変更します。
• コンテンツブロックをtypeで読み取り、thinkingブロックを変更せずにそのまま返します。
• 事前の思考なしで実行し続けるには、high以下のエフォートで最も低い思考設定を送信します。
• 強制ツール使用を、autoとstrictツールの組み合わせ（Amazon Bedrockではautoのみ）に置き換えます。
• 会話を追記のみに保ちます。
• Claude APIとGoogle Cloudでは、fine-grained-tool-streaming-2025-05-14ベータヘッダーを使わずに、コンピュータ使用をツールセットに移行します。
• アドバイザーツールをサポートされているアドバイザーと組み合わせ、暗号化されたアドバイスを想定します。
• ツール呼び出し間のテキストをthinkingブロックから読み取ります。
• 拒否を処理し、フォールバックを設定します。
• エフォートのスイープを再実行し、コストのベースラインを再設定します。

Claude Sonnet 4.6以前

• thinkingフィールドのないリクエストで思考が実行されることを想定し、max_tokensを見直します。
• 思考予算をエフォートレベルに置き換えます。
• デフォルト以外のtemperature、top_p、top_kの値を削除します。
• 思考テキストを表示する場合は、display: "summarized"を設定します。
• トークンを再カウントし、画像トークンの予算を見直します。

Claude Sonnet 4.5以前

• アシスタントのプリフィルを置き換えます。
• ツール呼び出しの入力を標準のJSONパーサーで解析します。
• Amazon Bedrockでは、コンピュータ使用をcomputer_20250124からcomputer_20251124に移行します。
• output_config.effortを明示的に設定します。
• コンテキストウィンドウのベータヘッダーをすべて削除します。
• interleaved-thinking-2025-05-14を削除し、fine-grained-tool-streaming-2025-05-14をeager_input_streamingに置き換えます。
• output_formatをoutput_config.formatに移行します。

Claude Sonnet 4以前

• ツールバージョンをtext_editor_20250728とcode_execution_20260521に更新します。
• refusalおよびmodel_context_window_exceededの停止理由を処理します。
• ツールの文字列パラメータに末尾の改行がないか確認します。
• token-efficient-tools-2025-02-19とoutput-128k-2025-02-19を削除します。
• プロンプトを見直します。

Claude Haiku 4.5のみ

• claude-haiku-4-5-20251001またはそのエイリアスを置き換えます。
• トークンあたりの価格が高くなるため、コストのベースラインを再設定します。
• Claude Haiku 4.5ではキャッシュするには短すぎたプロンプトを見直します。

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

このセクションの変更は、すべての移行元モデルで必要です。モデルIDを、日付サフィックスのないclaude-sonnet-5-5に置き換えてください。他のプラットフォームでは、提供状況に記載されているIDを使用してください。

強制ツール使用はサポートされていません

このページに記載されている以前のモデルはすべて、タイプがanyまたはtoolのtool_choiceを受け付けます。Claude Sonnet 5.5は、トークンカウントエンドポイントを含め、どちらも400エラーで拒否します：

tool_choice: type "tool" and "any" are not supported for this model.

tool_choice: {"type": "auto"}を送信し、入力がスキーマに一致するようにツールにstrict: trueを指定してください。この場合、モデルはツールを呼び出さずに回答できるため、いつツールを使用すべきかをプロンプトで指示してください。「strict tool use」（厳格なツール使用）はJSON Schemaのサブセットをサポートし、すべてのオブジェクトにadditionalProperties: falseが必要です。JSON Schemaの制限事項を参照してください。Amazon Bedrockでは、厳格なツール使用を含む構造化出力はClaude Sonnet 5.5では利用できません。そこではstrictなしでautoを送信し、いつツールを呼び出すべきかをプロンプトで指示し、コード内でツールの入力を検証してください。

変更前（Claude Sonnet 5）：

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

変更後（Claude Sonnet 5.5）：

client.messages.create(
    model="claude-sonnet-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.",
        }
    ],
)

この例では、リスト内のすべてのツールをstrictに指定しています。1つのリクエストに含められるstrictツールは最大20個で、MCP、コンピュータ使用、ブラウザ使用のツールセットエントリはstrictを受け付けません。より長いツールリストでは、必要なツールのみを指定してください。

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

Claude Sonnet 5.5は、Claude Sonnet 5、Claude Opus 4.8、Claude Haiku 4.5、およびそれ以前のモデルの思考ブロックを読み取ります。Claude Opus 5、Claude Opus 5.5、またはClaude FableやClaude Mythosのいずれのモデルのブロックも読み取りません。APIは、モデルが読み取れないブロックを破棄します。その場合でもリクエストは200を返し、破棄されたブロックは課金されません。会話途中でのモデルの切り替えを参照してください。

Claude Sonnet 5.5の各思考ブロックは、それ以前の会話に対しても署名されています。2026年8月31日 00:00 UTC以降に作成されたアカウントについては、Claude API、Amazon Bedrock、Google CloudでAPIがデフォルトでこれを強制します。これらのアカウントでは、以前の履歴を編集した後にブロックを再送するリクエストは400エラーを返します。会話は追記のみに保ち、指示やツールの変更には会話途中のシステムメッセージを使用してください。Claude Sonnet 5.5が生成した思考ブロックは、それを生成したアカウント、またはそのアカウントにリンクされたアカウントでのみ機能します。保持された思考を参照してください。

Claude APIとGoogle Cloudでは、コンピュータ使用にツールセットが必要です

Claude APIとGoogle Cloudでは、Claude Sonnet 5.5はcomputer_toolset_20260801ツールセットを通じてのみ「computer use」（コンピュータ使用）をサポートします。これらのプラットフォームでは、computer_20251124は400エラーを返します。Claude Sonnet 5.5は、どのプラットフォームでもcomputer_20250124を受け付けません。現在送信しているバージョンを確認してください：

fine-grained-tool-streaming-2025-05-14ベータヘッダーを送信している場合は、ツールセットに移行する際に削除してください。ツールセットエントリと併用すると、400エラーが返されます。代わりに、必要な各ツールにeager_input_streaming: trueを設定してください。

すでにツールセットを送信しているコードは変更不要です。computer_20251124からの移行に、リクエストとエージェントループの変更点が記載されています。その他のプラットフォームについては、互換性を参照してください。

アドバイザーツールが受け付けるアドバイザーが減りました

「advisor tool」（アドバイザーツール）では、Claude Sonnet 5.5のエグゼキューターには次のいずれかのアドバイザーが必要です：Claude Opus 5、Claude Opus 5.5、Claude Sonnet 5.5、Claude Fable 5、Claude Fable 5.1、Claude Mythos 5、またはClaude Mythos 5.1。Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、Claude Sonnet 5、Claude Sonnet 4.6のアドバイザーは400エラーを返します。アドバイスはadvisor_redacted_resultブロックとして暗号化されて返されるため、レスポンス内でそのテキストを読むことはできません。モデルの互換性を参照してください。

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

Claude Sonnet 5.5では、モデルがツール呼び出しの間に書く1〜2文より長いメモは、進捗更新のthinkingブロックとして返され、デフォルトのdisplayでは空になります。より短いコメントはtextのままです。Claude Sonnet 5以前のモデルでは、ツール呼び出し間のすべてのテキストがtextブロックとして返されます。失敗するリクエストはありませんが、それらのメモを表示するインターフェースには何も表示されなくなります。

適応型思考では、更新のみを取得するにはdisplayを"updates"（ベータ、thinking-display-updates-2026-08-18ヘッダー）に設定し、推論と混在した形で取得するには"summarized"に設定します。空でない各thinkingブロックは、その後に続くtool_useブロックの前にレンダリングしてください。between_toolsでは、displayなしでテキストが返されます。ユーザー向けの進捗更新を参照してください。

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

Claude Sonnet 5.5は、Claude Sonnet 5よりも多くのカテゴリで応答を拒否します。拒否するとstop_reason: "refusal"が返され、そのstop_detailsには次のいずれかのカテゴリが示される場合があります：

• "cyber"： リクエストが、マルウェアやエクスプロイトの開発など、サイバー上の危害を可能にする恐れがあります。
• "bio"： リクエストが、危険な実験手法など、生物学的な危害を可能にする恐れがあります。
• "frontier_llm"： リクエストが、競合するAIモデルの開発を支援する恐れがあります。
• "reasoning_extraction"： リクエストが、モデルの内部推論をレスポンステキスト内で再現するよう求めています。
• "general_harms"： リクエストが、その他の利用ポリシー領域に該当します。無害な作業でもこのカテゴリがトリガーされることがあります。

サーバー側フォールバック（fallbacks: "default"、ベータ、Claude APIのみ）は、"cyber"および"frontier_llm"の拒否をClaude Sonnet 5で再試行します。"bio"、"reasoning_extraction"、"general_harms"の拒否は再試行しません。拒否とフォールバックおよび拒否の課金方法を参照してください。

リアルタイムのサイバーセーフガードは、Claude Sonnet 4.6、Claude Sonnet 4.5、Claude Haiku 4.5から移行するコードにとっては新しいものです。正当なセキュリティ業務については、Cyber Verification Programに申請してください。

その他の変更点

• プロンプトキャッシング： キャッシュ可能なプロンプトの最小サイズは512トークンで、Claude Sonnet 5、Claude Sonnet 4.6、Claude Sonnet 4.5の1,024トークンから引き下げられました。プロンプトキャッシングを参照してください。
• 新機能： 会話途中のシステムメッセージ、会話途中のツール変更、メッセージごとのエフォートについては、Claude Sonnet 5.5の新機能を参照してください。between_toolsでは、会話の途中でエフォートを変更できません。

推奨される変更

エフォートのスイープを再実行してください。Claude Sonnet 5.5には、low、medium、high、xhigh、maxの5つのエフォートレベルがあります。Claude APIでのデフォルトはhighです。レベルは再調整されているため、同じレベルでもClaude Sonnet 5と同じ量の思考が生成されるわけではありません。ワークロードがエージェント型、または「latency」（レイテンシ）に敏感なものでない限り、highから始めてください。エージェント型コーディングや複数ステップのツール使用では、仕様が明確なタスクにはmediumから始め、より難しいタスクや長いタスクにはhighに移行してください。チャットやその他のレイテンシに敏感な作業では、mediumまたはlowから始めてください。レベルはoutput_config.effortで設定します。Claude Sonnet 5.5の推奨エフォートレベルを参照してください。その後、モデル固有のプロンプト指示をClaude Sonnet 5.5へのプロンプトに照らして再評価してください。

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

まず、claude-sonnet-4-6を置き換えたうえで、これより前のすべてのセクションを適用します。次に、以下の変更を行います。Claude Sonnet 4.5以前の場合は、続くサブセクションに進んでください。

破壊的変更

思考を省略していたリクエストで思考が実行されます。 思考はデフォルトで実行されるおよび事前の思考をオフにするを参照してください。

思考予算はエラーを返します。 Claude Sonnet 4.6は、thinking: {"type": "enabled", "budget_tokens": N}を非推奨の設定として受け付けます。Claude Sonnet 4.5とClaude Haiku 4.5は、すべての思考にこれを使用します。Claude Sonnet 5.5は400エラーを返します：

"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

予算を削除し、エフォートレベルを設定してください。予算からエフォートレベルへの固定的な対応関係はないため、2〜3のレベルで評価を実行してください。

変更前（Claude Sonnet 4.6）：

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

変更後（Claude Sonnet 5.5）：

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

サンプリングパラメータはエラーを返します。 Claude Sonnet 4.6以前のモデルとClaude Haiku 4.5は、temperature、top_p、top_kを受け付けます。Claude Sonnet 5.5では、デフォルト以外の値は400エラーを返します。これらを削除してください。

思考テキストはデフォルトで省略されます。 レスポンス内の思考を処理するを参照してください。

その他の変更点

• トークンが約30%増加： Claude Sonnet 5.5はClaude Sonnet 5のトークナイザーを使用します。Claude Sonnet 4.6、Claude Sonnet 4.5、Claude Haiku 4.5と比較すると、同じテキストでもコンテンツに応じて約30%多くのトークンが生成されます。トークンカウントで再カウントし、max_tokensとコストを見直してください。
• エフォート： xhighが新たに追加され、レベルが再調整されています。推奨される変更を参照してください。
• 画像： Claude Sonnet 5.5は高解像度の画像ティアを使用し、長辺最大2576ピクセル、画像あたり最大4,784ビジュアルトークンに対応します。Claude Sonnet 4.6、Claude Sonnet 4.5、Claude Haiku 4.5は1568ピクセルと1,568トークンが上限です。2000×1500の画像は、Claude Sonnet 5.5では約2.5倍のトークンを消費します。解像度とトークンコストを参照してください。

Claude Sonnet 4.5以前からの移行

Claude Sonnet 4.5、Claude Sonnet 4、またはClaude 3.7 Sonnetの場合は、まずこれより前のすべてのセクションを適用し、次に以下の変更を行います。

プリフィルはエラーを返します。 Claude Sonnet 5.5は、Claude Sonnet 4.6やClaude Sonnet 5と同様に、「prefill」（プリフィル）された最後のアシスタントターンを400エラーで拒否します。Claude Sonnet 4.5、Claude Haiku 4.5、およびそれ以前のモデルはこれを受け付けます。エラーは次のとおりです：

This model does not support assistant message prefill. The conversation must end with a user message.

各プリフィルを、その用途に応じて置き換えてください：

• 出力形式： 構造化出力を使用するか、分類にはenumフィールドを持つツールを使用します。
• 前置き： システムプロンプトで直接的な回答を求めます。
• 不要な拒否： 通常は、ユーザーメッセージ内の明確な指示で十分です。
• 続き： ユーザーメッセージに移動します。例：「前回の応答は中断され、[previous_response]で終わっていました。中断したところから続けてください。」
• コンテキストのリマインダー： ユーザーターンに含めます。

ツール入力のエスケープ。 ツール呼び出しの引数におけるエスケープが異なる場合があります。inputは標準のJSONパーサーで解析してください。

コンピュータ使用。 Claude Sonnet 5.5はcomputer_20250124を受け付けません。コンピュータ使用の表を参照してください。

エフォート。 Claude Sonnet 4.5にはeffortパラメータがありません。推奨される変更の説明に従って、エフォートレベルを明示的に設定してください。

コンテキストと出力。 Claude Sonnet 5.5は、ベータヘッダーなしでより大きなコンテキストウィンドウを持ち、出力の上限も高くなっています。モデルページを参照してください。コンテキストウィンドウのベータヘッダーはすべて削除してください。

ベータヘッダー。 適応型思考は自動的にインターリーブされるため、interleaved-thinking-2025-05-14を削除してください。fine-grained-tool-streaming-2025-05-14は、必要な各ツールでのeager_input_streaming: trueに置き換えてください。このヘッダーは、コンピュータ使用またはブラウザ使用のツールセットエントリと併用すると400エラーを返します。きめ細かいツールストリーミングを参照してください。

構造化出力。 output_formatパラメータは非推奨であり、将来削除される予定です。それでも使用する場合は、structured-outputs-2025-11-13ベータヘッダーを追加してください。このヘッダーがない場合、APIは400エラーを返します。代わりにoutput_config.formatを使用してください。

Claude Sonnet 4以前からの移行

Claude Sonnet 4はClaude APIでは廃止済みですが、Amazon BedrockとGoogle Cloudでは引き続き利用できます。Claude 3.7 Sonnetは廃止済みです。いずれのモデルからの移行でも、まずこれより前のすべてのセクションを適用し、次に以下の変更を行います：

• ツールバージョン： ツール名str_replace_based_edit_toolを使用し、undo_editコマンドのないtext_editor_20250728を使用します。code_execution_20260521を使用します。テキストエディタツールおよびコード実行ツールを参照してください。
• 停止理由： refusalを処理します。Claude 4.5以降のモデルは、コンテキストウィンドウの上限に達するとmodel_context_window_exceededでも停止します。停止理由の処理を参照してください。
• 末尾の改行： Claude 4.5以降のモデルは、ツール呼び出しの文字列パラメータ内の末尾の改行を保持します。
• レガシーベータヘッダー： token-efficient-tools-2025-02-19とoutput-128k-2025-02-19を削除します。
• プロンプト： プロンプトのベストプラクティスに照らして見直します。

Claude Haiku 4.5からClaude Sonnet 5.5への移行

まず、Claude Sonnet 4のサブセクションを除き、Claude Sonnet 4.5以前からの移行までのすべてのセクション（同セクションを含む）を適用します。次に、以下の変更を行います：

• モデルID： claude-haiku-4-5-20251001またはエイリアスclaude-haiku-4-5をclaude-sonnet-5-5に置き換えます。
• コスト： トークンあたりの価格が高く、同じテキストでもより多くのトークンが生成されます。トークンを再カウントし、コストのベースラインを再設定してください。Claudeの料金を参照してください。
• プロンプトキャッシング： キャッシュ可能なプロンプトの最小サイズが、4,096トークンからClaude Sonnet 5.5の最小値に引き下げられます。
• インターリーブ思考： 適応型思考は、ベータヘッダーなしでツール呼び出しの間に自動的に実行されます。
• ルーティング： Claude Sonnet 5.5はClaude Haiku 4.5の思考ブロックを読み取ります。上位モデルに移行した会話は推論を保持します。Claude Haiku 4.5に戻った会話では、Claude Sonnet 5.5のブロックが破棄されます。