はじめに
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)組織では使えません。ベータヘッダーの日付はリリースノートの日付と異なりますが、記載どおりに指定してください。
- 次の一手 必須対応はありません。まず読み取り専用スコープで、自組織の設定の棚卸しから試すのがおすすめです。