# Compliance APIで個人指示を棚卸しする設計

> Compliance APIのuser_preferencesは、全メンバーのInstructions for ClaudeとCowork Global instructionsを取得できます。棚卸しと運用設計を解説します。

- Canonical: https://kuucorp.com/blog/claude-compliance-api-user-preferences-personal-instruction-audit-design/
- Date: 2026-11-03
- Last modified: 2026-11-03
- Publisher: Kuu株式会社 (https://kuucorp.com)

---
組織の統制ポリシーを整備しても、社員が claude.ai の個人設定や Cowork のグローバル指示に書いたテキストは、管理者から見えない領域でした。全社テンプレートの外側で、各自が出力形式や行動ルールをエージェントに常時指示している可能性があります。2026年10月15日、Compliance API にこの領域を読み取る `user_preferences` エンドポイントが追加されました（ベータ、Claude Enterprise 向け）。

本記事は[AIエージェントガバナンス](/ai-governance/)のピラーコンテンツと連動しています。同じ Compliance API のローカルセッション監査は[Compliance APIでローカルAIエージェントを監査する](/blog/claude-compliance-api-local-session-visibility-design/)を参照してください。

## user_preferences は何を返すのか

> user_preferences は、全メンバーの個人指示と Cowork のグローバル指示を返すベータ APIです。

エンドポイントは `GET /v1/compliance/organizations/{org_uuid}/user_preferences` です。レスポンスの各行は次の3要素で構成されます。

- `conversation_preferences`: 個人設定の「Instructions for Claude」。未設定・削除済みなら `null`
- `cowork_global_instructions`: Cowork（デスクトップエージェント）の「Global instructions」。未設定なら `null`
- `user`: メンバーの `id` と `email_address`

公式ドキュメントによれば、どちらもアカウント単位の設定で、メンバーが所属する全組織で同じテキストが返ります。複数組織に所属する社員の設定は、組織ごとの別管理にはなりません。

## 取得時に押さえるべき仕様は何か

> 既定では設定済みメンバーのみ返り、limit は最大100件、user_ids は1回10名までです。

- `include_unset=true` を付けると、未設定者も `null` 付きで全員返ります。既定は設定済みのみです。
- `limit` は既定20・最大100です。`page` は不透明トークンとして扱い、中身を解釈しません。
- 1ページが `limit` 未満、または空でも最終ページとは限りません。サーバーが1リクエストの処理量を制限するためです。`next_page` が `null` になるまで辿ります。
- 並び順は組織参加順（古い順）です。`user_ids` で対象を最大10名に絞れます。

空ページで巡回を止める実装は、取得漏れの原因になります。

## 必要な権限とキー管理はどう設計するか

> 読み取りには Compliance Access Key と read:compliance_user_data が必要です。

公式の権限表では、`read:compliance_user_data` が user preferences の読み取りを含みます。Admin API キー（`sk-ant-admin01-`）は Activity Feed しか呼べず、他のエンドポイントは 403 になります。

設計上の要点は3つです。

1. 同じスコープでチャット・ファイル・セッション転写も読めるため、キーは強い権限を持ちます。公式も、本番DB資格情報と同等に扱うよう警告しています。
2. スコープは作成後に変更できません。読み取り専用の棚卸し用キーを別に発行します。
3. 削除権限（`delete:compliance_user_data`）とはキーを分けます。ローテーションは「新規作成→切替→旧キー削除」の順で、猶予期間はありません。

## 取得したテキストをどう棚卸しするか

> 個人指示は組織ポリシーの外側にあるため、日次で取得し、差分とリスク観点で点検します。

取得そのものより、点検ルールの設計が成果を分けます。以下は公式仕様に基づく設計案です。

- **日次スナップショットと差分検知**: ユーザーID単位でテキストのハッシュを保存し、変更時のみ内容を再点検します。
- **点検観点**: 外部URLへの送信指示、承認手順の省略を促す指示、機密区分の取り扱いに反する記述を、ルールとレビューで確認します。
- **本人への是正フロー**: 違反を自動削除する手段はこのAPIにありません。是正は本人への通知と、全社推奨テンプレートの提示で行います。
- **扱う個人データ**: 返るのはメールアドレス付きの本文です。閲覧者、保管期間、監査証跡を事前に決め、社内の労務・プライバシー部門と合意します。

個人指示は社員の私的な好みも含みます。「全文の常時監視」ではなく、リスク観点のルール検知と例外レビューに絞ると、現場の反発も抑えられます。

## 規模別の留意点（SMB / エンタープライズ）

> 大規模組織では、親組織キーと子組織キーのどちらで取得するかが運用負荷を左右します。

親組織の Primary owner が作るキーは配下の全組織を、組織オーナーのキーは自組織のみを対象にします。数千人規模では、棚卸し用キーを親組織スコープで1本に集約する案と、事業部ごとに分ける案を比較してください。前者は運用が軽く、後者は漏洩時の影響範囲を絞れます。小規模なら、ベータ機能の変更に備え、取得スクリプトを薄く保てば十分です。

## 参考

- [List organization members' personal preferences — Claude API Reference](https://platform.claude.com/docs/en/api/compliance/organizations/user_preferences)
- [Set up the Compliance API — Claude Platform Docs](https://platform.claude.com/docs/en/manage-claude/compliance-api-access)
- [Release notes — Claude Platform Docs](https://platform.claude.com/docs/en/release-notes/overview)

## まとめ

user_preferences により、個人指示という統制の盲点を API で棚卸しできるようになりました。スコープ分離したキーで日次取得し、差分とリスク観点で点検する運用が出発点です。ベータ機能のため、仕様変更は公式ドキュメントで継続確認してください。大規模なマルチチーム環境での統制設計は、[Kuuの大規模AI変革プログラム（RDE）](https://kuucorp.com/services/rde/)までご相談ください。
