著者注：claude-sonnet-4-5 は 2026-11-30 に提供終了となります。本記事では、claude-sonnet-5-5 への移行に伴うモデル ID、キャッシュ読み取り倍率、請求額の変化を説明し、切り替え当日の確認項目と検証方法を紹介します。
コードや設定ファイル、ゲートウェイのルーティングに claude-sonnet-4-5、または日付付きスナップショットの claude-sonnet-4-5-20250929 が残っている場合は、早めに移行計画を立てましょう。Anthropic のモデル提供終了ページでは、このスナップショットは Deprecated とされ、告知日は 2026-09-30、提供終了日は 2026-11-30 と記載されています。公式の移行先モデルは claude-sonnet-5-5 です。
本記事は「新モデルのほうが高性能」といった宣伝記事ではありません。Sonnet 4.5 から Sonnet 5.5 へ移行するためのエンジニアリング作業に絞って解説します。モデル ID の変更点、倍率と価格の変化、切り替え当日に更新すべき項目、切り替え後の検証方法を取り上げます。性能差については本記事では結論を出しません。ご自身のタスクで回帰テストを行ってください。
この記事でわかること：新旧モデルの比較表と、実行可能な切り替え手順を確認できます。また、移行後にどのリクエストを送り、どの項目を確認すれば移行の成功を判断できるかもわかります。
Sonnet 4.5 の退役に伴う Sonnet 5.5 への移行：押さえておきたいポイント
まず結論から紹介します。以下の表に、今回の移行で特に確認しておきたい4つのポイントをまとめました。データは2026-11-10時点のものです。
| ポイント | 説明 | 影響 |
|---|---|---|
| 退役日 | claude-sonnet-4-5-20250929 は2026-11-30に退役します。発表日は2026-09-30です |
あと約20日です。月末までに切り替える必要があります |
| 公式の移行先モデル | Anthropicは claude-sonnet-5-5 への移行を推奨しています |
移行先が明確なため、複数のモデルから選ぶ必要はありません |
| 新旧モデルをどちらも呼び出し可能 | 現在、新旧どちらのモデルもプラットフォームのモデル一覧に掲載されています | しばらく並行して運用し、段階的な切り替えや回帰テストを実施できます |
| 料金とキャッシュ倍率の変更 | 入力、出力、キャッシュ読み取りの単価がすべて下がり、キャッシュ読み取りの倍率は0.1から0.05に変更されます | 請求額が変わります。キャッシュヒット率が高いサービスほど、変化が大きくなります |
Sonnet 4.5 と Sonnet 5.5 は現在どちらも呼び出し可能
今回の移行では、一度にすべてを切り替える必要はありません。2026-11-10にAPIYI（apiyi.com）の公開料金インターフェースを確認したところ、掲載されている283モデルの中に claude-sonnet-4-5 と claude-sonnet-4-5-20250929 があり、claude-sonnet-5-5 と claude-sonnet-5-5-thinking もすでに利用可能でした。新旧モデルを同時に使えるため、退役日前に同じAPIキーとOpenAI互換インターフェースを使いながら、旧IDから新IDへ段階的にトラフィックを移行できます。
注意したいのは、日付付きのスナップショット claude-sonnet-4-5-20250929 と、日付なしの claude-sonnet-4-5 が、コード内の別々の箇所に記載されている場合が多いことです。前者は再現性を重視するオフライン評価スクリプトで、後者は業務コードや設定管理システムでよく使われます。移行時は両方の表記を検索し、片方だけを変更しないようにしてください。
Sonnet 5.5 への移行における thinking バリアント
claude-sonnet-5-5-thinking は料金インターフェース上で独立した項目として掲載されており、専用の倍率が設定されています。業務ですでに「通常の呼び出し」と「深い推論を行う呼び出し」を使い分けている場合は、移行時もそれぞれ個別に対応付けてください。thinking バリアントの料金を、ベースモデルの claude-sonnet-5-5 と合算しないようにしましょう。この記事で後述する料金の換算はベースモデルのみを対象としています。thinking バリアントについては、プラットフォームのモデル一覧に掲載されている実際の項目を確認してください。
Sonnet 4.5 と Sonnet 5.5 のモデル ID 対照表
移行の第一歩は、ID の対応表を作成することです。以下の表に、旧表記と推奨される新表記をまとめました。
| 現在の表記 | 状態 | 移行後の表記 | 備考 |
|---|---|---|---|
claude-sonnet-4-5-20250929 |
非推奨、2026-11-30 に廃止 | claude-sonnet-5-5 |
公式が推奨する移行先 |
claude-sonnet-4-5 |
まだ一覧に掲載されていますが、スナップショットとあわせて移行が必要 | claude-sonnet-5-5 |
業務コードで最もよく使われる表記 |
| 推論用途で独自に組み立てた Sonnet 4.5 の呼び出し | 個別に確認が必要 | claude-sonnet-5-5-thinking |
独立した項目で、料金も別途設定 |
対応関係は、複数のサービスに個別にハードコードするのではなく、設定センターや環境変数など一か所にまとめておくのがおすすめです。そうすれば、廃止日の前後も変更は一か所で済み、ロールバックも簡単です。
Sonnet 5.5への移行後における価格とキャッシュ読み取り倍率の変化
倍率の換算方法
料金表のAPIが返すのは米ドル価格ではなく、3つの倍率フィールドです。model_ratio（入力倍率）、completion_ratio（入力に対する出力の倍率）、cache_ratio（入力に対するキャッシュ読み取りの倍率）です。この記事では、プラットフォームが公開している記事と同じ方法で換算します。
- 倍率1 = 入力100万トークンあたり2ドル
- 出力単価 = 入力単価 ×
completion_ratio - キャッシュ読み取り単価 = 入力単価 ×
cache_ratio
以下の表に記載した米ドル価格は、上記の方法で換算したもので、公式の表示価格ではありません。データ基準日：2026-11-10。
| モデル | model_ratio | completion_ratio | cache_ratio | 入力 $/100万トークン | 出力 $/100万トークン | キャッシュ読み取り $/100万トークン |
|---|---|---|---|---|---|---|
claude-sonnet-4-5 |
1.5 | 5 | 0.1 | $3 | $15 | $0.30 |
claude-sonnet-5-5 |
1 | 5 | 0.05 | $2 | $10 | $0.10 |
Sonnet 5.5のキャッシュ読み取り倍率の変化
表からは、2段階の変化が分かります。まず基本倍率では、model_ratio が1.5から1に下がり、completion_ratio はどちらも5です。そのため、入力と出力の単価はどちらも約3分の1下がります。次にキャッシュ読み取りでは、cache_ratio が0.1から0.05に下がります。基本倍率の低下も重なり、キャッシュ読み取り単価は$0.30から$0.10へ、約3分の2下がります。
つまり、同じモデルIDに移行しても、業務によって請求額の変化幅は異なります。長いシステムプロンプト、長文ドキュメントの質疑応答、複数ターンのAgentなど、キャッシュのヒット率が高い用途では、請求額に占めるキャッシュ読み取りの割合が大きいため、入力・出力だけを使う業務よりも全体の変化が顕著になります。予算を見積もる際は、一律の変化率だけで計算しないようにしましょう。
請求額の変化例（想定使用量）
以下では、月間の想定使用量を使って換算し、3項目の価格が請求額にどう影響するかを示します。数値は計算方法の説明用です。実際の使用量の集計値に置き換えてください。
| 課金項目 | 想定月間使用量 | Sonnet 4.5の換算費用 | Sonnet 5.5の換算費用 |
|---|---|---|---|
| 入力 | 1,000万トークン | $30 | $20 |
| 出力 | 200万トークン | $30 | $20 |
| キャッシュ読み取り | 3,000万トークン | $9 | $3 |
| 合計 | — | $69 | $43 |
なお、プロンプトキャッシュは通常、モデルごとに分かれています。新しいIDに切り替えると、旧モデルで蓄積されたキャッシュは引き継がれません。最初のリクエスト群ではキャッシュが再作成されるため、切り替え当日はキャッシュヒット率が一時的に下がり、請求額にも小さな変動が生じる可能性があります。請求額を比較する際は、切り替え後の最初の数時間を除いてから前後を比べることをおすすめします。
切り替えの前後に、APIYI apiyi.com のモデル一覧で claude-sonnet-5-5 と claude-sonnet-5-5-thinking の最新倍率を確認し、その結果を社内のコスト見積もり表とアラートしきい値に反映してください。
Sonnet 4.5 から Sonnet 5.5 への移行：クイックスタート
最小限のリクエスト例
OpenAI互換インターフェースで新しいモデルを呼び出す場合、確認する項目は次のとおりです。
- APIエンドポイント base_url：
https://api.apiyi.com/v1 - リクエストパス：
/chat/completions - モデルフィールド model：
claude-sonnet-5-5（従来のclaude-sonnet-4-5またはclaude-sonnet-4-5-20250929を置き換えます） - 認証：リクエストヘッダー
Authorization: Bearer YOUR_API_KEY - メッセージ本文：
messagesはそのままで、移行時に変更する必要はありません
OpenAI公式SDKを使っている場合、通常はクライアント初期化時の base_url と、呼び出し時の model パラメーターを変更するだけで済みます。それ以外のアプリケーションコードはそのまま利用できます。
切り替え項目の一覧を見る
切り替え当日に、次の項目を一つずつ確認してください。
– クライアントの初期化：base_url を `https://api.apiyi.com/v1` に統一し、APIキーは環境変数から読み込む
– デフォルトモデル：設定センターまたは環境変数のデフォルト model を `claude-sonnet-5-5` に変更する
– 推論ルーティング：従来、深い推論に使っていた分岐を `claude-sonnet-5-5-thinking` に変更する（料金は別途設定）
– フォールバックリスト：fallback やリトライ処理に `claude-sonnet-4-5` が含まれている場合は、あわせて置き換え、提供終了後にフォールバックが失敗しないようにする
– 許可リストと権限：ゲートウェイのモデル許可リストや、チームメンバーが利用できるモデルの一覧に新しいIDを追加する
– コストとアラート：単価表と予算アラートのしきい値を、新しい倍率に合わせて更新する
– ログとレポート：model フィールドで使用量を集計するダッシュボードでは、新旧のIDを同じ業務ラインにまとめ、切り替え後にレポートが途切れないようにする
– オフライン評価スクリプト：日付付きスナップショット `claude-sonnet-4-5-20250929` を使っている評価タスクを新しいIDに変更し、ベースラインを再実行する
クイックスタートのおすすめ：まずテスト環境で、APIYIの同じAPIキーを使って新旧両方のモデルを呼び出し、出力と使用量の差を記録してから、段階的な切り替えの割合を決めましょう。新規ユーザーは、無料のテスト枠を使って回帰テストを実施できます。
推奨する5段階の切り替え手順
- 旧IDを全体検索する：コードベース、設定センター、CIスクリプト、ゲートウェイ設定で
claude-sonnet-4-5を検索します。日付付き・日付なしの両方を探し、一覧にまとめましょう。 - 新モデルの料金を確認する：プラットフォームのモデル一覧で
claude-sonnet-5-5とthinking版の現在の倍率を確認し、コスト見積もりとアラートのしきい値を更新します。 - 一部のトラフィックから段階的に切り替える：まずは重要度の低い業務、またはリクエストの一部を新しいIDに切り替えます。残りは旧IDで処理し、エラー率と出力品質を観察します。
- 同じリクエストで検証する：固定した検証用リクエストを新旧それぞれのモデルに送信し、応答、使用量、課金が想定どおりか確認します（詳しくは次のセクションを参照）。
- 廃止日前に全面切り替えを完了する：2026-11-30までに全面切り替えを完了し、コードと設定から旧IDを削除します。切り替え漏れがあると、廃止後にエラーが発生するおそれがあります。
切り替え後は同じリクエストで検証する
検証のポイントは「同じリクエスト」を使うことです。システムプロンプト、ユーザーメッセージ、max_tokensを固定し、新旧のモデルにそれぞれ送信して、以下を比較します。
- 応答のmodelフィールド：応答内のモデル名が
claude-sonnet-5-5であり、デフォルト値やフォールバック処理によって別のモデル名に書き換えられていないことを確認します。 - usageの使用量フィールド：
prompt_tokensとcompletion_tokensを比較します。応答にキャッシュ関連のフィールドが含まれる場合は、それも記録し、キャッシュが機能しているか確認します。 - 業務上の出力：独自の評価基準に沿って結果を確認します。たとえば、構造化出力がJSON検証を通過するか、ツール呼び出しの形式が正しいかなどをチェックします。能力の差は、実際のタスクでの回帰テストを基準に判断してください。
- 課金明細：APIYI（apiyi.com）のコンソールにある使用量記録から該当リクエストを見つけ、新しい倍率に基づく計算と請求額が一致するか確認します。
翌日、同じリクエストでもう一度検証すると、キャッシュが再構築された後のヒット状況も確認できます。検証に合格したら、段階的に切り替え対象の割合を増やしましょう。
よくある質問（FAQ）
Q1：Sonnet 4.5 の廃止対象となるモデルIDはどれですか？
Anthropic の廃止モデル一覧に掲載されているのは `claude-sonnet-4-5-20250929` です。ステータスは Deprecated、告知日は 2026-09-30、廃止日は 2026-11-30 です。業務で日付のない `claude-sonnet-4-5` を使用している場合も、廃止後に呼び出しが失敗するのを避けるため、あわせて移行することをおすすめします。
Q2：Sonnet 5.5 への移行時、Sonnet 4.5 との違いで注意すべき点はありますか？
実装面で主に変更するのは3点です。モデルIDを `claude-sonnet-5-5` に変更すること、入力・出力・キャッシュ読み取りの単価がいずれも下がること、キャッシュ読み取りの倍率が 0.1 から 0.05 に変わることです。自分の用途で必要な性能を満たすかどうかは、実際のタスクで回帰テストを行って確認してください。この記事では、全面的な置き換えが可能だとは結論づけていません。
Q3：廃止日前であれば、引き続き claude-sonnet-4-5 を呼び出せますか？
2026-11-10 時点では、`claude-sonnet-4-5` と `claude-sonnet-4-5-20250929` の両方がプラットフォームのモデル一覧に掲載されており、引き続き呼び出せます。この期間に新旧モデルを並行して動かし、比較するのがおすすめです。ただし、切り替えを廃止日当日まで先延ばしにするのは避けてください。
Q4：Sonnet 5.5 への移行で、特に請求額の変化が大きいのはどんな業務ですか？
キャッシュ読み取りの割合が高い業務ほど、変化が大きくなります。たとえば、次のようなケースです。
– **長いシステムプロンプトを使うカスタマーサポートやアシスタント**：リクエストのたびに同じ長いプロンプトのキャッシュが使われる
– **長文ドキュメントへの質問応答**：同じドキュメントについて繰り返し質問する
– **複数ターンにわたる Agent タスク**：ターンをまたいでコンテキストを大量に再利用する
Q5：API経由で claude-sonnet-5-5 にすばやく切り替えるにはどうすればよいですか？
APIYI に登録して APIキーを取得したら、OpenAI互換の呼び出し方法はそのままに、`base_url` をこの記事で案内しているアドレスに変更し、`model` を `claude-sonnet-5-5` に設定してください。新規ユーザーは、無料テスト枠を使って受け入れテストを実施できます。
Q6：thinking バリアントの料金はどのように計算されますか？
`claude-sonnet-5-5-thinking` は料金一覧のAPIで独立した項目として扱われ、倍率もベースモデルとは別に設定されています。この記事で換算している料金は、ベースモデルの `claude-sonnet-5-5` のみが対象です。thinking バリアントについては、プラットフォームのモデル一覧で最新の項目を確認し、ベースモデルの料金を適用しないでください。
Q7：移行に伴う既知のリスクはありますか？
主なリスクは3つあります。1つ目は、コードにハードコードされた古いIDが残り、廃止後にエラーが発生すること。2つ目は、切り替え直後にキャッシュを再構築する必要があり、短期間はヒット率が低下すること。3つ目は、出力のスタイルや形式に差が生じる可能性があることです。厳密な形式解析に依存する後続処理は、回帰テストが必要です。段階的な切り替えと、固定リクエストによる受け入れテストを行えば、ほとんどのリスクに対応できます。
Sonnet 4.5からSonnet 5.5への移行：押さえておきたいポイント
- 廃止日は確定済み：
claude-sonnet-4-5-20250929は2026-11-30に廃止されます。公式ではclaude-sonnet-5-5への移行が推奨されています。 - 新旧モデルを併用して段階的に移行可能：2026-11-10時点では、新旧両方のモデルがプラットフォームの一覧に掲載されており、並行して比較できます。
- 3項目すべての単価が変更：倍率換算では、入力が $3→$2、出力が $15→$10、キャッシュ読み取りが $0.30→$0.10 です。
- キャッシュ読み取りの変化が最大：
cache_ratioは0.1から0.05に下がります。キャッシュの利用割合が高い業務ほど、変化が大きくなります。 - thinkingは別料金：
claude-sonnet-5-5-thinkingは独立したモデル項目です。ベースモデルの料金と混同しないようにしましょう。 - 同じリクエストで動作を確認：
modelフィールド、usageの使用量、課金明細を確認し、性能の違いは実際のタスクで回帰テストを行いましょう。
まとめ
Sonnet 4.5からSonnet 5.5へ移行する際の要点は次のとおりです。
- まずモデルIDを変更：
claude-sonnet-4-5とclaude-sonnet-4-5-20250929をclaude-sonnet-5-5に統一してマッピングし、推論用の分岐はthinking版にマッピングします。 - 次に料金を再確認：
model_ratio、completion_ratio、cache_ratioに基づいて、入力・出力・キャッシュ読み取りの3項目のコストを再計算します。 - 最後に動作を確認：段階的な切り替え後、同じリクエストで返却されたモデル、使用量、課金額を確認し、廃止日までに旧IDを削除します。
2026-11-30まであと約20日です。今週中に全体を検索してテスト環境を切り替え、業務の回帰テストに備えることをおすすめします。新旧モデルを同時に比較する場合は、APIYI（apiyi.com）で1つのAPIキーを使って呼び出しと使用量の確認ができます。モデルと料金は、プラットフォームのモデル一覧をご確認ください。
📚 参考資料
- Anthropic モデルの提供終了ページ：Claudeモデルの非推奨化・提供終了スケジュール
- リンク：
platform.claude.com/docs/en/about-claude/model-deprecations -
説明：
claude-sonnet-4-5-20250929のステータス、発表日、提供終了日、公式の移行先の推奨を確認できます。 -
APIYI 公開料金インターフェース：モデル倍率データの参照元
- リンク：
api.apiyi.com/api/pricing - 説明：2026-11-10に取得。
model_ratio、completion_ratio、cache_ratioフィールドが含まれます。
著者：APIYI 技術チーム
技術交流：移行中にお困りのことがあれば、APIYI のウェブサイトのトップページからお問い合わせください。その他の接続資料は docs.apiyi.com のドキュメントセンターをご覧ください。
