2026-10-21で変わること

ClaudeDevsが2026年10月21日に出した投稿は、壊れる点を三つ挙げています。temperature、top_p、top_kがMessages APIから外れ、assistantターンのドキュメントとuserターンのcitationsは400を返し、非推奨になっていたAdminおよびEnterprise Analyticsのフィールドがいくつか置き換わります。移行ガイドは、このMessagesの規則をPOST /v1/messages、トークン計数、そして2026-10-21で作ったMessage Batchの各リクエストに適用します。

temperature、top_p、top_kを送ると、パラメータのデフォルト値でも400が返ります。これらを外すと、リクエストはデフォルトでサンプリングし、temperature 1.0を含みます。パラメータを省いた2023-06-01のリクエストと同じです。Claude 4.7以降は、すでにそのデフォルトだけを受け付け、サンプリングも以前と同じです。別の値を受け付けるモデルについて、ガイドの例はClaude Sonnet 4.6です。下げたtemperatureはその効果を失い、代わりになる設定はなく、そのリクエストは2023-06-01に残せます。

assistantメッセージにドキュメントブロックを直接置くと400が返ります。ドキュメントはuserメッセージで送ります。別のブロックの中に入れ子になったドキュメント、たとえばClaudeが返したweb-fetchツールの結果は、引き続き受け付けられます。citations配列が空でないuserメッセージのテキストブロックは400を返し、search_resultブロックの中のcitationsも含まれます。以前の返答を送り返す場合のように、assistantメッセージのテキスト上のcitationsは引き続き受け付けられ、ドキュメントと検索結果の"citations": {"enabled": true}も同じです。

Admin APIとClaude Enterprise Analytics APIの応答には、表にある古い名前が含まれなくなります。APIキーではworkspace_idが外れ、呼び出し側はscopeを読みます。Default Workspaceに紐づくキーを含め、ワークスペースに紐づくキーは、そのワークスペースの実際のIDをscope.workspace_idに置きます。すべてのワークスペース向けキーのscopeは{"type": "organization"}で、workspace_idはありません。ガイドは、2023-06-01ではDefault Workspaceに紐づくキーとすべてのワークスペース向けキーの両方でworkspace_idがnullだったと記しています。nullをDefaultとして扱っていたコードは、include_default=trueを付けてList Workspacesを呼び、名前がDefaultのワークスペースとscope.workspace_idを比較します。レート制限の一覧エンドポイントにあるgroup_typeクエリパラメータと、APIキー一覧エンドポイントのworkspace_idフィルタは変わりません。

Anthropicの移行ガイドによる、APIバージョン2026-10-21の応答フィールド名の変更。
エンドポイント古い名前新しい名前
RBACグループ: 作成、一覧、取得、更新rolesrole_ids
RBACグループのメンバー: 一覧、追加、およびメンバー削除の応答group_idrbac_group_id
RBACロール: 一覧と取得namedisplay_name
組織とワークスペースのレート制限: 一覧、およびワークスペースのレート制限を設定した応答group_typegroup.type
APIキー: 一覧、取得、更新workspace_idscope（値は異なる）
ユーザー別の利用量とコストのレポートactor.emailactor.email_address
アクティビティの要約summariesdata

クライアントを変える必要がある場合

ClaudeDevsは、Anthropic SDKとant CLIの新しいメジャーバージョンが投稿当日の2026年10月21日に出て、既定が2026-10-21だと述べています。移行ガイドはそのクライアントのリリース日を記していません。SDKは、そのメジャーがリリースされた時点で現行だったAPIバージョンを送り、各言語で示されたバージョンが2026-10-21を送る最初の版で、Amazon BedrockとGoogle Cloudのクライアントも含まれる、とガイドは述べています。それより前のSDKとCLIはanthropic-version 2023-06-01を送っていました。ガイドが名指しするPythonのアップグレードはanthropic 2.0.0です。他の言語については、その言語のタブに示されたバージョンを指しています。

Amazon Bedrockでは、2026-10-21はClaude 4.7以降でのみ使えます。Claude on Amazon BedrockでOpus 4.6以前とされている、より古いBedrockモデルへの呼び出しは、その呼び出しがClaude 4.7以降のモデルを使うようになるまで、今使っているSDKのバージョンか、今送っているバージョンヘッダーのままにします。同じガイドは、それらのSDKバージョンのGoogle Cloudクライアントが2026-10-21を送ると記しています。

SDKとCLIは、APIキーをX-Api-KeyではなくAuthorization: Bearerとして送ります。Claude APIはどちらのヘッダーのキーも受け付けるので、APIと直接話すプログラムは、この入れ替えだけでは変更不要です。X-Api-Keyを読む、または設定するプロキシやゲートウェイはAuthorizationを使うか、呼び出し側がX-Api-Keyを送り続けられます。ガイドは、AnthropicFoundryが引き続きキーをx-api-keyで送ると記しています。

APIキーと認証トークンが同じヘッダーを共有するようになったため、SDKクライアントが持つ資格情報は一つです。Pythonでは、コンストラクタに二つ以上を渡すか、一回のcopy()またはwith_options()呼び出しに二つ以上を渡すとValueErrorになります。Noneを渡しても資格情報には数えません。ゲートウェイトークンとAPIキーを送るには、トークンをauth_tokenとして渡し、default_headersにX-Api-Keyを設定し、転送前にゲートウェイが自分のAuthorizationヘッダーを外すようにします。Claude APIはリクエストごとに資格情報を一つ期待するからです。Python、TypeScript、Go、PHP、RubyのSDKでは、X-Api-Keyを省くextra_headersでは、リクエストからキーを外せなくなりました。ガイドが示すPythonの置き換えはextra_headers={"Authorization": omit}です。

ant CLIは--api-keyと--auth-tokenを外します。フラグの値がシェル履歴とプロセス一覧に見えるためです。両フラグはv1.27.0から非推奨の警告を出していました。どちらかをまだ渡すコマンドは"flag provided but not defined."で止まります。キーにはANTHROPIC_API_KEY、--api-key-stdin、またはant auth loginを使います。トークンにはANTHROPIC_AUTH_TOKENまたは--auth-token-stdinを使います。

  • Text CompletionsはTypeScript、Go、Java、RubyのSDKとCLIから外れ、ant completions createも含まれます。ガイドはMessages APIを使うよう述べています。
  • TypeScriptとRubyのツールランナーは、クライアント側のcompactionをやめ、サーバー側のcompactionに切り替えます。input tokenのトリガーは50,000以上である必要があります。手動の呼び出しはcompactBeforeNextTurn()です。
  • 非ベータのModelsメソッドはbetasを取らなくなり、ant modelsコマンドも--betaを取らなくなります。ベータヘッダーはclient.beta.modelsまたはant beta:modelsを通り、戻り値はBetaModelInfoです。
  • MessageParamは、UserMessageParam、AssistantMessageParam、SystemMessageParamのユニオンになりました。BetaMessageParamも同じ分け方です。SDKが送るJSONのフィールドと値は同じままです。Pythonでは{"role": "user", "content": "Hello"}のようなdictリテラルは変更不要です。MessageParam()またはBetaMessageParam()の呼び出し、あるいはどちらかの名前のサブクラス化はTypeErrorになります。UserMessageParamのように、ロール用の型をサブクラス化します。
  • C#、Go、Java、PHP、RubyのSDKでは、取り得る値が一つだけの必須フィールドが定数になり、メンバーが一つのenum型はなくなります。SDKが送受信するJSONは同じままです。CLIでは、ant beta:sessions:resources addの--typeは任意で、取り得る値はfileだけであり、--type fileをまだ渡すコマンドはそのまま動きます。

切り替え方

SDKを使わない呼び出し側は、anthropic-versionヘッダーを2026-10-21にします。SDKを使う側は、ガイドが自分の言語について示すバージョンへ上げます。Pythonで名前が挙がっている段階はanthropic 2.0.0です。ガイドの順序は、バージョンを切り替え、該当する破壊的変更と新しいSDKまたはCLIが必要とする変更をコードに反映し、リリース前に連携を2026-10-21でテストすることです。バージョンのアップグレードは、それらの修正と一緒に出します。

ClaudeDevsは、Claude Codeの/claude-apiスキルか移行ガイドを案内しています。2026年10月21日付けのClaude Code 2.1.307は、Claude APIのコードをAPIバージョン2026-10-21へ移す/claude-api api-versionを追加します。

これらのSDKとCLIのバージョンはApache License 2.0です。それより前のバージョンはMITのままです。ガイドは、ライセンス変更にコードの変更は不要だとし、依存関係のライセンスを記録しているならその項目を更新するよう述べています。1.0.0リリースは、TypeScriptのプラットフォーム向けパッケージと、それ以外のC#パッケージのライセンス変更です。Javaの変更は、すべてのcom.anthropicアーティファクトを含みます。ガイドにおけるPythonのAPIバージョンの指定は、anthropic 2.0.0のままです。

まだ開いている点

ClaudeDevsの投稿と移行ガイドは、2023-06-01についても2026-10-21についても、価格、クォータの変更、終了日を示していません。ClaudeDevsは2023-06-01が非推奨ではないと述べています。ガイドの関連する指示は、デフォルト以外のサンプリング値が必要なリクエストは2023-06-01に残す、というものです。バージョンをより頻繁に出すというClaudeDevsの計画は、日程、次のバージョンid、後のバージョンを必要とするモデルを挙げていません。

出典

Claude Developers · @ClaudeDevs

あわせて

資料と編集方針

このブリーフは、2026年10月21日に公開されたClaudeDevsの投稿、APIバージョン2026-10-21向けのAnthropicの移行ガイド、2026年10月21日付けのClaude Code 2.1.307の変更履歴を根拠にしています。ガイドと変更履歴は2026年10月22日に確認しました。提供状況、2023年以降で初の公式バージョンだという説明、バージョンをより頻繁に出す計画、2023-06-01は非推奨ではないという一文、同日のSDKとant CLIのリリースは、ClaudeDevsの発言です。リクエストとクライアントの挙動は、移行ガイドが述べている内容です。価格、クォータ、終了日、実際のAPI呼び出し、別掲のBedrockモデル一覧は扱っていません。ガイドはPythonについてanthropic 2.0.0を名指しし、他の言語については各言語に示されたバージョンを指しています。