Claude Sonnet 5.5の新機能

Claude Sonnet 5.5は、速度と知能の最良の組み合わせを提供します。Claude Sonnet 5ですでに稼働しているコードには、次の5つの「breaking change」（破壊的変更）が影響します：

• between_toolsで事前思考をオフにする。
• 強制ツール使用はエラーを返します。
• 思考ブロックはモデルと会話に紐付けられます。
• Claude APIとGoogle Cloudでは、以前のcomputer_20251124 computer useツールは受け付けられません。
• advisorツールは、Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5をアドバイザーとして受け付けません。

もう1つの変更は、リクエストを失敗させることなくレスポンスの形状を変えます：ツール呼び出し間のテキストがthinkingブロックで返されます。そのテキストをユーザーに「streaming」（ストリーミング）するアプリケーションは、テキストを返すdisplay値を設定するか、between_toolsで事前思考をオフにするまで、ツール呼び出しの間は何も表示されなくなります。

新しいモデル

「Adaptive thinking」（適応型思考）はデフォルトでオンになっており、「effort parameter」（エフォートパラメータ）が思考の深さを制御します。Claude APIでのデフォルト値はhighです。トークナイザーはClaude Sonnet 5と同じであるため、同じテキストからは同じトークン数が得られます。「context window」（コンテキストウィンドウ）、出力制限、知識のカットオフ、価格については、Claude Sonnet 5.5モデルページを参照してください。

現在のすべてのモデルについては、モデルの概要を参照してください。

破壊的変更

between_toolsで事前思考をオフにする

Claude Sonnet 5.5で「up-front thinking」（事前思考）をオフにするには、"disabled"の代わりにthinking: {"type": "between_tools"}を送信します。これはこのモデルで最も低い思考設定です。Claude Sonnet 5.5を提供するすべてのプラットフォームで利用でき、ベータヘッダーは不要です。モデルがツール呼び出しの間に書く短い「progress update」（進捗更新）は、引き続き要約テキスト付きのthinkingブロックとして返されます。これらのブロックは、アシスタントターンの残りの部分とともに変更せずに送り返してください。送り返した進捗更新ブロックは、要約ではなく、モデルが書いた完全なメモをモデルに提供します。リクエストでツールを使用しない場合、Claude Sonnet 5でdisabledを使用した場合と同様に、レスポンスにはテキストのみが含まれます。

Claude Sonnet 5.5では、thinking: {"type": "disabled"}を送信するリクエストは、between_toolsを案内するメッセージを含む400 invalid_request_errorを返します。

between_toolsは、low、medium、highのエフォートで受け付けられます。xhighまたはmaxのエフォートでは、between_toolsを含むリクエストは400エラーを返します。xhighまたはmaxで実行するには、適応型思考を使用してください：thinkingフィールドを省略するか、同等のthinking: {"type": "adaptive"}を送信します。between_toolsでは、会話の途中でエフォートを変更できません：有効なレベルと異なるメッセージごとのoutput_config.effortは400エラーを返します。ターンごとにエフォートを変えるには、適応型思考を使用してください。

between_toolsは他のフィールドを受け付けません：display、budget_tokens、またはblock_bindingを一緒に送信すると400エラーが返されます。手動の思考予算（thinking: {"type": "enabled", "budget_tokens": N}）は400エラーを返します。思考と、移行ガイドの変更前と変更後を参照してください。

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

Claude Sonnet 5.5は「forced tool use」（強制ツール使用）をサポートしていません。tool_choiceを{"type": "any"}または{"type": "tool", "name": "..."}に設定すると、400 invalid_request_errorが返されます：

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

tool_choice: {"type": "auto"}（デフォルト）と{"type": "none"}はサポートされています。同じチェックがトークンカウントエンドポイントにも適用されます。スキーマに準拠したツール入力を得るには、tool_choice: {"type": "auto"}のままにしてstrict tool useでstrict: trueを設定するか、スキーマを構造化出力に移してください。モデルにテキストで返答させるのではなくツールを呼び出させるには、そのツールがどのような場合に適用されるかをプロンプトで伝えてください。移行ガイドに変更前と変更後が示されています。

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

すべての「thinking block」（思考ブロック）には、それを生成したモデルが記録されます。各モデルは自身のブロックと、一部の他モデルのブロックのみを読み取ります。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のいずれのモデルの思考ブロックも読み取りません。Claude Sonnet 5.5の思考ブロックを読み取る他のモデルはありません。

そのため、Claude Sonnet 5からClaude Sonnet 5.5に移行する会話は推論を保持しますが、Claude Sonnet 5.5から他のモデルに移行する会話では、切り替え後のターンは推論なしで実行されます。対象モデルが読み取れないブロックをリクエストが含む場合、APIはモデルがそれを参照する前にブロックを削除します：リクエストは成功し、削除されたブロックは課金されません。thinking-binding-controls-2026-08-01ベータヘッダーを使用すると、削除はトップレベルのinput_transformations配列で報告されます。会話の途中でのモデルの切り替えを参照してください。

APIは、Claude Sonnet 5.5の思考ブロックが生成されて以降、そのブロックより前の内容（systemプロンプト、tools、または以前のメッセージ）が変更されていないかどうかもチェックします。Claude API、Amazon Bedrock、Google Cloudでは、2026年8月31日00:00 UTC以降に作成されたアカウントに対して、このチェックがデフォルトで適用されます。これらのアカウントでは、そのような変更の後にブロックを再送するリクエストは400エラーを返します。代わりに影響を受けるブロックを削除するには、thinking-binding-controls-2026-08-01ベータヘッダーを送信し、thinking.block_binding.prefix_mismatch_behaviorを"drop_block"に設定してください。それより前に作成されたアカウントでは、このフィールドをいずれかの値に設定すると、そのリクエストでチェックが有効になります。block_bindingはthinking: {"type": "adaptive"}でのみ機能します。between_toolsを使用する場合は、履歴を追記のみに保つか、編集したターン以降の思考ブロックを削除してください。

チェックが失敗しないように、会話は追記のみに保ってください：指示やツールを変更する場合は、編集ではなく会話途中のシステムメッセージを使用します。保持される思考と、移行ガイドのこの変更に関する注記を参照してください。

Claude APIとGoogle Cloudではcomputer_20251124 computer useツールはサポートされていません

Claude APIとGoogle Cloudでは、Claude Sonnet 5.5はcomputer_toolset_20260801ツールセットを通じてのみ「computer use」（コンピューター操作）をサポートします。以前のcomputer_20251124ツールを宣言するリクエストは、400 invalid_request_errorを返します。Claude APIでは、メッセージは拒否されたタイプを示し、続いてモデルが受け付けるツールタイプを列挙します。メッセージは次のように始まります：

'claude-sonnet-5-5' does not support tool types: computer_20251124.

Amazon Bedrockでは、Claude Sonnet 5.5は以前のcomputer_20251124ツールを受け付けます。

既存の統合をClaude APIまたはGoogle Cloud上で移行するには、変更前と変更後のリクエストを示しているcomputer_20251124からの移行に従ってください。ベータヘッダーを削除し、toolsエントリを{"type": "computer_toolset_20260801"}に置き換え、メンバーのtool_useブロック、バッチアクション、結果のtoolset_nameに対応するようエージェントループを更新します。このツールセットはClaude APIとGoogle Cloudで利用できます。その他のプラットフォームについては、コンピュータ使用ツールの互換性セクションを参照してください。すでにツールセットを使用している統合、およびブラウザ使用ツールは変更不要です。

一部のadvisorツールの組み合わせはサポートされていません

「advisor tool」（advisorツール）（ベータ）では、Claude Sonnet 5.5のエグゼキューターには、アドバイザーとしてClaude Mythos 5.1、Claude Fable 5.1、Claude Mythos 5、Claude Fable 5、Claude Opus 5.5、Claude Opus 5、またはClaude Sonnet 5.5自身が必要です。Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5のアドバイザーはClaude Sonnet 5のエグゼキューターでは機能しますが、Claude Sonnet 5.5のエグゼキューターでは400 invalid_request_errorを返します。Claude Sonnet 5.5が受け付けるすべてのアドバイザーは、アドバイスをadvisor_redacted_resultブロックとして暗号化して返すため、クライアントはアドバイスのテキストを読み取れません。advisorツールのモデルの互換性と結果のバリエーションを参照してください。

機能サポート

Claude Sonnet 5.5は、メッセージごとのエフォート（ベータ）、会話途中のシステムメッセージ、会話途中のツール変更（ベータ）、キャッシュ可能なプロンプトの最小長が512トークンの「prompt caching」（プロンプトキャッシング）、バッチ処理、Files API、PDFサポート、ビジョン、およびサーバーサイドとクライアントサイドのツールをサポートしています。メッセージごとのエフォート、会話途中のシステムメッセージ、会話途中のツール変更はClaude Sonnet 5では利用できず、Claude Sonnet 5のキャッシュ可能なプロンプトの最小長は1,024トークンです。Claude APIとGoogle Cloudでは、computer useにはcomputer_toolset_20260801ツールセットが必要です（破壊的変更を参照）。モデルごとの提供状況については、各機能のページを参照してください。

オンデマンドのコンパクション（ベータ）

compact-2026-09-04ベータヘッダーを使用すると、トップレベルのcompactionパラメータを送信するリクエストは、会話全体を要約した署名付きのcompactionブロックを返します。その後、要約されたメッセージの代わりに、そのブロックを先頭に送信します。コンパクションのタイミングは自分で選択でき、保持するターン内の思考ブロックは、コンパクションと保持される思考に記載された条件のもとで、置き換え後も有効なままにできます。Claude Sonnet 5.5では思考ブロックが会話に紐付けられるため、これは重要です。プラットフォームごとの提供状況とリクエストの全体的な流れについては、オンデマンドのコンパクションを参照してください。

メッセージ内でツールを定義する（ベータ）

inline-tools-2026-09-15ベータヘッダーを使用すると、会話途中のシステムメッセージ内のtool_additionブロックに、参照の代わりに完全なツール定義を含めることができます。toolsを編集することなく、またプロンプトキャッシュを失うことなく、会話の途中でツールを追加したり、そのスキーマを変更したり、サーバーツールを新しいバージョンに移行したりできます。メッセージ内でツールを定義するを参照してください。

思考ブロックはそれを生成したアカウントに留まります

Claude Sonnet 5.5が生成する思考ブロックは、それを生成したアカウント、またはそのアカウントにリンクされたアカウントでのみ機能します。別のアカウントがこれらのブロックのいずれかを送信すると、APIはモデルがそれを参照する前にブロックを削除し、リクエストは成功します。Claude APIとGoogle Cloudでは、thinking-binding-controls-2026-08-01ベータヘッダーを使用すると、レスポンスは削除された各ブロックをreason: "organization_binding_mismatch"とともにinput_transformationsに列挙します。以前のモデルのブロックは影響を受けません。保持される思考を参照してください。

動作の違い

Claude Sonnet 5.5は、コードを変更しなくても現れるいくつかの点でClaude Sonnet 5と異なります。Claude Sonnet 5.5へのプロンプトに、それぞれのガイダンスがあります：

• エフォートレベルが再調整されています。 エフォートレベルは、Claude Sonnet 5と同じ量の思考を生成しません。設定をそのまま引き継ぐのではなく、エフォートの比較検証をやり直してください。ワークロードがエージェント型またはレイテンシに敏感なものでない限り、highから始めてください。エージェント型のコーディングや複数ステップのツール使用では、仕様が明確なタスクにはmediumから始め、より難しいタスクや長いタスクにはhighに移行してください。チャットやその他のレイテンシに敏感な作業では、mediumまたはlowから始めてください。
• ツール呼び出し間のテキストは思考ブロックで返されます。 ツール呼び出しの間に書かれる1〜2文より長いメモは、進捗更新のthinkingブロックとして返されます。それより短いコメントはtextのままです。デフォルトのdisplay: "omitted"では、進捗更新ブロックのテキストは空になるため、それらのメモをユーザーにストリーミングするアプリケーションは、エラーなしにツール呼び出しの間は何も表示されなくなります。between_toolsで事前思考をオフにすると、テキストが返されます。移行ガイドに、テキストを受け取る方法が示されています。
• セーフガードのカテゴリ。 モデルのセーフガードは、5つのstop_detailsカテゴリでリクエストを拒否することがあります。"cyber"は、リクエストがサイバー上の危害を可能にするおそれがあることを意味します。"bio"は、生物学的な危害を可能にするおそれがあることを意味します。"frontier_llm"は、競合するAIモデルの開発を支援するおそれがあることを意味します。"reasoning_extraction"は、モデルの内部推論をレスポンステキスト内で再現するよう求めていることを意味します。"general_harms"は、その他の利用ポリシー領域に該当することを意味します。拒否、フォールバック、課金を参照してください。

拒否、フォールバック、課金

拒否とフォールバックの内容はすべてClaude Sonnet 5.5に適用されます。拒否されたリクエストは、HTTP 200とstop_reason: "refusal"、およびポリシー領域を示すstop_detailsオブジェクトを返します。拒否を処理し、フォールバックを設定してください。サーバーサイドのフォールバック（fallbacks: "default"、ベータ、Claude APIで利用可能）は、"cyber"と"frontier_llm"の拒否をClaude Sonnet 5で再試行します。"bio"、"reasoning_extraction"、"general_harms"の拒否は再試行しません。SDKミドルウェアや独自の再試行処理を使用することもできます。出力の前に届いた拒否が課金されるかどうかは拒否カテゴリによって異なり、いずれの場合も「rate limit」（レート制限）にカウントされます。拒否の課金方法を参照してください。

価格

Claude Sonnet 5.5の価格は、プロンプトキャッシングとバッチ処理の料金を含め、Claude Sonnet 5と同じです。完全な一覧、データレジデンシー、ツールの価格については、価格を参照してください。

提供状況

Claude Sonnet 5.5は以下で利用できます：

• Claude API： すべてのお客様、claude-sonnet-5-5として。
• AWS： Claude in Amazon Bedrock（anthropic.claude-sonnet-5-5として）、およびClaude Platform on AWS（claude-sonnet-5-5として）。
• Google Cloud： Claude on Google Cloud、claude-sonnet-5-5として。
• Microsoft Foundry： Claude in Microsoft Foundry、claude-sonnet-5-5として。

Claude Sonnet 5からの移行

モデルIDを更新します：

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

次に、以下の6点を確認してください：

1. コードでdisabledを使用して思考をオフにしている場合は、代わりにhigh以下のエフォートでbetween_toolsを送信してください。
2. tool_choiceのタイプanyとtoolを、autoとstrict tool useの組み合わせに置き換えてください。
3. 会話は追記のみに保ってください。以前の履歴を編集した後にClaude Sonnet 5.5の思考ブロックを再送するリクエストは、400エラーを返すことがあります。思考ブロックはモデルと会話に紐付けられますを参照してください。
4. Claude APIまたはGoogle Cloudでcomputer_20251124を通じてcomputer useを使用している場合は、ツールセットに移行してください。
5. Claude Opus 4.8、Claude Opus 4.7、またはClaude Sonnet 5のアドバイザーでadvisorツールを使用している場合は、Claude Sonnet 5.5が受け付けるアドバイザーに切り替えてください。
6. インターフェースでツール呼び出し間のテキストを表示している場合は、適応型思考を使用する際にthinking.displayを設定してください。between_toolsでは、設定しなくてもテキストが返されます。ツール呼び出し間のテキストは思考ブロックで返されますを参照してください。

移行ガイドには、Claude Sonnet 5およびそれ以前のモデルからの段階的な手順と、完全なチェックリストが記載されています。

次のステップ