Claude Sonnet 4.5は11月30日に終了|移行先と直す設定

Claude APIで「claude-sonnet-4-5-20250929」を指定しているアプリや社内ツールは、2026年11月30日の退役予定日を過ぎると呼び出しが失敗します。移行先はclaude-sonnet-5-5ですが、モデルIDを替えるだけではtemperatureやbudget_tokens、プリフィルが400エラーになることがあります。この記事では、対象の見分け方と、替えるときに直す設定、替えた後に測り直す点を順に説明します。
⚠️ 退役日より前に急にエラーが出たときは
11月30日より前にClaudeの呼び出しが一斉に失敗する場合は、退役ではなく障害の可能性があります。まず稼働状況を確かめてください。
結論|Claude APIでは11月30日に退役し、移行先はSonnet 5.5
9月30日に通知され、11月30日が退役予定日
Anthropic公式の「Model deprecations」によると、Anthropicは2026年9月30日に、Claude API上でのSonnet 4.5の退役予定を利用者へ通知しました。モデルの状態は「Deprecated」(非推奨)で、退役予定日(Tentative retirement date)は2026年11月30日、推奨の移行先はclaude-sonnet-5-5です。
同じページには、公開モデルの退役は利用中の顧客へ最低60日前にメールで知らせると書かれています。9月30日の通知から11月30日まではちょうどこの範囲に入ります。
ほかのSonnetの状態も同じ表で確かめられます。claude-sonnet-4-6とclaude-sonnet-5-5はどちらも「Active」で、退役はそれぞれ2027年2月17日、2027年9月28日より前にはならないと書かれています。長く使う前提なら、推奨どおりSonnet 5.5へ移るのが無難です。
退役日を過ぎたリクエストは失敗する
公式は「Retired」を、モデルがもう使えず、リクエストが失敗する状態と定義しています。移行の節には次の1文があります。
Requests to models past the retirement date will fail.(訳)退役日を過ぎたモデルへのリクエストは失敗します。
退役後にどんなエラー文が返るかは、公式ページには書かれていません。自動で新しいモデルへ切り替わるとも書かれていないので、11月30日までにコード側のモデルIDを書き換えておく必要があります。

自分が11月30日の対象か見分ける
Claude APIなどAnthropicが運営する経路は対象
公式ページの日付が当てはまるのは、Anthropicが運営する次の経路です。
- Claude API
- Claude Platform on AWS
- Claude Models on Google Cloud(Anthropic managed)
- Microsoft Foundry
これらの経路でclaude-sonnet-4-5-20250929を呼んでいるなら、11月30日が期限です。
Amazon BedrockとGoogle管理のGoogle Cloudは別の日程
Amazon Bedrockと、Claude Models on Google Cloud(Google managed)は、それぞれが独自の退役日程を決めるため、状態や日付が異なることがあると公式に書かれています。
これらの経路で使っている場合は、Anthropicのページではなく、各社のモデル一覧や提供終了の案内で日付を確かめてください。この記事では各社の具体的な日付は扱いません。
Consoleの利用履歴から使っている場所を探す
どのシステムがSonnet 4.5を呼んでいるか分からないときは、Claude Consoleの「Usage」ページで「Export」を押し、ダウンロードしたCSVを見ます。APIキー別・モデル別に利用が分かれているので、まだ旧モデルを使っているキーを特定できます。
あわせて、コードや環境変数を「sonnet-4-5」で検索してください。日付つきのIDだけでなく、日付なしの別名で書いている箇所も一緒に洗い出せます。

替えると400エラーになる設定
公式の「Claude Sonnet 5.5 migration guide」は、Sonnet 4.5から移る場合、Sonnet 5・4.6向けの変更をすべて当てたうえで、4.5向けの変更を足す積み上げ式になっています。主な変更は次の表のとおりです。
| Sonnet 4.5での書き方 | Sonnet 5.5での扱い | 直し方 |
|---|---|---|
| temperature・top_p・top_k | エラーになる | 指定を外す |
| thinkingのbudget_tokens | 400エラー | adaptiveとeffortに置き換える |
| 最後のassistantプリフィル | 400エラー | 用途ごとに別の方法へ移す |
| computer_20250124 | 受け付けない | 新しい版のツールへ替える |
| context-windowのbetaヘッダー | 不要 | ヘッダーを外す |
temperature・top_p・top_kを外す
移行ガイドは、temperature・top_p・top_kのサンプリング設定がSonnet 5.5ではエラーになるとして、指定を外すよう求めています。値で出力のばらつきを調整していた場合は、指示文(プロンプト)で望む書き方を伝える形に置き換えます。
ライブラリやフレームワークが既定でtemperatureを送っている場合もあるので、自分のコードに書いていなくても、送信内容を一度確かめてください。
関連記事:Claudeのtemperatureエラー|deprecatedと出る原因と直し方
thinkingのbudget_tokensをeffortに置き換える
Sonnet 4.5では、思考(thinking)の量を、typeをenabledにしたうえでbudget_tokensで指定していました。Sonnet 5.5ではこの書き方が400エラーになり、次の文が返ると移行ガイドに書かれています。
"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.(訳)このモデルは"thinking.type.enabled"に対応していません。思考の動きは"thinking.type.adaptive"と"output_config.effort"で制御してください。
budget_tokensを外し、typeをadaptiveにして、effortで深さを選びます。effortはmax・xhigh・high・medium・lowから選べます。
thinking={"type": "adaptive"},
output_config={"effort": "high"},
最後のassistantプリフィルをやめる
会話の最後にassistantの書き出しを入れて出力を誘導する「プリフィル」は、Sonnet 4.5では使えましたが、Sonnet 5.5では400エラーになります。返る文は次のとおりです。
This model does not support assistant message prefill. The conversation must end with a user message.(訳)このモデルはassistantメッセージのプリフィルに対応していません。会話はuserメッセージで終わる必要があります。
移行ガイドは、プリフィルを何に使っていたかで置き換え先を分けています。
- 出力の形式をそろえる:structured outputs、または分類ならenumを持つツールを使う
- 前置きを省かせる:system promptで直接答えるよう頼む
- 途中の続きを書かせる:続きの指示をuserメッセージへ移す
JSONの先頭の「{」をプリフィルしていたような使い方は、structured outputsへ移すのがいちばん確実です。
替えた後に確かめること
同じ文でもトークンが約3割増える
Sonnet 5.5はSonnet 5と同じトークナイザーを使うため、Sonnet 4.5と比べて同じ文が約30%多いトークンになると移行ガイドに書かれています(増え方は内容によります)。
トークン数を数え直し、max_tokensの値と費用の見積もりを見直してください。上限ぎりぎりで返答が途切れるようになった場合は、まずmax_tokensを疑います。
画像のトークンと既定の思考も変わる
画像の扱いも変わります。Sonnet 5.5は長辺2,576ピクセル・1枚最大4,784トークンまでの高解像度で読みます。Sonnet 4.5は1,568ピクセル・1,568トークンまでだったため、2000×1500の画像は約2.5倍のトークンになると書かれています。
もう1つの違いは思考の既定です。Sonnet 4.5ではthinkingを書かなければ思考なしで動きましたが、Sonnet 5.5では書かなくても思考が動きます。思考が動く分だけ応答時間とトークン数が変わるので、思考を前提にしない処理では移行ガイドの「Turn off up-front thinking」の節で止め方を確かめてください。
本番の前に2〜3段階のeffortで試す
budget_tokensとeffortには決まった対応表がないため、移行ガイドは2〜3段階のeffortで評価するよう勧めています。Sonnet 4.5にはeffortの設定自体が無いので、移行時に明示して指定します。
普段の処理を高めと中くらいのeffortで流し、出力の質・応答時間・トークン数を並べて比べると、どの段階に置くか決めやすくなります。
関連記事:Sonnet 5.5が使えない原因|Sonnet 5に戻る理由と直し方

まとめ
claude-sonnet-4-5-20250929は、Claude APIなどAnthropicが運営する経路で2026年11月30日に退役する予定で、移行先はclaude-sonnet-5-5です。Amazon BedrockとGoogle管理のGoogle Cloudは別の日程なので、各社の案内で確かめてください。
替えるときは、temperature系の指定・budget_tokens・プリフィルの3つを先に直し、替えた後はトークン数と費用、effortの段階を測り直します。まずはClaude ConsoleのUsageからCSVを出し、旧モデルを呼んでいるAPIキーを洗い出すところから始めてください。




