Claudeのモデルは、新しい版が出ると古い版が順番に使えなくなります。
直近では、Claude Sonnet 4.5(claude-sonnet-4-5-20250929)が2026年11月30日に退役します。その日を過ぎると、このモデルを呼び出すリクエストはエラーになります。
APIでClaudeを組み込んでいるサービスは、コードを1行も変えていなくてもある日突然止まります。この記事では、退役の仕組みと、慌てないための備えをまとめます。
モデルには4つの状態がある
Anthropicはモデルの状態を4段階で管理しています。
- Active:サポートされていて、利用が推奨される状態
- Legacy:更新はもうされない状態。いずれ非推奨になる可能性がある
- Deprecated(非推奨):まだ動くが、移行先と退役日が示された状態
- Retired(退役):使えない状態。リクエストは失敗する
退役の通知は、少なくとも60日前に届きます。逆に言えば、猶予は最短で2か月です。Sonnet 4.5の場合も9月30日に非推奨になり、11月30日に退役という日程でした。
2026年だけでこれだけ退役した
公式の退役ページに載っている、2026年の退役日を並べます。
- 2月19日:Claude Sonnet 3.7、Claude Haiku 3.5
- 4月20日:Claude Haiku 3
- 6月15日:Claude Sonnet 4、Claude Opus 4
- 8月5日:Claude Opus 4.1
- 11月30日(予定):Claude Sonnet 4.5
ほぼ2か月おきに、何かが使えなくなっています。「一度組み込んだら終わり」ではなく、ライブラリのアップデートと同じように、定期的なメンテナンスが必要なものだと考えたほうが安全です。
次に注意が必要なのは、Claude Opus 4.5(claude-opus-4-5-20251101)とClaude Haiku 4.5(claude-haiku-4-5-20251001)です。どちらもまだActiveですが、「この日より前には退役させない」という保証の日付が、Opus 4.5は11月24日、Haiku 4.5は10月15日です。保証期間が切れる、またはすでに切れているので、いつ非推奨の告知が出てもおかしくありません。
一方、現行の最新モデルは当面安心です。Opus 5.5は2027年9月22日、Sonnet 5.5は2027年9月28日、Haiku 5.5は2027年10月7日、Fable 5.2は2027年11月9日より前には退役しないとされています。
備え1:モデルIDをコードに直書きしない
モデルIDがコードのあちこちに書かれていると、移行のたびに探して回ることになります。環境変数に1か所で持たせておけば、切り替えは設定の変更だけで済みます。Next.jsとTypeScriptの例です。
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic();
// モデルIDは環境変数で1か所にまとめる
const MODEL = process.env.CLAUDE_MODEL ?? "claude-sonnet-5-5";
export async function summarize(text: string) {
const res = await client.messages.create({
model: MODEL,
max_tokens: 1024,
messages: [{ role: "user", content: `次の文章を要約してください。\n\n${text}` }],
});
return res.content;
}
Vercelなら、環境変数を書き換えて再デプロイするだけでモデルが切り替わります。
備え2:退役日をカレンダーに入れる
使っているモデルの「退役しない保証日」を、公式の退役ページで確認してカレンダーに登録します。通知メールは届きますが、担当者が変わっていたり、迷惑メールに埋もれたりすることはあります。自分たちで日付を持っておくのが確実です。
どのモデルを使っているか分からなくなったときは、Claude ConsoleのUsageページからCSVを書き出せます。APIキーごと、モデルごとの利用状況が出るので、古いモデルを呼んでいる場所を特定できます。
備え3:移行前に試すためのテストを持っておく
新しいモデルは基本的に賢くなっていますが、出力の書き方や長さは変わります。JSONで返してもらう処理や、決まった形式を期待する処理は、モデルを変えたとたんに崩れることがあります。
代表的な入力を10〜20件ほど保存しておき、モデルを変える前に流して結果を見比べる。これだけで、移行の不安はかなり減ります。Anthropicも、退役日より前に新しいモデルでアプリをテストすることをすすめています。
備え4:モデル以外の変更にも目を配る
止まる原因はモデルの退役だけではありません。APIのパラメータも変わります。
たとえばtemperature、top_p、top_kの3つは、APIバージョン2026-10-21で削除されました。指定すると400エラーが返ります。古いサンプルコードをそのまま使っていると、ここでつまずきます。公式の案内は、これらのパラメータを省き、挙動はプロンプトで調整することです。
まとめ
- Claudeのモデルは Active → Legacy → Deprecated → Retired の順に進む
- 退役の通知は少なくとも60日前。猶予は短い
- Sonnet 4.5は2026年11月30日に退役。移行先はclaude-sonnet-5-5
- モデルIDは環境変数にまとめ、退役日をカレンダーに入れ、テスト用の入力を持っておく
AIを組み込んだ機能は、作ったあとも手をかけ続ける必要があります。最初から「モデルは入れ替わるもの」として設計しておくことが、いちばんの備えです。


