1. JustFit
  2. ブログ
  3. Claude API 3年ぶり新版、温度指定は送るとエラー

Claude API 3年ぶり新版、温度指定は送るとエラー

JustFit編集部（運営：株式会社LEGAREA）

2026年10月21日、AnthropicがClaude APIの新しい版「2026-10-21」を公開しました。この記事では、何が送れなくなったのか、旧版はどうなるのかを、公式のドキュメントで確かめた範囲で整理します。そのうえで、AIを事業の部品として使うときに、版の管理をどう考えるかを、私たち JustFit編集部の見方として書きます。

APIの版を示す日付が、約3年ぶりに変わった

Claude APIでは、リクエストごとに「anthropic-version」というヘッダー（通信の付加情報）を送ります。APIを呼び出すときは、このヘッダーの送信が必須で、例として2026-10-21が示されています。SDK（各言語向けの開発用ライブラリ）を使っている場合は、この指定が自動で処理されます。

今回、この版の値に新しいものが加わりました。公式のリリースノートには、2026年10月21日にAPI version 2026-10-21を公開したと記載されています。複数の報道では、2023年の版に続く、約3年ぶりの公式な版の更新と伝えられています。PANewsは、ClaudeDevsの発表をもとに、2023年以来最初の公式版だと報じています。

同じ日に、SDKも新しい主要版（メジャーバージョン）になりました。リリースノートによると、Python SDK 2.0.0、TypeScript SDK 1.0.0、C# SDK 13.0.0、Go SDK 2.0.0、Java SDK 3.0.0、PHP SDK 1.0.0、Ruby SDK 2.0.0、そしてant CLIが、2026-10-21を既定で送る版として公開されています。

提供先についても、公式の「Versions」ページに記載があります。Claude API、Claude Platform on AWS、Google Cloud上のClaude、Microsoft Foundryで使え、Amazon Bedrockでは Claude 4.7以降のモデルが対象です。

エラーになる指定と、置き換えの方針

temperature・top_p・top_k の3つが送れなくなった

temperature、top_p、top_kは、AIの回答にどのくらいばらつきを持たせるかを調整する数値です。「サンプリングパラメータ」と呼ばれます。数値を下げると回答が安定しやすく、上げると多様になりやすい、という使い方をしてきた開発チームも多いと思います。

公式の「Model deprecations」ページでは、これらの扱いが次のように整理されています。3つとも2026-10-21の版で削除され、送ると400エラーが返ります。推奨される代替は、パラメータを省き、プロンプトでモデルの振る舞いを導くことです。

注意したいのは、既定値と同じ値でも送れないことです。複数の解説記事が移行ガイドを引いて、既定値であってもエラーになると伝えています。「念のため1.0を入れている」というコードも、書き換えの対象になります。

モデルによって、影響の出方が違う

影響の大きさは、使っているモデルで変わります。公式のページには、旧版でも、Claude 4.7以降のモデルとClaude Mythos Previewでは、既定値以外を設定すると400エラーが返るとあります。そのため、これらのモデルでは、新版に移っても出力の挙動は変わらないと報じられています。

一方で、影響を受けやすいのは、既定値以外を受けつけるモデルを使っている場合です。移行ガイドを引いた解説では、Claude Sonnet 4.6のように別の値を受けつけるモデルで、安定のためにtemperatureを下げていた場合、その効果が失われ、代わりになる設定もないとされています。

会話の組み立てと、管理用APIにも変更がある

サンプリングの3指定以外にも、変更があります。公式の「Versions」ページには、アシスタントのメッセージにdocumentブロックを直接置くと、400エラーになると書かれています。報道によれば、ユーザー側のターンにcitations（引用情報）を入れた場合も同様にエラーです。

管理用のAPIも対象です。Admin APIとClaude Enterprise Analytics APIは、名前が変わったフィールドの旧名を返さなくなります。社内で利用状況や費用を集計している場合は、読み取り側の確認が必要になります。ほかにも、認証ヘッダーの扱いやSDKのライセンス表記の変更が解説記事で触れられていますが、詳細は公式の移行ガイドで確かめてください。

旧版は、そのまま動き続ける

今回の発表で、先に押さえておきたい点があります。Anthropicは、旧版の2023-06-01は非推奨にしておらず、今後はより頻繁に版を出すと述べたと報じられています。目的は、新しいモデルが必要とする非互換な変更に、開発側が事前に対応できるようにすることだと伝えられています。

公式の移行ガイドにも、切り替えの仕組みが書かれています。SDKを使う場合、リクエストが使うAPI版は、SDKのメジャーバージョンが公開された時点で最新だったものです。SDKを使わずに呼び出している場合は、anthropic-versionヘッダーを2026-10-21にします。つまり、版が切り替わるきっかけは、SDKのメジャー更新か、ヘッダーの書き換えです。

また、Amazon Bedrockで古いモデルを呼んでいる場合は、移行ガイドが別の手順を示しています。Opus 4.6以前のモデルを使う呼び出しは、今使っているSDK版や送っている版のままにしておくこと、2026-10-21に移すなら先にClaude 4.7以降のモデルへ切り替えることとされています。

なお、Claude Codeからの移行支援もあります。ClaudeDevsの投稿では、Claude Code内の/claude-apiスキルで更新するか、移行ガイドで一つずつ変更を確認する方法が案内されています。

私たちの見方：AIの「出力の揺れ」を、設定で抑える作りは見直したくなる

ここからは、公式の事実ではなく、JustFit編集部としての見方です。

見方1：同じ入力で、同じような答えを求める仕組みの設計

temperatureを下げる理由は、いくつかあります。回答の形式をそろえたい、テストで再現しやすくしたい、画面の表示を安定させたい、などです。新しい版では、こうした目的を数値の設定で支えられなくなります。

公式の推奨はプロンプトで導くことですが、これは出力の形式を決める、結果を検証する、といった作りの側で受け止める設計に寄っていく、という意味にもなります。たとえば、回答を決まった形式（JSONなど）で受け取り、形が崩れたときは再試行する、重要な判断は人が確認する、といった組み立てです。AIの出力を判断の部品として切り出す考え方は、Decisions API正式版の記事でも触れました。

新規事業では、AIが返す文章そのものが商品の価値になることがあります。その場合、「出力の揺れの許容範囲」は事業の品質基準でもあります。設定値に頼っていたなら、その基準を言葉にして、テストや確認の手順に移す作業が出てきます。

見方2：版を上げる時期は、事業の都合で決めてよい

旧版が継続されるので、急いで全面移行する必要があるとは限りません。一方で、Anthropicは今後、版をより頻繁に出す方針だと伝えられています。「今回は見送る」と決めても、次の版は来る、という前提で考えておくほうが現実的です。

見送る場合でも、新版に移すときに何が壊れるかを、事前に棚卸ししておくと後が楽になります。たとえば次のような点です。

  • コードの中で、temperatureなどを指定している箇所はどこか
  • 会話履歴を保存している場合、documentやcitationsの置き場所は新版のルールに合うか
  • SDKを更新したとき、版が自動で切り替わる箇所はどこか
  • 使っているモデルは、新版に対応しているか（Bedrockは条件つき）

SDKを使っていると、版を意識しないまま、ライブラリの更新で切り替わることがあります。更新の手順に、「API版が変わるかどうか」の確認を入れておくと安心です。

見方3：外部のAIは、事業の約束ごとに関わる「依存先」

自社のサービスがClaudeのようなAPIに依存している場合、その版の方針は、事業の前提条件の一部です。版が固定される期間、非互換な変更が告知されるタイミング、旧版が使える期間などは、保守の計画や運用コストに関わります。

AIで作ったコードの保守や引き継ぎについては、AI生成コードの保守は可能かでも整理しています。また、どのAIを組み込むかの考え方は、AIシステム開発でのAIの選び方が参考になります。モデルの性能や価格だけでなく、「版の変更にどう付き合うか」も、選ぶときの観点に加えられます。

この記事で確かめた範囲

この記事は、Anthropicの公式ドキュメント（リリースノート、Versions、移行ガイド、Model deprecations）と、ClaudeDevsの投稿を中心に確認しました。第三者の報道や解説記事は、公式の記載を補う範囲で使っています。

確認できなかった点もあります。

  • 旧版（2023-06-01）の利用を終える時期：確認できた範囲では、公式の記載は見当たりませんでした。
  • 次の版が出る時期や、変更の内容：今後出す頻度が高くなる、という報道までで、具体的な予定は確認できていません。
  • 各社のサービスへの影響の大きさ：使っているモデルや実装によって変わるため、一般論では判断できません。

実際の移行にあたっては、公式の移行ガイドで、自分たちのコードに関係する項目を確かめてください。

まとめ

Claude APIに、約3年ぶりの新しい版「2026-10-21」が加わりました。temperature・top_p・top_kは、既定値でも送るとエラーになります。旧版は引き続き使え、SDKのメジャー更新かヘッダーの書き換えで、新版に切り替わります。

AIを使う事業では、モデルだけでなく、APIの版も「外部の依存先」です。出力の安定を設定値に頼っていないか、版が切り替わるきっかけはどこか、を棚卸ししておくことが、今回のニュースから得られる整理の観点です。

JustFitは、新規事業のアイデアに対して、システムを軸に事業の形まで提案する受託開発サービスです。構想をもとに約1ヶ月で動くプロトタイプを先に作り、実物を見てから進めるかを判断できます。AIを組み込んだ事業の進め方を考えている段階でも、JustFitのサービス紹介から、お気軽にご相談ください。

参考にした情報

← ブログ一覧へ