Admin APIの組織管理メソッドがGAに：client.organizationへの移行ガイド

はじめに

Anthropic の Admin API のうち、組織管理に関するメソッド群がベータを終了し、正式版（GA） になりました。リリースノートの 2026年9月30日付エントリに追記された内容です。

各公式 SDK と ant CLI では、新しい名前空間 client.organization / ant organization から呼び出せます。

📌 影響を受ける人

• Claude の組織管理（メンバー、ワークスペース、API キーなど）をスクリプトや社内ツールで自動化している管理者・プラットフォームエンジニア
• Python / TypeScript / C# / Go / Java / PHP / Ruby の公式 SDK、または ant CLI を使っている人
• 監査・コンプライアンス対応で、組織設定を IaC や定期ジョブで管理している人

結論から言うと、既存コードは壊れません。旧ベータ名前空間も残っているためです。ただし、新規コードでは GA 側の名前空間を使うのが推奨で、段階的な移行を検討する価値があります。

変更の全体像

変更内容

GA になった対象メソッド

カテゴリ	概要
組織情報	組織自体の情報の取得
メンバー	組織メンバーの管理
招待	メンバー招待の管理
ワークスペース	ワークスペースの管理
API キー	API キーの管理
レート制限	レート制限の管理
サービスアカウント	サービスアカウントの管理
ワークロードアイデンティティフェデレーション	外部 ID 基盤との連携
カスタマー管理暗号鍵（CMEK）	暗号鍵の管理
コンプライアンス設定	コンプライアンス関連設定

セキュリティやガバナンスに関わる領域（CMEK、ワークロードアイデンティティフェデレーション、コンプライアンス設定、サービスアカウント）が含まれている点が重要です。これらを業務で使うチームにとっては、ベータ扱いだったものが正式機能になったことを意味します。

対応バージョン

GA の名前空間を使うには、以下のバージョン以上が必要です。

SDK / CLI	最小バージョン
Python SDK	1.10.0
TypeScript SDK	0.130.0
C# SDK	12.52.0
Go SDK	1.77.0
Java SDK	2.67.0
PHP SDK	0.53.0
Ruby SDK	1.75.0
ant CLI	1.37.0

名前空間の新旧比較

項目	旧（ベータ）	新（GA）
SDK	client.beta.organization	client.organization
CLI	ant beta:organization	ant organization
状態	引き続き利用可能	正式版・新規コードで推奨

⚠️ 注意：ベータ名前空間の終了時期は未記載
今回の差分には、ベータ名前空間をいつまで残すかの記載がありません。「いつか消える」可能性を前提に、計画的に移行しておくのが安全です。

影響と対応

緊急対応は不要

• action_required は false。SDK を更新しても既存の client.beta.organization / ant beta:organization の呼び出しはすぐには壊れません。
• ただし、旧名前空間の廃止時期は示されていないため、放置はおすすめしません。

推奨アクション

1. SDK / CLI のバージョン確認：上表の最小バージョン以上に更新する
2. 新規コードは GA 名前空間で書く：client.organization / ant organization
3. 既存コードの棚卸し：beta.organization / beta:organization を検索して使用箇所を洗い出す
4. 段階的に置換：テスト環境で動作確認してから本番に反映する
5. 社内ガイドを更新：CLAUDE.md などに方針を追記する

💡 Tips
使用箇所の洗い出しは、次のようなコマンドで一括検索できます。

grep -rnE "beta\.organization|beta:organization" .

CLAUDE.md への追記例

Claude Code などを使ってこのリポジトリを開発している場合、次のような方針を書いておくと、AI が古い書き方を生成するのを防げます。

## Claude API / SDK 利用ガイド（Admin API）

- Admin API の組織管理メソッドは GA 済み。新規コードでは
  `client.organization` / `ant organization` を使う
- 旧 `client.beta.organization` / `ant beta:organization` は
  引き続き動くが、新規コードでは使わない
- 最低バージョン: Python 1.10.0 / TS 0.130.0 / C# 12.52.0 /
  Go 1.77.0 / Java 2.67.0 / PHP 0.53.0 / Ruby 1.75.0 / ant CLI 1.37.0

コード例

以下は名前空間の変更点を示すための例です。具体的なメソッド名や引数は、お使いの SDK のリファレンスで確認してください。

Python（Before / After）

# Before: ベータ名前空間
client.beta.organization  # ...各メソッドを呼び出す

# After: GA 名前空間（Python SDK 1.10.0 以上）
client.organization  # ...各メソッドを呼び出す

TypeScript（Before / After）

// Before: ベータ名前空間
client.beta.organization; // ...各メソッドを呼び出す

// After: GA 名前空間（TypeScript SDK 0.130.0 以上）
client.organization; // ...各メソッドを呼び出す

CLI（Before / After）

# Before
ant beta:organization ...

# After（ant CLI 1.37.0 以上）
ant organization ...

移行は、基本的に beta を取り除く だけです。呼び出しの前段にあたる名前空間の部分だけを置き換え、その後ろのメソッド呼び出しは既存のものを引き続き利用する形になります。

まとめ

• Admin API の組織管理メソッド（組織情報、メンバー、招待、ワークスペース、API キー、レート制限、サービスアカウント、ワークロードアイデンティティフェデレーション、CMEK、コンプライアンス設定）が GA になった
• 新しい呼び出し先は SDK が client.organization、CLI が ant organization
• 必要バージョンは Python 1.10.0、TypeScript 0.130.0、C# 12.52.0、Go 1.77.0、Java 2.67.0、PHP 0.53.0、Ruby 1.75.0、ant CLI 1.37.0 以上
• 旧 client.beta.organization / ant beta:organization も残っており、既存コードはそのまま動く
• ベータ名前空間の廃止時期は未記載のため、新規は GA 側で書き、既存は段階的に移行するのが安全

組織管理を自動化している方は、まず grep で旧名前空間の使用箇所を確認するところから始めてみてください。