Claude Opus 5・Sonnet 5リリースと知るべき破壊的変更まとめ

はじめに

2026年7月、Anthropic は Claude Opus 5 と Claude Sonnet 5 という2つの新モデルを立て続けにリリースしました。それに伴い、既存コードがそのままでは動かなくなる 破壊的変更（Breaking Change） も複数発生しています。

特に注意すべきは以下の3点です。

• Claude Opus 5 で effort: "xhigh" または "max" を指定したまま thinking を無効化すると 400エラー
• Claude Opus 4.7 の fast mode が削除され、speed: "fast" 指定が 即座にエラー
• Claude Sonnet 4 / Opus 4 など旧世代モデルが 提供終了（EOL）、レガシー Workbench も 2026年8月17日に廃止

「バージョンアップだから動くだろう」と油断してデプロイすると、本番環境で一斉にリクエストが失敗するリスクがあります。この記事では、Claude API を業務で使っている開発者・SREの方向けに、直近半年の変更点を整理し、対応すべきアクションをまとめます。

📌 影響を受ける人

• claude-opus-4-7 / claude-sonnet-4 / claude-opus-4 / claude-opus-4-1 を本番で使っている人
• effort パラメータや手動 thinking 設定をコードにハードコードしている人
• レガシー Workbench（platform.claude.com/workbench）に保存したプロンプトや評価データがある人

変更の全体像

まずは2026年前半〜7月末までの主要リリースを時系列で整理します。

続いて、破壊的変更が生じている箇所の関係を整理します。

変更内容

新モデルのスペック

項目	Claude Opus 5	Claude Sonnet 5
リリース日	2026/7/24	2026/6/30
コンテキスト	1M トークン（デフォルト）	1M トークン
最大出力	128k トークン	128k トークン
thinking	デフォルトで有効	adaptive thinking がデフォルト有効
価格	$5 / $25 per MTok	導入価格 $2 / $10（〜8/31）→ 標準 $3 / $15
対応プラットフォーム	Claude API, Bedrock, Vertex AI, Foundry	Messages API

重要な破壊的変更（critical / high）

変更	内容	発生条件
Opus 5: effort × thinking無効化	effort: xhigh/max かつ thinking: disabled で400エラー	Opus 5 移行時
Sonnet 5: 手動thinking廃止	thinking: {type:"enabled", budget_tokens:N} が400エラー	Sonnet 4.6→5 移行時
Sonnet 5: サンプリングパラメータ制限	temperature/top_p/top_k を非デフォルト値にすると400エラー	Sonnet 5 利用時
Sonnet 5: トークナイザー変更	同一テキストで約30%多くトークン消費	コスト試算・コンテキスト管理に影響
Opus 4.7 fast mode削除	speed:"fast" がエラー（フォールバックなし）	2026/7/24以降
Sonnet 4 / Opus 4 提供終了	該当モデルへの全リクエストがエラー	2026/6/15〜
MCP tunnels API移設	管理APIが Admin API から Claude API の /v1/tunnels へ	ベータヘッダー mcp-tunnels-2026-06-22 が必要

今後の廃止スケジュール

対象	廃止日	備考
Claude Opus 4.1	2026/8/5	Opus 4.8以降へ移行推奨
レガシー Workbench	2026/8/17	保存プロンプト・変数・evalsは新Workbench非対応。事前エクスポート必須
実験的 prompt tools API（generate/improve/templatize_prompt）	2026/8/17	廃止後は全リクエストがエラー

影響と対応

⚠️ Breaking Change
Opus 5 で effort: "xhigh" または "max" と thinking: {"type": "disabled"} を同時に指定すると、Opus 4.8までは通っていたリクエストが400エラーになります。

対応が必要な項目をチェックリスト形式でまとめます。

1. Opus 5移行前: effort を xhigh/max に設定した上で thinking を無効化しているコードがないか grep する
2. Opus 4.7利用中: speed: "fast" を使っている箇所を洗い出し、Opus 5 または Opus 4.8 へ切り替える
3. Sonnet 5移行前: 手動 thinking 設定（budget_tokens）と temperature/top_p/top_k の明示指定を除去する
4. コスト試算: Sonnet 5 のトークナイザー変更（約+30%）を踏まえてコンテキスト長・課金試算を見直す
5. Workbench利用者: 保存済みプロンプト・変数・evalsを2026/8/17までにエクスポートする
6. 実験的 prompt tools API利用者: /v1/experimental/* エンドポイントの利用箇所を洗い出し、8/17までに代替実装へ移行する
7. MCP tunnels利用者: 管理APIの呼び出し先を /v1/organizations/tunnels（Admin API）から /v1/tunnels（Claude API）へ移行する

💡 Tips
claude-sonnet-4-20250514 のような日付固定のモデルIDを直接ハードコードしていると、提供終了時に気づかずエラーが本番で発生しがちです。モデルIDは設定ファイルやCLAUDE.mdなど一箇所で管理し、リリースノートを定期的に確認する運用にしておくと安全です。

コード例

Opus 5: effort と thinking の組み合わせ

# Before（Opus 4.8までは動作していた）
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    effort="max",
    thinking={"type": "disabled"},  # Opus 5では400エラー
    messages=[{"role": "user", "content": "Hello"}],
)

# After（effortをhigh以下に下げる、またはthinkingを無効化しない）
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    effort="high",  # xhigh/maxでない場合はthinking無効化が可能
    thinking={"type": "disabled"},
    messages=[{"role": "user", "content": "Hello"}],
)

Sonnet 5: 手動thinkingとサンプリングパラメータ

# Before（Sonnet 4.6までは動作していた）
response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    temperature=0.7,
    thinking={"type": "enabled", "budget_tokens": 4000},  # 削除された、400エラー
    messages=[{"role": "user", "content": "要約して"}],
)

# After（サンプリングパラメータとbudget_tokensを削除し、adaptive thinkingに任せる）
response = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "要約して"}],
)

Opus 4.7: fast mode の廃止

# Before（2026/7/24より前は高速応答が返っていた）
response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    speed="fast",  # 2026/7/24以降エラー
    messages=[{"role": "user", "content": "Hello"}],
)

# After（Opus 5 または Opus 4.8 へ移行）
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    speed="fast",
    messages=[{"role": "user", "content": "Hello"}],
)

まとめ

2026年7月は Claude Opus 5 と Sonnet 5 という大型リリースが重なり、それに伴う破壊的変更も多い月でした。特に次の3点は本番影響が大きいため優先的に確認してください。

• Opus 5: effort: xhigh/max と thinking: disabled の併用は不可（400エラー）
• Sonnet 5: 手動thinkingとサンプリングパラメータ指定は不可、トークン数は約30%増加
• 期限が迫っている廃止項目: Opus 4.1（8/5 EOL）、レガシーWorkbenchと実験的prompt tools API（8/17 廃止）

いずれも「動いていたコードが急に動かなくなる」タイプの変更です。モデルIDやパラメータをハードコードせず、リリースノートを定期的にチェックする体制を整えておくことをおすすめします。