APIバージョン2026-10-21への移行

このガイドでは、APIバージョン2023-06-01から2026-10-21に移行するためのコード変更を一覧で示します。アップグレード手順では、行うべきことを順番に説明しています。

アップグレード手順

1. 1

   2026-10-21に切り替える

   SDKを使用している場合、リクエストには、そのSDKのメジャーバージョンがリリースされた時点で最新だったAPIバージョンが使用されます。各言語について示されているバージョンは2026-10-21を使用する最初のバージョンなので、それらにアップグレードしてください。SDKを使わずにAPIを呼び出している場合は、anthropic-versionヘッダーを2026-10-21に設定してください。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   anthropicパッケージをバージョン2.0.0にアップグレードします。

   アップグレードは、次のステップでの修正と一緒にリリースしてください。

2. 2

   破壊的変更に合わせてコードを更新する

   「breaking changes」（破壊的変更）を確認し、影響を受ける各変更に合わせてコードを更新してください。また、新しいSDKまたはCLIバージョンで必要なコード変更も行ってください。

3. 3

   2026-10-21に対してテストする

   リリース前に、2026-10-21に対して統合をテストしてください。

破壊的変更

Messages API

これらの変更は、Messages API（POST /v1/messages）へのリクエスト、トークンカウント、および2026-10-21で作成されたMessage Batch内の各リクエストに適用されます。

assistantメッセージ内のdocumentブロックはエラーを返す

assistantメッセージ内にdocumentブロックを直接送信している場合に影響します。

2026-10-21では、assistantメッセージ内にdocumentブロックを直接配置したリクエストは400エラーを返します。代わりに、ドキュメントはuserメッセージで送信してください。Claudeが返したweb fetchツールの結果など、別のブロック内にネストされたドキュメントは引き続き受け付けられます。

userメッセージ内のcitationsはエラーを返す

userメッセージ内のtextブロック（search_resultブロック内を含む）でcitationsを送信している場合に影響します。

2026-10-21では、userメッセージ内で空でないcitations配列を持つtextブロックを送信するリクエストは400エラーを返します。それらのブロックからcitationsを削除してください。送り返すClaudeの以前の応答など、assistantメッセージ内のtextブロックのcitationsは引き続き受け付けられます。また、ドキュメントや検索結果に対する"citations": {"enabled": true}設定も引き続き受け付けられます。

サンプリングパラメータの削除

Messagesリクエストまたは Message Batchリクエストでtemperature、top_p、またはtop_kを送信している場合に影響します。

2026-10-21では、temperature、top_p、またはtop_kを送信するリクエストは、パラメータのデフォルト値であっても400エラーを返します。

リクエストからこれら3つのパラメータを削除してください。

最新のメジャーバージョンでは、SDKとCLIにこれら3つのパラメータはなくなりました。

これらのパラメータがない場合、リクエストはtemperatureの1.0を含むデフォルト値でサンプリングされます。これは、これらを省略した2023-06-01のリクエストと同じです。Claude 4.7以降のモデルなど、すでにデフォルト値のみを受け付けるモデルは、以前と同様にサンプリングします。Claude Sonnet 4.6など、他の値を受け付けるモデルでは、より一貫した出力を得るためにtemperatureを下げていたリクエストはその効果を失います。これに代わる設定はありません。リクエストがデフォルト以外の値に依存している場合は、パラメータの送信をやめるか、そのリクエストを2023-06-01のままにしてください。

Admin APIとClaude Enterprise Analytics API

コードが以下の表にあるAdmin APIまたはClaude Enterprise Analytics APIのレスポンスフィールドを読み取っている場合に影響します。

2026-10-21では、Admin APIおよびClaude Enterprise Analytics APIからのレスポンスに、名前が変更されたフィールドの古い名前が含まれなくなります。代わりに新しい名前を使用してください。

Admin API：

Claude Enterprise Analytics API：

レート制限一覧エンドポイントのgroup_typeクエリパラメータと、APIキー一覧エンドポイントのworkspace_idフィルターは変更されていません。

APIキーのworkspace_id

コードがAPIキーのworkspace_idを読み取っている場合に影響します。

2023-06-01では、APIキーのworkspace_idは、キーがバインドされているワークスペースのIDです。Default Workspaceにバインドされたキー、および1つのワークスペースにバインドされていないキー（全ワークスペースキー）の場合はnullになります。

2026-10-21では、workspace_idは削除されます。代わりにscopeを読み取ってください。Default Workspaceを含むワークスペースにバインドされたキーの場合、scope.workspace_idはそのワークスペースの実際のIDです。全ワークスペースキーのscopeは{"type": "organization"}で、workspace_idはありません。

コードでnullのworkspace_idをDefault Workspaceとして扱っていた場合は、代わりにscope.workspace_idをDefault WorkspaceのIDと比較してください。そのIDを確認するには、include_default=trueを指定してList Workspacesを呼び出し、"Default"という名前のワークスペースを取得します。

SDKとCLIの変更

以前のSDKおよびCLIバージョンは、すべてのリクエストでanthropic-version: 2023-06-01を送信していました。2026-10-21に切り替えるに記載されているバージョンは2026-10-21を送信します。破壊的変更の変更はこれらにも適用されます。削除されたパラメータと古いフィールド名は、SDKの型、およびCLIのフラグと出力からもなくなっています。

Amazon BedrockとGoogle CloudでのAPIバージョン

Google Cloud's Agent Platform用のSDKクライアントは、バージョンをヘッダーではなくリクエストボディで指定します。以前のバージョンがvertex-2023-10-16を送信していたところでanthropic_version: 2026-10-21を送信し、anthropic-versionヘッダーは送信しません。

Amazon Bedrockクライアントも同様です。以前のバージョンがbedrock-2023-05-31を送信していたところでanthropic_version: 2026-10-21を送信し、anthropic-versionヘッダーは送信しません。Claude Opus 4.7より古いモデルは、Bedrock上でAPIバージョン2026-10-21をまだサポートしておらず、それを指定したリクエストは400エラーになる可能性があります。それらのモデルを使用している場合は、当面は以前のSDKバージョンを使い続けるか、アップグレードしたうえでbedrock-2023-05-31を自分で送信してください。

MessageParamはロールごとに1つの型を持つユニオンになった

以前のバージョンでは、MessageParamはすべてのロールに共通の1つの型でした。現在は各ロールが独自の型を持ちます：UserMessageParam、AssistantMessageParam、SystemMessageParamです。BetaMessageParamも同様に、BetaUserMessageParam、BetaAssistantMessageParam、BetaSystemMessageParamに分割されています。SDKが送信するリクエストのフィールドと値は以前と同じです。

# 変更前
message = MessageParam(role="user", content="Hello")

# 変更後
message: MessageParam = {"role": "user", "content": "Hello"}

# 変更前
def to_message(role: Literal["user", "assistant"], text: str) -> MessageParam:
    return {"role": role, "content": text}


# 変更後
def to_message(role: Literal["user", "assistant"], text: str) -> MessageParam:
    if role == "user":
        return {"role": "user", "content": text}
    return {"role": "assistant", "content": text}

単一値のenumは定数になりました

この変更は、C#、Go、Java、PHP、Ruby の各SDKと、1つのCLIフラグに影響します。以前のバージョンでは、1つの値しか取れない必須フィールドは、メンバーが1つだけの独自のenum型を持っていました。これらのフィールドは定数になり、enum型は削除されました。SDKが送受信するJSONは変わりません。

ツールランナーからクライアントサイドのコンパクションが削除されました

この変更は、TypeScript と Ruby のSDKに影響します。「tool runner」（ツールランナー）における「client-side compaction」（クライアントサイドのコンパクション）は削除され、サーバーサイドのコンパクションに置き換えられました。サーバーサイドのコンパクションは、クライアントからの追加リクエストではなく、API内部で会話を要約します。

// 変更前
const runner = client.beta.messages.toolRunner({
  // ...
  compactionControl: { enabled: true, contextTokenThreshold: 100_000 }
});

// 変更後
const runner = client.beta.messages.toolRunner({
  // ...
  betas: ["compact-2026-01-12"],
  context_management: {
    edits: [{ type: "compact_20260112", trigger: { type: "input_tokens", value: 100_000 } }]
  }
});

トリガーのしきい値は50,000トークン以上である必要があります。その他のオプション（pause_after_compaction、カスタムの instructions）については、コンパクションを参照してください。

Text Completionsが削除されました

レガシーのText Completions APIは、TypeScript、Go、Java、Ruby の各SDKとCLIから削除されました。新しいモデルや機能はこれをサポートしていません。代わりにMessages APIを使用してください。

# 変更前
ant completions create \
  --model "$MODEL" \
  --max-tokens-to-sample 1024 \
  --prompt $'\n\nHuman: Hello, Claude\n\nAssistant:'

# 変更後
ant messages create \
  --model "$MODEL" \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'

ベータ版以外のModelsメソッドから betas が削除されました

ベータ版以外のModelsメソッドは betas を受け取らなくなり、ant models コマンドは --beta を受け取らなくなりました。ベータヘッダーを送信するには、client.beta.models で同じメソッドを呼び出すか、CLIでは ant beta:models を使用してください。SDKでは、ベータ版以外のメソッドが ModelInfo を返すのに対し、これらのメソッドは BetaModelInfo を返します。

# 変更前
page = client.models.list(betas=[beta])

# 変更後
page = client.beta.models.list(betas=[beta])

APIキーは Authorization: Bearer として送信されます

SDKとCLIは、APIキーを X-Api-Key ヘッダーではなく Authorization: Bearer <key> として送信します。そのため、X-Api-Key を読み取ったり設定したりするプロキシやゲートウェイは Authorization を使用するように変更するか、キーを自分で X-Api-Key に入れて送信してください。Claude APIはどちらのヘッダーのキーも受け付けるため、APIと直接通信するプログラムは変更の必要がありません。

# Before
X-Api-Key: <key>

# After
Authorization: Bearer <key>

プロキシやゲートウェイが X-Api-Key を読み取る場合

import httpx2
from anthropic import Anthropic, DefaultHttpxClient


def send_x_api_key(request: httpx2.Request) -> httpx2.Request:
    if request.headers.get("Authorization") == f"Bearer {api_key}":
        del request.headers["Authorization"]
        request.headers["X-Api-Key"] = api_key
    return request


client = Anthropic(api_key=api_key, http_client=DefaultHttpxClient(auth=send_x_api_key))

リクエストで X-Api-Key を設定または削除していた場合

この変更は、Python、TypeScript、Go、PHP、Ruby の各SDKに影響します。

リクエストが認証トークンのみを送信するように X-Api-Key を削除していた場合は、そのコードを変更するのではなく削除してください。Authorization を削除するとトークンも削除されてしまうためです。クライアントは1つの認証情報を保持しますので、それがトークンであることを確認してください。コードで何も渡さず、ANTHROPIC_API_KEY と ANTHROPIC_AUTH_TOKEN の両方が設定されている場合、クライアントはキーを使用します。

クライアントは1つの認証情報を保持する

APIキーと認証トークンが同じヘッダーを共有するようになったため、SDKクライアントは1つの認証情報を保持します。コードで何も渡さない場合は、認証情報の優先順位の順序に従います。

client = Anthropic(api_key=key, auth_token=token)

# 変更前: `X-Api-Key: <key>` と `Authorization: Bearer <token>` の両方を送信していました
# 変更後: `ValueError` を送出します

1つのSDKまたはCLIにおける変更

これらの変更は、それぞれ1つのSDKまたはCLIに影響します。

# 変更前
ant --api-key "$KEY" models list

# 変更後（環境変数から取得）
export ANTHROPIC_API_KEY="$KEY"
ant models list

# 変更後（シークレットマネージャーから取得）
op read op://vault/anthropic/api-key | ant --api-key-stdin models list

ライセンスはApache 2.0です

これらのバージョン以降、SDKとCLIはApache License, Version 2.0の下でライセンスされます。以前のバージョンは引き続きMIT Licenseの下にあります。コードの変更は必要ありません。依存関係のライセンスを追跡している場合は、それらのエントリを更新してください。

• TypeScript： プラットフォームパッケージ（@anthropic-ai/bedrock-sdk、@anthropic-ai/vertex-sdk、@anthropic-ai/foundry-sdk、@anthropic-ai/aws-sdk、@anthropic-ai/google-cloud-sdk）は、それぞれの1.0.0リリースでライセンスが変更されます。
• C#： その他のパッケージ（Anthropic.Bedrock、Anthropic.Vertex、Anthropic.Foundry、Anthropic.Aws、Anthropic.GoogleCloud、Anthropic.Mcp）は、それぞれの1.0.0リリースでライセンスが変更されます。
• Java： この変更はすべてのcom.anthropicアーティファクトに適用されます。