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

> Claude Tag APIはSlack上のClaudeを5設定で制御します。設定継承の解決規則、include_inheritedとsourcesによる有効値監査、Access bundle運用の設計をまとめます。

- Canonical: https://kuucorp.com/blog/claude-tag-api-settings-inheritance-effective-audit-design/
- Date: 2026-10-28
- Last modified: 2026-10-28
- Publisher: Kuu株式会社 (https://kuucorp.com)

---
数百の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_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つあります。

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 — Claude Platform Docs](https://platform.claude.com/docs/en/manage-claude/claude-tag-api)
- [Work with Claude Tag — Claude Docs](https://claude.com/docs/claude-tag/overview)
- [Claude Platform release notes — Claude Platform Docs](https://platform.claude.com/docs/en/release-notes/api)

## まとめ

Claude Tag APIの要点は、5設定の階層解決規則を理解し、`include_inherited=true` と `sources` で有効値と出所を継続監査することです。`enabled` の既定が `true` である点と、`instructions` が加算される点を設計に織り込んでください。マルチチーム・大規模なSlack運用でのClaude統制の設計は、[Kuuの大規模AI変革プログラム（RDE）](https://kuucorp.com/services/rde/)までご相談ください。
