
Claude APIを「Sonnet 5.5」へ移行するときの5つの注意点|そのままでは動かなくなる設定と書き換え方(Sonnet 4.5は11月30日に提供終了)
ClaudeのAPIを使ってアプリや自動化を動かしている人に、確認しておきたいお知らせがあります。古いモデルの「Claude Sonnet 4.5」は、2026年11月30日に提供が終わる予定です。
移行先としてすすめられている「Claude Sonnet 5.5」は、これまでのコードの一部の設定が、そのままではエラーになります。この記事では、提供終了の日程、5つの変更点、書き換え方をまとめます。
内容は2026年10月23日に確認した、移行ガイドと報道にもとづきます。
■事実:提供終了の日程と移行先
・Claude Sonnet 4.5:2026年11月30日に提供終了(9月30日に告知)
・移行先:Claude Sonnet 5.5(9月28日公開)
・料金:Sonnet 5.5は入力100万トークンあたり2ドル、出力10ドル(Sonnet 4.5は3ドル・15ドル)
・Sonnet 5.5の提供終了は「2027年9月28日より前ではない」とされている
ほかのモデルの提供終了の日程は、Anthropicの公式の一覧で確認するのが確実です。
■そのままではエラーになる5つの設定
ツールの強制呼び出し
tool_choiceに「any」や「tool」を指定すると、エラー(400)になります。
→「auto」と「strict: true」を使い、ツールを使ってほしい場面を指示文で伝える考える処理(thinking)の完全オフ
thinkingを「disabled」にするとエラーになります。
→「between_tools」を使い、effort(考える量)はlow・medium・highのどれかに考える量の上限の指定
thinkingで「budget_tokens」を指定するとエラーになります。
→ output_configのeffortで、考える量を指定するtemperatureなどの調整
temperature、top_p、top_kを初期値以外にするとエラーになります。
→ これらの指定を外す回答の書き出しを先に入れる(prefill)
会話の最後をアシスタントの書き出しで終えるとエラーになります。
→ 会話は利用者のメッセージで終える。出力の形は構造化出力や、システムの指示で伝える
■もう1つの注意:考えた内容の引き継ぎ
考える処理の結果(thinkingのブロック)は、それを作ったモデル・アカウント・会話にひも付いています。別のモデルに切り替えたとき、読めないブロックは、初期設定では何も言われずに捨てられます。会話の履歴を別のモデルで使い回している人は注意が必要です。
■書き換えの手順
コードの中のモデル名を検索して、どこでSonnet 4.5を使っているかを一覧にする
上の5つの設定が入っていないかを検索する(tool_choice、thinking、budget_tokens、temperature、prefill)
1つずつ書き換えて、テスト用の環境で動かす
出力の形や長さが変わっていないかを確認する
問題がなければ、本番のモデル名を切り替える
Claude Codeを使っている人は、「このプロジェクトのClaude APIの呼び出しを、Sonnet 5.5の変更点に合わせて洗い出して」と頼むと、確認の手間を減らせます。
■まとめ
・Claude Sonnet 4.5は2026年11月30日に提供終了。移行先はSonnet 5.5
・Sonnet 5.5は料金が下がった(入力2ドル・出力10ドル)
・tool_choiceのany・tool、thinkingのdisabled、budget_tokens、temperatureなど、prefillはエラーになる
・考えた内容のブロックは、別のモデルに引き継げない
・テスト用の環境で1つずつ書き換えてから、本番を切り替える
提供終了の日が近づいてから慌てないように、まずは今日、自分のコードの中のモデル名を検索するところから始めてみてください。
※情報は10月23日時点のものです。料金や機能は変わることがあるため、最新の情報は公式サイトでご確認ください。
■Xでも発信しています
AIの料金や新機能の変更は、Xで先に短くまとめています。フォローしておくと見逃しにくくなります。
X:@ai_erabikata https://x.com/ai_erabikata
この記事が役に立ったら、スキとフォローをしてもらえると励みになります。