Claude Sonnet 5.5 APIの使い方

TL;DR

Claude Sonnet 5.5 は、スコープが明確なコーディング、ドキュメント、ツール活用型ワークフロー向けの高速モデルです。Anthropic は、標準のトークン単価が同じ条件で Sonnet 5 比で 30%以上の高速化を報告しています。CometAPI のキー、モデル ID claude-sonnet-5-5 を用意し、Messages または Chat Completions で小さなリクエストから開始してください。既存のエージェントは、展開前に thinking、ツール選択、履歴リプレイを再テストしてください。

Key Takeaways

• Claude Sonnet 5.5 を使用し、エンドポイントに合ったリクエスト形式に合わせてください。
• 画像、ツール、長いコンテキストを追加する前に、短いリクエストを 1 件から始めてください。
• Claude 固有の制御が必要なら Messages、既存の OpenAI SDK アプリなら Chat Completions を使ってください。
• 既存のエージェント ループを移行する前に、thinking とツール選択の挙動を確認してください。
• 受理タスクの品質、レイテンシ、トークン使用量、キャッシュヒットを比較してからトラフィックを拡大してください。

What Is Claude Sonnet 5.5?

Claude Sonnet 5.5 API は、Anthropic の Sonnet 5.5 モデルに対するプログラムインターフェースです。ソフトウェア開発、リポジトリ分析、カスタマーサポートの自動化、ドキュメント処理、画像理解、ツールを使うエージェント、構造化されたプロフェッショナルなワークフローなどのタスク向けに設計されています。

Anthropic は Sonnet 5.5 を、Claude 5.5 ファミリーの 2 番目のモデルである Opus 5.5 を補完する、より高速・低コストなモデルとして位置づけています。よく定義されたコーディング、バグ修正、ドキュメントやスライド作成、日常的な業務タスクに最適化されています。開発者は CometAPI でモデル ID claude-sonnet-5-5 を指定して Claude Sonnet 5.5 API にアクセスできます。

Anthropic は 1M トークンのコンテキストウィンドウと 128K の同期出力上限を確認しています。バッチ出力で 300K トークンに到達できるのは、output-300k-2026-03-24 ベータヘッダー付きの Message Batches のみです。Gateway の機能サポートは、モデルレベルのサポートとは別に確認が必要です。

How Does Claude Sonnet 5.5 Perform on Official Benchmarks?

以下の簡易比較は、API 採用前に評価すべきワークロードを見極める助けになります。ベンチマーク結果は、実際のプロンプトやツールループでの自前テストの代替にはなりません。

Anthropic のベンチマーク結果と評価ノートに基づく比較です。Opus 5.5 の Terminal-Bench は Xhigh の effort を使用しています。FrontierCode は Sonnet 5.5 に対して Max と Xhigh の結果を別々に報告しています。OSWorld は一部のみの評価です。GDPval-AA と AA-Briefcase は、Claude Platform のプレリリース展開で発生した構造化出力の不具合がスコアを過小評価した可能性があると Artificial Analysis が指摘し、Anthropic はその不具合が修正されたと述べています。これらの結果は、運用成果の保証ではなく、ワークロードテストの指針として用いてください。Humanity’s Last Exam はツール使用あり、Chartography はツールなしです。新しい行はAnthropic 公開スコアを使用しています。元の画像はそのまま保持し、拡張表には 3 つの評価を追加しています。

Claude Sonnet 5.5 の公式ベンチマーク比較

What Changed in Claude Sonnet 5.5 API From Sonnet 5?

thinking、ツール選択、履歴リプレイの変更は既存のエージェント ループに影響します。この表は運用上の変更点をまとめたもので、機能一覧の完全版ではありません。

Breaking Changes to Check

以下の 5 つの破壊的変更をすべて確認してください：disabled の thinking を between_tools に置き換える、ツール強制選択を削除する、互換 thinking ブロックと変更されていない会話履歴を保持する、Claude API と Google Cloud では computer_20251124 を computer_toolset_20260801 に移行する、サポートされないアドバイザの組み合わせを置き換える。Amazon Bedrock は依然として computer_20251124 を受け付けます。サポート外のアドバイザには Opus 4.8、4.7、4.6、Sonnet 5、Sonnet 4.6、Haiku 5.5 が含まれます。サポート対象の代替として Opus 5.5 があります。レスポンスブロックはタイプごとに読み取ってください。展開前にプラットフォームおよび gateway の互換性を確認してください。公式移行ガイド。

Additional Capabilities and Workflow Changes

公式の機能ガイドで、進捗アップデート、メッセージ単位の effort、会話中の制御について確認してください。ベータ機能を有効にする前に gateway のサポートを確認してください。

What Do You Need Before Using the Claude Sonnet 5.5 API?

• CometAPI のアカウント、API キー、モデルアクセス、利用可能な請求残高
• cURL が使えるターミナル、SDK 例のための Python と pip または Node.js と npm
• 選択したエンドポイント：/v1/messages または /v1/chat/completions
• サーバ環境に保存した COMETAPI_KEY と、https://api.cometapi.com へのネットワークアクセス
• 短いテストプロンプトと、利用可能な出力・完了ステータス・トークン使用量の明確なチェック

How Do You Access Claude Sonnet 5.5 API Through CometAPI?

Claude の挙動自体が重要な場合は Messages API を選びます。既に Claude、GPT、Gemini、DeepSeek などを同一抽象化層で切り替えるアプリケーションでは OpenAI 互換 API を選びます。

Step 1: Store the API Key

CometAPI の API キーコンソールでキーを作成し、実行環境に設定します。

POSIX シェルで CometAPI キーを設定

export COMETAPI_KEY="YOUR_COMETAPI_KEY"

PowerShell で CometAPI キーを設定

$env:COMETAPI_KEY="YOUR_COMETAPI_KEY"

Step 2: Make the First Messages Request

Anthropic 互換の最初の Messages リクエストを送信

curl https://api.cometapi.com/v1/messages \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 2048,
    "messages": [{"role": "user", "content": "Explain exponential backoff in three bullet points."}]
  }'

より多くの制御を追加する前に、content ブロック、stop_reason、usage を検査してください。上記の cURL 構文は POSIX シェルを使用しています。

Step 3: Use the Anthropic Python SDK

Anthropic Python SDK をインストール

pip install anthropic

Anthropic SDK でテキストブロックと usage を読み取る

import os
import anthropic

anthropic_client = anthropic.Anthropic(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com",
)

response = anthropic_client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Review this migration plan and list the three biggest risks."}],
)

for block in response.content:
    if block.type == "text":
        print(block.text)
print("Completion:", response.stop_reason)
print("Usage:", response.usage)

Step 4: Use the OpenAI Python SDK

OpenAI Python SDK をインストール

pip install openai

OpenAI 互換の Chat Completions 経由で Sonnet 5.5 を呼び出す

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[
        {
            "role": "system",
            "content": "You are a concise software engineering assistant."
        },
        {
            "role": "user",
            "content": "Review this function and identify the highest-risk bug."
        }
    ],
)

print(response.choices[0].message.content)

この方法は、アプリケーションが既に OpenAI SDK インターフェースを使用している場合に有用です。基本的なテキスト連携は、base URL、API キー、モデル ID の変更だけで済むことがありますが、本番移行ではサポートされるパラメータ、レスポンス形式、ツール呼び出し、ストリーミングイベント、タイムアウト、トークン計上を必ず検証してください。

Step 5: Use JavaScript in Node.js

OpenAI の Node.js SDK をインストール

npm install openai

Node.js の ES モジュールから Sonnet 5.5 を呼び出す

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.COMETAPI_KEY,
  baseURL: "https://api.cometapi.com/v1",
});

const response = await client.chat.completions.create({
  model: "claude-sonnet-5-5",
  messages: [
    {
      role: "user",
      content: "Create a TypeScript function that validates an email address.",
    },
  ],
});

console.log(response.choices[0].message.content);

バックエンドの Node.js アプリでは、COMETAPI_KEY をサーバ環境に保持し、ブラウザクライアントへ送らないでください。

Claude Sonnet 5.5 Thinking and Effort Levels

API の既定は High です。Claude のアプリケーションや Claude Code では Medium が使用されます。effort は、受理タスクの品質、レイテンシ、トークンコストに応じて選択してください。以下の表は編集部の出発点であり、公式のワークロード分類ではありません。

すべてのリクエストに自動的に最高の effort を割り当てるのは避けてください。追加の reasoning がツール呼び出しや出力の増加も招く場合、エージェントのワークロードは実質的に高コストになり得ます。タスク単位の評価で設定を選んでください。Xhigh と Max では adaptive thinking を使用し、低い設定と受理タスクの品質・総コストを比較してください。公式の effort ガイダンス。

Configure Effort Through Messages

以下の例は、上で初期化した Anthropic クライアントを使用します。展開前に CometAPI 側の同等制御もテストしてください。

adaptive thinking と High の effort を設定

response = anthropic_client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=8192,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "Audit this service migration plan."}],
)

Turn Off Up-Front Thinking

thinking={"type": "between_tools"} を Low、Medium、High で使用します。Xhigh または Max には adaptive thinking を使用してください。between_tools は display や budget_tokens フィールドを取らず、会話の途中で effort を変更することはできません。

Preserve Thinking in Tool Loops

ツール結果を追加する前に、元の assistant の content ブロックを返してください。thinking の保持は、モデル、会話プレフィックス、生成したアカウントに依存します。プレフィックスのバインディングは、2026-08-31 00:00 UTC 以降に作成されたアカウントでは Claude API、Amazon Bedrock、Google Cloud で既定有効です。すべての gateway が同じバインディング制御を公開するとは限らない点に注意してください。

How to Stream Claude Sonnet 5.5 Responses

Stream Long Responses

ストリーミングは、チャット UI、コーディングアシスタント、長い応答で有用です。生成が完了する前に出力を表示できます。

OpenAI 互換の Chat Completions でテキストをストリーム

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1",
)

stream = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[
        {
            "role": "user",
            "content": "Explain how a retrieval-augmented generation pipeline works."
        }
    ],
    stream=True,
)

for chunk in stream:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

ストリーミングは通常、生成されるトークン総数を減らしません。主な利点は体感レイテンシです。アプリケーションは、中断されたストリーム、部分的な出力、ネットワークリトライ、明示的なキャンセルも処理する必要があります。

Use Tools With Automatic Selection

tool_choice={"type": "auto"} を使用してください。すべてのツール名と引数を検証し、認可とタイムアウトを適用し、構造化結果を返し、反復回数を制限してください。必須のツール実行はアプリケーションのオーケストレーションで行ってください。

チケット参照ツールを定義し、自動選択を要求

tools = [{
    "name": "lookup_ticket",
    "description": "Retrieve a support ticket by ID",
    "input_schema": {
        "type": "object",
        "properties": {"ticket_id": {"type": "string"}},
        "required": ["ticket_id"],
        "additionalProperties": False,
    },
}]

response = anthropic_client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    tools=tools,
    tool_choice={"type": "auto"},
    messages=[{"role": "user", "content": "Look up ticket T-123 and summarize its status."}],
)

tool_use ブロックはアクションを要求します。この最初の呼び出しは実行しません。サーバ側でリクエストを検証し、操作を実行し、assistant の content を変更せずに追加し、対応する tool_result を返してください。このスキーマでもアプリケーション側の検証は必要です。選択した経路での厳密なツールサポートは別途確認してください。

Use Prompt Caching for Repeated Context

プロンプトキャッシングは、同一の大きなプレフィックス（システムポリシー、ツールスキーマ、リポジトリマップ、製品ドキュメント、再利用指示、リファレンスマニュアルなど）を繰り返し含むリクエストに有用です。

Sonnet 5.5 では、キャッシュ可能なプロンプトプレフィックスは少なくとも 512 トークンが必要です。より短いプレフィックスは、cache_control を設定してもキャッシュされずに処理されます。cache_creation_input_tokens と cache_read_input_tokens を確認してください。両方がゼロならキャッシュは使用されていません。gateway ルートでのサポートを確認してください。プロンプトキャッシングのリファレンス。

動的なリクエスト内容の前に安定したコンテキストを配置

Stable system instructions
Stable tools
Stable repository or knowledge context
---------------- cache boundary ----------------
Current user request
Current retrieved context

現在の CometAPI のキャッシュ読み取り単価は 100 万トークンあたり $0.16 で、新規入力の $1.60 と比べて安価です。キャッシュ書き込みは別料金です。見積もりの前に usage メタデータでキャッシュヒットを確認してください。

キャッシングは、リクエストの各ターンで大きなコンテキストプレフィックスを再利用するコーディングエージェントやエンタープライズアシスタントに特に有効です。ただし、安定プレフィックスを書き換える頻度が高いと期待する効果が失われる場合があります。

Send Images Using the Selected Endpoint Schema

Sonnet 5.5 はテキストと画像の入力を受け付けます。以下の JSON は OpenAI 互換 Chat Completions のペイロード例です。画像 URL は公開アクセス可能な管理下の画像に置き換えてください。Messages は異なる image ブロックスキーマを使用します。

Chat Completions のペイロードで画像を送信

{
  "model": "claude-sonnet-5-5",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Find the three most important UI problems in this screenshot."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/interface.png"
          }
        }
      ]
    }
  ]
}

マルチモーダルリクエストの正確な形状は、Claude ネイティブと OpenAI 互換のインターフェースで異なる場合があります。実際に展開するエンドポイントのスキーマを使用し、両者が相互に代替可能と仮定しないでください。

Handle Safeguards and Retained Data

拒否やフォールバックの挙動を明示的なアプリケーション状態として記録してください。Anthropic は自社サービスのセーフガードとゼロデータ保持の可用性について説明しています。本番データ送信前に、利用する gateway での保持とルーティングの取り決めを別途検証してください。

Claude Sonnet 5.5 vs Sonnet 5 vs Opus 5.5

以下の定性的ラベルは、タスクスコープに基づく編集部のルーティング指針であり、公式の性能等級ではありません。代表的なワークロードでこれらの役割を検証してください。詳細なアーキテクチャをベンチマークスコアから推測することは意図していません。

難しいタスクをエスカレーションモデルへルーティング

Routine task
    ↓
Claude Sonnet 5.5
    ↓
Confidence / validation failure?
    ├── No → Return result
    └── Yes → Escalate difficult case
                 ↓
              Opus-class model

このルーティングパターンは、難しいケースのためのより強力な推論ティアへのアクセスを維持しつつ、コスト削減に寄与します。

Claude Sonnet 5.5 Pricing Through CometAPI

2026 年 10 月 10 日時点の確認：CometAPI の入力/出力は引き続き $1.60/$8（100 万トークンあたり）で、Anthropic の $2/$10 より 20% 低い水準です。CometAPI のキャッシュ読み取り/書き込みは $0.16/$2 のまま。Anthropic の現在のキャッシュ読み取り/書き込みは 5 分 TTL で $0.10/$2.50 です。ローンチページは依然として $0.20 のキャッシュ読み取りを表示していますが、本稿は最新のキャッシングリファレンスに基づきます。Gateway の価格は独立して変更される可能性があります。

トークン単価とタスクコストの差は、エージェントアプリケーションでは重要です。コーディングエージェントは、生成トークンが少なくても、複数回のツール呼び出し、キャッシュ読み取り、コード検査、リトライ、検証を行う場合があります。そのため、成功裏に完了したタスクあたりのコストは、入力トークン単価よりも一般に有益な指標です。

新規入力と出力トークンの料金見積り

Input:
100,000 / 1,000,000 × $1.60 = $0.16

Output:
5,000 / 1,000,000 × $8.00 = $0.04

Estimated model-token cost:
$0.20

ツール料金、キャッシュ操作、エージェントの反復、その他の課金対象機能により最終コストは変動します。

2026 年 10 月 10 日にCometAPI の現行モデルページで再確認済み。新規入力/出力の価格は不変のため、作業例は新規入力 100,000 と出力 5,000 トークンで $0.16 + $0.04 = $0.20 のままです。キャッシュ書き込み、キャッシュ読み取り、ツール料金、リトライは含みません。予算策定前に経路ごとの請求仕様を再確認してください。

Control Cost per Accepted Task

モデルを即時に切り替えずに支出を抑える実践的手段がいくつかあります。第一に、受理条件を明確に定義します。

集中した応答の受理フォーマットを定義

Return only:
1. the root cause;
2. the affected file;
3. the smallest safe fix;
4. one regression test.

第二に、送信前に取得コンテキストを絞り込んでください。1M トークンのコンテキストウィンドウは上限であって目標ではありません。第三に、安定したコンテキストはプロンプトキャッシングで再利用してください。第四に、すべてを High にせず、ワークロードに応じて effort を選んでください。第五に、受理タスクあたりのコストを測定します。

受理タスクあたりのコストを計算

Total API cost
÷
Number of outputs accepted without rework

リクエストを安くしても、リトライ、修正、ツール呼び出しの増加を招く場合は、ワークフロー全体では安くなりません。

How Do You Migrate From Sonnet 5 to Claude Sonnet 5.5 API?

1. ロールバックのために従来の本番構成を保持します。
2. モデル ID を claude-sonnet-5 から claude-sonnet-5-5 に変更します。
3. 上述の thinking、ツール選択、履歴の変更を適用します。
4. 代表的なリクエスト（ツール、画像、ストリーミングを含む）を再生します。
5. 受理出力、人手修正率、p50/p95 レイテンシ、タスク総コストを比較します。
6. リトライ、拒否、キャンセル、中断ストリームを検証します。
7. usage メタデータでキャッシュヒットと出力予算の挙動を確認します。
8. 小規模のカナリアトラフィックを展開し、受理基準を満たした後にのみ拡大します。

Troubleshooting Claude Sonnet 5.5 API Errors

不正なリクエストや認証失敗をそのままリトライしないでください。中断したエージェント実行を再生する際、重複ツールアクションを防止してください。

Claude Sonnet 5.5 Production Best Practices

ワークロードを選定し、受理ゲートを定義し、アプリケーション全体を評価してください。モデル ID、エンドポイント、effort、レイテンシ、トークンとキャッシュ使用、ツール失敗、完了ステータス、受理タスクの結果を記録します。キーはサーバ側に保持し、タイムアウト、有界リトライ、エージェントの反復回数上限を設定してください。

Measure Workflow Quality and Reliability

コーディングエージェントでは、テスト合格数、不必要に変更されたファイル、差し戻されたパッチ、人の介入なしでの完了率も追跡してください。

Example: Fix a Well-Scoped Repository Bug

失敗するテスト、関連ソースファイル、期待される動作を提供します。回帰チェック付きの集中的なパッチを依頼してください。受理ゲートは、再現可能な修正、関連テストの合格、無関係な編集がないことです。受理されたパッチに対する API とツールの総コストを比較します。

Example: Triage a Support Ticket

顧客の問題と承認済みナレッジベースの抜粋を取得します。問題を分類し、根拠のある回答案を作成し、エスカレーションが必要なケースをフラグ付けするようモデルに依頼します。取得した資料と主張が一致し、ルーティング判断がサポート方針に従う場合のみ結果を受理します。

Example: Review a Document and Screenshot

承認済み手順と対応するインターフェースのスクリーンショットを提供します。該当箇所と可視 UI 要素への参照付きで相違点を求めてください。手順を変更する前にレビュアーによる確認を必須とします。

Conclusion

Claude Sonnet 5.5 は、チームにとって高速なコーディング、サポート、ドキュメント、ツール活用型ワークフローの実用的な候補を提供します。まずは動作する CometAPI リクエストから始め、アプリケーションに必要な制御を段階的に追加してください。

移行は単にモデル ID を置き換えるだけでは足りません。thinking 設定、自動ツール選択、レスポンス解析、履歴リプレイを確認してください。評価で品質・レイテンシ・コストのバランスが許容範囲と示されたときにモデルを昇格させ、受理ゲートで失敗するタスクには上位ティアを確保してください。

FAQ

How Should Teams Rotate a Claude Sonnet 5.5 API Key Without Downtime?

サーバ側のシークレットマネージャにキーを保存し、アプリコードに埋め込まずにワーカーが資格情報を再読み込みできるようにします。プロバイダが重複有効なキーをサポートする場合は、新キーを先に導入して小さなリクエストで検証し、ワーカーを段階的に切り替えた後、旧キーを失効させます。切り替え中は認証エラーを監視し、どちらのキーもログ出力しないでください。

How Can a Claude Sonnet 5.5 Job Resume After a Worker Restart?

ジョブ ID、最後に完了したステップ、リクエスト構成、ツール実行記録を永続化し、検証済みチェックポイントから再開します。ツールアクションを再生する前に、既に完了していないか、再実行が安全かを確認してください。保存されたトランスクリプトだけでは、重複チケット、メッセージ、DB 書き込みを防止できません。

How Should Teams Detect Claude Sonnet 5.5 Behavior Changes Over Time?

受理済み回答または受理チェック、SDK バージョン、リクエスト設定を含む日付付き評価セットを保持します。プロバイダ、SDK、プロンプト、ルーティングの変更後や定期的に再実行してください。タスク成功、修正率、レイテンシ、総コストを比較します。アカウントがバージョン固定を提供する場合は、その保証内容を確認してから依存してください。重要なワークフローにはロールバックルートを維持してください。