はじめに
2026年7月24日、Anthropic は新モデル Claude Opus 5(claude-opus-5)を正式リリースしました。1M トークンのコンテキストウィンドウ、最大128kトークンの出力、thinking のデフォルト有効化など、Claude Opus 4.8 から大きく進化しています。価格は Opus 4.8 と同じ $5 / $25 per MTok に据え置かれており、コストを増やさずに性能を引き上げられる点が大きなポイントです。
一方で、今回のリリースには 開発者が対応必須の破壊的変更が2件 含まれています。
- Opus 5 では
effortがxhigh/maxのときthinkingを無効化すると 400 エラーになる - Claude Opus 4.7 の fast mode が削除され、指定するとエラーになる
さらにベータ機能として fallbacks パラメータに "default" モードが追加されました。この記事では、これらの変更点を整理し、既存コードで何を確認・修正すべきかを解説します。
📌 影響を受ける人
- Claude API / Amazon Bedrock / Google Cloud Vertex AI / Microsoft Foundry で Opus 系モデルを利用している開発者
effortパラメータとthinkingの無効化を組み合わせて利用しているアプリケーション- fast mode(
speed: "fast")で Claude Opus 4.7 を呼び出している実装
変更の全体像
Opus 5 は Opus 4.8 の後継として登場し、Bedrock・Vertex AI・Microsoft Foundry を含む全チャネルで利用可能です。一方 Opus 4.7 は fast mode 非対応となり、fast mode を使い続けたい場合は Opus 5 か Opus 4.8 への移行が必要になります。
変更内容
1. Claude Opus 5 の新規リリース(severity: high)
| 項目 | Claude Opus 4.8 | Claude Opus 5 |
|---|---|---|
| コンテキストウィンドウ | 従来値 | 1M トークン(デフォルト・最大値) |
| 最大出力 | 従来値 | 128k トークン |
| thinking | オプション | デフォルトで有効 |
| 価格(入力/出力) | $5 / $25 per MTok | $5 / $25 per MTok(据え置き) |
| 利用チャネル | Claude API, Bedrock, Vertex AI, Foundry | 同左 |
価格が据え置かれたまま、コンテキストウィンドウが大幅に拡張されている点が最大のトピックです。長文コンテキストを扱うRAGやコードベース全体の解析タスクへの活用が期待できます。
2. Opus 5 における thinking 無効化の制限(severity: critical)
⚠️ Breaking Change
Claude Opus 5 では、effortがxhighまたはmaxの場合にthinking: {"type": "disabled"}を指定すると 400 エラーが返るようになりました。Opus 4.8 では許容されていた組み合わせのため、既存コードをそのまま Opus 5 に向けると失敗する可能性があります。
thinking を無効化できるのは effort: "high" 以下の場合のみです。high effort レベルでの推論精度を確保するための挙動変更と考えられます。
3. Claude Opus 4.7 の fast mode 削除(severity: critical)
⚠️ Breaking Change
claude-opus-4-7に対してspeed: "fast"を指定するリクエストは、標準速度へのフォールバックなしにエラーを返すようになりました(Opus 4.6 とは挙動が異なります)。Opus 4.7 自体は標準速度で引き続き利用可能です。
fast mode を使い続けたい場合は、Claude Opus 5 または Claude Opus 4.8 への切り替えが必要です。
4. fallbacks パラメータの "default" モード追加(severity: medium, ベータ)
fallbacks パラメータに "default" モードが追加され、拒否カテゴリ(refusal category)ごとに Anthropic 推奨のフォールバックモデルが自動適用されるようになりました。利用には server-side-fallback-2026-07-01 ベータヘッダーの指定が必要です。
影響と対応
開発者が取るべきアクションは次の3点です。
-
effort × thinking の組み合わせを棚卸しする:
effort: "xhigh"または"max"を指定しつつthinking: {"type": "disabled"}を送っている箇所がないかコードを検索し、Opus 5 移行前に修正する -
fast mode の利用箇所を確認する:
claude-opus-4-7+speed: "fast"を使っている場合、Opus 5 または Opus 4.8 へ切り替える - Opus 5 への切り替えを検討する: 価格据え置きで1Mコンテキスト・128k出力が使えるため、長文処理を行うワークロードは移行のメリットが大きい
コード例
thinking 無効化の破壊的変更
# Before: Opus 4.8 では許可されていた組み合わせ
response = client.messages.create(
model="claude-opus-4-8",
max_tokens=1024,
thinking={"type": "disabled"},
effort="xhigh",
messages=[{"role": "user", "content": "..."}]
)
# After: Opus 5 に移行する場合は effort を下げるか、thinking を無効化しない
response = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
thinking={"type": "disabled"},
effort="high", # xhigh/max では disabled 指定不可
messages=[{"role": "user", "content": "..."}]
)
fast mode 削除への対応
# Before: Opus 4.7 + fast mode(Opus 5 リリース後はエラー)
response = client.messages.create(
model="claude-opus-4-7",
speed="fast",
max_tokens=1024,
messages=[{"role": "user", "content": "..."}]
)
# After: fast mode を使うなら Opus 5 か Opus 4.8 を指定
response = client.messages.create(
model="claude-opus-5",
speed="fast",
max_tokens=1024,
messages=[{"role": "user", "content": "..."}]
)
まとめ
- Claude Opus 5 が2026年7月24日にリリース。価格据え置き($5/$25 per MTok)のまま、1Mトークンコンテキスト・128k出力・thinkingデフォルト有効を実現
-
破壊的変更①: Opus 5 で
effort: xhigh/maxとthinking: disabledを併用すると400エラー。既存コードの棚卸しが必要 -
破壊的変更②: Claude Opus 4.7 の fast mode が削除され、
speed: "fast"指定はエラーに。継続利用にはOpus 5/4.8への移行が必要 - ベータ機能として
fallbacksパラメータに"default"モードが追加され、拒否時のフォールバックモデル選定が簡略化された
Opus 5 への移行を検討している場合は、まず effort と thinking の組み合わせ、fast mode の利用有無をコードベースで確認することから始めるとスムーズです。