ClaudeSonnet5.5 を使用したビルド

Claude Sonnet 5.5は、「Opus 5.5」に続く、「Claude 5.5」ファミリーの2番目のモデルです。これは「Sonnet 5」から明らかにアップグレードされており、よりスマートで効率的、かつ処理速度が30％向上しています。 トークン単価は変更されていませんが、Sonnet 5.5では通常、同じ作業を行うために必要なトークン数が大幅に少なくて済むため、ほとんどの作業においてコストが最大30％削減されます。

「コードから絵画へ」に関するアイデアを提供してくれた@jkeatnさん、および参考画像を提供してくれた@IceSolstさんに感謝します。

このガイドでは、モデルを使った構築方法について説明します。試してみるには、以下のリクエストを記載通りに実行してください：

import anthropic

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"},
)

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

このループは、Sonnet 5.5 がデフォルトで各ブロックを型ごとに読み込むため、各ブロックを型ごとに読み込みます。そのため、レスポンスは thinking ブロックで始まる可能性があり、 content[0].text コードは動作しなくなります。

「SONNET 5.5」と「OPUS 5.5」のどちらを選ぶか

Claude 5.5 ファミリーの中で、Opus 5.5 は、慎重な判断を要する複雑な作業向けに設計されています。Sonnet 5.5 は、バグの修正や機能の迅速な反復開発など、範囲が明確な日常的なタスクに適しています。また、洗練された文書、スライド、スプレッドシートを作成でき、デザイン面でも優れた機能を備えています。 その処理速度の高さから、迅速な反復開発に最適です。Claude Haiku 5.5は、大量処理かつ低遅延が求められるワークフローに対応するため、今後数週間以内にこのファミリーに加わります。

「Epicによる初期テストにおいて、『Claude』Sonnet 5.5は、上位モデルに期待されるのと同等の品質基準を満たし、システム設計監査やデータフローのレビューにも耐え抜きました。 この新モデルは、ゲームプレイシステムアーキテクチャの数万行に及ぶコードを処理し、応答を俊敏に保ち、数時間に及ぶタスクを処理し、指示的なプロンプトを最小限に抑えて成果を出しました。」（ダニエル・フォーゲル、Epic Games COO）

Sonnet 5.5は、タスクの仕様が明確で、結果を確認する方法がある場合に最も適しています。プロンプティングガイドにもあるように、「最も難易度が高く、長期的な視点が求められる作業には、Opusモデルの方が適しています。」

価格

Sonnet 5.5のすべての価格（バッチ処理およびプロンプトキャッシュを含む）は、Sonnet 5と同じであるため、モデルIDを変更してもトークンあたりの請求額は変わりません。米国限定の推論（inference_geo: "us"）の料金は、標準価格の1.1倍となります。

トークンあたりの価格は変わりませんが、前述の通り、Sonnet 5.5ではSonnet 5に比べてタスクあたりのトークン使用数が一般的に少ないため、総費用は変わります。

なお、Sonnetのデフォルトの動作レベルは、製品によって異なる場合があります。例えば、Claude Platformでは「高」、Claude Codeでは「中」に設定されているなどです。

Sonnet 5.5では、長辺が最大2576ピクセルまでの高解像度画像ティアが使用されており、2000×1500の画像の場合、Sonnet 4.6、Sonnet 4.5、またはHaiku 4.5と比較して、約2.5倍のトークンが必要となります。 詳細な描写が必要ない場合は、送信前に解像度を下げてください。

モデルの詳細

Claude APIのデフォルト設定は high に設定されているため、最初から確かな結果が得られます。まずはそこから始めて評価を行い、ワークロードに必要な処理レベルを選択してください。もし xhigh や max effortを使用したい場合は、Sonnet 5.5では処理時間が長くなり、コストも高くなる点に留意してください。タスクによっては、Sonnetの利点である「品質、速度、コストのバランス」が損なわれる可能性があります。その場合は、Opus 5.5の使用を検討してください。

SONNET5からの移行

「思考」機能はデフォルトでオンになっています。Sonnet5を「思考」機能をオフにして実行した場合は、 between_tools を使用して、初期の思考機能を無効にできます。以下の手順1でその方法を説明します。

モデルIDを claude-sonnet-5-5に変更し、5つの互換性破りの変更と、レスポンスの形状に関する1つの変更を順に処理してください。『Sonnet 5.5 移行ガイド』では、それぞれの変更について詳しく解説しています。

Claude Code 弊社でも移行作業を代行いたします。 /claude-api migrate this project to claude-sonnet-5-5 を実行して、バンドルされているClaude APIスキルを呼び出してください。これにより、コードベース全体に対してモデルIDの置換と、互換性を損なうパラメータの変更が適用されます。

1. `between_tools` を使って、先回りした思考をオフにする

Sonnet 5.5 では、 thinking フィールドを持つリクエストはアダプティブ・シンキングで処理され、 thinking: {"type": "disabled"} 400エラーが返されます。代わりに新しい between_tools 設定を使用してください。 between_tools、処理はツール呼び出し間でのみ行われ、総応答時間は同等か、あるいはより速くなります。

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

# After: 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": "..."}],
)

また、この例では、 xhigh から highに削減されます。これは、 between_tools には次のような制限があるためです：

• between_tools 勤務先： low, medium および high 努力。で xhigh または max 400エラーが返されます。そこで実行するには、状況に応じた柔軟な対応が必要です。
• 他のフィールドは不要です。送信 display, budget_tokens または block_binding を指定して送信すると、400エラーが返されます。
• 「 between_tools、会話の途中で努力の度合いを変えることはできません。ターンごとに努力の度合いを変えるには、適応的思考を活用してください。
• ツール呼び出しの合間にモデルが書き出す短い進捗報告は、依然として thinking ブロックとして、要約テキストと共に返されます。コンテンツブロックをタイプ別に読み取り、これらのブロックをアシスタントのターン残りの部分と共に変更せずに返してください。ツールを使用しない場合、応答にはテキストのみが含まれます。
• Sonnet 5.5 を提供し、ベータ版ヘッダーがないすべてのプラットフォームで動作します。お使いの SDK バージョンで between_tools場合は、更新してください。

もし between_tools、ツールを使わず、数ステップの検討が必要なリクエストに対しては、代わりに適応型思考を活用してください。

2. 強制的な「tool_choice」を、「auto」と「strict tools」に置き換える

tool_choice タイプ any または tool 400エラーを返します。これには、トークンカウントエンドポイントも含まれます。送信 auto、ツールに strict: true して入力がスキーマに一致するようにし、プロンプト内でいつこれを使用すべきかを明記してください：

weather_tool = {
    "name": "get_weather",
    "description": "Get the current weather in a given location",
    "input_schema": {
        "type": "object",
        "properties": {"location": {"type": "string"}},
        "required": ["location"],
        "additionalProperties": False,
    },
    "strict": True,
}

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

厳密なツール使用には、 additionalProperties: false すべてのオブジェクトに対して。

3. 会話は追記専用にする

Sonnet 5.5の思考ブロックは、モデルと会話に紐付けられています。Sonnet 5.5はSonnet 5の思考ブロックを読み取るため、Sonnet 5からSonnet 5.5へと切り替えた場合でも、その推論は維持されます。他のモデルはSonnet 5.5のブロックを読み取ることはできません。

4. コンピュータの使用をツールセットに移行する

Claude APIおよびGoogle Cloud上では、Sonnet 5.5は、 {"type": "computer_toolset_20260801"}のみでのコンピューター利用をサポートしています。 computer_20251124 400エラーが返されます。リクエストから anthropic-beta: computer-use-2025-11-24 ヘッダーを削除し、SDK では betas パラメータを削除し、ベータネームスペースではなく標準クライアント経由で Messages API を呼び出してください。 tools エントリを置き換え、メンバー向けのエージェントループを更新してください tool_use ブロック、バッチアクション、および toolset_name on results に対応するエージェントループを更新してください。 fine-grained-tool-streaming-2025-05-14 「beta」ヘッダーを送信している場合は、これも削除してください。ツールセットエントリと併用すると400エラーが返されるためです。代わりに、 eager_input_streaming: true 各ツールで必要に応じて設定してください。Amazon Bedrockは引き続き computer_20251124.

5. アドバイザーの組み合わせを確認してください

アドバイザーツールを使用すると、Sonnet 5.5 のエグゼキュータは、Opus 4.8、Opus 4.7、および Sonnet 5 をアドバイザーとして拒否します。受け入れられるアドバイザーには、Opus 5.5、Opus 5、および Sonnet 5.5 自体が含まれます。受け入れられたすべてのアドバイザーからのアドバイスは、暗号化された advisor_redacted_result ブロックとして返されるため、コードからアドバイス本文を読み取ることはできません。

6. シンキングブロック内のツール呼び出しの間に書かれたテキストを読む

この変更によってエラーは発生しませんが、ツール呼び出しの合間に、UI上でモデルのメモが表示されなくなる場合があります。これらのメモは、1～2文を超える長さの場合、progress-update thinking ブロックとして表示されますが、デフォルトではその内容は空になります display.

適応的な思考をもって、 thinking.display を "updates" (ベータ版、 thinking-display-updates-2026-08-18 ヘッダー付き) またはに設定し、各非空 "summarized"に設定し、空でない各 thinking ブロックを、 tool_use その後に続くブロックより前に、各空でないブロックをレンダリングする。 between_toolsを使用すると、テキストが display.

Sonnet バージョン5.5では、メッセージごとの作業量（ベータ版）、会話中のシステムメッセージ、および会話中のツール変更（ベータ版）も追加されました。Sonnet 4.6以前、またはHaiku 4.5から移行する場合は、移行ガイドに各開始モデルごとのチェックリストが掲載されています。

チューニング

エフォートスイープを再実行してください

努力レベルは再調整されているため、Sonnet5の頃とは同じレベルでも必要な思考量が異なり、以前の設定は引き継がれません。 high から始めてください。ただし、作業負荷が主体的なものや、遅延に敏感な場合はこの限りではありません。主体的なコーディングや多段階の道具の使用については、 medium から始め、 high より難易度が高い、あるいは時間がかかるタスクの場合は、から始めてください。チャットやその他の遅延に敏感な作業については、 medium または lowから始めてください。 xhigh またはは、評価の結果、品質の向上が確認された場合にのみ使用してください。 max は、評価の結果、品質の向上が確認された場合にのみ使用してください。

思考は max_tokensため、余裕を持たせてください。エージェント型コーディングを行う場合は、 max_tokens をモデルの最大値である128,000に設定し、応答をストリーム出力してください。思考を減らすには、エフォートレベルを下げてください。システムプロンプト内でモデルに「あまり考えないで」と指示しても、確実に思考を減らせるわけではありません。

Sonnet.5 を削除する 5つの回避策

既存のSonnet 5のプロンプトは、変更を加えなくても良好な性能を発揮するはずです。プロンプトに、拒否誘導、ツール呼び出しの再試行シム、あるいは「怠けないで」といった回避策が含まれている場合は、それらを削除し、他の調整を行う前に評価を再実行してください。

手間をかけずに本物の小切手を請求する

Sonnet 5.5 では、変更を「完了」として報告する前に通常は確認を行いますが、 low 場合によっては、その変更を検証するチェックが省略されることがあります。テストやビルドの出力がなく、変更が「完了」として報告されているのを見つけた場合、プロンプトガイドでは、以下のシステムプロンプトの段落を使用することを推奨しています：

When you change code that can be run, built, or type-checked, run a real
check that exercises the change before reporting it done: the project's
tests, type-checker, or build, or the changed command itself. A syntax-only
check, or a check command that failed to start, does not count; if all
that is missing is the project's declared dependencies, install them with
its own package manager and lockfile (e.g. npm install, pip
install -r requirements.txt), never via sudo or the system package manager,
unless told not to. Only if no real check can run here, say which one you
did not run and why instead of reporting the change as done.

進行状況の表示には thinking.display を使用してください

回答の中でモデルにその推論過程を記述するよう求めないでください。そうすると reasoning_extraction 断られる原因となります。その代わりに、考えを要約して記載するようにしてください：

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

ユーザー向けの進捗メモのみを表示する場合は、 display: "updates" (ベータ版) をご利用ください。最初のツール呼び出しの直前の行や、終了時の簡単なまとめなど、予測可能なタイミングで更新を表示したい場合は、システムプロンプトでその旨を指定してください。

プロンプトをさらにキャッシュする

キャッシュ可能なプロンプトの最小長が512トークンに短縮されたため、より短いシステムプロンプトやツール定義もキャッシュの対象となりました。キャッシュの読み取りにかかるコストは、入力コストの10分の1です。リクエスト間でトップレベルの努力度を変更すると、キャッシュは無効化されます。異なるレベルで1ターン実行するには、キャッシュを維持する「メッセージごとの努力度（ベータ版）」を使用してください。

拒否とフォールバック

当社の自動行動監査において、「Sonnet 5.5」は、整合性や誠実性に関するほとんどの指標において、「Sonnet 5」と同等か、それ以上の成績を示しています。また、これは当社の最高性能モデルと同様のサイバーセキュリティ対策が施された、初の「Sonnet」モデルでもあります。通常のソフトウェア開発のほとんどには影響がありません。

リクエストが拒否された場合、HTTP 200 が返され、 stop_reason: "refusal"、そして stop_details 5つのカテゴリのいずれかが指定されます： cyber, bio, frontier_llm, reasoning_extraction または general_harms。サーバーサイドのフォールバック（fallbacks: "default"、ベータ版、Claude API）は再試行を行います cyber し、 frontier_llm Sonnet 5 では拒否されます。他の3つについては再試行されません。SDKのミドルウェアや独自の再試行機能を使用することも可能です。

正当なセキュリティ業務において、「サイバー検証プログラム」はまもなく、Sonnet 5.5 にも対応するよう拡大される予定です。

在庫状況

Claude Sonnet バージョン 5.5 は本日、以下のプラットフォームで利用可能になりました。開発者向けプラットフォームでは、以下のモデル ID を使用してください：

• Claude API、として claude-sonnet-5-5
• Amazon Bedrockは、 anthropic.claude-sonnet-5-5
• Claude AWS上のプラットフォームとして、 claude-sonnet-5-5
• Google Cloudは、 claude-sonnet-5-5
• Microsoft Foundryは、 claude-sonnet-5-5、Global Standardの展開に限定されます

Claude Code にて

Claude Code v2.1.284（Agent SDK for TypeScript v0.3.284 以降）以降では、 sonnet エイリアスは、Claude API上でSonnet 5.5に解決されます。デフォルトでは medium デフォルトで `effort` モードで実行され、1M コンテキストウィンドウがネイティブで利用可能です。Claude Code では `Sonnet` 5.5 の思考機能をオフにすることはできず、モデルの思考量は `effort` によって設定されます。Sonnet 5.5 には高速モードがありません。 default モデルはOpus 5.5のままですので、 /model sonnet 切り替えてください。

Sonnet 5.5 をぜひお試しいただき、いつもどおり、ご意見・ご感想をお寄せください。