Claude APIが3年ぶりに版を更新　temperatureは送れなくなる

米Anthropicは2026年10月21日、Claude APIの新しい版「2026-10-21」を公開した。リクエストに付ける版の指定はこれまで「2023-06-01」が最新で、約3年4か月ぶりの更新になる。新しい版では、出力のばらつきを決める「temperature」など3つの設定を送るとエラーが返る。各言語の新しいSDKはこの版を既定で使うので、Claude APIを直接呼ぶアプリを作っている人は、SDKを上げる前に自分のコードを確かめる必要がある。

3年ぶりに版が変わった

Claude APIでは、リクエストのヘッダー「anthropic-version」で版を指定する。Claude Platformのリリースノートによると、同社は新しい版に合わせて各言語のSDKとコマンドラインの道具「ant」の新版も出した。Python SDK 2.0.0、TypeScript SDK 1.0.0、Go SDK 2.0.0、Java SDK 3.0.0、C# SDK 13.0.0、PHP SDK 1.0.0、Ruby SDK 2.0.0、ant 2.0.0で、どれも2026-10-21を既定で送る。それより前のSDKは、すべてのリクエストに2023-06-01を付けていた。

APIの版の一覧を見ると、版は今回で3つ目だ。最初に公開された2023-01-01と、ストリーミングの形式を改めた2023-06-01に続く。同社は、同じ版の中では既存の入力と出力を保つと説明している。つまり、版を上げない限り今のコードは動き続け、壊れる変更は版を上げた時にまとめて来る。

temperatureが使えなくなる

読者に一番効くのは、temperature、top_p、top_kの3つの設定が消えたことだ。移行の手引きによると、新しい版ではこのどれかを送ると、既定の値であっても400エラーが返る。新しいSDKの型からも3つは消えた。

影響はモデルによって違う。Claude 4.7以降のように既定の値しか受け付けないモデルでは、設定を消しても出力は変わらない。ところが、Claude Sonnet 4.6のように値を変えられるモデルで、temperatureを下げて出力をそろえていた処理は、その効果を失う。手引きは代わりの設定は無いとし、既定以外の値に頼るリクエストは2023-06-01に残すよう勧めている。

ほかにも、assistantのメッセージに直接置いたdocumentブロックと、userのメッセージで引用の情報（citations）を持つtextブロックは400エラーになる。組織を管理するAdmin APIでは、roles、group_id、workspace_idなどの古い項目名が返らなくなり、新しい名前に替わった。

移行はClaude Codeに任せられる

提供先は、Claude APIのほか、Claude Platform on AWS、Microsoft Foundry、Google Cloudだ。Amazon Bedrockでは、Claude 4.7以降のモデルだけが新しい版を使える。手引きは、Opus 4.6以前のモデルをBedrockで呼んでいる処理は、先にモデルを替えるまで今のSDKか今の版のままにするよう求めている。

新しいSDKは、版と関係のない変更も含む。ライセンスがMITからApache 2.0に変わり、antではAPIキーをコマンドの引数で渡す指定が無くなった。依存するライブラリのライセンスを管理している会社は、記録を直す必要がある。

移行の手間を減らす道具も出た。Claude CodeのGitHubのリリースによると、10月22日の2.1.307で「/claude-api api-version」が加わり、手元のClaude APIのコードを2026-10-21に移せるようになった。要は、版の更新は3年ぶりの大きな区切りで、SDKを上げることがそのまま壊れる変更を受け入れることになる。

編集部の見方

Claude APIを直接呼ぶ処理を持つ読者は、SDKの自動更新の設定をまず確かめたい。メジャー版が上がった時点でtemperatureを送るコードは止まるので、依存の範囲を固定していないと、ある朝突然エラーが出る。移行はClaude Codeの新しいコマンドに任せられるが、temperatureを下げて結果をそろえていた処理は代わりが無い。その処理だけは2023-06-01に残すか、出力の揺れを前提に作り直すかを先に決めておきたい。