Claude Opus 5登場、effort xhigh/max×thinking無効化は400エラーに注意

はじめに

2026年7月24日、Anthropicから新モデル Claude Opus 5(claude-opus-5)がリリースされました。前世代の Opus 4.8 から大幅に性能が向上しているにもかかわらず、価格は据え置きの $5 / $25 per MTok(入力/出力)です。

今回のアップデートで特に注意したいのが、effort パラメータと thinking の組み合わせに関する 破壊的変更 です。Opus 4.8 で動いていたコードが、Opus 5 に切り替えた途端に 400 エラー を返すようになるケースがあるため、移行時は必ずチェックしてください。

📌 影響を受ける人

• Claude API / Amazon Bedrock / Google Cloud Vertex AI / Microsoft Foundry で Opus 系モデルを利用している開発者
• effort パラメータで xhigh や max を指定しつつ thinking: {"type": "disabled"} を使っているエージェント実装
• 長時間のマルチターン会話でツール構成を動的に切り替えるエージェントを運用しているチーム

この記事では、Opus 5 の新機能・仕様変更・移行時に必要な対応をまとめて解説します。

変更の全体像

Opus 4.8 から Opus 5 への変化と、周辺の API アップデートの関係を図にまとめました。

Opus 5 本体の強化に加え、API 全体としては「会話途中のツール変更」「フォールバックの自動化」といった、エージェント運用を楽にする周辺機能もあわせて追加されています。

変更内容

1. Claude Opus 5 リリース(重要度: high)

項目	Opus 4.8	Opus 5
コンテキストウィンドウ	(旧仕様)	1M トークン(デフォルト かつ 最大)
最大出力トークン	(旧仕様)	128k トークン
thinking	オプション	デフォルト有効
価格(入力/出力)	$5 / $25 per MTok	$5 / $25 per MTok(変更なし)
利用可能な場所	同左	Claude API, Amazon Bedrock, Google Cloud (Vertex AI), Microsoft Foundry

性能向上分がそのまま価格に転嫁されていない点は嬉しいポイントです。詳細な新機能・挙動変更は Anthropic 公式の「What's new in Claude Opus 5」ドキュメントにまとまっています。

2. 【破壊的変更】effort xhigh/max × thinking無効化 → 400エラー(重要度: critical)

⚠️ Breaking Change
Claude Opus 5 では、thinking の無効化(disabled)が許可されるのは effort: high 以下の場合のみです。effort: xhigh または effort: max と thinking: {"type": "disabled"} を同時に指定すると 400 エラー が返ります。

Opus 4.8 では「高い effort を指定しつつ thinking を切る」という組み合わせが可能でしたが、Opus 5 ではこれが仕様変更により禁止されています。既存コードをそのまま Opus 5 に向けると、リクエストが失敗するようになるため注意が必要です。

対応方法は2択です。

• effort を high 以下に下げる
• thinking の無効化設定を外す(デフォルトの有効状態に戻す)

3. effortパラメータが全レベル対応(重要度: medium)

Opus 5 は effort ラダーの全段階、low / medium / high / xhigh / max をサポートします。特に max は「能力(ケイパビリティ)が最重要となる作業」向けに新設された最上位レベルで、コストやレイテンシよりも精度を優先したいタスクに使えます。

4. 会話途中のツール変更(ベータ)

複数ターンにわたる会話の中で、ツールを追加・削除してもプロンプトキャッシュを維持できる mid-conversation tool changes がベータ提供されました。

長時間セッションのエージェントで、状況に応じてツール構成を切り替えたい場合でもキャッシュヒットを保てるため、コストとレイテンシの両面でメリットがあります。

5. fallbacksパラメータの"default"モード(ベータ)

fallbacks パラメータに "default" モードが追加され、拒否(refusal)カテゴリごとに Anthropic 推奨のフォールバックモデルが自動適用されるようになりました。個別にフォールバック先を設定しなくても、サーバーサイドで適切なモデルに切り替わります。

6. ドキュメントのリンク・構成整理(重要度: low)

過去のリリースノートにおける thinking 関連リンクやモデル移行ガイドの参照 URL が統一されました。API の機能自体への影響はありません。

影響と対応

変更	action_required	対応内容
Opus 5 リリース	不要	必要に応じてモデル指定を claude-opus-5 に更新
effort xhigh/max × thinking disabled	必要	該当コードを洗い出し、effortを下げるかthinking無効化を外す
effort全レベル対応	不要	max を高精度タスクで検討
mid-conversation tool changes	不要	ベータヘッダーを付与して試験導入を検討
fallbacks "default" モード	不要	個別フォールバック設定の簡略化を検討

特に重要なのは effort × thinking の組み合わせチェック です。以下のフローで移行判断をしてください。

コード例

Before(Opus 4.8: xhigh + thinking disabled が可能だった)

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=4096,
    effort="xhigh",
    thinking={"type": "disabled"},
    messages=[{"role": "user", "content": "複雑な設計タスクを解いて"}],
)

After(Opus 5: そのまま移行すると400エラー)

# NG: そのままモデル名だけ変更すると 400 エラー
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    effort="xhigh",
    thinking={"type": "disabled"},  # xhigh/max と disabled の組み合わせはNG
    messages=[{"role": "user", "content": "複雑な設計タスクを解いて"}],
)

# OK: 対応1 - effort を high 以下に下げる
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    effort="high",
    thinking={"type": "disabled"},
    messages=[{"role": "user", "content": "複雑な設計タスクを解いて"}],
)

# OK: 対応2 - thinking の無効化を外す(デフォルト有効のまま使う)
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    effort="xhigh",
    messages=[{"role": "user", "content": "複雑な設計タスクを解いて"}],
)

mid-conversation tool changes ベータ利用例

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    tools=[...],
    messages=[...],
    extra_headers={
        "anthropic-beta": "mid-conversation-tool-changes-2026-07-01"
    },
)

まとめ

• Claude Opus 5 が Opus 4.8 と同価格($5/$25 per MTok)でリリースされ、1M コンテキスト・128k 出力・thinking デフォルト有効という強力な仕様になった
• 【重要】 effort: xhigh/max と thinking: disabled の組み合わせは Opus 5 では 400 エラー になる。Opus 4.8 からの移行時は該当コードの有無を必ず確認する
• effort は low〜max まで全レベルに対応し、精度最優先のタスクには max が選択肢に
• 会話途中のツール変更(ベータ)や、fallbacksの"default"モード(ベータ)など、エージェント運用を楽にする周辺機能も同時に追加されている

Opus 5 への移行を検討している場合は、まず effort と thinking の組み合わせをコードベース全体で検索し、破壊的変更の影響を受けていないか確認することをおすすめします。