2026年9月4日 金曜日
AI時短ラボ
検証· 約20

curl一本槍だったAnthropic Admin APIが、ant CLIと7言語SDKに対応した

Anthropicは2026年8月26日、組織管理用のAdmin APIを`ant` CLIとPython・TypeScript・C#・Go・Java・PHP・Rubyの各SDKから使えるようにしました。`client.beta.organization`配下に、組織情報・メンバー・招待・ワークスペース・APIキー・レート制限・サービスアカウント・ワークロードID連携・CMEKがまとまっています。使用量/コストレポートとEnterpriseのユーザー管理・分析系エンドポイントは、公式リリースノートによると引き続きcurlのみの対応です。

curl一本槍だったAnthropic Admin APIが、ant CLIと7言語SDKに対応した
執筆・編集:
目次

2026年8月27日、Claude Developer Platform公式リリースノート(platform.claude.com)を実際に開いて確認した内容です。 2026年8月26日のエントリに、次の記載があります(原文と訳)。

"The Admin API is now available in the ant CLI and the Python, TypeScript, C#, Go, Java, PHP, and Ruby SDKs under client.beta.organization. They cover organization info, members, invites, workspaces and workspace members, API keys, rate limits, service accounts, workload identity federation issuers and rules, and customer-managed encryption keys. Usage and cost reports and the Claude Enterprise user-management and analytics endpoints remain curl-only. The CLI and SDKs read an Admin API key from ANTHROPIC_API_KEY or an org:admin OAuth token from ANTHROPIC_AUTH_TOKEN."

(訳:Admin APIがant CLIおよびPython・TypeScript・C#・Go・Java・PHP・RubyのSDKでclient.beta.organization配下から利用可能になった。これらは組織情報、メンバー、招待、ワークスペースとワークスペースメンバー、APIキー、レート制限、サービスアカウント、ワークロードID連携の発行者とルール、顧客管理鍵(CMEK)をカバーする。使用量・コストレポートおよびClaude Enterpriseのユーザー管理・分析系エンドポイントは、引き続きcurlのみの対応。CLIとSDKはANTHROPIC_API_KEYからAdmin APIキーを、またはANTHROPIC_AUTH_TOKENからorg:adminスコープのOAuthトークンを読み取る)

3行まとめ

  • 2026年8月26日、Anthropic Admin APIがant CLIと7言語SDK(Python・TypeScript・C#・Go・Java・PHP・Ruby)のclient.beta.organization配下から呼べるようになった
  • カバー範囲は組織情報・メンバー・招待・ワークスペース・APIキー・レート制限・サービスアカウント・ワークロードID連携・CMEK。使用量/コストレポートとClaude Enterpriseのユーザー管理・分析系はcurl限定のまま
  • 認証はANTHROPIC_API_KEY(Admin APIキー)またはANTHROPIC_AUTH_TOKENorg:adminスコープのOAuthトークン)のどちらか

これまで「curlのみ」だった管理系API

Admin APIは、組織全体のメンバー管理・APIキー発行・レート制限設定といった管理者向けの操作をプログラムから行うためのAPIです。この種の管理系エンドポイントは、多くのAPIプロバイダーで「まずcurlでの直接呼び出しに対応し、その後SDKに組み込まれる」という順序を辿ることが珍しくありません。今回の変更は、Admin APIがそのcurl限定の状態から、公式CLIと主要7言語SDKに統合された、という節目です。

カバー範囲の内訳

公式リリースノートが挙げている、今回SDK/CLIから使えるようになった機能を整理すると次の通りです。

  • 組織情報(organization info)
  • メンバー(members)
  • 招待(invites)
  • ワークスペースとワークスペースメンバー(workspaces and workspace members)
  • APIキー(API keys)
  • レート制限(rate limits)
  • サービスアカウント(service accounts)
  • ワークロードID連携の発行者とルール(workload identity federation issuers and rules)
  • 顧客管理鍵(customer-managed encryption keys、CMEK)

これらはいずれも、Claude APIを組織で運用する際の管理業務(誰がアクセスできるか、APIキーの発行・失効、レート制限の調整、暗号鍵の管理など)に関わる項目です。個人開発者が単独でClaude APIを使っている場合には直接関係しない機能が中心ですが、チームでAnthropicのAPIを運用している場合は、これまでcurlスクリプトで自作していた管理作業を、使い慣れた言語のSDKに置き換えられる、という変化になります。

curlのままの2項目

一方で、リリースノートは「Usage and cost reports and the Claude Enterprise user-management and analytics endpoints remain curl-only(使用量/コストレポートとClaude Enterpriseのユーザー管理・分析系エンドポイントは引き続きcurlのみ)」とも明記しています。全てのAdmin API機能がSDK化されたわけではなく、レポート系・分析系の一部は今回の対応範囲から外れている、という点は導入前に確認しておくべき事実です。

なお、Claude Enterpriseのユーザー管理エンドポイント自体は、公式リリースノートの別の日付(2026年8月19日)のエントリで「out of beta(ベータを卒業)」になったことが確認できています。ベータを卒業したエンドポイントであっても、今回のCLI/SDK統合の対象には含まれていない、という切り分けです。

認証方法:公式ガイドを読むと実は3つの選択肢

公式リリースノートによると、ant CLIとSDKは次のどちらかから認証情報を読み取ります。

  • ANTHROPIC_API_KEY環境変数:Admin APIキーを設定する
  • ANTHROPIC_AUTH_TOKEN環境変数:org:adminスコープを持つOAuthトークンを設定する

通常のメッセージAPI呼び出しで使うANTHROPIC_API_KEYとは別の権限(Admin API用のキー)が必要になる点は、実装時に混同しやすいポイントだと考えられます。

リリースノートの1文だけでは触れられていない点があったため、Admin APIの公式ガイドページ(platform.claude.com/docs/en/manage-claude/admin-api)を追加で確認しました。それによると、Admin APIが受け付ける認証情報は実際には3種類あります。

  1. Admin APIキーsk-ant-admin...で始まる):管理者ロールを持つ組織メンバーのみが発行できる
  2. org:adminスコープ付きOAuthベアラートークン:管理者・オーナー・プライマリオーナーのロールを持つメンバーのみが取得できる
  3. 個人キーまたはサービスアカウントキー(特定のワークスペースに紐づいていないもの):紐づくアカウントと同じ権限を持つ

送信するHTTPヘッダーと発行条件も3種類で異なっており、公式ガイドの記載を表にまとめると次の通りです。

認証情報 送信ヘッダー 発行・取得できる人 全エンドポイントを呼べるか
Admin APIキー(sk-ant-admin... x-api-key adminロールを持つメンバーのみ サービスアカウント・フェデレーション発行者・フェデレーションルールの3系統は呼べない
org:adminスコープ付きOAuthベアラートークン authorization: Bearer admin・owner・primary ownerロールのメンバー 呼べる(上記3系統を含む全エンドポイントに対応)
個人キー/サービスアカウントキー(ワークスペース非紐づけ) x-api-key 各アカウントの保有者 紐づくアカウントと同じ権限の範囲内

つまりAdmin APIキー1つですべてのエンドポイントを呼べるわけではなく、サービスアカウント・フェデレーション発行者・フェデレーションルールの操作にはorg:adminのOAuthトークンが必須ということになります。また同ガイドには「Admin APIは個人アカウントでは利用できない」という前提条件、Claude EnterpriseとClaude Platform on AWSでは対応範囲が異なる、という注記もありました(詳細は後述)。

組織の5つのロールと権限

Admin APIで管理する「メンバーのロール」について、公式ガイドには5段階のロール一覧が表で掲載されていました。実際の表をそのまま日本語化すると次の通りです。

ロール 権限
user playgroundを使える
claude_code_user playgroundとClaude Codeを使える
developer playgroundを使え、APIキーを管理できる
billing playgroundを使え、請求情報を管理できる
admin 上記すべてに加え、ユーザーを管理できる

なお組織のowner・primary ownerはadminの全権限を持ったうえでadminユーザー自体を管理できる、と同ガイドは注記しています(このページでの「adminロール」への言及はowner・primary ownerにも当てはまる、とのこと)。Admin APIでメンバーのロールを更新する際は、この5段階のいずれかを指定する形になります。

Admin APIでできないこと

公式ガイド末尾のFAQを確認すると、Admin APIの機能には次のような明確な制限があることが分かりました。

  • 新規APIキーの発行はできない:「Admin API経由で新しいAPIキーを作成できるか」という質問に対し、公式回答は「いいえ。APIキーはClaude Consoleで作成する。Admin APIは既存キーの読み取り・改名・ステータス変更のみ対応」と明記されている
  • adminロールのメンバーはAPI経由で削除できない:「組織のadminをAPI経由で削除できるか」という質問への回答は「いいえ。APIはadminロールを持つメンバーを削除できない」
  • 招待の有効期限は21日固定:「組織への招待はどのくらいの期間有効か」という質問への回答は「21日で失効する。有効期限は設定変更できない」

つまりAdmin APIは「既存の管理業務を自動化するための読み取り・更新用API」であって、キー発行やadmin権限の剥奪といった、より強い操作まではカバーしていません。

ユーザー削除時、APIキーはどうなるか(キーの種類で挙動が違う)

同じくFAQで確認できた、組織からメンバーを削除した際にAPIキーがどうなるかの挙動は、キーの種類によって異なっていました。

キーの種類 メンバー削除時の挙動
個人キー(personal key) 紐づくユーザーが組織から削除されると使えなくなる
サービスアカウントキー サービスアカウントがアーカイブされると使えなくなる。作成したユーザーが削除されても、キー自体は使え続ける
ワークスペースAPIキー 使え続ける(ユーザー削除の影響を受けない)
Claude Codeワークスペースのキー 作成したメンバーに紐づいており、そのメンバーが削除されると使えなくなる

サービスアカウントキーとワークスペースAPIキーは「作った人がいなくなっても動き続ける」設計になっている一方、個人キーとClaude Codeワークスペースのキーは「作った人(または紐づく人)が組織を離れると止まる」という違いがある、という整理です。

Claude EnterpriseとClaude Platform on AWSでは対応範囲がさらに違う

前述の「3つの選択肢」の節で触れた「対応範囲が異なる」という注記の中身を、公式ガイドで具体的に確認しました。

  • Claude Enterprise(claude.ai)組織:claude.aiで発行したスコープ付きAPIキーでAdmin APIを呼ぶ。このページで説明されているエンドポイントのうち、メンバーと招待の2系統のみが該当する。加えてEnterprise専用のエンドポイント(グループ・カスタムロールの読み取り、spend limits)が使える
  • Claude Platform on AWS:利用できるのはワークスペース関連(/v1/organizations/workspacesでの作成・取得・一覧・更新・アーカイブ)と、外部キー関連(/v1/organizations/external_keysでの登録・取得・一覧・更新・削除。バリデーション用エンドポイントは存在しない、ワークスペースに紐づけた時点で検証されるため)のみ。組織メンバー・ワークスペースメンバー・招待・APIキー・使用量/コスト/レート制限レポートは、AWS版では利用できない

つまり本記事の主題である「7言語SDKとant CLIから呼べるようになったAdmin API」は、標準のClaude Developer Platform上での話が前提であり、Claude Platform on AWSを使っている組織では、そもそも呼べるエンドポイントの範囲自体が大きく絞られる、という点は導入前に確認しておくべき事実です。

翌日8月27日にも関連のアップデートがあった

今回確認したリリースノートを読み進めると、Admin APIのCLI/SDK対応が発表された翌日、2026年8月27日のエントリにも関連する変更が記載されていました。

"You can now create personal keys and service account keys in the Claude Console. They act as you or as a service account, with the same permissions, and stop working when the linked account is removed from an organization. (…) These API keys can be scoped to a specific workspace or work on admin endpoints and across any workspace the account has access to. Workspace API keys remain supported as a legacy option."

(訳:Claude Consoleで個人キーとサービスアカウントキーを作成できるようになった。これらは自分自身またはサービスアカウントとして動作し、同じ権限を持ち、紐づくアカウントが組織から削除されると使えなくなる。〈中略〉これらのAPIキーは特定のワークスペースにスコープを絞ることも、管理系エンドポイントおよびアカウントがアクセスできる全ワークスペースで動作させることもできる。ワークスペースAPIキーはレガシーオプションとして引き続きサポートされる)

つまり、Admin APIが個人キー・サービスアカウントキーという認証情報の存在を前提に設計された翌日、その個人キー・サービスアカウントキー自体をClaude Console上で作成できるようにする機能が追加されており、2日連続でこの領域に手が入っていたことになります。

Claude Codeの/claude-apiスキルにも反映

Anthropicが同時に配布しているClaude Codeでは、この変更が別の形でも反映されています。当サイトが確認したClaude Codeのリリース履歴(v2.1.247、2026年8月26日公開)には、次の記載がありました(原文と訳)。

"Updated the /claude-api skill with Admin API coverage (organization members, invites, workspaces, API keys, rate limit reports, workload identity federation, CMEK)"

(訳:/claude-apiスキルをAdmin APIカバレッジで更新(組織メンバー、招待、ワークスペース、APIキー、レート制限レポート、ワークロードID連携、CMEK))

同じ日にAPI本体の変更とClaude Code側のスキル更新が両方入っており、Anthropicが自社製品間でこの種の変更を同期させていることが分かります。

正式版化の時期とSDKごとの命名規則は未確認

client.beta.organizationという命名から、この機能自体がまだベータ扱いであることがうかがえますが、正式版化の予定時期については、今回確認したリリースノートの1文には記載がありませんでした。また、7言語SDKそれぞれで具体的にどのようなメソッド名・呼び出し方になるのか(言語ごとの命名規則の違いなど)についても、各SDKのドキュメント本体までは今回確認していません。

加えて、Admin APIの公式ガイドには「Usage and cost reports」「Claude Code analytics」「Rate limits」「Compliance API」という4つの関連APIが、それぞれ別の見出しで独立して案内されています。このうち使用量/コストレポートがcurl限定であることは2026年8月26日のリリースノートで明記されていましたが、Claude Code Analytics APIとCompliance APIについては、今回確認したリリースノートの当該エントリに記載がなく、ant CLI/SDK対応の範囲に含まれるかどうかを本記事では確認できていません。また、Claude EnterpriseとClaude Platform on AWSでエンドポイントの対応範囲が公式ガイド上で明記されている一方、CLI/SDK経由で呼んだ場合にもこの範囲制限が同様に適用されるかどうかは、リリースノートには明記されておらず、推測にとどまります。

関連記事

シェア: ポスト はてブ

出典・参照資料

AIニュースの解説を動画でも

YouTubeでは注目ニュースの背景を解説し、Xでは新着記事をお知らせしています。

コメント

まだコメントはありません。最初のコメントを書いてみませんか?

AIについて聞きたいことはありますか?

質問箱で無料で受け付けています。回答は公開され、他の方の参考にもなります。

質問箱を見る →

新しい記事をメールで受け取る

AIの新しい発表を、出典付きで整理して届けます。

関連記事