Anthropicは2026年6月30日にClaude Sonnet 5をリリースしました。これはSonnet 4.6のドロップイン代替品です。モデルIDを変更するだけで、ほとんどの場合、コードは引き続き機能します。しかし、その文の「ほとんどの場合」という部分が重要です。Sonnet 5は新しいトークナイザーを搭載しており、アダプティブシンキングがデフォルトでオンになり、いくつかのリクエストパラメーターがエラーを返すようになりました。この記事では、何が変更され、そのコストはどれくらいで、ワークロードにとってアップグレードする価値があるのかを正確に解説します。
要するに、トークンあたりの価格は同じで、コーディングやエージェントタスクでのスコアは向上し、3つの小さなコード変更と、トークン数と予算に影響する見落としがちなトークナイザーの注意点があります。本番環境でスイッチを切り替える前に、詳細を読んでください。
アップグレードの概要
Sonnet 5 はSonnet 4.6と同じトークンごとの価格設定を維持しているため、トークンあたりで請求額が変わることはありません。ツール使用とコーディングにとって重要なベンチマークが向上しています。また、デフォルトの動作が十分に変わったため、盲目的な交換では驚くかもしれません。
以下に比較を示します。
| 属性 | Sonnet 4.6 (claude-sonnet-4-6) |
Sonnet 5 (claude-sonnet-5) |
|---|---|---|
| リリース | 前モデル | 2026年6月30日 |
| コンテキストウィンドウ | 最大1Mトークン | 1Mトークン (デフォルトおよび最大) |
| 最大出力 | 128Kトークン | 128Kトークン |
| 思考のデフォルト | thinking フィールドがない場合はオフ |
アダプティブシンキングがデフォルトでオン |
拡張思考 (budget_tokens) |
非推奨 | 400エラーを返す |
サンプリングパラメーター (temperature, top_p, top_k) |
受け入れられる | 非デフォルト値は400エラーを返す |
| トークナイザー | 古いトークナイザー | 新しいトークナイザー (テキストあたりのトークン数が約30%増加) |
| 標準価格 | 入力1Mあたり3ドル / 出力1Mあたり15ドル | 入力1Mあたり3ドル / 出力1Mあたり15ドル |
| 導入価格 | 該当なし | 2026年8月31日まで入力1Mあたり2ドル / 出力1Mあたり10ドル |
Sonnet 4.6で動作する他のすべての機能は、構造化出力、ビジョン、プロンプトキャッシュ、ツール使用、バッチ処理など、追加のコード変更なしでSonnet 5でも動作します。失われる唯一のプラットフォーム機能は、Sonnet 5では利用できないプライオリティティアです。
向上した点：ベンチマーク
Sonnet 5は、これまでで最もエージェント的なSonnetモデルとして位置づけられており、報告されている数値はツールを多用する作業においてそれを裏付けています。これらはAnthropicのリリース時のベンチマークであり、リリース日の記事でも確認されています。これらは報告された数値として扱い、独立したテスト結果とは見なさないでください。
| ベンチマーク | Sonnet 4.6 | Sonnet 5 |
|---|---|---|
| SWE-bench Pro (エージェント的コーディング) | 58.1% | 63.2% |
| OSWorld-Verified (コンピュータ使用) | 78.5% | 81.2% |
これは、Sonnetが最も使われているタスク（ツールを使ったコードの作成と修正、コンピューターやターミナルの操作）での大きな飛躍です。Anthropicはまた、Sonnet 5がツールが関与するとOpus 4.8に近い性能を発揮し、エージェントタスクでは数ポイント差で、はるかに低いコストで提供されると報告しています。アプリがエージェント型である場合、これは待ち望んでいたアップグレードです。プレミアムモデルとの直接比較については、Sonnet 5 vs Opus 4.8を参照してください。
Sonnet 5はAnthropicの基準では4.6よりも安全です。望ましくない振る舞いの発生率が低く、幻覚や従順性が低減され、プロンプトインジェクションに対する耐性が向上しています。リアルタイムのサイバーセキュリティ保護機能を備えた初のSonnetティアモデルです。知っておくべき動作の1つとして、禁止されたリクエストの拒否は、エラーではなく、stop_reason: "refusal"を伴う成功したHTTP 200として返されます。レスポンスの解析時にこの停止理由を処理してください。
3つの実際のコード変更
ほとんどの移行では、これら3点のみが変更されます。これらを確認し、必要に応じて調整すれば、残りの統合は変更されません。
1. アダプティブシンキングがデフォルトでオンに
Sonnet 4.6では、thinkingフィールドがない場合、思考は行われませんでした。Sonnet 5では、thinkingフィールドのないリクエストはアダプティブシンキングがオンの状態で実行されます。モデルはタスクに基づいてどの程度思考するかを決定し、あなたはeffortパラメーター（low、medium、high、またはxhigh）で深さを制御します。
これが重要なのは、max_tokensが合計出力の厳密な上限であり、合計出力には思考トークンと応答テキストが含まれるようになったためです。4.6で応答テキストのみのために設定されていたmax_tokensは、Sonnet 5では思考が同じ予算を消費するため、回答を途中で打ち切る可能性があります。
以前思考なしで実行されていたワークロードをそのまま維持したい場合は、明示的に思考をオフにしてください。
from anthropic import Anthropic
client = Anthropic()
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
thinking={"type": "disabled"},
messages=[
{"role": "user", "content": "Return the OpenAPI 3.1 path object for GET /invoices/{id}."}
],
)
print(response.content[0].text)
制御された深さでアダプティブシンキングを使用するには、無効にする代わりにeffortを設定します。
response = client.messages.create(
model="claude-sonnet-5",
max_tokens=8192,
thinking={"type": "adaptive"},
effort="medium",
messages=[
{"role": "user", "content": "Draft integration tests for the POST /orders endpoint."}
],
)
注意すべきは形式です: thinking={"type": "adaptive"}であり、トークン予算ではありません。これが次の変更につながります。
2. 手動による拡張思考が削除されました
以前のthinking: {type: "enabled", budget_tokens: N}パターンは、Sonnet 5では400エラーを返します。これは4.6でも非推奨とされていたため、ほとんどの現在のコードでは使用されていませんが、念のため確認してください。手動の予算はすべて、アダプティブシンキングとエフォートパラメータに置き換えてください。難しいタスクのために大きなbudget_tokensを設定していた場合は、effort="high"またはeffort="xhigh"が代替のレバーとなります。
3. サンプリングパラメータが400を返すようになりました
Sonnet 5では、`temperature`、`top_p`、または`top_k`をデフォルト以外の値に設定すると400エラーが返されます。これらを省略するか、デフォルト値のままにしておく場合は問題ありません。この制約はOpus 4.7以降にはすでにありましたが、Sonnetクラスでは今回が初めてです。
決定論的な出力のために`temperature=0`に依存していた場合は、それを取り除き、代わりにシステムプロンプトを通じて動作を制御してください。サンプリングではなく、命令の中で形式、トーン、制約を明示的に指定してください。コードベース全体でこれらのパラメータを素早く検索することで、本番環境での400エラーを未然に防ぐことができます。
4.6から変更されなかった点として、アシスタントメッセージのプリフィルは引き続きサポートされておらず、400エラーを返します。アシスタントのターンをプリフィルすることで応答開始を強制していた場合は、代わりに構造化出力、`output_config.format`、またはシステムプロンプトの指示を使用してください。
誰も警告しないトークナイザーの注意点
Sonnet 5は新しいトークナイザーを使用しています。同じ入力テキストでも、Sonnet 4.6と比較して約30%（約1.3倍）多くのトークンが生成されます。これはAPIの変更ではありません。リクエスト、レスポンス、ストリーミングの形式は同じであり、新しいコードを書く必要はありません。しかし、トークン単位で測定または予算化するすべてが変わります。
再測定すべき項目は以下の通りです。
- トークン数と
usageフィールド。 Sonnet 5では同じプロンプトでもより多くのトークンが報告されます。4.6のトークン数を再利用しないでください。追跡しているすべてのプロンプトについて、claude-sonnet-5に対してトークンカウントを再実行してください。 - 1Mコンテキストウィンドウが保持できるテキスト量が減少します。 各トークンが平均してより少ないテキストをカバーするため、同じウィンドウにはより少ない文字数のコンテンツしか収まりません。限界近くまでコンテキストを詰め込んでいた場合、まだ収まるかどうか確認してください。
- 予想される出力に近いサイズに設定された
max_tokens予算は、途中で切れる可能性があります。 4.6で通常の応答を問題なく収めていた予算でも、Sonnet 5では途中で切れる可能性があります。アダプティブシンキングがその予算を共有することと相まって、これはアップグレード後に予期せず短い回答になる最も一般的な原因です。 - 同じテキストに対するリクエストごとのコストが高くなる可能性があります。 トークンあたりの料金は変更ありませんが、リクエストあたりのトークン数が増えるということは、同じテキストに対して支払う金額が増えるということです。
最後の点については、具体的な例を挙げて説明する価値があります。Sonnet 4.6ではプロンプトと応答で10,000トークンだったとします。Sonnet 5では同じテキストが約13,000トークンになります。トークンあたりの料金が同じでも、価格表が変わらないように見えても、そのリクエストのコストは約30%高くなります。コストが平準化されると仮定する前に、実際のワークロードでトークンカウントをモデル化してください。Sonnet 5の料金内訳では、導入価格と標準価格の計算についてさらに詳しく解説しています。
トークンカウントのエンドポイントを使って、ご自身で変化を測定できます。
curl https://api.anthropic.com/v1/messages/count_tokens \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data '{
"model": "claude-sonnet-5",
"messages": [
{"role": "user", "content": "Summarize the changelog for our billing API v3 release."}
]
}'
同じ呼び出しを`claude-sonnet-4-6`で実行し、カウントを比較してください。その差が、あなたの実際の予算への影響です。
アップグレードにかかる費用
トークンあたりで言えば、Sonnet 5はSonnet 4.6と同じコストです。標準料金では、入力トークン100万あたり3ドル、出力トークン100万あたり15ドルです。2026年8月31日まで、導入価格として入力100万あたり2ドル、出力100万あたり10ドルが適用され、その後は標準の3ドル/15ドルに移行します。
したがって、導入期間中は、同等のテキストは4.6の標準料金よりもトークンあたり安くなります。これは、トークナイザーによる約30%のトークン増加を部分的に相殺します。8月31日以降は、トークンあたりの料金は再び4.6と一致し、トークナイザーの効果により、同等のリクエストでも4.6と同じリクエストよりもコストがかかる可能性があります。これを実際のトラフィックに対してモデル化してください。バッチ処理とプロンプトキャッシングの料金については、固定割引を仮定するのではなく、Anthropicの料金ページを確認してください。
古い世代のコストも検討している場合は、Sonnet 4.6の料金とClaude APIのコストガイドで比較のベースラインが示されています。
アップグレードすべきか？ユーザー別の判断
モデルIDの切り替えは簡単です。切り替えるかどうかは、実行する内容によって異なります。
エージェント、コーディングツール、またはツールを多用するワークフローを構築している場合は、今すぐアップグレードしてください。これは最も明確な利点です。SWE-bench ProとOSWorldの改善は、まさにエージェント型アプリケーションが活躍する場所であり、安全性の向上は自律ループにおける望ましくない動作を軽減します。3つのパラメーターを見直し、トークン予算を再測定し、リリースしてください。
大量の運用ワークロードを実行している場合は、アップグレードしますが、慎重にテストしてください。トークンあたりの価格が同じであることは朗報ですが、トークナイザーの変更により、総トークン費用と`max_tokens`の切り捨て動作の両方が変わります。実際のトラフィックをルーティングする前に、トークンカウントの実行と回帰テストスイートを実行してください。8月31日までの導入価格期間中に、より低い料金で検証を行うことができます。
`temperature`、`budget_tokens`、またはプリフィルに依存している場合は、慎重にアップグレードしてください。これらは現在400を返します。移行は簡単で、決定性をシステムプロンプトに移動し、予算を労力に置き換えるだけですが、ゼロ作業ではありません。切り替え後ではなく、切り替え前にこれらを修正してください。
特にプライオリティティアが必要な場合は、現状維持してください。Sonnet 5では利用できません。SLAがそれに依存している場合、要件が変わるまでそれらのパスでは4.6を使用し続けてください。
ほとんどのチームにとって、答えは「すぐにアップグレード」です。なぜなら、同じ見出し価格でより優れたエージェント性能が得られるからです。これは、金曜日にリリースする1文字の編集ではなく、テストパスを含む本格的な移行として扱ってください。より広範な世代比較を行っている場合は、Sonnet 4.6 APIガイドで、移行前のインターフェースが文書化されています。
Apidogで保存されたリクエストスイートを使用して回帰を検出する
アップグレードの最も安全な方法は、ベンチマーク表ではなく、自身のプロンプトでSonnet 5をSonnet 4.6と比較することです。これこそ、APIプラットフォームが構築された目的である前後比較テストです。
Apidogは、オールインワンのAPI開発およびテストツールです。Claude APIを呼び出すとき、認証ヘッダー、JSONリクエストボディ、JSONレスポンスを含むHTTPエンドポイントにアクセスしています。Apidogを使用すると、そのリクエストを一度保存し、再利用可能なコレクションとして再実行できます。これにより、モデル移行が手動での再試行ではなく、繰り返し可能なテストになります。
実用的な移行ワークフローは次のようになります。
- 本番環境のMessages APIリクエストを、代表的なプロンプトごとに1つずつ、Apidogコレクションとして保存します。
- `ANTHROPIC_API_KEY`を環境変数として保存し、リクエストボディに貼り付けないようにします。
- `model`値のみが異なる2つの環境を設定します。`claude-sonnet-4-6`と`claude-sonnet-5`です。
- レスポンス形式と`usage`トークン数にアサーションを追加し、両方の環境に対してコレクションを実行します。
- 2つの実行を比較します。トークン数の差分は、トークナイザーがプロンプトに与える実際の影響を示し、失敗したアサーションは、リリース前に調査すべき回帰です。
ApidogでClaudeエンドポイントをモックすることもでき、トークンを消費することなく、stop_reason: "refusal"パスを含む周辺の統合を構築およびテストできます。アプリがエージェント型で他のツールを呼び出す場合、ApidogはそれらのダウンストリームAPIもテストおよびモックする場所となります。
比較スイートを構築するにはApidogをダウンロードするか、ブラウザでApidogを開いてリクエストから開始してください。Postmanから移行する場合、PostmanなしでのAPIテストガイドで同等のフローが解説されています。
よくある質問
Claude Sonnet 5はSonnet 4.6のドロップイン代替品ですか？ ほとんどの場合そうです。モデルIDをclaude-sonnet-4-6からclaude-sonnet-5に変更し、次の3点を確認してください。アダプティブシンキングがデフォルトでオンになりました（これはmax_tokensに影響します）、budget_tokens拡張思考が400を返します、非デフォルトのサンプリングパラメーターが400を返します。その他のすべては引き継がれます。Sonnet 5 APIガイドで完全なリクエスト設定を参照してください。
Sonnet 5はSonnet 4.6よりもコストがかかりますか？ トークンあたりではいいえ。どちらも標準料金では入力100万トークンあたり3ドル、出力100万トークンあたり15ドルです。しかし、Sonnet 5の新しいトークナイザーは同じテキストで約30%多くのトークンを生成するため、同等のリクエストでもトークンあたりの料金が同じでもコストが高くなる可能性があります。2026年8月31日まで、入力100万あたり2ドル/出力100万あたり10ドルの導入料金が適用されます。
アップグレード後に応答が途中で途切れるのはなぜですか？ Sonnet 5ではアダプティブシンキングがデフォルトでオンになっており、思考トークンと応答テキストが同じmax_tokens予算を共有します。4.6で応答を問題なく収めていた予算でも、現在では途中で途切れる可能性があります。max_tokensを増やすか、その呼び出しで思考が必要ない場合はthinking={"type": "disabled"}を設定してください。
新しいトークナイザーのためにコードを変更する必要がありますか？ いいえ。リクエスト、レスポンス、およびストリーミングの形式は同じなので、コードの変更は必要ありません。ただし、トークン単位で予算化しているものはすべて再測定する必要があります。トークン数、max_tokensのサイズ、リクエストあたりのコスト見積もりなどです。Sonnet 4.6のトークン数を再利用しないでください。
`temperature`と`budget_tokens`はどうなりましたか？ Sonnet 5では、これらが非デフォルト値に設定されている場合、どちらも400エラーを返すようになりました。非デフォルトの`temperature`、`top_p`、`top_k`を削除し、システムプロンプトを通じて動作を制御してください。`budget_tokens`拡張思考は、アダプティブシンキングと`effort`パラメータに置き換えてください。Fable 5およびMythos API変更ガイドでは、より上位のティアでも同じパターンが説明されています。