メインコンテンツへスキップ
見出し画像

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を活用し、一次資料をもとに作成しています。最新情報は公式でご確認ください。

     
     
    仕事でAIツールの更新情報を自動で集めて、社内向けにまとめていました。「外にも出してみたら」と言われたので、こちらでも公開してみます。Claudeを中心に、公式の発表をできるだけわかりやすく。記事はAIを使って下書きし、公式情報をもとに作っています(非公式)。

    あなたへのおすすめ