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稼働状況ページを見る

結論|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を書き換えておく必要があります。

図解:結論|Claude APIでは11月30日に退役し、移行先はSonnet 5.5

自分が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だけでなく、日付なしの別名で書いている箇所も一緒に洗い出せます。

図解:自分が11月30日の対象か見分ける

替えると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キーを洗い出すところから始めてください。

メルマガ登録CTA B2(MCPカオスマップ無料プレゼント)