TOPIC COLLECTION
Claude Enterprise合规API新接口：怎么批量导出员工的Instructions与Cowork全局指令
2026-10-15起，Claude Enterprise Compliance API新增beta端点GET .../user_preferences，返回成员在claude.ai保存的Instructions for Claude与Cowork Global instructions；需Compliance Access Key的read:compliance_user_data权限。
资料更新：2026-10-19
依据Anthropic平台文档Compliance organizations / Compliance API及2026-10-15发布说明。本站未在真实Enterprise租户实测。核查2026-10-19（新加坡时间）。
主题标签：Claude、Compliance API、Enterprise、用户指令、合规
企业里用Claude久了，安全和法律总会问一句：员工给AI写了哪些「常驻指令」？以前要靠人肉点进设置看，现在Compliance API多了一个beta接口，可以直接拉。
按Anthropic平台发布说明，2026-10-15起，Claude Enterprise的Compliance API新增（beta）端点：GET /v1/compliance/organizations/{org_uuid}/user_preferences。它返回组织成员保存在claude.ai里的Instructions for Claude，以及Cowork里的Global instructions。
这篇文章按官方文档梳理：返回什么、要什么权限、怎么分页、落地时要注意隐私与误读。
它到底读的是什么
字段有两个：
conversation_preferences：用户在claude.ai保存的「Instructions for Claude」正文；cowork_global_instructions：Cowork里的全局指令正文。
官方强调：这两项是账号级设置。一个人同时属于多个组织时，同一段文字会在每个组织的查询结果里重复出现。做审计报表时，按用户ID去重，别按「组织×用户」当成多套指令。
默认只返回「至少设过其中一项」的成员。要全员清单（含未设置），加include_unset=true，未设置字段为null。也可以用user_ids[]最多指定10个用户做抽查。
权限：别拿错钥匙
这个端点要的是Compliance Access Key上的read:compliance_user_data，不是read:compliance_org_data。只有组织数据权限、没有用户数据权限，会直接403。
钥匙本身必须是在claude.ai创建的Compliance Access Key（文档示例形态sk-ant-api01-...）。Claude Console里的Admin API Key只能打Activity Feed一类接口，拿去调user_preferences会403。
调用时记得带anthropic-version头，例如2023-06-01，和现有Compliance API一致。
分页坑比看起来深
limit默认20、最大100。翻页靠next_page令牌：下一请求把上次的next_page原样放进page参数。
三个容易踩的点：
- 某一页结果数可以少于limit，甚至为空，但仍可能不是最后一页——必须看到
next_page为null才停； - 从第二页起，
include_unset和user_ids[]必须和第一页相同，否则400； - 用户列表接口和偏好接口的用户ID是同一套
user_...格式，可以和Activity Feed、会话导出对齐。
示例（占位符，勿把真实密钥写进仓库）：
curl --fail-with-body -sS
"https://api.anthropic.com/v1/compliance/organizations/$ORG_UUID/user_preferences"
-H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"
-H "anthropic-version: 2023-06-01"合规团队通常拿它干什么
策略对齐。公司规定「不得在指令里贴客户名单、密钥、未公开财报」。接口能批量扫出谁的常驻指令违规，比抽查对话快。
入职/离职。新人是否按模板写入安全提示；离职账号移除后，该用户不会再出现在当前成员列表里，但历史活动仍可在Activity Feed保留期内查到。
和会话导出分工。Compliance API本来就能拉聊天、文件、Claude Code/Cowork会话记录。user_preferences补的是「每次对话默认生效」的那一层，不是单次prompt。
若你们已经在用OpenTelemetry看Claude调用，那是实时遥测；Compliance API是按需拉取保留内容。站内相关：Claude平台OpenTelemetry追踪。
隐私和治理上要先想清楚
指令文本经常包含：岗位背景、写作口吻、内部项目代号、甚至半加密的操作习惯。批量导出前建议：
- 更新隐私告知与员工手册，写明企业版可审计账号级指令；
- 最小权限：只给安全/法务的合规钥匙开
read:compliance_user_data，别开给普通开发Admin Key； - 落盘加密、访问留痕，导出任务进工单，而不是工程师笔记本里随手curl；
- beta接口：字段和错误行为仍可能变，脚本要能容忍schema微调。
本站未在真实Enterprise租户上实测该端点，上文依据官方文档与发布说明整理。
和「企业里落地Claude」其他步骤的关系
开Compliance API通常还有：Activity Feed接入SIEM、会话/文件保留策略、IP允许列表、SSO。user_preferences是目录与内容能力里较新的一块，适合在已有合规管道跑通之后再加。
采购与区域布局可参考Anthropic新加坡办公室。更多开发向工具见AI开发分类、AI编程分类；对话类入口见Claude与Claude开发者平台。
常见疑问
Team套餐能用吗？发布说明写的是Claude Enterprise组织。Team是否开放以账号后台与合同为准。
能改或删除别人的指令吗？该端点是读。修改仍在用户自己的设置里完成；内容处置走其他删除/保留接口与流程。
Admin Key加个scope行不行？文档写明Admin Key达不到这些目录/用户端点，需要Compliance Access Key。
来源与核查日期
- Anthropic文档：Compliance organizations / List user preferences
- Anthropic文档：Compliance API概述
- Claude Platform发布说明：user_preferences（2026-10-15）
核查日期：2026-10-19（新加坡时间）。接口为beta，以Anthropic当前文档为准。
