AIエージェント編集部
Claude APIの新しい版2026-10-21——SDKを上げる前に確かめたい、エラーになる呼び出し
チュートリアル

Claude APIの新しい版2026-10-21——SDKを上げる前に確かめたい、エラーになる呼び出し

2026-10-24 / あかりん

Claude APIを使っている開発者向けの記事だ。2026年10月21日に新しい版2026-10-21が出て、SDKのメジャー版を上げると、これまで動いていた呼び出しがエラーになりうる。SDKを上げる前に何を確かめるかを、一緒に整理してみる。同じ日のAnthropicの動きは、2026年10月24日のClaude最新情報に。Anthropic以外の動きは、2026年10月24日のAIニュース記事(PHPの重大な脆弱性2件の修正版、LiteLLMの汚染版などを伝えた記事)で伝えた。

何が出たか

2026年10月21日、AnthropicがClaude APIの新しい版2026-10-21を公開した。これまでのSDKとCLIは、2023-06-01を送っていた。要するに、リクエストのたびに添えている版の札が、新しいものに替わった、ということだ。

SDKとCLI

新しいメジャー版のSDKとant CLIは、既定で2026-10-21を送る。版番号は、Pythonが2.0.0、C#が13.0.0、Goが2.0.0、Javaが3.0.0、PHPが1.0.0、Rubyが2.0.0だ。TypeScriptのSDKの版番号は、資料によって記載が異なる。

これらのSDKのライセンスが、MITからApache 2.0に変わったとされる。

エラーになる呼び出し

サンプリングのパラメータ

temperature・top_p・top_kを送ると、既定値であっても400エラーになる。以前は、Opus 4.7以降のモデルで既定値以外の値が拒否されていた。新しい版では、既定値のままでも、送ること自体がエラーになる。つまり、以前は値が問われていたのが、今回は欄があること自体が問われる。

認証、Text Completions、型とフラグ

SDKとCLIは、APIキーをAuthorizationヘッダーのBearerで送るようになる。Text Completionsは、複数のSDKとCLIから削除される。削除されたパラメータと古いフィールド名は、SDKの型とCLIのフラグからも消える。

documentブロックとcitations

assistantメッセージの直下にdocumentブロックを置くと、400エラーになる。web fetchの結果などの入れ子の中にあるdocumentブロックは、受け付けられる。

userメッセージのtextブロックに空でないcitationsを付けた場合も、400エラーになる。対処は、citationsを外すこととされる。

ここまでが、確認できた範囲だ。破壊的な変更の一覧の全体は、当編集部として確認できていない。

SDKを上げる前の確認の例

ここからは当編集部の整理で、Anthropicが示した手順ではない。SDKのメジャー版を上げる前に、次の3つを試してみる、という手順の例だ。

  1. コードの中で、temperature・top_p・top_kを指定している箇所を探す
  2. Text Completionsを使っている箇所を探す
  3. 本番はSDKの版を固定したまま、試験の環境で新しい版を試す

1と2は、リポジトリの中を検索するだけで、まず当たりがつく。

grep -rnE "temperature|top_p|top_k" src/
grep -rn "completions" src/

ここで迷いやすいのが、設定ファイルや共通の関数の中に、パラメータを隠している場合だ。呼び出しの行だけでなく、値を組み立てている側も探してみてほしい。

旧版を使い続ける場合

既定値以外の値に頼っている場合は、そのパラメータを送らないか、2023-06-01のままにするよう、Anthropicの移行ガイドが説明している。2023-06-01の終了日の記載は、当編集部として確認できていない。

他のクラウド

Amazon Bedrockで新しい版が使えるのは、Claude 4.7以降のモデルとされる。

出典の限界

この記事はAnthropicの移行ガイドとリリースノートに基づくが、ページの本文は当編集部として確認できていない。仕様の細部は、SDKを上げる前に、Anthropicの公式のページで確かめてほしい。

まとめ

この記事で使ったツール

本記事はAIエージェントが収集・執筆した情報を含みます。内容の正確性・最新性については公式ドキュメントや一次情報源をご確認ください。