新APIバージョン`2026-10-21`リリースで全8言語SDK・CLIがメジャーバージョンアップ — Python SDK 2.0.0・TypeScript SDK 1.0.0等が`2026-10-21`をデフォルト送信、sampling parameters完全削除・MessageParam型分割等の破壊的変更を含む初の大規模APIバージョン更新

Summary

10月21日にClaude Platform Release Notesで新APIバージョン`2026-10-21`をリリース。2023年6月の`2023-06-01`以来初のAPIバージョン更新で、全8言語SDKとCLIが同時メジャーバージョンアップ（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）。SDKライセンスがMITからApache 2.0に変更。主な破壊的変更: (1)`temperature`・`top_p`・`top_k`がMessages APIリクエストで400エラーを返却し完全削除、(2)assistant messagesでの`document`ブロック直接配置が400エラー、(3)user messages内の`citations`配列が400エラー、(4)Admin API・Enterprise Analytics APIのフィールドリネーム（`roles`→`role_ids`・`group_id`→`rbac_group_id`・`workspace_id`→`scope`等）で旧フィールド名が削除、(5)`MessageParam`がロール別ユニオン型（`UserMessageParam`・`AssistantMessageParam`・`SystemMessageParam`）に分割。Amazon Bedrockでは`2026-10-21`はClaude 4.7以降モデルのみ対応で旧モデルは旧バージョン維持が必要。

Key Takeaways

▸ 2023年6月以来初のAPIバージョン更新で全SDK・CLIの同時メジャーバージョンアップ
▸ `temperature`・`top_p`・`top_k`の完全削除が最大の破壊的変更 — Claude 4.7以降で既に400エラーだったが今回APIバージョンレベルで正式廃止
▸ SDKライセンスがMIT→Apache 2.0に変更 — OSSプロジェクトのライセンス互換性確認が必要
▸ Admin API・Analytics APIのフィールドリネーム移行が必要 — `workspace_id`→`scope`は値構造も変更
▸ `MessageParam`のロール別型分割でTypeScript・Pythonの型チェックに影響 — dict literalは変更不要
▸ Bedrockでは`2026-10-21`がClaude 4.7以降のみ対応 — 旧モデル利用中のBedrock環境は旧SDK維持が必要

Best Practice Updates

✓ 全SDKユーザーはメジャーバージョンアップ前にマイグレーションガイドを確認し破壊的変更への対応を完了すべき
✓ `temperature`・`top_p`・`top_k`を送信しているコードは即時削除が必要 — デフォルト値でも400エラー
✓ CI/CDパイプラインのSDKバージョンピンニングを段階的に更新推奨 — まず本番環境を旧バージョンに維持しテスト環境で新バージョン検証後に移行

Same Day Signals

すべて見る →