
Claude APIの新版2026-10-21とは?移行を整理
Claude API に、2026年10月21日付で新しい API バージョン 2026-10-21 が出ました。同じ日に公式 SDK と ant CLI もメジャー版が上がり、新しい版はこのバージョンを既定で送ります。
API を自分のコードから呼んでいる人ほど影響があります。公式の移行ガイドを読んで、「何が壊れるのか」「誰が対象か」を整理しました。
結論:何が変わり、誰が影響を受ける?
先に結論を表にまとめます。
`temperature`・`top_p`・`top_k` の廃止:影響を受ける人 3つのどれかを送っている人 / やること 送るのをやめる(送ると400エラー)
assistant メッセージ内の `document` ブロック:影響を受ける人 assistant 側に文書を直接入れている人 / やること 文書は user メッセージで送る
user メッセージの `citations`:影響を受ける人 user 側の text に引用情報を付けている人 / やること `citations` を外す
Admin API・Analytics API の旧フィールド名:影響を受ける人 管理系 API の応答を読んでいる人 / やること 新しい名前に読み替える
SDK の型の作り直し・キーの送り方:影響を受ける人 SDK をメジャー更新する人 / やること 移行ガイドに沿ってコードを直す
ライセンス:影響を受ける人 依存ライブラリのライセンスを管理している人 / やること MIT から Apache 2.0 に記録を更新
一番影響が広そうなのは、サンプリング用の3つのパラメータが無くなる点だと思います。既定値と同じ値を送っていても400エラーになる、と明記されています。
API バージョン 2026-10-21 とは?いつから?
Claude API では、リクエストに anthropic-version ヘッダーを付けて、どの版の仕様で動かすかを選びます。SDK を使っていれば、SDK が自動で付けてくれます。
公式のバージョン一覧を見ると、これまでの最新は 2023-06-01 でした。今回の 2026-10-21 はそれ以来の新版で、日付の差は1,238日、約3年4か月ぶりです(日数は自分で数えたもの)。
公開はリリースノートの2026年10月21日の項です。使える場所は、Claude API、Claude Platform on AWS、Microsoft Foundry、Google Cloud です。Amazon Bedrock では、Claude 4.7 以降のモデルに限られます。
古い 2023-06-01 の終了日は、バージョン一覧にも移行ガイドにも書かれていませんでした。移行ガイドには、既定以外の temperature に頼るリクエストは 2023-06-01 のままにする、という選択肢も書かれています。すぐに使えなくなるわけではない、と読めます。
自分の環境では何を上げればいい?
SDK は、そのメジャー版が出たときの API バージョンを送ります。新バージョンを使うには、次の版以上に上げます。
Python(`anthropic`):`2026-10-21` を送る最初の版 2.0.0
TypeScript(`@anthropic-ai/sdk`):`2026-10-21` を送る最初の版 1.0.0
C#(`Anthropic`):`2026-10-21` を送る最初の版 13.0.0
Go:`2026-10-21` を送る最初の版 2.0.0
Java(`anthropic-java`):`2026-10-21` を送る最初の版 3.0.0
PHP:`2026-10-21` を送る最初の版 1.0.0
Ruby(`anthropic`):`2026-10-21` を送る最初の版 2.0.0
`ant` CLI:`2026-10-21` を送る最初の版 2.0.0
SDK を使わずに HTTP で直接呼んでいる場合は、anthropic-version ヘッダーを 2026-10-21 に書き換えます。
Go は、メジャー版が変わると import のパスが /v2 付きに変わります。CLI を go install で入れている人は、古いパスのままだと v1 の最新版が警告なしで入る、と書かれています。ここは気づきにくいと思いました。
temperature が使えなくなると何が起きる?
2026-10-21 では、temperature・top_p・top_k を送るとエラーになります。新しい SDK と CLI からは、この3つのパラメータ自体が消えています。
送らなければ既定値で動き、temperature は1.0です。これは 2023-06-01 で3つを省いたときと同じ動きです。
影響はモデルによって違います。
Claude 4.7 以降のモデル:もともと既定値しか受け付けないので、出力の傾向は変わらない
Claude Sonnet 4.6 など、他の値を受け付けるモデル:temperature を下げて出力をそろえていた場合、その効果が無くなる
公式は、代わりになる設定はないと書いています。既定以外の値に頼る処理は、パラメータを外すか、その処理だけ 2023-06-01 に残すかの二択です。
SDK を上げるときに気をつける点は?
API の変更とは別に、SDK と CLI のメジャー版そのものにも壊れる変更があります。主なものをチェックリストにしました。
API キーの送り方:X-Api-Key ではなく Authorization: Bearer で送るようになる。API はどちらも受け付けるので直接呼ぶなら変更不要。X-Api-Key を読むプロキシやゲートウェイは直す
認証情報は1つだけ:Python では、API キーとトークンなどを2つ以上渡すと ValueError になる
MessageParam の型:user・assistant・system の役割ごとの型に分かれた。辞書で書いている Python のコードは基本そのまま
Text Completions の削除:TypeScript・Go・Java・Ruby の SDK と CLI から消えた。Messages API へ移す
ライセンス:新しい版から Apache 2.0。以前の版は MIT のまま
TypeScript では、Bedrock・Vertex などの周辺パッケージも同時に 1.0 系へ上げる必要があります。そろえないと、古い本体 SDK がもう1つ入ってしまうと書かれています。
影響の試算:どれくらいの作業になる?
前提:Python SDK を使い、API を呼ぶ箇所が10か所ある社内ツールを想定します。そのうち3か所で temperature を指定し、ゲートウェイは通していないものとします。数字はすべて仮定です。
SDK を 2.0.0 に上げる:対象 依存の定義 / 件数(仮定) 1か所
`temperature` を外す:対象 指定している呼び出し / 件数(仮定) 3か所
出力のぶれを確認する:対象 外した呼び出し / 件数(仮定) 3か所
ゲートウェイの修正:対象 通していないので対象外 / 件数(仮定) 0か所
この想定だと、コードの修正よりも「temperature を外したあと、出力が許容範囲か」を確かめる作業が中心になると思います。使っているモデルが Claude 4.7 以降なら、もともと既定値で動いているので、この確認はほぼ要らない計算です。
代わりの選択肢は?
移行するかどうかは、今のところ選べます。事実だけ並べると次の通りです。
`temperature` などの指定:`2023-06-01` のまま 使える / `2026-10-21` に移る 送ると400エラー
SDK:`2023-06-01` のまま 旧メジャー版のまま / `2026-10-21` に移る 新メジャー版が必要
ライセンス:`2023-06-01` のまま MIT(旧版) / `2026-10-21` に移る Apache 2.0(新版)
Bedrock の古いモデル:`2023-06-01` のまま 使える / `2026-10-21` に移る Claude 4.7 以降のみ
公式の推奨:`2023-06-01` のまま ― / `2026-10-21` に移る 可能なら最新版を推奨
Bedrock で Claude 4.7 より前のモデルを呼んでいる場合は、まずモデルを上げないと新バージョンに移れません。
個人的な考察
調べて意外だったのは、temperature が「非推奨」ではなく、いきなり「送るとエラー」になった点です。既定値の1.0をわざわざ書いているだけのコードでも止まるので、影響を受ける人は思ったより多いのではないかと思います。
一方で、旧バージョンの終了日が示されていないので、急いで全部を移す必要はなさそうです。自分なら、まず Claude 4.7 以降のモデルを使っている処理から移し、temperature に頼る処理は最後に回します。
API キーのヘッダーが変わる件は、社内のゲートウェイやログの仕組みを持つ会社ほど影響が出そうです。キーを X-Api-Key で見分けている仕組みがあるなら、SDK を上げる前に確認しておく方が安全だと考えます。
出典
Claude Platform「Release notes」(2026年10月21日の項)
Claude Platform「Migrating to API version 2026-10-21」
Claude Platform「Versions」
更新履歴
2026年10月22日:公開
本記事はAIを活用し、一次資料をもとに作成しています。最新情報は公式でご確認ください。