Claude API 2026-10-21、temperature・top_p・top_kを廃止

Anthropicは2026年10月21日、Claude APIの新しいバージョン2026-10-21を公開しました。このバージョンでは、サンプリング設定のtemperature、top_p、top_kが削除されます。これらのいずれかを送るリクエストは、400エラーで失敗するようになりました。7つの公式SDKとコマンドラインツールのantが、このバージョンを標準で使う新しいメジャーバージョンを公開しました。

これまでのバージョン2023-06-01は、3年以上にわたって標準でした。Munder Difflinによるエージェントツールの日刊まとめは、これをそれ以来初めてとなるAnthropicの新しいAPIバージョンだとしています。

Claude APIのバージョンの仕組み

Claude APIへのすべてのリクエストには、anthropic-versionヘッダーが付きます。その値は日付で、リクエストを1つの固定された動作に結び付けます。SDKを使わずに新しいバージョンを使うには、anthropic-version: 2026-10-21を送ります。

Anthropicのバージョンに関するページは、1つのバージョンの中では既存の入力フィールドと出力フィールドをそのまま保つと約束しています。それでもAnthropicは、任意の入力、新しい出力値、新しいストリーミングイベントの種類を追加できます。フィールドの削除や名前の変更には新しい日付のバージョンが必要で、今回起きたのがまさにそれです。

SDKはバージョンを自動で選びます。移行ガイドによると、リクエストは「SDKのメジャーバージョンがリリースされた時点で最新だったAPIバージョンを使う」とされています。古いメジャーバージョンのSDKで動くコードは、SDKをアップグレードするまで2023-06-01を送り続けます。

Messages APIで動かなくなるもの

Anthropicのリリースノートによると、3種類のリクエストが400エラーを返すようになりました。

• サンプリング設定。 temperature、top_p、top_kは削除されました。いずれかを送ると、どのモデルでも失敗します。
• assistantターン内のドキュメント。 assistantメッセージに直接置かれたdocumentブロックは拒否されます。
• userターン内の引用。 userメッセージ内で、空でないcitations配列を持つtextブロックは拒否されます。search_resultブロックの中に入れ子になったものも対象です。

Admin APIでも、いくつかのフィールド名が変わります。RBACグループはrolesの代わりにrole_idsを使い、ロールはnameの代わりにdisplay_nameを使います。APIキーでは、workspace_idがscope.workspace_idに移ります。Claude Enterprise Analyticsの2つのフィールドも変わります。actor.emailはactor.email_addressに、summariesはdataになります。

新しいバージョンは、Claude API、Claude Platform on AWS、Microsoft Foundry、Google Cloudで使えます。Amazon Bedrockでは、Claude 4.7以降のモデルだけが対象です。

SDKの新しいメジャーバージョン

リリースノートと移行ガイドによると、2026-10-21を送る最初のリリースは次のとおりです。

SDKまたはツール	2026-10-21を使う最初のバージョン
Python（anthropic）	2.0.0
TypeScript（@anthropic-ai/sdk）	1.0.0
C#（Anthropic）	13.0.0
Go（anthropic-sdk-go/v2）	2.0.0
Java（com.anthropic:anthropic-java）	3.0.0
PHP（anthropic-ai/sdk）	1.0.0
Ruby（anthropic gem）	2.0.0
ant CLI	2.0.0

SDKには、APIバージョンとは別に、SDK自体の互換性のない変更もあります。移行ガイドは主なものを次のように挙げています。

• Authorizationヘッダー。 SDKとCLIは、キーをX-Api-KeyではなくAuthorization: Bearerで送るようになりました。APIはどちらのヘッダーも受け付けますが、X-Api-Keyを読み取るプロキシやゲートウェイは変更が必要です。
• クライアントごとに認証情報は1つ。 APIキーと認証トークンの両方を渡すと、エラーになるようになりました。PythonではValueError、TypeScriptではTypeErrorが発生します。
• Text Completionsの削除。 古いcompletionsのインターフェースは、TypeScript、Go、Java、RubyのSDKとCLIからなくなりました。Messages APIを使ってください。
• Goのモジュールパス。 Goのコードは、すべてのimportをgithub.com/anthropics/anthropic-sdk-go/v2に変える必要があり、Go 1.25以降が必要です。
• PHPのアップグレードコマンド。 単にcomposer updateを実行しても、古いメジャーバージョンのままです。1.0.0に移るにはcomposer requireを使ってください。

ライセンスも変わります。これらのバージョンから、SDKとCLIのライセンスはMITではなくApache 2.0になります。以前のバージョンはMITのままで、ガイドによると、そのためのコード変更は必要ありません。

10月21日のその後、Python SDK 2.1.0とTypeScript SDK 1.1.0は、ユーザープロフィールに規約執行のステータスとアクションを追加しました。これは別の機能で、バージョン変更の一部ではありません。

開発者にとっての意味

SDKのメジャーバージョンをアップグレードするか、自分でヘッダーを変えるまでは、何も壊れません。時間の余裕はありますが、リリースノートには2023-06-01の提供終了日が書かれていません。終了日を待つのではなく、移行を計画してください。

• まずサンプリング設定を探す。 temperature、top_p、top_kを設定しているすべての呼び出しを、ラッパーや設定ファイルも含めて見つけてください。アップグレード後は、そのどれもが400エラーになります。
• APIとの間にあるものを確認する。 X-Api-Keyを読み取るロギング用のプロキシ、ゲートウェイ、シークレットスキャナーは、SDKがAuthorization: Bearerを送るようになるとキーを検出できなくなります。
• ロックファイルでメジャーバージョンを固定する。 anthropicや@anthropic-ai/sdkのバージョン範囲を固定していないと、次のインストールで新しいメジャーバージョンに上がることがあります。テストをしたうえで、意図してアップグレードしてください。
• 保存した会話を見直す。 保存したメッセージ履歴を再生する場合は、assistantターン内のドキュメントやuserターン内の引用がないか確認してください。
• ライセンスの担当者に伝える。 新しいメジャーバージョンはMITではなくApache 2.0です。アップグレードを出荷する前に、この変更を記録してください。