Claudeモデルの引退で自動化が止まる日 — バージョン固定とエイリアスの設計判断
引退したモデルへのリクエストは失敗します。エージェント定義やCIにモデルIDを書くときの「固定かエイリアスか」を、止まり方の違いから設計判断としてまとめます。
Claude Opus 4.1は2026年6月5日に非推奨化の通知が出て、8月5日に引退しました。引退したモデルへのリクエストは失敗します。エージェント定義・CI・スクリプトにそのモデルIDを直書きしていた自動化は、この日を境に全部止まります。
一方で、モデルIDをエイリアスにしておけば止まらないかというと、そうでもありません。エイリアスは解決先が移った日に、通知なくコストと挙動が変わります。渡していたパラメータが400エラーで弾かれることさえあります。つまり「固定かエイリアスか」は好みの問題ではなく、どちらの壊れ方を引き受けるかという設計判断です。この記事では、引退の仕組みと2つの壊れ方を確認したうえで、書く場所ごとの使い分けまで見ます。
Claudeモデルの引退はどう進むか
Claudeモデルの引退とは、AnthropicがモデルをAPIから完全に取り下げ、リクエストが失敗するようになることです。公式はライフサイクルをActive(現役)・Legacy(更新停止)・Deprecated(非推奨、引退日確定)・Retired(引退済み)の4段階で定義しています。Deprecatedになった時点で推奨代替モデルと引退日が公表され、公開モデルでは引退の60日以上前に通知されます。通知はメールとドキュメントの両方です。
実績を見ると、猶予は本当に約2ヶ月しかありません。
| 非推奨化の通知 | 引退日 | 引退したモデル | 推奨代替 |
|---|---|---|---|
| 2026年6月5日 | 引退日2026年8月5日 | 引退したモデルclaude-opus-4-1-20250805 | 推奨代替claude-opus-4-8 |
| 2026年4月14日 | 引退日2026年6月15日 | 引退したモデルclaude-sonnet-4-20250514 / claude-opus-4-20250514 | 推奨代替claude-sonnet-4-6 / claude-opus-4-8 |
| 2026年2月19日 | 引退日2026年4月20日 | 引退したモデルclaude-3-haiku-20240307 | 推奨代替claude-haiku-4-5-20251001 |
現役モデルにも「これより早くは引退しない」という暫定日が公表されています。たとえばclaude-opus-5は2027年7月24日、claude-sonnet-4-5-20250929は2026年9月29日より前には引退しません。日付の近いモデルを固定している自動化は、次の非推奨化候補を抱えていることになります。
この日程が適用されるのはAnthropic運営のプラットフォーム(Claude API・Claude Platform on AWS・Microsoft Foundry)です。Amazon BedrockとGoogle Cloudはパートナー運営のため引退スケジュールが別で、同じモデルでも状態と日付が食い違うことがあります。複数プラットフォームにまたがる自動化は、引退の監視も別々に必要です。
バージョン固定の壊れ方 — 引退日に確実に止まる
claude-opus-4-8 のような完全なモデルIDを書くのがバージョン固定です。注意したいのは、4.6世代以降の日付なしIDも固定であることです。claude-sonnet-4-6 は「最新のSonnetに追随するポインタ」ではなく、単一のスナップショットを指す正式IDだと公式が明言しています。重みが更新されることはなく、改良版は必ず別IDで出ます。日付がないから追随する、という直感は誤りです。
固定したIDが引退すると、無効なモデルIDへのリクエストとしてAPIは404(not_found_error)を返します。Claude Codeでは次のエラーになります。
There's an issue with the selected model (claude-...).
It may not exist or you may not have access to it.
Run /model to pick a different model.自動化パイプラインでこの停止が起きる経路は、大きく2つあります。
1つ目は「自分で書いた固定」です。サブエージェント定義のfrontmatter(model: に完全IDを書ける)、CIの環境変数、スクリプトの引数。書いた本人が引退通知のメールを読み飛ばすと、引退日にそのサブエージェントの起動やCIジョブが一斉に失敗します。失敗は引退日まで一切表面化しないため、事前のテストでは見つかりません。
2つ目は「ツールに同梱された固定」です。CIでCLIやSDKのバージョンを固定して使っている場合、その古いバージョンが内包する既定モデルや依存先が引退対象になることがあります。自分ではモデルIDを1文字も書いていないのに、実体としては固定していたというパターンです。この場合の対処はモデルIDの書き換えではなく、ツール自体の更新になります。「モデルIDをどこにも書いていないから無関係」とは言えません。
Claude Codeには、この事故を手前で知らせる仕組みが入っています。指定したモデルに引退予定日が設定されていると、起動時に警告が表示されます。v2.1.182以降は非対話モードでも同じ警告がstderrに書かれ、サブエージェント定義のfrontmatterに書いた model: も検査対象です(--output-format json では抑制されるため、結果メッセージの modelUsage フィールドで実際のモデルを確認します)。加えてfallbackModelも緩和策になります。チェーンに引退済みモデルが混ざっていても、そのエントリを飛ばして次に切り替わる仕様です。
ただしこの警告はAnthropic API直結の環境が前提です。Bedrock・Vertex AI・FoundryやLLMゲートウェイの背後では、モデル名の定義はプロバイダ側にあるため、Claude Codeは文字列を検査せずそのまま通します。ゲートウェイ越しの固定は、失敗が最初のリクエストまで表面化しません。スクリプトやハーネスからは、stderrの [claude-code:unrecognized_model] 診断行を監視すると、認識されないモデルIDでリクエストが出た瞬間を検出できます。
エイリアスの壊れ方 — 移動した日に静かに別物になる
エイリアスの壊れ方は逆で、止まらない代わりに中身が変わります。Claudeのエイリアスは主に3種類です。
| 種類 | 例 | 解決のされ方 |
|---|---|---|
| API上の簡易エイリアス(4.6世代より前) | 例claude-sonnet-4-5 | 解決のされ方そのマイナー版の最新日付スナップショットを指す |
| Claude Codeのファミリーエイリアス | 例opus / sonnet / haiku / fable | 解決のされ方プロバイダごとの推奨バージョンに追随し、時間とともに更新される |
| Claude Codeの特殊値 | 例default | 解決のされ方アカウント種別の推奨モデル(組織既定があればそちら)に戻す |
エイリアスの解決先が新世代へ移ると、その日から料金・トークナイザー・挙動が一度に変わります。実害が出やすいのはパラメータです。Opus 4.7以降のモデルは temperature / top_p / top_k に既定値以外を渡すと400エラーを返します。エイリアス経由で旧世代を使っていたコードがこれらを渡していると、解決先の移動当日から全リクエストが失敗します。固定の壊れ方が「引退日に止まる」なら、エイリアスの壊れ方は「移動日に化ける、ときどき止まる」です。
止まらないケースのほうが、実は厄介です。トークナイザーの変更でトークン数が変わればコストが黙って動きます(Opus 4.7世代のトークナイザーは従来比1〜1.35倍)。応答の性格が変われば、プロンプトの調整前提が崩れます。パイプラインは緑のまま、成果物の品質だけが変わっている状態は、監視では捕まえにくいものです。
中間解として、Claude Codeには ANTHROPIC_DEFAULT_OPUS_MODEL などの環境変数があります。fableエイリアスの解決先を変えるANTHROPIC_DEFAULT_FABLE_MODELと同じ仕組みで、エイリアスという書き方を保ったまま、解決先の移動タイミングを自分の管理下に置けます。組織なら enforceAvailableModels と env ブロックの併用で、許可モデルの制限とバージョン固定を両方かけられます。
どこに何を書くか — 固定とエイリアスの使い分け
壊れ方が対照的なので、使い分けの軸は「その場所で起きてほしくないのはどちらの事故か」です。
| 書く場所 | 推奨 | 理由 |
|---|---|---|
| 本番パイプライン・CI | 推奨固定 + 引退日の監視 | 理由挙動が黙って変わるほうが検証コストが高い。停止は日付が事前に分かる |
| 評価・ベンチマーク | 推奨固定 | 理由比較対象が動いたら測定にならない |
| サブエージェントのモデル指定 | 推奨ファミリーエイリアス | 理由目的は「安い層を使う」こと。特定バージョンへの依存がない |
| 個人の対話セッション | 推奨エイリアス | 理由常に推奨バージョンでよい。壊れてもその場で気づける |
| 配布するエージェント定義・テンプレート | 推奨エイリアス | 理由受け取った側の環境と時期を選ばない。固定IDは配布先で引退を迎える |
固定を選んだ場合の引退検出には、Claude ConsoleのUsageページからCSVをエクスポートする方法が公式に案内されています。APIキー×モデル別の使用量が出るため、非推奨モデルを使い続けている箇所をリストアップできます。どのモデルを固定していたか自体を忘れる、というのが引退事故の典型なので、棚卸しの手段を持っておくことに意味があります。
よくある質問
Deprecated(非推奨)になったモデルはすぐ使えなくなりますか
引退日までは動きます。ただし公式は、非推奨モデルはActiveなモデルより信頼性が落ちる可能性があると注記しており、引退日を待たず早めに移行するよう案内しています。
SDKの型定義にはtemperatureが残っているのに、なぜ400エラーになるのですか
既存コードの型チェックを壊さないために、非推奨パラメータはSDKのリクエスト型に残す方針だからです。受け付けるかどうかはモデル側で判定され、Opus 4.7以降では既定値以外の指定が拒否されます。コンパイルが通ることは互換の保証になりません。
引退したモデルの重みは消えるのですか
消えません。Anthropicはモデル重みの長期保存を確約しており、将来的に過去モデルを再公開したい意向も表明しています。ただし仕様としては、引退済みモデルへのリクエストは失敗します。「いつか戻るかもしれない」を運用の前提にはできません。
Claude Codeのopusエイリアスはいつ切り替わりますか
切り替え時期は事前告知されません。エイリアスは「プロバイダごとの推奨バージョン」に追随するとだけ定義されています。移動タイミングを管理したい場合は、完全IDを書くか ANTHROPIC_DEFAULT_OPUS_MODEL で解決先を固定します。
引退前に代替モデルへの移行はどう検証すればよいですか
公式は、引退日より十分前に代替モデルでアプリケーションを実際にテストするよう案内しており、非推奨化の告知には推奨代替モデルが必ず併記されます。世代をまたぐ移行ではパラメータの扱いやトークナイザーが変わることがあるため、破壊的変更の一覧を先に確認すると手戻りが減ります。
まとめ
固定は引退日に確実に止まり、エイリアスは移動日に静かに変わります。事故をゼロにする書き方は存在しないので、選ぶのは「どちらの壊れ方なら検知して吸収できるか」です。検証済みの挙動を守りたい本番経路は固定と引退日監視、バージョン差に依存しない用途はエイリアス、という分担が出発点になります。そして固定を選んだ日には、そのモデルの引退予定日を調べて記録しておく。60日は、気づいてから動くには意外と短い時間です。現行モデルの一覧と各IDの位置づけはClaudeモデル一覧で確認できます。