【8月5日提供終了】Claude Opus 4.1からclaude-opus-4-8への移行手順と注意点
本番のバッチ処理やCIで claude-opus-4-1-20250805 をモデルIDに直書きしていませんか。そのコードは2026年8月5日を境に動かなくなります。
この記事はClaude APIとClaude Codeを業務で使っているエンジニア向けに、Claude Opus 4.1の提供終了までにやるべきことを整理したものです。後継モデル claude-opus-4-8 との違い、移行手順、そして移行時に400エラーを引き起こす具体的な落とし穴まで、その場で確認できるチェックリスト形式でまとめます。本記事の情報はすべて2026-08-01時点の公式ドキュメントに基づいています。
Claude Opus 4.1は2026年8月5日に使えなくなる
出典: Unsplash（撮影者: Christopher Gower）
結論から言うと、Claude Opus 4.1（モデルID: claude-opus-4-1-20250805）は2026年8月5日にClaude API上で提供終了（Retired）となり、それ以降このモデルIDを指定したAPIリクエストは失敗します。Anthropicが公式に案内する移行先は claude-opus-4-8 です（Anthropic公式 Model deprecations、2026-08-01時点）。
やるべきことは本質的にはひとつ、「モデルIDの書き換え」です。ただし後述するとおり、Opus 4.7以降でパラメータ仕様が変わっているため、モデル名だけ変えるとエラーになるケースがあります。
通知から60日というスケジュール感
Anthropicは公開モデルについて、提供終了の少なくとも60日前までに通知する方針を示しています。今回のOpus 4.1も2026年6月5日に非推奨（Deprecated）通知、8月5日に退役と、ちょうど約2ヶ月のスパンです。
Deprecated: The model is still functional but no longer recommended. Anthropic provides a recommended replacement and assigns a retirement date.
（Anthropic公式ドキュメント Model deprecations）
見落としがちですが、Opus 4とSonnet 4はすでに退役済みです。Anthropicが短いサイクルでモデルを入れ替えている実態がわかります。
| モデル | 非推奨通知 | 提供終了 | 推奨移行先 |
|---|---|---|---|
claude-opus-4-20250514 |
2026-04-14 | 2026-06-15（終了済み） | claude-opus-4-8 |
claude-sonnet-4-20250514 |
2026-04-14 | 2026-06-15（終了済み） | claude-sonnet-4-6 |
claude-opus-4-1-20250805 |
2026-06-05 | 2026-08-05 | claude-opus-4-8 |
なお、Anthropicは廃止済みモデルの重みを長期保存するコミットメントを公式に表明していますが、一般提供が再開される時期は未定です。「あとで戻せばいい」という前提は置かないほうが安全です。
後継モデル claude-opus-4-8 とは？Opus 4.1との違い
Claude Opus 4.8は2026年5月28日に発表・GAされたモデルで、コーディングやエージェント用途の性能向上に加え、不確実な場合に誤った断定をしにくい「正直さ」の改善が挙げられています（Anthropic公式 Claude Opus 4.8）。
出典: Anthropic公式
料金・スペック比較表
移行を考えるうえで最もインパクトが大きいのは料金です。Opus 4.8の単価はOpus 4.1の約3分の1で、そのうえコンテキストウィンドウは5倍になっています。
| 項目（100万トークンあたり） | Opus 4.1 | Opus 4.8 | Opus 5 | Sonnet 5 |
|---|---|---|---|---|
| 入力 | $15 | $5 | $5 | $2（導入価格） |
| 出力 | $75 | $25 | $25 | $10（導入価格） |
| コンテキストウィンドウ | 200k | 1M | 1M | 1M |
| 最大出力トークン | 32k | 128k | 128k | 128k |
Sonnet 5の$2／$10は導入記念価格で、2026年8月31日以降は入力$3／出力$15へ改定予定とされています。価格は変動しやすいため、実際の見積もり前に公式のModels overviewで最新値を確認してください（数値はいずれも2026-08-01時点）。
知識カットオフが1年近く新しくなる
Opus 4.1の信頼できる知識カットオフは2025年1月（学習データは2025年3月まで）でしたが、Opus 4.8では2026年1月まで前進しています。ライブラリのバージョン情報や最近のAPI仕様を扱うタスクでは、この差が回答品質に直結します。
今すぐやるべき移行チェックリスト
出典: Unsplash（撮影者: Chris Ried）
1. 自分がOpus 4.1をどこで使っているか棚卸しする
まずはClaude ConsoleのUsageページでモデル別の使用量を確認し、Opus 4.1のリクエストが今も発生しているかを見ます。CSVエクスポートを使えば、どのAPIキー・どの期間で使われているかを機械的に洗い出せます。通知メールを見落としている可能性を考えると、自分で監査するのが確実です。
チェックすべき典型的な場所は次のとおりです。
- アプリケーションコード内の
model=引数 ~/.claude/settings.jsonなどClaude Codeの設定ファイル- サブエージェント定義ファイルのfrontmatter
- CI／CDのワークフロー定義や環境変数
- 社内ツール・バッチスクリプトのハードコード箇所
2. CLI／SDKのバージョンを上げる
Opus 4.8の利用にはClaude Code v2.1.154以降、Opus 5にはv2.1.219以降が必要です。まず claude update を実行してバージョンを最新にしてください。バージョンが古いままだと、次のステップでモデル設定を書き換えても正しく反映されないことがあります。
3. Claude Codeのモデル設定を確認する
ここが実務者の見落としポイントです。Claude Codeの opus エイリアスは、v2.1.219以降かつAnthropic API利用時にはすでにClaude Opus 5を指しています（v2.1.154〜v2.1.218の期間はOpus 4.8）。つまり /model opus で運用している人は自動的に移行済みで、影響を受けるのはモデルIDを直接書いているケースだけです。
モデルを明示的に固定する方法は3つあり、優先順位は「セッション内 /model > 起動時 --model フラグ > 環境変数 > 設定ファイル」です（Claude Code公式 Model configuration）。
| 方法 | 書き方 | 用途 |
|---|---|---|
| 設定ファイル | ~/.claude/settings.json に {"model": "claude-opus-4-8"} |
常用の既定値 |
| 環境変数 | ANTHROPIC_MODEL=claude-opus-4-8 |
CI・コンテナ環境 |
| スラッシュコマンド | /model claude-opus-4-8 |
セッション単位の切り替え |
廃止予定モデルや自動リマップ対象のモデルを指定している場合、Claude Codeは起動時に警告を出します（非対話モードではstderrに出力）。CIログに警告が出ていないか確認しておくとよいでしょう。
移行時に気をつけたい5つの注意点
出典: Unsplash（撮影者: Andras Vas）
temperature・top_p・top_kを指定すると400エラー
Opus 4.7以降（4.8・5を含む）では、temperature / top_p / top_k にデフォルト以外の値を指定すると400エラーになります。出力のばらつきを抑えたい場合は、パラメータではなくプロンプト側で「出力形式を固定する」「候補を挙げず1案だけ返す」といった指示に置き換えます。
extended thinkingの書き方が変わる
thinking: {"type": "enabled", "budget_tokens": N} はOpus 4.8では非対応です。代わりに thinking: {"type": "adaptive"} と output_config: {"effort": ...} の組み合わせで思考量を制御します。なお effort はAPI・Claude Code・claude.aiのいずれでもデフォルトが high になるため、明示指定しない限り思考量は多めになります。
# 変更前（Opus 4.1）
resp = client.beta.messages.create(
model="claude-opus-4-1-20250805",
max_tokens=8000,
temperature=0.2,
thinking={"type": "enabled", "budget_tokens": 4000},
betas=["interleaved-thinking-2025-05-14"],
messages=messages,
)
# 変更後（Opus 4.8）
resp = client.messages.create(
model="claude-opus-4-8",
max_tokens=12000, # トークナイザー変更分を上乗せ
thinking={"type": "adaptive"}, # enabled + budget_tokens は不可
output_config={"effort": "high"},
messages=messages,
)
ベータヘッダー（interleaved-thinking-2025-05-14 など）も不要になるため、client.beta.messages.create から通常の client.messages.create に戻します（Migration guide）。
トークナイザー変更で消費トークンが増える
Opus 4.7以降はトークナイザーが変更されており、同じ文章でも旧モデル比で最大約30〜35%多くトークンを消費するとされています（Anthropic公式 Migration guide）。max_tokens を据え置くと出力が途中で切れるため、余裕を持たせて再設定してください。単価が下がっていてもトークン数は増えるので、実コストは必ず実測で確認しましょう。
サードパーティツール側が未対応だとエラーが出る
自分のコードを直しても、Claude APIを組み込んだ他社ツールが古い仕様のままだとエラーになります。実際にVS CodeのCopilot Chatでは、統合側が thinking.type.enabled を送り続けて次のエラーが報告されています。
thinking.type.enabled is not supported for this model. Use thinking.type.adaptive and output_config.effort to control thinking behavior.
（GitHub microsoft/vscode Issue #312290）
エディタ拡張やAIオーケストレーション系のツールを使っている場合は、そちら側のリリースノートも合わせて確認してください。
出力の傾向が変わるためプロンプトの再調整が要る
モデルが変わると、出力の長さや指示への従い方も変わります。特に評価用のプロンプトや、出力をパースして後段処理に渡しているワークフローは、切り替え直後に少量のサンプルで回帰確認をしておくと安全です。
Opus 4.8だけじゃない。Sonnet 5・Opus 5という選択肢
公式ドキュメントのModels overviewには、「Opus 4.8以前を使っている場合はClaude Opus 5へ移行するように」という警告が掲載されています。Opus 5は2026年6月9日に一般提供が始まった現行の最新Opusで、料金はOpus 4.8と同額（入力$5／出力$25）です。つまり「Opus 4.8への最小移行」で止めると、遠くない将来に再び移行作業が発生する可能性があります。
出典: Anthropic公式
Opus 4.8はLegal Agent Benchmarkで最高スコアを記録し、コンピュータ操作ベンチマークOnline-Mind2Webでも84%という結果が公表されています（Anthropic公式 Claude Opus 4.8。母数・比較条件など詳細な脚注は未公開のため、数値は参考情報としてご覧ください）。性能面で十分な用途なら、当面はOpus 4.8で運用するのも現実的な選択です。
| 判断軸 | おすすめ | 理由 |
|---|---|---|
| 変更を最小にしたい | claude-opus-4-8 |
公式の推奨移行先。パラメータ修正だけで済む |
| 最新・最高性能を使いたい | claude-opus-5 |
現行最新Opus。料金はOpus 4.8と同額 |
| コストを下げたい | claude-sonnet-5 |
1Mコンテキストで単価が最も低い。8/31の価格改定に注意 |
Opus 4.1（200k／32k）を使い続けていたワークフローなら、Sonnet 5でもコンテキスト・最大出力の両方が上回ります。まずSonnet 5で品質が足りるか試し、不足する部分だけOpusに寄せる構成がコスト効率の面では有力です。
Bedrock・Vertex AI利用者と企業契約での確認事項
Amazon Bedrock、Google Cloud（Vertex AI）、Microsoft Foundry経由でClaudeを使っている場合、モデルの退役スケジュールはAnthropic直接提供のClaude APIとは異なる可能性があります。各プラットフォームが独自にスケジュールを設定しているため、必ず利用中プラットフォームの公式モデル一覧を別途確認してください。
また、Enterprise向けの個別契約で猶予期間が変わるかどうかは公式ページに明記がありません。企業として大規模に利用している場合は、断定せずAnthropicのサポート窓口に確認するのが確実です。
まとめ｜8月5日までにやることリスト
残り時間は多くありません。最低限、次の3つを今日中に確認してください。
- 棚卸し: Claude ConsoleのUsageページで
claude-opus-4-1-20250805の利用が残っていないか確認する - 書き換え: モデルIDを
claude-opus-4-8（またはclaude-opus-5）へ変更し、temperature/top_p/top_kを削除、thinkingをadaptive+output_config.effortに置き換える - 検証:
claude updateでCLIを更新し、max_tokensを30%程度上乗せしたうえで代表的なプロンプトを回帰テストする
モデルの退役は今後も約60日サイクルで繰り返されます。この機会にモデルIDを設定ファイルや環境変数に外出しし、次回は1箇所の変更で済む構成にしておくと、移行作業そのものを軽くできます。最新のスケジュールはAnthropic公式のModel deprecationsページをブックマークして定期的に確認しましょう。
