組織の統制ポリシーを整備しても、社員が claude.ai の個人設定や Cowork のグローバル指示に書いたテキストは、管理者から見えない領域でした。全社テンプレートの外側で、各自が出力形式や行動ルールをエージェントに常時指示している可能性があります。2026年10月15日、Compliance API にこの領域を読み取る user_preferences エンドポイントが追加されました(ベータ、Claude Enterprise 向け)。
本記事はAIエージェントガバナンスのピラーコンテンツと連動しています。同じ Compliance API のローカルセッション監査はCompliance APIでローカルAIエージェントを監査するを参照してください。
user_preferences は何を返すのか
user_preferences は、全メンバーの個人指示と Cowork のグローバル指示を返すベータ APIです。
エンドポイントは GET /v1/compliance/organizations/{org_uuid}/user_preferences です。レスポンスの各行は次の3要素で構成されます。
conversation_preferences: 個人設定の「Instructions for Claude」。未設定・削除済みならnullcowork_global_instructions: Cowork(デスクトップエージェント)の「Global instructions」。未設定ならnulluser: メンバーの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つです。
- 同じスコープでチャット・ファイル・セッション転写も読めるため、キーは強い権限を持ちます。公式も、本番DB資格情報と同等に扱うよう警告しています。
- スコープは作成後に変更できません。読み取り専用の棚卸し用キーを別に発行します。
- 削除権限(
delete:compliance_user_data)とはキーを分けます。ローテーションは「新規作成→切替→旧キー削除」の順で、猶予期間はありません。
取得したテキストをどう棚卸しするか
個人指示は組織ポリシーの外側にあるため、日次で取得し、差分とリスク観点で点検します。
取得そのものより、点検ルールの設計が成果を分けます。以下は公式仕様に基づく設計案です。
- 日次スナップショットと差分検知: ユーザーID単位でテキストのハッシュを保存し、変更時のみ内容を再点検します。
- 点検観点: 外部URLへの送信指示、承認手順の省略を促す指示、機密区分の取り扱いに反する記述を、ルールとレビューで確認します。
- 本人への是正フロー: 違反を自動削除する手段はこのAPIにありません。是正は本人への通知と、全社推奨テンプレートの提示で行います。
- 扱う個人データ: 返るのはメールアドレス付きの本文です。閲覧者、保管期間、監査証跡を事前に決め、社内の労務・プライバシー部門と合意します。
個人指示は社員の私的な好みも含みます。「全文の常時監視」ではなく、リスク観点のルール検知と例外レビューに絞ると、現場の反発も抑えられます。
規模別の留意点(SMB / エンタープライズ)
大規模組織では、親組織キーと子組織キーのどちらで取得するかが運用負荷を左右します。
親組織の Primary owner が作るキーは配下の全組織を、組織オーナーのキーは自組織のみを対象にします。数千人規模では、棚卸し用キーを親組織スコープで1本に集約する案と、事業部ごとに分ける案を比較してください。前者は運用が軽く、後者は漏洩時の影響範囲を絞れます。小規模なら、ベータ機能の変更に備え、取得スクリプトを薄く保てば十分です。
参考
- List organization members' personal preferences — Claude API Reference
- Set up the Compliance API — Claude Platform Docs
- Release notes — Claude Platform Docs
まとめ
user_preferences により、個人指示という統制の盲点を API で棚卸しできるようになりました。スコープ分離したキーで日次取得し、差分とリスク観点で点検する運用が出発点です。ベータ機能のため、仕様変更は公式ドキュメントで継続確認してください。大規模なマルチチーム環境での統制設計は、Kuuの大規模AI変革プログラム(RDE)までご相談ください。
