Claude Sonnet 5.5の新機能

Claude Sonnet 5.5は、速度とインテリジェンスの最適な組み合わせを提供します。Claude Sonnet 5ですでに実行されているコードに影響を与える可能性のある破壊的変更が5つあります：

• between_toolsで事前思考をオフにする。
• 強制ツール使用はエラーを返す。
• 思考ブロックはモデルと会話に紐付けられる。
• 一部のコンピューター使用ツールのバージョンはサポートされない。
• アドバイザーツールは4つのモデルをアドバイザーとして拒否する：Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5、およびClaude Haiku 5.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: trueを設定するか、スキーマを構造化出力に移してください。モデルにテキストで返答させるのではなくツールを呼び出させるには、そのツールがいつ適用されるかをプロンプトで伝えてください。移行ガイドの強制ツール使用はサポートされていないに、変更前と変更後が示されています。

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

すべての思考ブロックには、それを生成したモデルが記録されます。モデルを切り替える会話は、切り替え先のモデルが以前のモデルの思考ブロックを読み取れる場合にのみ、以前の推論を保持します：

リクエストにターゲットモデルが読み取れないブロックが含まれている場合、APIはモデルがそれを受け取る前にそのブロックを除外します。リクエストは成功し、除外されたブロックは課金されません。thinking-binding-controls-2026-08-01ベータヘッダーを使用すると、APIはその除外をトップレベルのinput_transformations配列で報告します。モデルを切り替えて元に戻すを参照してください。Claude Sonnet 5.5が関与しない切り替えについては、Claude APIで推論を保持するモデル切り替えを参照してください。

APIは、Claude Sonnet 5.5の思考ブロックより前にある内容が、モデルがそのブロックを生成してから変更されていないかどうかも確認します。この「prefix check」（プレフィックスチェック）は、systemプロンプト、tools、およびそれ以前のすべてのメッセージを対象とします。会話は「append-only」（追記のみ）に保ってください。指示やツールを変更する場合は、編集ではなく会話途中のシステムメッセージを使用してください。

プレフィックスチェックに失敗すると、400エラーになる場合もあれば、ならない場合もあります。両方のケースを特定して対処するには、思考ブロックのプレフィックスチェックを参照してください。

プレフィックスチェックは、Claude APIおよび一部のクラウドプラットフォームで実行されます。

保持された思考および移行ガイドの思考ブロックに関する注記を参照してください。

一部のコンピューター使用ツールのバージョンはサポートされない

Claude Sonnet 5.5は、computer_toolset_20260801ツールセットを通じて「computer use」（コンピューター使用）をサポートしています。Amazon Bedrockでは、Claude Sonnet 5.5はcomputer-use-2025-11-24ベータヘッダーとともにcomputer_20251124ツールも受け付けます。Claude Sonnet 5.5は、Claude APIでのcomputer_20251124など、受け付けないコンピューター使用ツールのバージョンに対しては400エラーを返します。Claude APIのinvalid_request_errorメッセージは、拒否されたタイプを示し、Did you mean one ofの後にモデルが受け付けるツールタイプを列挙します。メッセージは次のように始まります：

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

ツールセットを使用しているインテグレーションは変更不要です。computer_20251124のインテグレーションをツールセットに移行するには、変更前後のリクエストを示しているcomputer_20251124からの移行に従ってください。ベータヘッダーを削除し、toolsエントリを{"type": "computer_toolset_20260801"}に置き換えます。その後、メンバーのtool_useブロック、バッチアクション、および結果のtoolset_nameに対応するようにエージェントループを更新してください。

一部のアドバイザーツールの組み合わせはサポートされていません

アドバイザーツールはベータ版です。Claude Sonnet 5.5のエグゼキューターは、次のアドバイザーのみを受け付けます：

• Claude Mythos 5.2およびClaude Fable 5.2
• 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 Haiku 5.5のアドバイザーはClaude Sonnet 5のエグゼキューターでは機能します。Claude Sonnet 5.5のエグゼキューターでは、400 invalid_request_errorを返します。Claude Sonnet 5.5が受け付けるすべてのアドバイザーは、アドバイスを暗号化してadvisor_redacted_resultブロックとして返します。そのため、クライアントはアドバイスのテキストを読み取れません。アドバイザーツールのモデルの互換性および結果のバリエーションを参照してください。

機能サポート

Claude Sonnet 5.5は次の機能をサポートしています：

• メッセージごとのeffort（ベータ版）
• 会話途中のシステムメッセージ
• 会話途中のツール変更（ベータ版）
• プロンプトキャッシング（キャッシュ可能なプロンプトの最小値は512トークン）
• バッチ処理
• Files API
• PDFサポート
• ビジョン
• サーバーサイドとクライアントサイドのツール（Claudeでのツール使用を参照）

Claude Sonnet 5は、メッセージごとのeffort、会話途中のシステムメッセージ、および会話途中のツール変更をサポートしていません。Claude Sonnet 5では、キャッシュ可能なプロンプトの最小値は1,024トークンです。モデルごとの利用可否については、各機能のページを参照してください。

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

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

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

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

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

Claude Sonnet 5.5が生成する思考ブロックは、それを生成したアカウント、またはそれにリンクされたアカウントでのみ機能します。別のアカウントがこれらのブロックのいずれかを送信した場合、APIはモデルが受け取る前にそのブロックを除外し、リクエストは成功します。Claude Haiku 5.5、Claude Fable 5.2、およびClaude Mythos 5.2のブロックも同じルールに従います。

Claude APIおよびClaude Models on Google Cloud (Google managed)では、どのブロックが除外されたかを確認できます。thinking-binding-controls-2026-08-01ベータヘッダーを送信すると、レスポンスは除外された各ブロックをreason: "organization_binding_mismatch"とともにinput_transformationsに列挙します。アカウントとクラウドプラットフォームを参照してください。

動作の違い

以下の各項目に関するガイダンスについては、Claude Sonnet 5.5へのプロンプトを参照してください。Claude Sonnet 5.5は、コードを変更しなくても現れる次の点でClaude Sonnet 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に適用されます。拒否されたリクエストは、stop_reason: "refusal"と、ポリシー領域を示すstop_detailsオブジェクトを含むHTTP 200を返します。

コード内で拒否を処理し、フォールバックを設定してください。サーバー側フォールバック（fallbacks: "default"）を使用すると、"cyber"または"frontier_llm"カテゴリで拒否されたリクエストはClaude Sonnet 5で再実行されます。"bio"、"reasoning_extraction"、または"general_harms"カテゴリで拒否されたリクエストは再試行されません。サーバー側フォールバックは、Claude APIおよびClaude Models on Google Cloud (Anthropic managed)でベータ版として提供されています。SDKミドルウェアや独自の再試行を使用することもできます。

出力の前に到着した拒否は、一部の拒否カテゴリでは課金され、それ以外では課金されません。いずれの場合も、レート制限にはカウントされます。拒否の課金方法を参照してください。

料金

Claude Sonnet 5.5の料金はClaude Sonnet 5と同じですが、プロンプトキャッシュの読み取りは例外で、100万トークンあたり$0.10 USDと、Claude Sonnet 5の半額です。完全な一覧、データレジデンシー、およびツールの料金については、料金を参照してください。

提供状況

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

• Claude API： すべてのお客様、claude-sonnet-5-5として
• AWS： Amazon Bedrock の Claudeでanthropic.claude-sonnet-5-5として、およびClaude Platform on AWSでclaude-sonnet-5-5として
• Google Cloud： Claude Models on Google Cloud (Anthropic managed)でclaude-sonnet-5-5として、およびClaude Models on Google Cloud (Google managed)でclaude-sonnet-5-5として
• Microsoft Foundry： Microsoft FoundryのClaudeでclaude-sonnet-5-5として

Claude Sonnet 5からの移行

モデルIDを更新します。

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

次に、6つの点を確認してください。

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

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

次のステップ