
Claude API 2026-10-21版:temperature等は400エラーに
※この記事は、公開情報(出典は末尾)と、俺の感想です。AIの補助で書いています。
Anthropicの公式ドキュメントに、2026年10月21日付の新しいAPIバージョン「2026-10-21」が載っていました。リリースノートでは、SDKも同日に新しい版が出ています。
俺はコードを書けませんが、Claude Codeでアプリを作っています。APIを直接触る人向けの話が中心ですが、「何が変わったか」を、書かれている範囲で整理します。
先に大事なこと
公式の移行ガイドは、旧バージョン 「2023-06-01」 から 「2026-10-21」 への移行を説明するものです。SDKを使っている場合は、そのメジャー版が出た時点のAPIバージョンで動く、と書かれています。つまり、SDKを新しい版に上げたときに、挙動が変わる可能性があります。
Messages APIで変わること
バージョン履歴のページに、次の3点が書かれていました。
assistantメッセージの中に、documentブロックを直接置くと、400エラーになる。
userメッセージの中の、textブロック(またはsearch_resultブロックの中)に、中身のあるcitationsを付けると、400エラーになる。
「temperature」「top_p」「top_k」が削除された。どれか1つでも送ると、全モデルで400エラーになる。
移行ガイドには、これらを送らない場合は、既定の値(temperatureは1.0)で動く、とあります。Claude 4.7以降のモデルは、もともと既定値しか受け付けないので、動きは変わらないそうです。一方、Claude Sonnet 4.6のように、ほかの値を受け付けるモデルでは、temperatureを下げて出力を安定させていた効果がなくなる、と書かれています。
どうしても非既定の値に頼る場合は、そのリクエストだけ 「2023-06-01」 のままにする、という案内もありました。
SDKとCLIの新しい版
リリースノート(10月21日)に、新しいSDKとCLIが、この新バージョンを既定で送ると書かれていました。
Python 2.0.0
TypeScript 1.0.0
C# 13.0.0
Go 2.0.0
Java 3.0.0
PHP 1.0.0
Ruby 2.0.0
antCLI 2.0.0
どれも、互換性を壊す変更を含む、と書かれています。ライセンスも、MITからApache 2.0に変わります。移行ガイドによると、以前の版はMITのままで、ライセンスの管理をしている人は、依存関係の記録を更新する必要があります。コードの修正は要らない、とあります。
antCLIでは、「--api-key」と「--auth-token」のフラグが削除されました。コマンドラインに書いた値は、シェルの履歴やプロセス一覧から見えるため、という理由が書かれています。
管理用API(Admin API)の名前の変更
組織の管理用APIでも、項目の名前が変わっています。
RBACグループの 「roles」 は、「role_ids」 を使う。
RBACグループのメンバーの 「group_id」 は、「rbac_group_id」 を使う。
RBACロールの 「name」 は、「display_name」 を使う。
レート制限の 「group_type」 は、「group.type」 を使う。
APIキーの 「workspace_id」 は、「scope.workspace_id」 を使う。
確認できなかったこと
旧バージョン 「2023-06-01」 がいつまで使えるかは、俺が読んだ範囲では書かれていませんでした。
Claude Code本体に、この変更がどう関わるかは、書かれていませんでした。
移行ガイドは長く、SDK別の細かい変更点は、すべては読んでいません。
俺が気になった点
「これまで動いていたコードが、ある日400エラーになる」ことが、いちばん困る点だと思いました。今回は、バージョンを上げたときに初めて起きる形で、SDKを上げるタイミングが分かれ目になりそうです。これは俺の読み方です。
コードを書けない俺は、AIに書いてもらったコードの中に「temperature」が入っていないか、自分では見つけられません。AIに「このプロジェクトでtemperature、top_p、top_kを使っている箇所はあるか」と聞くのは、できそうな確認だと思いました。
今日からできること
Anthropicの移行ガイド(出典のリンク)を、一度、原文で読む。
APIを使うアプリを作っている人は、SDKを上げる前に、「temperature」「top_p」「top_k」を使っている箇所を探す。
上げる前に、今のバージョンをメモしておく。
新しい版に上げるかどうかは、自分のアプリに影響があるかを見てから決めればよさそうです。
出典
Anthropic「Versions」(API) https://platform.claude.com/docs/en/api/versioning
Anthropic「Migrating to API version 2026-10-21」 https://platform.claude.com/docs/en/api/migration-2026-10-21
Anthropic「Claude Platform release notes」(2026年10月21日の項) https://platform.claude.com/docs/en/release-notes/overview
(おわり)
俺の体験は、こちらに書いています。
https://note.com/takaden1981/n/n079c1a8bb591
続きは、フォローすると通知で届きます。
#ClaudeAPI #Claude #Anthropic #API #SDK #生成AI #非エンジニア #アプリ開発 #個人開発