Anthropic クライアント SDK 2.0.0 系の breaking changes と、旧版との実行比較で観測できる項目（2026-11-02 時点）

2026-10-21 に、API バージョン 2026-10-21 を既定で送る新しいクライアント SDK と ant CLI がリリースされました [1]。本稿は、公式リリースノートに書かれている SDK の breaking changes を、リリースごとに整理します。あわせて、Python SDK の旧版と新版を同じスクリプトで実行したときに観測できる項目を対応づけます。検証日は 2026-11-02（JST）です。

2026-10-21 のリリース

• 新しいクライアント SDK と ant CLI は、API バージョン 2026-10-21 を既定で送ります [1]。
• 新しいバージョン番号は、Python SDK 2.0.0、TypeScript SDK 1.0.0、C# SDK 13.0.0、Go SDK 2.0.0、Java SDK 3.0.0、PHP SDK 1.0.0、Ruby SDK 2.0.0、ant CLI 2.0.0 です [1]。メジャー番号は言語ごとに異なります。
• アップグレードの手順は「Migrating to API version 2026-10-21」にまとめられています [1]。
• 新しい SDK と CLI には、API バージョンに依存しない breaking changes もあります [1]。
• ライセンスは MIT License から Apache 2.0 に変わりました [1]。

API バージョンに依存しない breaking changes の個別の項目は、本稿で確認した引用範囲には含まれていません。

Python SDK v1.0 の変更

• Python 3.10 以降が必須になり、長く非推奨だった機能（surface）が削除されました [1]。削除された機能の具体名は、本稿の引用範囲には含まれていません。
• SDK の HTTP 層が httpx から httpx2 に移りました [1]。両者の互換性については、本稿の引用範囲に記述はありません。
• AWS リージョンが設定されていないとき、AnthropicBedrock は us-east-1 を既定にせず、エラーを送出します [1]。

v1.0 のリリース日は、本稿の引用範囲には含まれていません。

2026-08-27 のリリース（Python SDK 1.2.0 ほか）

• client.beta.files と client.beta.skills は、beta ヘッダー files-api-2025-04-14 と skills-2025-10-02 を送らなくなりました [1]。
• beta Messages の型 BetaSkill（container Skill の参照）は、BetaContainerSkill に改名されました [1]。

2026-09-30 のリリース（Python SDK 1.10.0 ほか）

• これらのリリースでも、client.beta.organization と ant beta:organization は残されています [1]。beta 名前空間の外に移ったかどうかは、本稿の引用範囲には含まれていません。

モデル側の変更（SDK の変更とは別）

• Claude Opus 5.5 では、thinking を無効化できません [1]。この挙動は SDK のバージョンとは関係なく、実際の API 呼び出しでしか観測できません。

旧版・新版の実行比較で観測できる項目

ローカルのエコーサーバーに base_url を向け、旧版と新版の Python SDK で同じリクエストを送ると、次の項目を API キーなしで観測できます。

• messages.create のリクエストヘッダー: 新版では 2026-10-21 が現れることが予想されます [1]。API バージョンを運ぶヘッダー名は、本稿の引用範囲には書かれていません。そのため、記録用のスクリプトは anthropic- で始まるヘッダーをすべて記録します。
• beta.files.list と beta.skills.list の anthropic-beta ヘッダー: 1.2.0 より前の版では files-api-2025-04-14 と skills-2025-10-02 が現れ、それ以降の版では現れないことが予想されます [1]。
• パッケージのメタデータ: ライセンスの表記（MIT から Apache 2.0）と、HTTP 層の依存（httpx から httpx2）[1]。
• anthropic.types.beta の公開名: BetaContainerSkill があるかどうか [1]。
• AnthropicBedrock: AWS リージョンを設定せずに使ったとき、旧版は us-east-1 を使い、新版はエラーを送出することが予想されます [1]。

本稿で扱わない項目

モデル移行（Claude Sonnet 5.5、Claude Haiku 5.5 など）の個別の変更点と、ant CLI の変更点は、本稿の対象外です。

References

[1] https://platform.claude.com/docs/en/release-notes/overview