数百のSlackチャンネルでClaudeを有効化する段階になると、管理画面の手作業では「どのチャンネルで何が効いているか」を説明できなくなります。2026年10月23日にベータ提供が始まったClaude Tag APIは、この設定を自社の承認フローやバージョン管理から操作し、監査するための入口です。本記事は設定の継承規則と、有効値の監査設計に絞って整理します。
Claude Tag APIは何を管理できるのか
Claude Tag APIはClaude Enterprise組織専用で、5種類の設定とAccess bundleの付け外しを14のエンドポイントで扱います。
Claude Tagは、Slackでメンションされたチャンネルのスレッド内でClaudeが作業するサービスです。APIは /v1/organizations/claude_tag/ 配下にあり、ベータヘッダー experimental-claude-tag-2026-10-21 が必要です。ヘッダーが無いリクエストは、エンドポイントが存在しないかのように 404 を返します。
認証にはAdmin APIキーを使います。キーはプライマリオーナーがclaude.aiで作成し、Claude Consoleで作ったキーは使えません。権限は2種類に分かれます。
read:claude_tag: すべてのGETwrite:claude_tag: すべてのPOSTとDELETE。読み取りは含まれない
読み取り専用の監査ジョブと、変更を行う承認フローでキーを分ければ、最小権限を保てます。Claude Platform(Console)組織では使えない点にも注意してください。
APIが扱う設定は次の5つだけです。
| 設定 | 内容 |
|---|---|
enabled | チャンネルでClaude Tagを有効にするか |
instructions | 追加指示。トリム後8,192字以内 |
model | 組織がClaude Tagで使えるモデルID |
environment_id | env_ で始まる有効な環境 |
guest_policy | restrict / channel_only / allow |
Slack workspaceの接続・解除、Bundleの作成と編集、利用上限は対象外で、引き続きclaude.aiで操作します。
設定はどの階層から継承され、どう解決されるのか
設定は最も近い階層が勝ちますが、instructionsだけは全階層の文面が結合されます。未設定時の既定値は enabled が true、guest_policy が restrict です。
階層は近い順に、チャンネル、(コードチャンネルの場合は)親チャンネル、workspace、Slackデフォルトです。解決規則は設定ごとに異なります。
| 設定 | 解決規則 | どの階層にも無い場合 |
|---|---|---|
enabled | 最も近い階層が勝つ | true |
instructions | 全階層を広い順に空行区切りで結合 | null |
model | 最も近い階層が勝つ | null(製品既定) |
environment_id | 最も近い階層が勝つ | null |
guest_policy | 最も近い階層が勝つ | restrict |
設計上の落とし穴が2つあります。
enabledの既定がtrue: 上位階層で何も設定しなければ、Claudeを入れたチャンネルは有効です。「明示的に許可したチャンネルだけ有効」にしたい場合は、Slackデフォルトかworkspaceでenabled: falseを置き、許可するチャンネルだけtrueにします。instructionsは上書きではなく加算: チャンネル側で全社方針を打ち消すことはできません。禁止事項は上位階層に置き、チャンネル側には用途固有の補足だけを書く構成にします。
書き込みの意味論も押さえてください。省略した設定は変更されず、null を送ると設定が消えて再び継承に戻ります。1つでも拒否された値があればリクエスト全体が保存されません。Idempotency-Key は無く、同じ内容の再送は安全で、後勝ちです。重複した変更が走ると 409 が返ります。
有効値と出所をどう監査するのか
include_inherited=trueを付けた GET は、継承後の有効値と、各設定がどの階層に由来するかを示すsourcesを返します。
既定の settings は、そのオブジェクト自身が保存している値を返し、未設定は null です。監査に必要なのは継承後の値なので、GETに include_inherited=true を付けます。このパラメータは作成・更新リクエストでは受け付けられず、400 になります。
sources は設定ごとの由来を返します。種別は slack_channel、slack_workspace、slack_parent_channel、slack_grid_channel(enabled のみ)、slack_default、default(組み込み既定)です。たとえば model の由来が slack_channel なら、そのチャンネル固有の上書きがあると分かります。
監査ジョブは次の流れで組めます。
GET /slack_workspacesで対象workspaceを列挙するGET /slack_channels?slack_workspace_id=…でset-up済みのチャンネルを列挙する(limitは1〜100)- 各チャンネルを
include_inherited=trueで取得し、有効値とsourcesを保存する - 期待値(Git管理のポリシー定義)と差分を取り、
guest_policy: allowやmodelの想定外の上書きを検出する
注意点は2つあります。include_inherited=true は、いずれかの階層が読めないと 503 を返します。その場合は結果を捨て、取得に成功したチャンネルだけで判定しないでください。もう1つは、API/Terraform read-only modeです。このモードはclaude.aiでの人の操作を止めますが、APIの挙動は変えません。キーを持つ主体が変更できる点は変わらないため、キーの保管とスコープ分離が統制の本体です。
Access bundleと障害時の振る舞いをどう設計するのか
Access bundleはコネクタ・リポジトリ・認証情報の名前付きセットで、APIではBundleの参照と、チャンネルまたはworkspaceへの付け外しだけができます。
BundleはAPIから一覧と参照ができ、返るのは名前と説明のみで、何を許可するかの中身は見えません。workspaceに付ければ配下の全チャンネルに、チャンネルに付ければそのチャンネルだけに適用されます。付け外しは設定値を変えませんが、実行中のセッションにはアクセス変更が通知されます。また、同じ組み合わせの再付与は 200 で既存のターゲットを返します。オンコール管理のBundleはAPIから付け外しできず、400 になります。
運用で効くのは、次の振る舞いです。
- チャンネル削除は不可逆:
DELETEは保存設定、Bundleターゲット、実行中を含むセッションとトランスクリプト、メモリ、ルーチン、アーティファクトを消します。enabledがtrueに解決されるチャンネルはslack_channel_enabledで拒否されるため、先に無効化が必要です。 - 削除してもClaudeは締め出せない: 継承でClaudeが有効になる場合、次のメンションで新しい
idのまま再set-upされます。締め出しには上位階層のenabled: falseが要ります。 guest_policyの変更は実行中セッションを終了させる場合がある: 業務時間帯の一括変更は避けます。- setup系の
500/503は結果が不明: set-upされたかどうかが分からないため、同じリクエストを再送します(再送は安全です)。
これらから、変更系の自動化には「変更前の有効値スナップショット保存 → 変更 → 再取得して差分確認」の3段階を入れておくと、事後説明が容易になります。
規模別の運用論点
数百チャンネル規模では、設定をGitで宣言管理し、APIは差分適用と監査にのみ使う構成が、手作業の見落としを最小にします。
エンタープライズ規模では次の運用を勧めます。
- 宣言と適用の分離: 望ましい設定をリポジトリで管理し、承認後にCIが
POSTで適用する。適用後に必ずinclude_inherited=trueで再取得し、乖離を検出する - キーの分離: 読み取り専用キー(
read:claude_tag)を監査基盤に、書き込みキーを承認済みパイプラインにだけ渡す。キーは組織に属し、作成者が退職しても有効なので、保管先とローテーション手順を決めておく - 対象外の範囲の明記: 利用上限、Bundleの作成・編集、Slackデフォルトの変更はAPIにない。これらの変更はclaude.ai側の権限管理と運用手順で別途統制する
- ベータの扱い: ベータヘッダー付きのAPIであり、仕様変更に備えて呼び出しをクライアントのラッパーに閉じる
SMBでは、まず単一のworkspaceで enabled と guest_policy の2設定だけをチャンネル単位で管理し、有効値の確認を月次で行う程度から始めれば十分です。
参考
- Claude Tag API — Claude Platform Docs
- Work with Claude Tag — Claude Docs
- Claude Platform release notes — Claude Platform Docs
まとめ
Claude Tag APIの要点は、5設定の階層解決規則を理解し、include_inherited=true と sources で有効値と出所を継続監査することです。enabled の既定が true である点と、instructions が加算される点を設計に織り込んでください。マルチチーム・大規模なSlack運用でのClaude統制の設計は、Kuuの大規模AI変革プログラム(RDE)までご相談ください。
