はじめに

2026年10月20日、Anthropic は Claude Enterprise 組織向けに Claude Tag API をベータ公開しました。これまで管理画面で設定していた Slack 上の Claude Tag の設定を、プログラムから読み取り・変更できるようになります。

Slack のチャンネルやワークスペースが増えるほど、手作業での設定管理は漏れや属人化の原因になります。API 化されたことで、設定の一括適用、設定状況の棚卸し、変更の自動化がしやすくなります。

📌 影響を受ける人

Claude Enterprise 組織の管理者(特にプライマリオーナー)

多数の Slack チャンネルで Claude Tag を運用している情報システム部門・社内 IT 担当

設定管理を IaC や自動化スクリプトに組み込みたい開発者

Claude Platform(Claude Console)組織では使えません。

なお、本記事は公開されたリリースノートの情報のみに基づいています。リクエスト・レスポンスの詳細なスキーマなど、記載のない点は推測せず、公式ドキュメントでの確認をお勧めします。

変更の全体像

Claude Tag API は /v1/organizations/claude_tag/ 配下のエンドポイント群で、Admin API キーで認証します。

呼び出しの流れは次のとおりです。

変更内容

できること

区分	内容
設定の読み取り・変更	Slack チャンネルと Slack ワークスペースの Claude Tag 設定
有効な設定の確認	あるチャンネルで有効な設定と、各設定の継承元(どこから来ているか)
Access bundles	Access bundles の割り当て

特に「継承元の確認」は運用上の価値が高い機能です。ワークスペースの設定とチャンネルの設定が重なる場合、「なぜこのチャンネルでこの挙動になるのか」を API で追跡できます。

利用条件

項目	内容
対象	Claude Enterprise 組織(ベータ)
対象外	Claude Platform(Claude Console)組織
beta ヘッダー	`experimental-claude-tag-2026-10-21`
エンドポイント	`/v1/organizations/claude_tag/` 配下
認証	Admin API キー
キー作成者	組織のプライマリオーナー(claude.ai で作成)
スコープ	参照: `read:claude_tag` / 変更: `write:claude_tag`

⚠️ 注意:ベータヘッダーの日付
ベータヘッダーの日付(2026-10-21)は、リリースノートの日付(2026-10-20)と一致していません。リリースノートの記載どおりに experimental-claude-tag-2026-10-21 を指定してください。「日付がずれているから」と自己判断で 10-20 に直さないよう注意が必要です。また experimental- の接頭辞が示すとおり、仕様が変更される可能性があります。

影響と対応

既存の API 利用が壊れるような変更(Breaking Change)ではなく、必須の対応はありません。新機能を使いたい場合に、次を確認してください。

推奨アクション

自組織が対象か確認する:Claude Enterprise か、Console(Claude Platform)組織かを確認します。
キーの発行を依頼する:Admin API キーはプライマリオーナーのみが claude.ai で作成できます。
最小権限でスコープを選ぶ:棚卸しや監査だけなら read:claude_tag で十分です。write:claude_tag は変更を自動化する場合に限定しましょう。
まず読み取りから試す:ベータ機能なので、最初は参照系で挙動を確認し、変更系はテスト用チャンネルで試すのが安全です。
ドキュメントを更新する:社内の API / ベータヘッダー一覧に追記しておくと、後から混乱しません。

💡 Tips
Admin API キーは組織設定に関わる強い権限を持ちます。環境変数やシークレット管理サービスで保管し、リポジトリにコミットしないでください。

ユースケース例

設定の棚卸し:全チャンネルの有効な設定と継承元を取得し、意図しない設定を洗い出す。
新規チャンネルの標準化:チャンネル作成時に、標準の設定や Access bundles を自動で適用する。
変更の監査:定期的に設定を取得して差分を記録する(差分管理は利用側で実装)。

コード例

リリースノートで確認できるのは、エンドポイントのベースパス、beta ヘッダー、認証方式です。個別のパスやレスポンス形式は記載がないため、以下はヘッダーの付け方を示す最小限の例です。<...> の部分は公式ドキュメントで確認して置き換えてください。

Before(Claude Tag API 以前)

Slack の Claude Tag の設定は、管理画面から手動で操作していました。

After(Claude Tag API)

# ADMIN_API_KEY: プライマリオーナーが claude.ai で作成したキー
# (read:claude_tag もしくは write:claude_tag スコープ)
curl "https://api.anthropic.com/v1/organizations/claude_tag/<公式ドキュメントのパス>" \
  --header "x-api-key: $ADMIN_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "anthropic-beta: experimental-claude-tag-2026-10-21"

💡 Tips
上記の anthropic-version や x-api-key の指定は、既存の Admin API の一般的な呼び出し方に倣った例です。Claude Tag API 固有の要件は、公式ドキュメントで確認してください。

CLAUDE.md への追記例

Claude Code などで API 周りを扱うプロジェクトでは、次のように記録しておくと便利です。

## Anthropic API / Admin API・ベータヘッダー一覧

### Claude Tag API(ベータ)
- 対象: Claude Enterprise 組織のみ(Claude Platform / Console 組織は対象外)
- beta ヘッダー: experimental-claude-tag-2026-10-21
- エンドポイント: /v1/organizations/claude_tag/
- 機能: Slack チャンネル/ワークスペース単位の設定の読み取りと変更、
  チャンネルで有効な設定と継承元の確認、Access bundles の割り当て
- 認証: プライマリオーナーが claude.ai で作成する Admin API キー
  (read:claude_tag / write:claude_tag スコープ)

まとめ

何が変わった? Claude Enterprise 向けに、Slack の Claude Tag 設定を管理する Claude Tag API がベータ公開されました。
何ができる? チャンネル/ワークスペース設定の読み取り・変更、有効な設定と継承元の確認、Access bundles の割り当てができます。
使うには? プライマリオーナーが claude.ai で作成した Admin API キー(read:claude_tag / write:claude_tag)と、beta ヘッダー experimental-claude-tag-2026-10-21 が必要です。
注意点 Claude Platform(Console)組織では使えません。ベータヘッダーの日付はリリースノートの日付と異なりますが、記載どおりに指定してください。
次の一手 必須対応はありません。まず読み取り専用スコープで、自組織の設定の棚卸しから試すのがおすすめです。