Claude API の 2026-10-21 では、Messages API に temperature、top_p、top_k のいずれかを送ると、全モデルで HTTP 400 エラーになります。temperature: 1.0 のように既定値を明示している場合も、リクエストから項目ごと削除します。
Anthropic の公式 SDK(開発用ライブラリ)を Python 2.0.0 や TypeScript 1.0.0 に更新すると、SDK が送る anthropic-version も 2026-10-21 に切り替わります。HTTP で直接呼び出す場合は、このヘッダーで切り替え時期を選べます。API キーを送るヘッダーの変更は SDK・CLI 側の仕様です。Anthropic の移行ガイド
この記事でわかること
- SDK と HTTP 直接呼び出しで、API バージョンの切り替え時期がどう違うか
- サンプリング設定の削除、メッセージ形式、管理系 API の変更でどの処理が影響を受けるか
- SDK・CLI の新メジャー、認証ヘッダー、Bedrock 混在構成で踏みやすい落とし穴
- ソースの grep からリリース判定までの影響調査フローとテスト観点
- 旧版 2023-06-01 を残す判断基準と、公式で確認できていない事項の線引き
Claude APIのバージョン指定とSDK更新の関係
2026-10-21 は、旧版 2023-06-01 に続く Claude API のバージョンです。Messages API では送れる入力が変わり、管理・分析用 API では応答フィールドが変わります。移行ガイド(API バージョン 2026-10-21)・バージョン履歴
バージョン指定の仕組みと旧版との関係
anthropic-version は、リクエストヘッダーで API の仕様世代を指定する値です。モデルの世代とは別物で、同じモデルでもバージョンによってリクエストの受け付け方が変わります。
履歴は 2023-01-01、2023-06-01、2026-10-21 の3つだけです。同一バージョンの中では、既存の入出力パラメータは維持されます。ただし任意入力の追加、出力値の追加、列挙型出力への新しい値の追加、特定エラー条件の変更は同一バージョン内でも起こり得ます。出力の列挙値が増えても落ちない実装にしておく必要があります(公式のバージョン管理ページ)。
SDK を使っている場合、API バージョンは SDK のメジャーバージョンに紐づきます。新メジャーは 2026-10-21 を送り、旧メジャーは 2023-06-01 を送り続けます(移行ガイド)。SDK を使わず HTTP で直接叩いている場合は、anthropic-version ヘッダーの値を自分で書き換えます。
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2026-10-21" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":1024,
"messages":[{"role":"user","content":"こんにちは"}]}'
SDKの自動更新前に確認すること
SDK のメジャー更新を自動マージしている場合は、対象サービスの型チェックとリクエストのテストを先に行います。古い型の利用はビルド時に見つけられますが、共通ライブラリが既定の temperature を補っていると、呼び出し時に初めて 400 が返ることがあります。
旧版を使い続けられるのか
2026年11月18日に確認した Anthropic の移行ガイドとバージョン履歴には、2023-06-01 の提供終了日は記載されていません。旧版で非既定の temperature を使えるモデルについて、公式ガイドは、値を省略するか、そのリクエストを旧版に残すかを選択肢に挙げています。Anthropic の移行ガイド
破壊的変更はサンプリング削除・形式の厳格化・名前変更の3系統
API 側の変更は、Messages API のリクエスト制約、サンプリング系パラメータの削除、管理系 API のフィールド名変更に分かれます。Messages API の変更は POST /v1/messages、トークンカウント、2026-10-21 で作成する Message Batch の各リクエストに適用されます(出典: 移行ガイドの破壊的変更、バージョン履歴)。
| 区分 | 変更内容 | 旧版での挙動 | 新版での挙動 |
|---|---|---|---|
| サンプリング | temperature / top_p / top_k を削除 | 受け付ける(モデルによる) | 1つでも送ると 400 |
| メッセージ形式 | assistant メッセージ直下の document ブロック | 受け付ける | 400。user メッセージへ移す |
| メッセージ形式 | user の text ブロックに空でない citations | 受け付ける | 400 |
| Admin API | roles / group_id / workspace_id などの改名 | 旧名で返る | 新名で返り、旧名は消える |
| Analytics API | actor.email / summaries の改名 | 旧名で返る | actor.email_address / data |
temperature・top_p・top_kを送ると全モデルで400になる
サンプリング系の3パラメータは、既定値であっても送れば 400 になります。SDK と CLI の型定義からも削除されました。
省略した場合の挙動は、temperature が既定の 1.0 でのサンプリングです。Claude 4.7 以降のモデルと Claude Mythos Preview は、旧版でも既定値しか受け付けません。非既定値を送ると旧版でも 400 が返ります(公式のモデル廃止ページの API パラメータ廃止表)。このため、Claude 4.7 以降を使っているコードでは挙動は変わらず、パラメータを消すだけで済みます。
問題が出るのは、Sonnet 4.6 など非既定値を受け付けるモデルで temperature を下げ、出力を安定させていた処理です。新版には代替設定がありません。たとえば分類、抽出、JSON 生成、定型文書の下書きなど、temperature: 0 付近で運用していた処理が該当します。
temperature を下げていた処理では、次の順で移行可否を判断します。
- パラメータを省いたときの結果を代表入力で評価し、業務上の許容範囲と比べる。
- 出力形式に問題があれば、プロンプトやスキーマを調整する。形式の検証と、分類・抽出した内容の正しさは別々に確かめる。
- 非既定値を受け付けるモデルで必要な品質を保てない場合は、そのリクエストを
2023-06-01に残す。
400になるメッセージ形式と、引き続き使える引用
メッセージ形式の厳格化は2点です。
1つ目は、assistant メッセージの直下に document ブロックを置くと 400 になる点です。document は user メッセージに移します。Claude が返したウェブ取得ツールの結果のように、別のブロックの中に入れ子になった document は引き続き使えます。
2つ目は、user メッセージの text ブロック(search_result ブロックの内部を含む)に空でない citations 配列を付けると 400 になる点です。過去の Claude の応答を送り返すときの assistant メッセージ内 text ブロックの citations と、document / search_result に付ける "citations": {"enabled": true} は変更ありません。
検索結果を使って回答を生成する仕組み(RAG)では、引用付きの回答を会話履歴に戻すときの role を確認します。過去の回答を assistant のまま戻す経路と、ユーザー入力として組み直す経路では、同じ citations でも扱いが異なります。
Admin APIとClaude Enterprise Analytics APIのフィールド変更
社内のコスト管理やアクセス権の棚卸しスクリプトは、この改名に影響されます(出典: 移行ガイド)。旧名は応答から消えるため、旧名を読んでいるコードはキー欠落で静かに壊れます。
| API | 旧名 | 新名 |
|---|---|---|
| RBAC groups | roles | role_ids |
| RBAC group members(応答) | group_id | rbac_group_id |
| RBAC roles | name | display_name |
| 組織・ワークスペースのレート制限 | group_type | group.type(クエリパラメータの group_type は変更なし) |
| API keys | workspace_id | scope(ワークスペースに属するキーは scope.workspace_id) |
| Analytics 利用量・コスト | actor.email | actor.email_address |
| Analytics activity summaries | summaries | data |
最も判断が難しいのは API keys の workspace_id です。旧版では Default Workspace のキーも全ワークスペース共通のキーも null でした。新版では Default Workspace にも実際の ID が入り、全ワークスペース共通キーは scope が {"type":"organization"} になって workspace_id が現れません。
null を Default Workspace 扱いしていたコードは、判定が壊れます。List Workspaces を include_default=true で呼んで「Default」の ID を取得し、その ID と比較する形に直します。list の絞り込みに使う workspace_id フィルタ自体は変更ありません。
SDK新メジャーで認証ヘッダーとクラウド構成が変わる
API バージョンに依存しない SDK 側の変更もあります。型が変わってビルドが落ちるものは見つけやすく、ヘッダーのように動作は変わらず周辺基盤だけが壊れるものが危険です。
言語ごとの新メジャーと注意点
最初に対応した SDK のバージョンは次のとおりです(出典: 移行ガイド、リリースノート)。
| 言語 | パッケージ | 最初の対応版 | 特記事項 |
|---|---|---|---|
| Python | anthropic | 2.0.0 | MessageParam(...) の呼び出しと継承が TypeError |
| TypeScript | @anthropic-ai/sdk | 1.0.0 | Bedrock / Vertex / Foundry 等のプラットフォーム SDK も同時更新 |
| C# | Anthropic | 13.0.0 | IChatClient が ChatOptions の Temperature / TopK / TopP を無視 |
| Go | github.com/anthropics/anthropic-sdk-go/v2 | 2.0.0 | import パス変更、Go 1.25 以上が必須 |
| Java | com.anthropic:anthropic-java | 3.0.0 | 多数の getter が Optional に変更 |
| PHP | anthropic-ai/sdk | 1.0.0 | 旧メジャーに固定した依存制約を composer require で更新 |
| Ruby | anthropic | 2.0.0 | Vertex・Bedrock クライアントの DEFAULT_VERSION 定数を削除 |
| ant CLI | ant | 2.0.0 | Go 経由は anthropic-cli/v2 パス |
Go は import パスの更新が必要です。ant CLI も go install で旧パスを指定すると v1 系が入るので、インストール後にバージョンを確認します。
TypeScript では、利用中のプラットフォーム向け SDK(bedrock-sdk、vertex-sdk、foundry-sdk、aws-sdk、google-cloud-sdk)も確認します。各パッケージの v1 は @anthropic-ai/sdk v1 を要求するため、本体と併せて依存関係を更新します。
そのほか、1値だけの enum の定数化、TypeScript / Ruby のツールランナーにあったクライアント側 compaction の削除(サーバー側 compaction へ移行)、Text Completions の TS・Go・Java・Ruby SDK と CLI からの削除、非 beta の Models メソッドから betas の削除があります。Text Completions を使っている場合は Messages API へ書き換えます。
認証ヘッダーの変更で確認するプロキシとログ
新しい標準 SDK と ant CLI は、API キーを Authorization: Bearer で送ります。Claude API は従来の X-Api-Key も受け付けるので、HTTP で直接呼び出す場合は上の curl 例のヘッダーも有効です。移行ガイド
X-Api-Key を読み取る社内プロキシや API ゲートウェイでは、Authorization も転送できるか確認します。リクエストヘッダーを記録するログでは両方の値をマスクし、ミドルウェアとテストのスタブも点検してください。
回避したい場合は、SDK なら X-Api-Key を自前で送る方法があります(ant CLI には独自ヘッダーを足す手段がないため、プロキシ側を Authorization の読み取りに直します)。Foundry クライアントは従来どおり x-api-key を使い、Bedrock Mantle は元から bearer です。
もう一つ、1クライアントに複数の資格情報を渡すとエラーになります(標準クライアントの場合。プラットフォーム別クライアントは個別の規則があります)。api_key と auth_token を同時に指定したときの挙動は、言語ごとに次のとおりです。
- Python:
ValueError - TypeScript:
TypeError - C#:
ArgumentException - Java:
IllegalStateException - PHP:
InvalidArgumentException - Ruby:
ArgumentError - Go: 全リクエストが失敗
たとえば Python の標準クライアントは、コードで資格情報を指定せず、環境変数に ANTHROPIC_API_KEY と ANTHROPIC_AUTH_TOKEN の両方があると、警告を出して API キーを使います。CI や開発端末では、使う資格情報と設定元を確認します。
ant CLI は --api-key と --auth-token のフラグが削除されました。API キーは ANTHROPIC_API_KEY、--api-key-stdin、ant auth login のいずれか、認証トークンは ANTHROPIC_AUTH_TOKEN か --auth-token-stdin に置き換えます。
Amazon Bedrockで移行できるモデルの条件
2026-10-21 は、Claude API、Claude Platform on AWS、Claude Models on Google Cloud(Anthropic managed と Google managed の両方)、Microsoft Foundry で使えます。Amazon Bedrock では Claude 4.7 以降のモデルだけが対象です(出典: バージョン履歴、移行ガイドの警告)。
Bedrock で Claude 4.6 以前のモデルを呼ぶ場合は、その経路の SDK または直接指定している API バージョンを据え置きます。2026-10-21 に移すには、先に Bedrock で利用できる Claude 4.7 以降のモデルに変更します。
直接 API と Bedrock が混在する会社では、「同じアプリの中で SDK を新旧併用できるか」を先に決めておきます。併用が難しければ、Bedrock 経由のサービスだけ SDK を据え置き、直接 API のサービスから先に上げる運用に分けるのが安全です。日本リージョンでの提供状況や、Google managed 側の個別制約は、この記事では確認できていません。契約している経路の公式ページで個別に確かめてください。
ライセンスがMITからApache 2.0に変わる
新しい SDK と CLI のライセンスは MIT から Apache 2.0 になりました。旧版は MIT のままです(移行ガイドの「The license is Apache 2.0」)。コードの変更は不要ですが、依存ライセンスを管理している場合は台帳や審査記録の更新が必要です。審査プロセスが重い会社では、コードの移行より台帳更新が先に詰まることがあります。
影響調査から本番反映まで、4段階で進める
公式の移行手順は3ステップです。2026-10-21 に切り替え、破壊的変更ごとに自分のコードを直し、リリース前に 2026-10-21 でテストする。SDK を上げるリリースと修正のリリースは同じにします。ここでは、実務で詰まりやすい順序を足して4段階に整理します。
全社の呼び出し箇所を洗い出す表を作る
最初の作業は、Claude API を呼んでいるサービスと、その呼び出し方の棚卸しです。次の表を埋めると、移行範囲が一枚で見えます。
| 確認項目 | 探し方 | 見つけたときの対処 |
|---|---|---|
| サンプリング系パラメータ | grep -rnE "temperature|top_p|top_k" をラッパー、設定ファイル、評価基盤、バッチ生成スクリプトに | 削除、または旧版に残す |
| assistant 直下の document | メッセージ組み立て処理の role とブロックの位置 | 直下の document を user メッセージへ移動 |
user の text にある空でない citations | search_result 内も含めた text ブロック | 該当する配列を外し、assistant の引用履歴は保持 |
| Admin / Analytics の旧名 | group_id、actor.email、workspace_id、summaries | 新名に修正、null 判定を見直す |
| 認証ヘッダー依存 | プロキシ、ゲートウェイ、WAF、ログマスク、テストスタブ | Authorization に対応 |
| 認証情報の二重指定 | api_key と auth_token の併用、環境変数 | 一本化 |
| SDK の言語とバージョン | 各リポジトリのロックファイル | 新メジャーの要件を確認 |
| 経由先 | 直接 API、Bedrock、Vertex、Foundry | Bedrock の旧モデルは据え置き |
| 依存ライセンス台帳 | 審査記録 | Apache 2.0 を追記 |
共通ライブラリや委託先の成果物も棚卸しの対象です。下の例は拡張子を限定しているので、利用している言語や設定に応じて .yml や .ipynb なども検索対象に加えます。コード調査に Claude Code を使う場合は、Claude Codeの基本機能と利用上の注意点を参照してください。
grep -rnE "temperature|top_p|top_k" \
--include="*.py" --include="*.ts" --include="*.go" \
--include="*.java" --include="*.yaml" --include="*.json" .
このコマンドは候補の洗い出しにすぎず、他社 API の temperature も拾います。ヒットした箇所を一件ずつ、呼び出し先が Claude かどうか確認してください。
互換性のある修正を先行し、SDKと依存する修正を同時にリリースする
- プロキシとログのマスク処理を、新旧両方の認証ヘッダーに対応させる。
- 旧版でも動くメッセージ形式の修正を先行する。非既定の
temperatureを外す処理は、先に出力への影響を評価する。 - ステージングで SDK を更新し、送信した
anthropic-versionの値を確認する。認証情報はログに記録しない。 - 管理系の集計には旧版と新版の応答例を通す。旧版には
scopeがないため、scope.workspace_idを読む修正は SDK 更新と同じリリースに含めるか、両形式を扱える状態で先行する。回帰テストを通ったサービスから本番に反映する。
回帰テストで見るべき6つの観点
以下は、公式の変更内容から整理したリリース前の確認項目です。
| 観点 | テスト内容 |
|---|---|
| 400 の回帰 | 削除パラメータを送るコードパスが残っていないか。バッチ生成を含む全経路を実行する |
| 出力のぶれ | temperature を下げていた処理で、同一入力を複数回流し、結果が変わる割合を計測する |
| 引用付き応答 | RAG の会話履歴で、2ターン目以降も 400 にならないか |
| 認証経路 | プロキシ経由、WAF 経由、ログにキーが平文で残っていないか |
| 管理系スクリプト | コスト集計、権限棚卸しのキー欠落、Default Workspace 判定 |
| ビルドと依存 | 各言語の型エラー、二重インストール、import パス、ライセンス台帳 |
たとえば分類処理なら、同じモデルと代表入力を使い、移行前後で同じ回数だけ実行します。同一入力で分類が割れた件数と、正解ラベルに一致した件数を比較し、業務で許容できる範囲を満たすか判断します。JSON が正しく読めても、分類結果まで一致するとは限りません。
代表入力や評価結果を継続的に記録する方法は、AIエージェントの運用設計でも解説しています。
旧版を継続する場合の判断基準
非既定の temperature に依存するリクエストだけ、2023-06-01 に残す手があります。公式の移行ガイドが示している選択肢の一つです。
旧版を残す場合は、対象モデルがその値を受け付けることを確認し、品質基準を満たせなかった処理と再評価日を記録しておくと、移行を再開する条件が明確になります。
同時期のモデル廃止予定も確認しておく
次の表は、Anthropic が運用するプラットフォームのモデル提供状況です(2026年11月18日確認)。「この日より前には廃止しない」という下限日と、発表済みの廃止予定日を区別しています。公開モデルの廃止は、対象モデルを利用中の顧客に少なくとも60日前に通知されます。公式のモデル廃止ページ
| モデル | 廃止の扱い | 推奨される代替 |
|---|---|---|
claude-sonnet-4-5-20250929 | 2026-11-30 廃止予定 | claude-sonnet-5-5 |
claude-opus-4-5-20251101 | 提供中。廃止日は未発表(下限は 2026-11-24) | 指定なし |
claude-haiku-4-5-20251001 | 提供中。廃止日は未発表(下限の 2026-10-15 は経過済み) | 指定なし |
claude-sonnet-4-5-20250929 を使っている場合は、API バージョンを据え置くサービスもモデル移行の対象です。モデルと API バージョンを両方変更するときは、一方ずつ切り替えて同じ入力を試すと、出力が変わった原因を切り分けられます。軽量モデルの比較には、Claude Haiku 5.5の解説も参考になります。
これらの日付は Anthropic が運用するプラットフォームに適用され、Amazon Bedrock と Google managed はそれぞれ独自のスケジュールです。契約している経路ごとに確認が必要です。
よくある質問
Q. 2026-10-21 に上げなければ、すぐに API が使えなくなりますか?
Anthropic が2026年11月18日時点で公開している移行ガイドとバージョン履歴には、2023-06-01 の提供終了日は記載されていません。利用モデルに廃止予定日がある場合は、旧版を継続していてもモデルの切り替えが必要です。
Q. temperature を 0 にしていた処理は、どうすれば安定しますか?
2026-10-21 に temperature: 0 の代替設定はありません。形式はスキーマで検証し、分類などの回答内容は代表入力で旧版と比較します。業務上必要な精度を保てず、モデルが旧版で非既定値に対応している場合は、その処理を旧版に残せます。
Q. 認証ヘッダーが変わると、API キーの扱いに影響しますか?
公式の標準 SDK は API キーを Authorization: Bearer で送ります。Claude API は X-Api-Key も受け付けます。旧ヘッダーを前提にしたプロキシでは認証の転送を確認し、ログでは両方の値をマスクしてください。
Q. Bedrock 経由でも 2026-10-21 に移行できますか?
Amazon Bedrock で Claude 4.7 以降を利用できる経路は移行できます。Claude 4.6 以前の呼び出しは現行の API バージョンで継続し、対応モデルに切り替えてから新版に移します。
Q. SDK のメジャー更新だけで済ませてよいですか?
利用している機能によります。SDK 更新後は新版のリクエスト制約と型定義が適用されます。削除された項目などへの依存があれば修正を同時にリリースし、該当箇所がない場合も、ステージングで実際の送受信を確認します。
まとめ
移行の対象は、サービスごとの SDK、送信する anthropic-version、接続先、モデルで判断します。削除されたサンプリング設定や認証ヘッダーへの依存を調べ、管理・分析用 API を読む処理では旧版と新版の応答をテストしてください。
旧版で temperature を下げている処理は出力評価を、Bedrock の Claude 4.6 以前の呼び出しはモデルの切り替えを先に進めます。旧版に残す処理には理由と再評価日を記録します。


