Claude Sonnet 5 API の使い方

クイックアンサー

Claude Sonnet 5 API は、Anthropic の新しい Sonnet クラスのモデルで、コーディングエージェント、長文脈推論、ツール利用、プロフェッショナルなナレッジワークに対応しています。Anthropic は 2026 年 6 月 30 日に Claude Sonnet 5 を発表し、これまでで最もエージェント指向の Sonnet モデルであり、Claude Sonnet 4.6 からの大幅なアップグレードと位置づけています。開発者は CometAPI を通じて、モデル ID claude-sonnet-5 を用い、ネイティブな Anthropic Messages エンドポイント POST /v1/messages または OpenAI 互換のエンドポイント POST /v1/chat/completions 経由で利用できます。

Claude Sonnet 5 が今重要な理由

Anthropic は 2026 年 6 月 30 日に Claude Sonnet 5 を投入し、エージェントシステムを構築する開発者を直接ターゲットにしています。同社は Sonnet 5 を、これまでで最もエージェント指向の Sonnet モデルと説明し、計画立案、ツール利用、コーディング、ブラウザ作業、ターミナル作業、プロフェッショナルな推論でより強力になったとしています。最も重要な位置づけは、Sonnet 5 が高速・高コスト効率という Sonnet ティアに留まりつつ、Claude Opus 4.8 との性能差を縮めた点です。

これは、マーケットが単純なチャット補完を超えて進化したため、重要です。本番 AI アプリケーションでは、長いコンテキストを読み、ツールを呼び出し、コードを書き、ドキュメントを精査し、ブラウザを使い、ターミナルコマンドを実行し、エラーから復旧し、マルチステップのワークフローを完了できるモデルがますます必要になっています。Claude Sonnet モデルは、歴史的にコーディングやエージェントのワークフローで人気があり、Sonnet 5 はまさにそのカテゴリ向けに設計されています。

このリリースは、開発者の API 制御に対する考え方も変えます。Claude Sonnet 5 はデフォルトでアダプティブシンキングを使用します。このモデルでは手動の拡張思考バジェットが廃止され、Anthropic の移行ノートでは、temperature、top_p、top_k といったデフォルト以外のサンプリング設定は 400 エラーを返す可能性があるとしています。言い換えると、Sonnet 4.6 からの移行は単なるモデル名の置き換えではありません。

Claude Sonnet 5 API とは？

Claude Sonnet 5 API は、Anthropic の Sonnet 5 モデルのプログラムインターフェースです。テキスト生成、コーディング、ツール利用、ドキュメント推論、画像理解、長文脈ワークフローに対応しています。CometAPI におけるモデル ID は次のとおりです。

claude-sonnet-5

主に 2 つの方法で呼び出せます。

1. Claude ネイティブの動作、アダプティブシンキング、エフォート制御、プロンプトキャッシュ、ツール、ウェブ検索、ストリーミング、Anthropic 形式のレスポンスを必要とする場合は、CometAPI の Anthropic Messages エンドポイントを使用します。
2. 既存のアプリケーションが OpenAI 形式のチャット補完を使っており、Claude/GPT/Gemini その他のモデルファミリーにまたがるルーティングを容易にしたい場合は、CometAPI の OpenAI 互換チャットエンドポイントを使用します。

多くの本番チームにとって、Claude 固有のエージェントワークフローにはネイティブの Messages エンドポイントが最適な第一選択です。OpenAI 互換エンドポイントは、可搬性、モデル比較、最小限の移行作業が重視される場合に適しています。

Claude Sonnet 5 クイックスペック

Claude Sonnet 5 API の新機能: 主要イノベーション

Anthropic は、実世界のエージェント信頼性に焦点を当て、Sonnet 4.6 からの大幅なアップグレードとして Sonnet 5 を位置づけています。

1. 新しいトークナイザーとトークン効率

Sonnet 5 は（Opus 4.7 に類似した）更新版トークナイザーを使用しています。同じ入力テキストがコンテンツタイプに応じて約 1.0–1.35 倍のトークンにマッピングされ、平均で約 30% 増加します。

影響: 導入価格（2026 年 8 月 31 日まで input/output それぞれ $2/$10 per 1M tokens）により、移行は概ねコスト中立になります。以降の標準価格は $3/$15 で、Sonnet 4.6 とトークン単価は同等ですが、トークン増によりタスクあたりのコストは上がる可能性があります。新モデルで常にトークンを再カウントしてください。

2. 能力の改善

Sonnet 5 は、ベンチマーク上で Sonnet 4.6 に対して大幅な向上を示しています。

• コーディング & エージェントタスク: SWE-bench 風評価、エージェント検索（BrowseComp）、コンピュータ操作（OSWorld-Verified）で Opus 4.8 に近づきました。
• 推論 & ナレッジワーク: 持続的な集中、自己検証、ブラウンフィールドコードやマルチステップのプロフェッショナルタスクへの対応が向上。
• マルチモーダル & ツール利用: 並列ツール呼び出しとビジョン能力が強化。

性能は effort レベル（low/medium/high/xhigh）に応じてスケールし、コストパフォーマンスの細かなトレードオフが可能です。高い effort では、多くのタスクで Opus に匹敵または接近します。

初期ユーザーフィードバックでは、複雑なタスクのより迅速な完了、幻覚の減少、実世界の実行性の向上が強調されています。

3. サイバーセキュリティ保護 & セーフティ

• 4.6 より全体的な望ましくない振る舞いが低減。
• Opus と比較してサイバーエクスプロイト能力が低下（Firefox 脆弱性テストで完全エクスプロイト 0%）。
• デフォルトでサイバー保護が有効 — 危険な使用をリアルタイムに検知・ブロック（Opus 4.7/4.8 と同様、一部上位モデルよりは緩やか）。

これにより、サイバーセキュリティに敏感な環境の本番エージェントでも Sonnet 5 をより安全に利用できます。

Claude Sonnet 5 は、サイバー関連推論で Sonnet 4.6 より強力ですが、Opus 4.8 ほどではなく、評価されたサイバータスクでは Mythos 5 よりかなり下です。

API の重要なポイントは、保護機能がモデル能力に応じてスケールすることです。Anthropic は、トラフィック全体に分類器ベースの保護を施しており、禁止用途、高リスク両用途、両用途などのカテゴリを説明しています。禁止用途と高リスク両用途のやり取りはデフォルトでブロックされる一方、脆弱性検出など通常の両用途のセキュリティタスクはデフォルトでブロックされません。

正当なセキュリティチームにとって、Sonnet 5 はコードレビュー、安全な設定ガイダンス、脆弱性のトリアージ、インシデント文書化、パッチ計画などの防御的作業に有用となり得ます。

Claude Sonnet 5 のアダプティブシンキング

アダプティブシンキングは、Claude Sonnet 5 における開発者向けの最重要な変更点の一つです。各コールごとに思考バジェットを手動指定させるのではなく、タスクに応じて Claude が推論の労力度を動的に割り当てます。

アダプティブシンキングは Sonnet 5 の目玉機能の一つです。推論の深さを動的に調整します。

• Effort Levels: Low（高速/低コスト）、Medium、High（より深い分析）、およびアダプティブな選択肢。
• デフォルト: Sonnet 5 の API/Claude Code では High。
• 利点: 品質とコスト/レイテンシのバランス。高い effort は複雑なタスクで優れますが、より多くのトークンを消費します。

プロンプト例:

Use adaptive thinking for this task: Quick overview first, then detailed analysis and code if critical issues are found.

旧来の Claude 統合では、次のような拡張思考コントロールを使うことがよくありました。

{
  "thinking": {
    "type": "enabled",
    "budget_tokens": 32000
  }
}

Claude Sonnet 5 では、その旧パターンは使用しないでください。Anthropic の Sonnet 5 移行ノートによれば、手動の拡張思考バジェットは削除され、400 エラーを返す可能性があります。代わりにアダプティブシンキングとエフォート制御を使用します。

エフォート制御の仕組み

effort パラメータにより、モデルがどれだけ作業を行うかをより簡単に影響させることができます。Anthropic の現在の effort レベルには、low、medium、high、xhigh、max があり、high がデフォルト（パラメータ省略と同等）です。実務上のポリシー例は以下のとおりです。

アーキテクチャ上のパターンは安定しています。難しいタスクは高い effort に、簡単なタスクは低い effort にルーティングします。

なぜ CometAPI で Claude Sonnet 5 API を使うのか？

CometAPI は、複数のモデルファミリーを 1 つの統合レイヤーで扱いたいチームに有用です。各モデルごとに個別のプロバイダ統合を構築する代わりに、Claude、GPT、Gemini、画像モデル、動画モデル、埋め込みモデルなどの API を、1 つのアカウントと 1 つのアプリケーションアーキテクチャの背後でルーティングできます。

Claude Sonnet 5 について、CometAPI には 3 つの実践的な利点があります。

第一に、CometAPI は Claude Sonnet 5 を、ネイティブな Anthropic Messages エンドポイントと OpenAI 互換エンドポイントの両方で公開します。これは、チームが本格的なエージェントワークフローには Claude ネイティブ機能を使いながら、OpenAI 形式のチャット補完を既に用いるアプリケーション内で Sonnet 5 をテストできることを意味します。

第二に、CometAPI のカタログはモデル比較を容易にします。同じプロンプトスイートを、Sonnet 5、Sonnet 4.6、Opus ティアのモデル、GPT クラスのモデル、Gemini クラスのモデル、特化型モデルに対して実行できます。これは、コーディングに最適なモデルがドキュメント抽出、カスタマーサポート、レイテンシ重視のチャット、コスト重視のバッチ処理に最適とは限らないため重要です。

第三に、CometAPI は本番ルーティングに役立ちます。コーディングとエージェント的推論のデフォルトモデルとして Sonnet 5 を起点にしつつ、可用性、予算、レイテンシ、拒否挙動に対するフォールバックルールを追加できます。成熟した AI システムは、1 つのモデル名に永遠に固定されるべきではありません。

CometAPI で Claude Sonnet 5 API を使う方法

以下の例はサーバーサイドコードを使います。CometAPI キーをブラウザの JavaScript、モバイルアプリ、公開リポジトリ、クライアントサイドのログに露出させないでください。

Step 1: CometAPI キーの作成と保存

API キーを環境変数として保存します。

export COMETAPI_KEY="your_cometapi_key"

Windows PowerShell:

$env:COMETAPI_KEY="your_cometapi_key"

Step 2: 適切なエンドポイントを選ぶ

Claude ネイティブの動作が必要な場合は POST /v1/messages を使用:

https://api.cometapi.com/v1/messages

OpenAI 互換チャットが必要な場合は POST /v1/chat/completions を使用:

https://api.cometapi.com/v1/chat/completions

推奨: 新しい Claude Sonnet 5 のエージェントシステムにはまず /v1/messages から開始してください。既に OpenAI SDK ラッパー、モデルルータ、マルチモデル評価ツールをチャット補完に基づいて構築している場合は、/v1/chat/completions を使用します。

Step 3: cURL で Claude Sonnet 5 を呼び出す

最も簡単なネイティブ Messages API の例です。

curl https://api.cometapi.com/v1/messages \  -H "Authorization: Bearer $COMETAPI_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "claude-sonnet-5",    "max_tokens": 1200,    "messages": [      {        "role": "user",        "content": "Write a concise migration checklist for moving a Node.js API from Express 4 to Express 5."      }    ]  }'

Sonnet 5 では、旧来のサンプリング上書きや手動の思考バジェットは、ルートが現行ドキュメントで明示的にサポートしていない限り追加しないでください。推論はアダプティブシンキングに任せ、対応している場合はエフォート制御を使いましょう。

Step 4: Anthropic SDK を使った Python 例

多くの Anthropic SDK のワークフローは、ベース URL と API キーを設定することで CometAPI に向けられます。

import osimport anthropic​client = anthropic.Anthropic(    base_url="https://api.cometapi.com",    api_key=os.environ["COMETAPI_KEY"],)​message = client.messages.create(    model="claude-sonnet-5",    max_tokens=1500,    messages=[        {            "role": "user",            "content": (                "Review this deployment plan for a payments API. "                "Return the top risks, missing tests, and rollout checklist."            ),        }    ],)​for block in message.content:    if getattr(block, "type", None) == "text":        print(block.text)

CometAPI のルートが、Anthropic の現行ドキュメントと同じ形でエフォート制御をサポートしている場合は、より難しい作業向けに effort 設定を追加できます。

message = client.messages.create(    model="claude-sonnet-5",    max_tokens=3000,    thinking={"type": "adaptive"},    output_config={"effort": "high"},    messages=[        {            "role": "user",            "content": "Analyze this incident report and propose a root-cause investigation plan.",        }    ],)

プロバイダやアグリゲータのスキーマは進化し得るため、本番投入前にステージングで effort パラメータをテストしてください。ルートが output_config を拒否する場合は、削除するか、CometAPI の現行ドキュメントに記載されたパラメータ形に合わせてください。

Step 5: OpenAI 互換のチャット補完例

アプリケーションが既に OpenAI 互換のチャット補完を使用している場合は、この経路を利用します。

curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: "application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {
        "role": "system",
        "content": "You are a senior backend engineer. Be precise and practical."
      },
      {
        "role": "user",
        "content": "Design a retry strategy for a webhook delivery service. Include database fields and failure states."
      }
    ],
    "max_completion_tokens": 1800,
    "stream": false
  }'

OpenAI 互換ルートは可搬性に優れていますが、すべての Claude ネイティブ機能がチャット補完に完全に対応すると想定しないでください。高度な Claude ワークフローには、Messages エンドポイントを優先してください。

Step 6: ストリーミング例

ストリーミングは、チャット、コーディングアシスタント、長文レポートの知覚レイテンシを改善します。

const response = await fetch("https://api.cometapi.com/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "claude-sonnet-5",
    max_tokens: 2500,
    stream: true,
    messages: [
      {
        role: "user",
        content: "Write a production runbook for investigating elevated API error rates.",
      },
    ],
  }),
});

if (!response.ok) {
  throw new Error(`Stream failed: ${response.status} ${await response.text()}`);
}

for await (const chunk of response.body) {
  process.stdout.write(Buffer.from(chunk).toString("utf8"));
}

本番では、生のチャンクを出力するのではなく、Server-Sent Events をパースしてください。また、ネットワーク切断、部分レスポンス、リトライの冪等性、ユーザーキャンセルも扱いましょう。

コンピュータ操作 / エージェント的フロー: ブラウザ/ターミナル制御用のツールと組み合わせてください。Sonnet 5 はここで力を発揮します。

CometAPI のベストプラクティス:

• コストを使用状況ダッシュボードで監視
• モデルを A/B テスト（例: Sonnet 5 vs. Opus 4.8）
• 予算アラートを設定
• CometAPI エンドポイントを指定して Claude Code 統合に利用

Claude Sonnet 5 のプロンプト設計のヒント

Claude Sonnet 5 は、タスクが明確で成功基準が明示されているときに最も良く機能します。

コーディングやエージェントタスクには、次の構成を使ってください。

Goal: [what should be achieved]
Context: [repo, system, constraints, known facts]
Inputs: [files, logs, tickets, data]
Rules: [must not change, security requirements, output format]
Success criteria: [tests pass, plan quality, risk list, exact schema]
Output: [what you want returned]

例:

Goal: Find likely causes of increased checkout API latency.
Context: The service is Node.js, PostgreSQL, Redis, and Stripe webhooks.
Inputs: I will provide logs, traces, recent deploy notes, and database metrics.
Rules: Do not invent metrics. Separate evidence from hypotheses.
Success criteria: Return the top 5 likely causes, what evidence supports each one, and the next query or dashboard to check.
Output: A table followed by a 30-minute investigation plan.

CometAPI における Claude Sonnet 5 の価格

この記事の執筆時点で確認した CometAPI カタログでは、claude-sonnet-5 は以下のとおりです。

顧客向けの価格を公表する前に、必ず CometAPI ダッシュボードで最新価格を確認してください。モデル価格は変更される場合があり、エンタープライズ契約は公開カタログと異なる場合があります。

コスト見積もり例

def estimate_sonnet5_cost(input_tokens, output_tokens):
    input_price_per_million = 1.60
    output_price_per_million = 8.00

    input_cost = (input_tokens / 1_000_000) * input_price_per_million
    output_cost = (output_tokens / 1_000_000) * output_price_per_million
    return round(input_cost + output_cost, 6)


print(estimate_sonnet5_cost(input_tokens=120_000, output_tokens=8_000))
print("Expected output: 0.256")

長文脈の分析で 120,000 input tokens と 8,000 output tokens を使用する場合、確認時点の CometAPI カタログ価格では約 $0.256 と見積もられます。別途、プラットフォーム手数料、割引、税金、将来の価格変更は含みません。

エージェントワークフローでは、解決済みタスクあたりのコストも測定してください。高い effort の Sonnet 5 で 1 回でチケットを完了できるコーディングエージェントは、低コストモデルで再試行や人手の修正を繰り返すよりも安上がりな場合があります。

Claude Sonnet 4.6 からの移行ガイド

移行は単純ですが、非互換の変更点に注意が必要です。

Sonnet 4.6 から Sonnet 5 に変わる点

移行チェックリスト

1. モデル名の更新: "claude-sonnet-4-6" を "claude-sonnet-5" に変更。
2. トークナイザー & コスト: プロンプトを再テストし、トークンを再カウント。約 30% 増を想定。
3. 思考設定: 旧拡張思考をアダプティブ（thinking: {type: "adaptive"}）+ effort レベルに置換。手動の budget_tokens は廃止/削除。
4. サンプリングパラメータ: temperature、top_p、top_k を削除（スタイル制御はシステムプロンプトを使用）。
5. 徹底テスト: エージェントフロー、ツール利用、出力パースの回帰テストを実施。コスト検証も行う。
6. レート制限: 引き上げが可能な場合あり。自分のティアを確認。
7. アダプティブシンキングで予算が必要になる場合に備え、max_tokens を増やす。

後方互換的な移行コード

async function runClaudeTask({ prompt, taskType, useSonnet5 = true }) {
  const model = useSonnet5 ? "claude-sonnet-5" : "claude-sonnet-4-6";
  const effort =
    taskType === "coding_agent" || taskType === "security_review"
      ? "high"
      : "medium";

  const body = {
    model,
    max_tokens: taskType === "coding_agent" ? 5000 : 1800,
    thinking: useSonnet5 ? { type: "adaptive" } : undefined,
    messages: [{ role: "user", content: prompt }],
  };

  if (useSonnet5) {
    body.output_config = { effort };
  }

  const response = await fetch("https://api.cometapi.com/v1/messages", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(body),
  });

  if (response.status === 400 && useSonnet5) {
    // Retry once without optional Sonnet 5-only controls in case the route schema changed.
    delete body.output_config;
    const retry = await fetch("https://api.cometapi.com/v1/messages", {
      method: "POST",
      headers: {
        Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(body),
    });

    if (!retry.ok) {
      throw new Error(`Retry failed: ${retry.status} ${await retry.text()}`);
    }

    return retry.json();
  }

  if (!response.ok) {
    throw new Error(`Claude request failed: ${response.status} ${await response.text()}`);
  }

  return response.json();
}

このパターンにより、アプリケーションを脆弱にすることなく Sonnet 5 をテストできます。フォールバックモデルを保持し、スキーマエラー時にオプションフィールドを取り除き、難しいワークロードは高い effort にルーティングできます。

無料の Claude Sonnet 5 API はある？

Anthropic が無制限の無料 Claude Sonnet 5 API を提供しているという信頼できる公開情報はありません。ただし、開発者は CometAPI の無料トライアルクレジットで Claude Sonnet 5 のテストを開始できます。CometAPI アカウントを作成すると、新規ユーザーには $1 の無料クレジットが付与され、サポートされているモデルの探索や初期 API テストに使用できます。その後、必要に応じて予算を追加してください。

Claude Sonnet 5 API に関する FAQ

Claude Sonnet 5 API とは？

Claude Sonnet 5 API は、Anthropic の Sonnet 5 モデルの開発者向けインターフェースです。コーディング、エージェント、ツール利用、長文脈推論、ドキュメント分析、プロフェッショナルワークに対応する高性能 AI モデルです。

CometAPI で Claude Sonnet 5 API を使うには？

CometAPI のモデル ID は claude-sonnet-5 を使用します。Claude ネイティブの動作には POST https://api.cometapi.com/v1/messages にリクエストを送信します。OpenAI 互換のチャットには POST https://api.cometapi.com/v1/chat/completions を使用します。

Claude Sonnet 5 の新機能は？

エージェント的コーディングとツール利用の強化、1M-token のコンテキストウィンドウ、デフォルトのアダプティブシンキング、エフォート制御、新しいトークナイザー、サイバー関連および高リスク要求への更新された保護機能が追加されています。

Claude Sonnet 5 はアダプティブシンキングをサポートしますか？

はい。Claude Sonnet 5 ではアダプティブシンキングがデフォルトで有効です。旧来の手動の拡張思考バジェットは使用せず、対応している場合はエフォート制御を使用してください。

新しい Claude Sonnet 5 のトークナイザーはなぜ重要ですか？

Claude Sonnet 4.6 と同じテキストでも、約 30% 多いトークンが生成される可能性があります。これはコスト、コンテキストパッキング、プロンプトキャッシュ、チャンク分割、max_tokens 設計に影響します。

CometAPI と Anthropic 直接連携: どちらが良い？

CometAPI は統合アクセス、低価格、マルチモデル実験の容易さを提供し、ほとんどの開発者に理想的です。

すぐに Claude Sonnet 4.6 から Claude Sonnet 5 に移行すべきですか？

段階的に移行してください。サポートされないパラメータを削除し、トークンを再カウント、内部評価を実行、コストと拒否挙動を監視、Sonnet 4.6 をフォールバックとして維持し、その後徐々に本番トラフィックを Sonnet 5 にルーティングします。

最終的なポイント

Claude Sonnet 5 API は、Sonnet クラスのモデルをよりエージェント的な作業へと押し進めた、2026 年の最重要な開発者向けモデルリリースの一つです。最も強力なユースケースは、コーディングエージェント、ターミナルワークフロー、長文脈分析、ツール利用、マルチモーダルなドキュメント推論、プロフェッショナルな自動化です。移行は単なるモデル名の変更より繊細で、Sonnet 5 は新しいトークナイザー、デフォルトのアダプティブシンキング、エフォートベースの制御、変更されたサンプリング挙動、更新されたサイバーセキュリティ保護を導入しています。

推奨: 今日から CometAPI を使って、無料クレジット、低コスト、統合管理で Sonnet 5（および 500+ の他モデル）へシームレスにアクセスしましょう。CometAPI に登録し、数分で統合、そして自信を持ってスケールしてください。