非推奨と移行ウォッチ
モデルは廃止され、パラメータは名称変更され、挙動は変化します。このページは、アップグレードで驚かされることがないよう 破壊的変更 を追跡します。API 上で構築するなら、定期的にざっと目を通しましょう。
なぜこれが重要なのか
固定したモデル ID は、いずれ 非推奨 となり、その後 削除 されます。それをハードコーディングしたコードは壊れます。少しの衛生管理が、深夜 2 時の不意打ちを防ぎます。
生き残るためのルール
- モデル ID は設定ファイルから読み込み、リテラルをコードベース全体に散らばらせないこと — そうすれば移行は 1 行の変更で済みます。
- 非推奨の日付や推奨される代替手段について 発表をウォッチ しましょう。
- モデルを切り替えたら 評価（evals） を再実行 しましょう — 「より新しく優れた」モデルでも挙動は変化することがあります。
- 削除後ではなく 締め切り前にテスト しましょう。
よくある変更の種類
| 変更 | 例 | 対処法 |
|---|---|---|
| モデルの廃止 | 古いモデル ID が動作しなくなる | 推奨される後継へ移行し、再評価する |
| パラメータの置き換え | 推論/予算のつまみが effort に置き換えられる | 呼び出しを更新する。思考とエフォート を参照 |
| デフォルトの変更 | 新しいデフォルトのモデル/挙動 | 意図的に固定し、プロンプトが引き続き機能するか検証する |
| エンドポイント/SDK の更新 | SDK の新しいメジャーバージョン | 移行ガイドを読み、慎重にバージョンを上げる |
現在のウォッチ
信頼できるスケジュールは 公式モデル非推奨ページ にあります — 移行する前に、必ずそこで日付を確認してください。Anthropic は、一般公開されたモデルを廃止する前に、少なくとも 60 日前に通知します。
非推奨のモデル
公開されている Claude モデルのうち 1 つが「非推奨だがまだ削除されていない」期間にあります(2026 年 11 月 2 日確認):claude-sonnet-4-5-20250929(Sonnet 4.5)は 2026 年 9 月 30 日に非推奨となり、2026 年 11 月 30 日に提供終了となります。 Anthropic の推奨する置き換え先は claude-sonnet-5-5 です。呼び出しは提供終了日まで動作し続け、その後は失敗します。この ID をまだ固定しているなら、これがあなたの移行であり、猶予は現在4 週間未満です。
もう 1 つ非推奨になっているのは、招待制の claude-mythos-preview です(2026 年 6 月 9 日に非推奨、提供終了日は未定)。現在の検証制モデルである claude-mythos-5-1 に移行してください。(claude-mythos-5 はまだ Active ですが、5.1 を指す独自の移行ガイドがあるため、二度移行するのは無駄な作業です。)
claude-haiku-4-5-20251001 は次に注意すべき ID で、現在、ラインナップの中で最短の提供終了予定日を過ぎている唯一のモデルです。その下限は 2026 年 10 月 15 日で、すでに過ぎました(次はOpus 4.5 の 2026 年 11 月 24 日です)。モデル概要ではレガシーモデルにも挙げられており、直接の後継は claude-haiku-5-5(2026 年 10 月 7 日リリース)です。2026 年 11 月 2 日時点で、公式のステータス表はこれを依然として Active と記載しており、非推奨の発表はありません。したがって、この 2 つの読み方は矛盾しません。Anthropic のライフサイクル用語での「レガシー」は更新を受けなくなり、将来非推奨になる可能性があるという意味で、「非推奨」の一段手前です。「早くてもこの日以降」という日付が来ても、それは計画を立てる合図であって停止ではありません。Anthropic は少なくとも 60 日前の通知を約束しており、そのカウントダウンは通知が出た時点から始まり、下限日を過ぎた時点からではありません。Sonnet 4.5 が実例です。下限日は 2026 年 9 月 29 日で、非推奨の通知は 9 月 30 日に出され、実際の提供終了はその 2 か月後です。この ID を固定しているなら、移行は見守るのではなく予定を組む段階に入っています。しかも単純な ID の差し替えではありません。400 を返す 5 つの変更と 200 を返す 6 つの変更については Claude Haiku 5.5: 100K の価格の崖 を参照してください。移行する前に公式のモデルステータス表で確認してください。
最近削除されたモデル
claude-opus-4-1-20250805(Opus 4.1) は 2026年8月5日に削除 されました —claude-opus-4-8（または直接claude-opus-5）に移行してください。claude-opus-4-20250514(Opus 4) とclaude-sonnet-4-20250514(Sonnet 4) は 2026年6月15日に削除 されました — Anthropic が挙げている移行先はそれぞれclaude-opus-4-8とclaude-sonnet-4-6です（または直接claude-opus-5/claude-sonnet-5）。
削除済みの ID への呼び出しは現在 API エラーを返します。コードがまだどれかを固定している場合は、それを最優先で修正してください。
パラメータの非推奨
サンプリングのつまみである temperature、top_p、top_k は廃止に向かっており、送信する API バージョンによって 2 つの異なるルールがあります。
anthropic-version: 2023-06-01の場合(2026 年 10 月 21 日より前にリリースされたすべての SDK メジャーが送るもの):Claude 4.7 世代以降のモデル(Opus 4.7、Opus 4.8、Opus 5、Opus 5.5、Sonnet 5、Sonnet 5.5、Haiku 5.5、Fable 5、Fable 5.1、Mythos 5、Mythos 5.1)および Claude Mythos Preview では、これらのいずれかをデフォルト以外の値に設定すると 400 エラーが返されます。デフォルト値は受け付けられ、古いモデルはデフォルト以外の値も引き続き受け付けます。名前ではなくバージョン番号に注意してください。Haiku 5.5 はデフォルト以外のサンプリング値を拒否しますが、古い Haiku 4.5 は引き続き受け付け、Opus 4.6 と Sonnet 4.6 も同様です。anthropic-version: 2026-10-21の場合:この 3 つのパラメータは削除されます。送信すると、どのモデルでも、パラメータのデフォルト値であっても 400 が返されます。最新の SDK メジャーとantCLI は、リクエスト型とフラグからこれらを削除しています。
どちらの場合も対処は同じです。3 つすべてを省略し、代わりに プロンプティング と 思考とエフォート で挙動を調整してください。代替手段がない唯一のケースは、まだ値を尊重する古いモデルで意図的に下げた temperature を使う場合で、Anthropic が文書化している選択肢は、パラメータの送信をやめるか、そのリクエストを 2023-06-01 のままにすることです。どのバージョンを使っているか、それに伴って他に何が変わるかの詳細は API Version 2026-10-21 — 3年ぶりの破壊的変更を伴うバージョン を参照してください。
現行モデルと価格 の表に対して、あなたのモデル ID を必ず確認してください。古い ID を使っている場合は、移行を計画しましょう。