Claude API バージョン 2026-10-21 への移行【2026年10月】— SDK メジャー更新で止まる4か所と社内の進め方

Claude API を自社のシステムに組み込んでいる開発チームにとって、2026年10月21日の API バージョン 2026-10-21 の公開は「SDK をアップデートしたら動かなくなった」が起きやすい変更です。Python・TypeScript・C#・Go・Java・PHP・Ruby の 7言語の SDK と ant CLI が同日にメジャー版へ上がり、既定で送る API バージョンが切り替わりました。

この記事では、Anthropic の移行ガイド・リリースノート・バージョン一覧を一次出典に、2026-10-21 で 400 エラーになる要求、SDK のメジャー版で変わる認証ヘッダーと資格情報の扱い、Admin API の項目名変更、Amazon Bedrock 経由の例外を整理します。読み終えると、自社のどのコードを棚卸しし、どの順番で本番を切り替えるかが決められます。

1. 旧バージョンは止まらない。 anthropic-version: 2023-06-01 を送る既存コードと旧メジャー版の SDK は動き続けます。Anthropic はバージョンごとに既存の入力・出力パラメータを維持すると明記しており、2026年10月時点で 2023-06-01 の提供終了日は示されていません。
2. SDK のメジャー版更新が API バージョンの切替を兼ねる。 Python 2.0.0・TypeScript 1.0.0・C# 13.0.0・Go 2.0.0・Java 3.0.0・PHP 1.0.0・Ruby 2.0.0・ant CLI 2.0.0 から、既定で 2026-10-21 を送ります。依存関係の自動更新で意図せず上がらないよう、上限を固定してから計画的に移します。
3. Messages API で 400 エラーになる要求は3種類。 temperature・top_p・top_k を送る要求（既定値でも）、assistant メッセージに直接置いた document ブロック、user メッセージの text ブロックに付けた citations です。
4. 認証の送り方が変わる。 新しい SDK と CLI は API キーを X-Api-Key ではなく Authorization: Bearer で送り、1つのクライアントが持てる資格情報は1つになります。社内ゲートウェイやプロキシで X-Api-Key を読んでいる構成は先に直します。
5. Admin API・Analytics API を読むコードは項目名を直す。 roles → role_ids、workspace_id → scope.workspace_id、actor.email → actor.email_address など、旧名が応答から消えます。利用状況の集計や鍵の棚卸しスクリプトが対象です。

2026年10月21日の Anthropic のリリースノートには、API バージョン 2026-10-21 の公開と、それを既定で送る SDK・CLI の新メジャー版、そして API バージョンに依存しない SDK 側の破壊的変更とライセンスの変更（MIT から Apache 2.0 へ）が並んでいます。

※ 出典: Release notes — Claude Platform（取得 2026-10）

※ 出典: Migrating to API version 2026-10-21 ／ SDKs, CLI, and libraries（取得 2026-10）

SDK の仕組みとして押さえるべき点は、SDK のメジャー版ごとに送る API バージョンが1つ決まっていることです。SDK の概要ページには「各メジャー版は1つの API バージョンを既定で送り、新しい API バージョンごとに新しいメジャー版が出る」と書かれています。したがって、API バージョンを変えないまま SDK だけ最新にする、という選択はありません。逆に言えば、旧メジャー版に留まる限り API バージョンも 2023-06-01 のままです。

API バージョンの一覧ページでは、Anthropic が各バージョンで「既存の入力パラメータ」「既存の出力パラメータ」を維持すると明記しています。追加される可能性があるのは、任意の入力・出力の値・エラー条件の変更・列挙値の追加です。2026-10-21 は Claude API に加えて、Claude Platform on AWS、Google Cloud（Anthropic managed・Google managed）、Microsoft Foundry で使えます。

※ 出典: Versions — Claude Platform（取得 2026-10）

移行ガイドの「Breaking changes」で Messages API に関わるのは次の3点です。トークン数カウントと、2026-10-21 で作成した Message Batch 内の各要求にも同じ規則が適用されます。

※ 出典: Migrating to API version 2026-10-21 — Breaking changes（取得 2026-10）

3つの引数を外した要求は、既定値（temperature は 1.0）でサンプリングされます。これは 2023-06-01 で引数を省略した要求と同じ挙動です。Claude 4.7 以降のモデルはもともと既定値しか受け付けないため、現行の Claude Fable 5.1・Opus 5.5・Sonnet 5.5・Haiku 5.5 を使う処理では、引数を外しても出力は変わりません。

挙動が変わるのは、Claude Sonnet 4.6 のように他の値を受け付けていたモデルで temperature を下げていた処理です。移行ガイドは「下げていた効果は失われ、代わりの設定は無い」と明記し、選択肢として「引数を送るのをやめる」か「その要求だけ 2023-06-01 に残す」の2つを挙げています。分類や抽出で出力のばらつきを抑えるために temperature: 0 を使っていた処理は、プロンプト側で出力形式を固定する、評価データで再測定する、その要求だけ旧バージョンに残す、のいずれかが必要です。

※ 出典: Migrating to API version 2026-10-21 — Sampling parameters are removed（取得 2026-10）

Messages API の変更より影響範囲が広いのが、SDK と CLI の認証の扱いです。これらは API バージョンに依存しない SDK 側の変更なので、anthropic-version を自分で指定していても、SDK を上げた時点で適用されます。

新しい SDK と CLI は、API キーを X-Api-Key ヘッダーではなく Authorization: Bearer <key> で送ります。Claude API に直接つないでいるなら何も起きませんが、次の構成では先に手当てが必要です。

• 社内のプロキシ・API ゲートウェイが X-Api-Key を読んで認証や部門別の集計をしている → ゲートウェイを Authorization から読むように直す。または SDK 側で X-Api-Key を自分で付け、Authorization を外す（Python は HTTP クライアントの auth 関数、TypeScript は defaultHeaders で Authorization: null、Go は option.WithHeaderDel("Authorization") など、言語ごとの手順が移行ガイドにあります）
• ゲートウェイ用のトークンと Claude API 用のキーを両方送っていた → 後述の「1クライアント1資格情報」の規則で初期化時にエラーになる。トークンを auth_token 相当で渡し、X-Api-Key を既定ヘッダーで付け、ゲートウェイ側で Authorization を外してから転送する設計に変える
• ant CLI でゲートウェイを指す → CLI には任意のヘッダーを足す手段が無いため、ゲートウェイ側を Authorization 対応にするしかない
• 自社のミドルウェアやログが X-Api-Key を読んでいる → Authorization を読むように直す

Microsoft Foundry 向けのクライアントは従来どおり x-api-key を送り、Bedrock Mantle 向けのクライアントは以前から Bearer トークンを送っていたので、これらは対象外です。

※ 出典: Migrating to API version 2026-10-21 — API keys are sent as Authorization: Bearer（取得 2026-10）

API キーと認証トークンが同じヘッダーを使うようになったため、SDK のクライアントは資格情報を1つしか持てません。言語ごとにエラーの種類は違いますが、規則は共通です。

※ 出典: Migrating to API version 2026-10-21 — A client holds one credential（取得 2026-10）

実務で起きやすいのは、CI や本番サーバーの環境変数に ANTHROPIC_API_KEY と ANTHROPIC_AUTH_TOKEN の両方が残っているケースです。エラーにはなりませんが、意図した方が使われているかを警告ログで確認してください。

CLI の 2.0.0 では、API キーや認証トークンをコマンドラインの値で渡すフラグが無くなりました。シェルの履歴やプロセス一覧に値が残るためで、v1.27.0 から非推奨の警告が出ていたものです。残っているコマンドは flag provided but not defined で止まります。代わりに ANTHROPIC_API_KEY などの環境変数、--api-key-stdin／--auth-token-stdin による標準入力、ant auth login を使います。シークレットマネージャーから値をパイプで渡す形にすると、履歴に残さずに済みます。

利用状況の集計や API キーの棚卸しを Admin API・Claude Enterprise Analytics API で自動化している会社は、応答の項目名の変更を確認します。2026-10-21 では旧名が応答から消えます。

※ 出典: Migrating to API version 2026-10-21 — Admin API and Claude Enterprise Analytics API（取得 2026-10）

とくに注意が要るのは API キーの workspace_id です。旧バージョンでは、Default Workspace に紐づく鍵も、全ワークスペースで使える鍵も、どちらも null でした。2026-10-21 では scope.workspace_id に Default Workspace を含む実際の ID が入り、全ワークスペースの鍵は scope が {"type": "organization"} になります。「workspace_id が null なら Default Workspace」と判定していたスクリプトは、List Workspaces を include_default=true で呼んで Default の ID を取り、scope.workspace_id と比較する形に直します。

なお、レート制限一覧の group_type クエリパラメータと、API キー一覧の workspace_id フィルタは変わっていません。変わったのは応答側だけです。

移行ガイドには、API バージョンに依存しない SDK・CLI の変更がまとまっています。社内のコードで該当しそうなものを拾います。

• MessageParam がロールごとの型の和になった（全言語）。{"role": "user", "content": "..."} のように辞書・オブジェクトで書いたメッセージは変更不要です。型名を直接呼び出す、継承する、ロールを変数で持つコードは言語ごとの直し方が必要です
• 値が1つだけの列挙型が定数になった（C#・Go・Java・PHP・Ruby）。主に Managed Agents 関連のクラスの type が対象で、構築時に Type を書かず、読むときは文字列で比較します
• クライアント側のコンパクションがツールランナーから消えた（TypeScript・Ruby）。compactionControl／compaction_control は、compact-2026-01-12 ベータの context_management によるサーバー側コンパクションに置き換えます。トリガーのしきい値は 50,000 トークン以上です
• Text Completions API が SDK・CLI から消えた（TypeScript・Go・Java・Ruby・CLI）。残っていれば Messages API に書き換えます
• ベータ以外の Models メソッドから betas が消えた。ベータヘッダー付きでモデル一覧を取るなら client.beta.models 側を呼びます
• Go は 1.25 以上が必要。モジュールパスは github.com/anthropics/anthropic-sdk-go/v2 に変わり、import を全て書き換えます。ant CLI も go install のパスに /v2 が付き、旧パスは警告なしに v1 の最新を入れ続けます
• Java はいくつかの getter が Optional を返すようになり、HttpRequest を自分で組む場合はベース URL が必須になりました。インターセプターが anthropic-version を上書きするなら putHeader ではなく replaceHeaders を使います
• ライセンスが Apache 2.0 に変わった。コードの変更は不要ですが、依存ライブラリのライセンス台帳を持つ会社は項目を更新します。旧版は MIT のままです

※ 出典: Migrating to API version 2026-10-21 — SDK and CLI changes（取得 2026-10）

Amazon Bedrock では、2026-10-21 は Claude 4.7 以降のモデルでしか使えません。Opus 4.6 以前のモデルを Bedrock で呼んでいる場合は、今の SDK バージョンに留まるか、API バージョンを自分で指定しているなら今の値を送り続けます。それらの呼び出しを 2026-10-21 に移すには、先に Claude 4.7 以降のモデルへ切り替える必要があります。

一方、Claude Platform on AWS、Google Cloud の Anthropic managed・Google managed、Microsoft Foundry では、モデルの制限なく 2026-10-21 が使えます。TypeScript の Bedrock・Vertex・Foundry・AWS・Google Cloud 用パッケージは、本体 SDK の v1 と組み合わせる必要があるため、同じ更新で一緒に上げます。別々に上げると、パッケージマネージャーが古い本体 SDK をもう1つ入れてしまいます。

※ 出典: Migrating to API version 2026-10-21 — Upgrade steps（取得 2026-10）

現行モデルの一覧は Anthropic のモデル概要ページで確認できます。2026年10月時点の現行は Claude Fable 5.1・Opus 5.5・Sonnet 5.5・Haiku 5.5 の4モデルで、いずれも Claude 4.7 以降に当たり、サンプリング引数は既定値のみです。Opus 4.6 や Sonnet 4.6 は「利用可能なレガシーモデル」として残っています。

※ 出典: Models overview — Claude Platform（取得 2026-10）

移行ガイドの「Upgrade steps」は、①SDK・CLI を新メジャー版に上げる（または anthropic-version を 2026-10-21 にする）、②破壊的変更に合わせてコードを直す、③2026-10-21 で試験してから公開する、の順で、①と②を同じリリースに入れるよう案内しています。社内で進めるときは、その前に棚卸しの段階を置くと手戻りが減ります。

1. 依存関係の上限を固定する。 まず全リポジトリで SDK のメジャー版を今の版に固定し、自動更新で意図せず上がるのを止めます。PHP は composer update だけでは制約内に留まるため、composer require "anthropic-ai/sdk" で明示的に上げる仕組みです
2. 棚卸しする。 下のセルフチェックで、該当するコードとインフラ（ゲートウェイ・環境変数・集計スクリプト）を列挙します
3. ステージングで SDK を上げる。 temperature などを外した状態で、評価データの出力を旧版と比較します
4. ゲートウェイと環境変数を直す。 Authorization 対応と、資格情報を1つに絞る作業は、SDK 更新の前にインフラ側で済ませます
5. 本番を切り替える。 移行ガイドどおり、SDK の更新とコード修正を同じリリースで出します。2023-06-01 に残す要求があるなら、その理由をコードのコメントと社内の台帳に書きます
6. Admin API の集計を検証する。 月次の利用レポートや鍵の棚卸しスクリプトが、新しい項目名で同じ結果を出すことを確認します

• Claude API を呼ぶリポジトリ・ノーコードツール（n8n・Dify・GAS など）を全て列挙した
• 各リポジトリの SDK のメジャー版と、anthropic-version を自分で指定している箇所を確認した
• temperature・top_p・top_k を送っている要求を検索した
• assistant メッセージに document ブロックを置いている要求がないか確認した
• user メッセージの text に citations を付けている要求がないか確認した
• 社内プロキシ・API ゲートウェイが X-Api-Key を読んでいないか確認した
• API キーと認証トークンを同時に渡しているクライアントがないか確認した
• 本番・CI の環境変数に ANTHROPIC_API_KEY と ANTHROPIC_AUTH_TOKEN が同時に設定されていないか確認した
• Admin API・Analytics API の応答を読むスクリプトで、旧項目名を使っている箇所を検索した
• Bedrock で Opus 4.6 以前のモデルを呼んでいる処理を洗い出した
• ant CLI を --api-key フラグで動かしているジョブがないか確認した
• 依存ライブラリのライセンス台帳で、SDK の項目を Apache 2.0 に更新する担当を決めた

件名: Claude API SDK のメジャー版更新について（期限: ○月○日）

Anthropic が 2026年10月21日に API バージョン 2026-10-21 と、
各言語 SDK のメジャー版を公開しました。
新しい SDK は既定で新バージョンを送るため、更新すると次が止まります。

- temperature / top_p / top_k を送る要求（400 エラー）
- X-Api-Key を読む社内ゲートウェイ経由の呼び出し
- API キーと認証トークンを同時に渡すクライアント

対応:
1. 各リポジトリで SDK のメジャー版を現行に固定する（○月○日まで）
2. 上記3点を検索し、該当箇所を台帳に記入する
3. ステージングで SDK を上げ、評価データで出力を比較する
4. 本番切替は SDK 更新とコード修正を同じリリースで行う

公式の移行ガイド:
https://platform.claude.com/docs/en/api/migration-2026-10-21

2026-10-21 の前後には、API を社内や顧客に提供する会社に関わる管理機能も出ています。移行計画の会議で一緒に扱うと、設定の変更が一度で済みます。

• user profiles（2026年10月20日）: どのエンドユーザーのための要求かを Anthropic に伝える仕組みで、プラットフォームやゲートウェイとして API を提供する会社向けです。安全上の制限が組織全体ではなく該当するエンドユーザーに限定されます。翌21日には enforcement_status・enforcement_actions の項目が加わり、制限・停止されたプロファイルを一覧で絞り込めます
• 組織 webhook（ベータ・2026年10月20日）: Admin API に webhooks-2026-10-07 ベータヘッダーで追加され、プロファイルの制限・停止とその解除の2種類のイベントを受け取れます。利用はアカウントチームへの申請が必要です
• 組織単位の Web fetch 無効化とドメイン制限（2026年10月20日）: Claude Console の Capabilities ページで Web fetch を切ると、Web fetch ツールを含む Messages API の要求は 400 エラーになります。Managed Agents の web_fetch もこの設定に従います
• Inference hooks の正式提供（2026年10月20日）: Claude Enterprise 組織でベータが外れました

※ 出典: Release notes — Claude Platform（2026年10月20日・21日の項）（取得 2026-10）

止まりません。anthropic-version ヘッダーに 2023-06-01 を送る既存のコードと、旧メジャー版の SDK はそのまま動きます。Anthropic はバージョンごとに既存の入力・出力パラメータを維持すると明記しており、2026年10月時点で 2023-06-01 の提供終了日は公表されていません。ただし Anthropic は常に最新の API バージョンを使うことを推奨しているので、期限を切られてからではなく、計画的に移すのが安全です。

新しいメジャー版の SDK は、既定で anthropic-version: 2026-10-21 を送ります。つまり SDK の更新は API バージョンの切替を兼ねます。temperature・top_p・top_k を送っていた処理は 400 エラーになり、API キーは X-Api-Key ではなく Authorization: Bearer で送られ、API キーと認証トークンを同時に持つクライアントは初期化時にエラーになります。依存関係の自動更新で意図せず上がらないよう、メジャー版の上限を固定しておく必要があります。

2026-10-21 では temperature・top_p・top_k を送ると、既定値であっても 400 エラーになります。Claude 4.7 以降のモデルはもともと既定値しか受け付けないので影響はありませんが、Claude Sonnet 4.6 のように他の値を受け付けていたモデルでは、下げていた効果が失われます。代わりの設定は用意されていないため、パラメータを外して評価し直すか、その処理だけ 2023-06-01 に残すかのどちらかです。

新しい SDK と CLI は API キーを Authorization: Bearer ヘッダーで送ります。X-Api-Key を読んで認証や課金の集計をしているゲートウェイは、Authorization から読むように直すか、SDK 側で X-Api-Key を自分で付けるかのどちらかが必要です。ゲートウェイ用のトークンと Claude API 用のキーを両方送っていた構成は、1クライアント1資格情報の規則に変わったため、ゲートウェイ側で Authorization を外してから転送する設計に変えます。

まず、Claude API を呼んでいるリポジトリとノーコードツールを全て列挙し、SDK のメジャー版を現行に固定してください。次に、上のセルフチェック 12 項目で該当箇所を台帳に書き出し、ゲートウェイと環境変数の手当てを先に済ませてから、ステージングで SDK を上げて評価データの出力を比べます。

自社のシステム構成でどこから手を付けるべきか、ゲートウェイや集計スクリプトを含めた移行の進め方を相談したい場合は、お問い合わせからご連絡ください。現状の構成を書面で整理したうえで、実装ステップを提示します。Claude の法人導入全体の整理は Claude 導入支援 のページにまとめています。

• 2026-10-28: 初版公開

• Claude Opus 5.5 への移行【2026年10月】— 4つの 400 エラー・effort の既定値・Fast mode 正式提供
• Claude Sonnet 4.5 は 2026年11月30日に退役【2026年10月】— 棚卸し・移行先の費用・コードの直し方
• Claude API・MCP 実装ハンドブック 2026 — Python/Node/Dify/n8n の現場仕様
• Claude の Google Cloud 契約【2026年10月】— Anthropic managed と Vertex AI の違い
• Claude 法人導入 完全ガイド 2026 — Team/Enterprise/API/Bedrock の 4 経路比較と契約実務
• Claude 導入支援