約 5 分で読めます

Claude Tag API設定継承と有効値の監査設計

数百の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: すべての GET
  • write:claude_tag: すべての POST と DELETE。読み取りは含まれない

読み取り専用の監査ジョブと、変更を行う承認フローでキーを分ければ、最小権限を保てます。Claude Platform(Console)組織では使えない点にも注意してください。

APIが扱う設定は次の5つだけです。

設定内容
enabledチャンネルでClaude Tagを有効にするか
instructions追加指示。トリム後8,192字以内
model組織がClaude Tagで使えるモデルID
environment_idenv_ で始まる有効な環境
guest_policyrestrict / 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つあります。

  1. enabled の既定が true: 上位階層で何も設定しなければ、Claudeを入れたチャンネルは有効です。「明示的に許可したチャンネルだけ有効」にしたい場合は、Slackデフォルトかworkspaceで enabled: false を置き、許可するチャンネルだけ true にします。
  2. 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 なら、そのチャンネル固有の上書きがあると分かります。

監査ジョブは次の流れで組めます。

  1. GET /slack_workspaces で対象workspaceを列挙する
  2. GET /slack_channels?slack_workspace_id=… でset-up済みのチャンネルを列挙する(limit は1〜100)
  3. 各チャンネルを include_inherited=true で取得し、有効値と sources を保存する
  4. 期待値(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の要点は、5設定の階層解決規則を理解し、include_inherited=true と sources で有効値と出所を継続監査することです。enabled の既定が true である点と、instructions が加算される点を設計に織り込んでください。マルチチーム・大規模なSlack運用でのClaude統制の設計は、Kuuの大規模AI変革プログラム(RDE)までご相談ください。

関連記事

Security posture逸脱をSIEMで検知する設計Claude全端末サインアウトAPIが止める範囲と残す範囲Compliance APIで個人指示を棚卸しする設計Claude Admin APIでメンバーのライフサイクルを自動化する