Claude Opus 4.8の高速モード終了：11月30日までにOpus 5.5へ移行
Opus 4.8の高速モードは2026年11月30日に削除され、対象リクエストは標準速度へ自動で切り替わらずエラーになります。モデルと速度の設定を探し、Opus 5.5へ移行してusage.speedを確認します。不要なbetaヘッダーと非対応パラメーターを見直し、直接利用するClaude APIの料金、専用レート制限、Claude Codeの設定、標準速度での復旧手順を確認できます。
目次
Claude Opus 4.8の高速モードは非推奨になりました。claude-opus-4-8とspeed: "fast"を組み合わせたリクエストは、2026年11月30日より前にclaude-opus-5-5へ移行してください。高速モードの削除後は、従来の組み合わせがエラーになり、標準速度への自動切り替えも行われません。
Anthropicは10月30日のリリースノートで期限を発表しました。Claude Code v2.1.316のリリース情報にも、標準速度へ自動で切り替わらないことが明記されています。
今回削除されるのは、速度を選ぶためのオプションです。2026-11-02時点のモデルのライフサイクル表では、claude-opus-4-8は引き続きActiveです。モデル自体の廃止時期は暫定で、早くても2027年5月28日とされています。このモデルを維持する必要がある場合は、高速モードの設定を削除し、標準速度のリクエストを検証してください。
以下では、Anthropicが直接提供するMessages APIへの移行手順を説明します。Claude Codeの利用者が確認すべき設定も扱います。
1. コードとデプロイ先の設定から対象リクエストを探す
まず、モデルを選択する設定と実行速度を指定する設定を、それぞれ検索してください。次に、アプリがどの処理で両者を組み合わせ、送信リクエストへ反映するかを確認します。設定元は同じとは限らず、別々のファイル、環境変数、ゲートウェイのルールから読み込まれる場合があります。
ripgrepをインストールした環境で、リポジトリのルートからBashで次の検索を実行します。影響を受ける可能性があるファイルを探すための検索です。
rg -l --hidden --no-ignore \
-g '!.git' \
-g '!node_modules' \
-g '!.venv' \
-e 'claude-opus-4-8' \
-e 'fast-mode-2026-02-01' \
-e 'fastMode' \
-e 'speed' .このコマンドは、設定内容ではなくファイル名を表示します。隠しファイルや通常は無視されるファイルも検索するため、ローカル設定の上書きも確認できます。一般的な名前のspeedは別の用途にも使われるので、検索結果を一件ずつ確認してください。
リポジトリ外に置かれた次の設定も調べます。
- デプロイ時の環境変数とCIジョブの設定。
- エージェントの既定モデルと、代替モデルの一覧。
- ゲートウェイ内のモデル対応表と、リクエストの変換処理。
- Claude Codeのユーザー設定、プロジェクト設定、管理者が配布する設定。
最終的に送信されるリクエストに、古いモデルIDとspeed: "fast"の両方が含まれるかを確認します。モデル名だけが記録された使用量レポートでは、そのリクエストが高速モードを使ったかどうかは判断できません。
対象サービスごとに、担当者、設定の読み込み元、指定モデル、指定速度、切り戻し先を記録してください。この調査記録には、認証情報やプロンプトの内容を含めないでください。
2. モデルを変更し、非対応の設定を見直す
Opus 5.5ではspeed: "fast"を維持し、高速モードだけに必要だったbetaヘッダー内の識別子を削除します。AnthropicのOpus 5.5の機能説明には、このモデルでそのbetaヘッダーが不要だと明記されています。
anthropic-betaに複数の機能識別子がある場合は、fast-mode-2026-02-01だけを取り除いてください。他の機能に必要な識別子は残します。
既存の処理を新しいモデルへ送る前に、次の設定を見直してください。
| 設定または動作 | Opus 5.5での対応 |
|---|---|
model | claude-opus-5-5を指定します。 |
speed | 高速モードが必要な場合は"fast"を維持します。 |
thinking | 省略するか、{"type":"adaptive"}を使います。思考を無効にする指定と、enabledで思考予算を手動指定する形式は、APIに拒否されます。 |
tool_choice | {"type":"auto"}または{"type":"none"}を使います。強制選択のanyと、ツール名を指定するtoolは拒否されます。 |
temperature、top_p、top_k | これらのパラメーターを省略します。 |
| アシスタント応答の書き出し指定 | 次の回答の開始部分を指定するために入れていた、不完全なアシスタントメッセージを削除します。 |
| 応答の読み取り | typeを使ってテキストブロックを選びます。回答がcontent[0].textにあるとは限りません。 |
この確認項目はOpus 5.5の移行ガイドに基づいています。一部の制限は以前のモデルにも適用されています。それでも、リクエストを組み立てる共通処理が、移行時に非対応パラメーターを再び追加する可能性があります。
アプリが特定のツール呼び出しを必須としている場合は、autoへの変更後も同じ呼び出しが保証されるという前提で進めないでください。強制選択を解除すると、アプリが期待していた動作の条件が変わります。新しい選択方法に合わせてアプリ側の検証処理を更新し、本番へ展開する前に該当する処理をテストしてください。
Opus 5.5では適応型思考が常に有効です。思考と表示されるテキストは同じ出力枠を使うため、max_tokensを見直します。思考の深さはoutput_config.effortで調整してください。
ツール呼び出しを繰り返す処理では、結果を返す際にアシスタントメッセージ全体を保持します。思考ブロックも含め、受け取ったメッセージを完全な形で会話履歴へ戻してください。画面表示用にテキストを抽出する処理を、会話履歴の保存や再送にもそのまま使わないようにします。
表示用の抽出によって、モデルへ返すメッセージの内容を変えてはいけません。会話履歴そのものを書き換えるアプリや、コンピューター操作ツールを使うアプリは、移行ガイドの専用項目も確認してください。
3. リクエストを送り、実際の速度を確認する
本番トラフィックを移す前に、成功した応答のusage.speedを確認してください。リクエスト内のフィールドは希望する速度を示し、応答内のフィールドは実際に使われた速度を示します。送信した設定だけで判断せず、モデルから返された値を確認することが検証の要点です。
Bash、jq、--fail-with-bodyに対応したcurlが必要です。高速モードを利用できる、Anthropic直接提供のClaude APIキーを用意してください。2026-11-02時点では、Opus 5.5の高速モードにStart、Build、Scale各階層の既定レート制限があります。Evaluation階層の組織は、利用可能な階層へ移る必要があります。
次の例は、現在のMessages APIのリクエスト形式を使います。ストリーミングを使わずに送信し、応答を保存して検証した後、回答テキストを表示します。
read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
curl --silent --show-error --fail-with-body \
--max-time 600 \
--dump-header fast-headers.txt \
--output fast-response.json \
https://api.anthropic.com/v1/messages \
-H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2026-10-21" \
-H "Content-Type: application/json" \
--data '{
"model": "claude-opus-5-5",
"max_tokens": 4096,
"speed": "fast",
"stream": false,
"output_config": {"effort": "low"},
"messages": [
{
"role": "user",
"content": "Explain a cache hit in one sentence."
}
]
}' &&
jq -e '
.type == "message"
and .model == "claude-opus-5-5"
and .usage.speed == "fast"
and .stop_reason == "end_turn"
and any(
.content[]?;
.type == "text" and (.text | length > 0)
)
' fast-response.json &&
jq -r '.content[] | select(.type == "text") | .text' fast-response.json期待する検証結果はtrueで、その後にモデルの回答が表示されます。高速モードだったことに加え、指定モデルが応答を完了し、空ではない回答テキストを返したことも検証します。これは成功条件の説明であり、実行済みリクエストの記録ではありません。
&&演算子により、リクエストが失敗した場合は成功判定の処理へ進みません。例の4096という出力枠とlowという思考設定は、この小さな確認用に選んだ値です。高速モードで必須となる値ではありません。
この例ではanthropic-version: 2026-10-21を使っています。既存の連携でこのヘッダーを変更する前に、別途APIバージョンの移行手順を確認してください。モデルの変更とAPIバージョンの変更は、それぞれの影響を確認して進めます。
curlが失敗した場合は、エラーと新たに保存された応答本文を調べます。リクエストが成功しても検証が失敗した場合は、model、usage.speed、stop_reason、contentを確認してください。
高速モードで実行された応答でも、max_tokensに達して停止する場合があります。この場合、実行速度の確認と、回答が最後まで得られたかの確認は別です。停止理由の説明を確認し、出力枠または思考の深さを調整してください。速度フィールドがない場合や"standard"の場合は、この高速モードの検証条件を満たしません。
2026-11-02時点で、BetterTokenにはclaude-opus-4-8とclaude-opus-5-5の両方が掲載されています。Messagesのリファレンスにはhttps://www.bettertoken.ai/v1/messagesが記載されています。この経路を使う場合は、移行前に高速モード設定の転送、usage.speedの返却、課金方法を確認してください。認証は同サービスの説明に従います。モデル一覧への掲載だけで、高速モードへの対応が確認できるわけではありません。
4. 容量不足と移行設定のエラーを分けて扱う
同時リクエスト数は、高速モード専用のレート制限に基づいて決めてください。標準速度のOpusで利用できる処理容量から、高速モードの利用枠を判断することはできません。
レート制限の説明では、実際の上限を組織のConsole制限ページで確認するよう案内しています。Opus 4.8の同時実行設定を、そのままOpus 5.5へ引き継げるとは考えないでください。
保存した応答ヘッダーのanthropic-fast-input-tokens-remainingとanthropic-fast-output-tokens-remainingを確認します。これらを使えば、入力トークン側と出力トークン側のどちらの上限に近づいているかを区別できます。
失敗の原因ごとに、処理方法を明示的に決めてください。
- 高速モードの
429とretry-after： 指定された時間を待ちます。標準速度でもよければ、speed: "fast"を外して再試行します。 - 支出上限による
429： 支出上限の問題を解決します。速度を変えても、使い切った予算は回復しません。 - 過負荷の
529： 再試行回数を制限し、試行間隔を延ばします。別の速度なら成功するとは限りません。 - 無効なパラメーターや、削除後のOpus 4.8高速設定： リクエストを修正します。同じ内容を繰り返し送信しても、移行は完了しません。
Anthropicは、高速モードのレート制限エラーに対して、アプリ側で標準速度へ切り替える方法を説明しています。この方法を選ぶ場合は、切り替え後の応答に"standard"と記録されることを確認してください。
可能であれば、再試行回数の管理は一つの層にまとめます。SDK自体の再試行に外側の再試行ループを重ねると、リクエスト数と待ち時間が増幅する可能性があります。独自のループを設けている場合は、SDK側とアプリ側の両方の設定を確認してください。実装の詳細はRetry-Afterの安全な処理と指数バックオフの解説を参照してください。
5. 同じトークン量で料金を比較する
公表されているOpus 5.5の高速モード料金は、Opus 4.8の高速モードより低くなっています。ただし、Opus 5.5の標準速度と比べると、トークン単価は高くなります。
以下は、Anthropicが直接提供するClaude APIのUSD建て料金です。2026-11-02時点の情報で、MTokは100万トークンを表します。
| 設定 | 入力1 MTokあたり | 出力1 MTokあたり |
|---|---|---|
| Opus 4.8の高速モード | $10 | $50 |
| Opus 5.5の高速モード | $8 | $40 |
| Opus 5.5の標準速度 | $4 | $20 |
高速モードの単価はAnthropicの料金表に基づきます。標準速度の単価はOpus 5.5のモデルページにも記載されています。
入力1 MTok、総出力0.2 MTokという仮定で見積もると、トークン料金は次のようになります。
Opus 4.8 fast: 1 × $10 + 0.2 × $50 = $20
Opus 5.5 fast: 1 × $8 + 0.2 × $40 = $16
Opus 5.5 standard: 1 × $4 + 0.2 × $20 = $8
Fast-to-fast reduction at fixed token usage:
($20 - $16) / $20 = 20%この試算は、入力をキャッシュせず、有料サーバーツールを使わず、データ所在地に関する追加料金も発生しない前提です。税金、クレジット、アカウント固有の割引も含めていません。キャッシュやデータ所在地の料金調整がある場合は、別途計算が必要です。
この20%は、同じ入力トークン数と出力トークン数を使って、高速モード同士を比べたときの差です。タスクを完了する費用が20%下がることを示すものではありません。実際の作業で使うトークン数まで同じになるとは限らないため、単価の比較とタスク全体の費用は分けて評価します。
Opus 5.5の思考トークンは、表示されない分も含めて出力として課金されます。そのため、以前は思考なしで処理していた仕事では、出力トークンの合計が変わる可能性があります。表示された回答だけを比較しても、思考を含めた総出力の違いは確認できません。
代表的なタスクで、検証に合格した結果、トークン料金、再試行回数、経過時間を測定してください。生成が速くなることで利用者の操作感が改善する場面では、高速モードを維持する理由があります。ツールや外部サービスの待ち時間が大半を占めるバックグラウンド処理では、まず標準速度を試してください。
6. Claude Codeのモデル選択と高速設定を更新する
Opus 5.5を明示的に選んでから、高速モードのスイッチを確認してください。Claude Codeを更新するだけでは、保存済みのモデル上書き設定が変更されたことは確認できません。
モデル設定の説明によると、Opus 5.5にはClaude Code v2.1.280以降が必要です。
ネイティブインストーラーを使った環境では、Bashで次を実行します。
claude update
claude --version
claudeパッケージマネージャーでインストールした場合は、セットアップの説明にある該当する更新コマンドを使ってください。
Claude Codeの対話セッション内では、次を実行します。
/model claude-opus-5-5
/fast
/status/fastでスイッチを変更する必要がある場合はSpaceを押し、Enterで確定します。説明にある有効状態では、Fast mode ONと↯アイコンが表示されます。選択中のモデルは/statusで確認してください。
~/.claude/settings.json、.claude/settings.json、.claude/settings.local.jsonのモデル上書き設定を調べます。ANTHROPIC_MODELとANTHROPIC_DEFAULT_OPUS_MODELも確認してください。起動時に渡すフラグや管理者が配布する設定にも、以前のモデル指定が残っていないかを調べます。設定ファイル全体を置き換えず、必要な既存キーを変更してください。
一度再起動し、モデルを再確認してください。再開したセッションや優先順位の高い設定が、以前のモデル選択を保持している場合があります。
Claude Codeの高速モードの動作には、専用レート制限に達した後の待機中に標準速度へ自動で切り替える処理があります。この動作があっても、Opus 4.8高速モードの削除後に発生するエラーを回避できるわけではありません。
アカウントの上限が変更を妨げている場合は、まずClaude Codeのサブスクリプション上限とAPIの429エラーを区別してください。
7. 実際に使える切り戻し先を用意して展開する
リクエストの確認とアプリ側の合格条件を満たしてから、トラフィックの一部だけを新しい設定へ移してください。
通常のテキストリクエストを検証に含めます。ツールを使うアプリでは、代表的なツールとのやり取りも確認してください。それとは別に、通常の出力枠に近いタスクも試します。新しいモデルで得られる利用可能な結果を、現在の設定と比較してください。速度の確認結果、エラー数、トークン料金、完了までの総時間を追跡します。
切り戻し先として、検証済みの標準速度の設定を残しておきます。11月30日以降は、claude-opus-4-8とspeed: "fast"を復元しても、使える復旧手段にはなりません。
展開済みサービスのリクエストを再確認して、移行を完了します。本番のどの経路からも、削除されたモデルと速度の組み合わせを生成できない状態にしてください。
