Anthropic의 릴리스 노트에서 User Profiles(/v1/user_profiles)가 출시되었습니다. 이 기능은 API 요청마다 '어떤 최종 고객을 위한 요청인지'를 Anthropic에 전달할 수 있게 하여, 안전성 관련 조치(Enforcement)를
조직 전체가 아닌, 해당 최종 고객 1인에게만 적용할 수 있도록 합니다.
아울러 Admin API에 **organization webhooks (베타)**이 추가되어 user profile이 제한되거나 BAN된 것을 자동으로 감지할 수 있게 되었습니다.
또한, Managed Agents의 web_search 도구가 조직의 도메인 제한을 따르게 되는 등, 놓치면 동작 방식이 달라지는 변경 사항도 있습니다.
📌 영향을 받는 사람
- 자체 플랫폼/게이트웨이 상에서 여러 최종 고객에게 Claude를 제공하는 사업자
- Claude API에 접근하여 재판매하는 사업자
- Claude Managed Agents에서
web_search를 사용하는 개발자
기존에는 1명의 최종 고객이 이용 약관을 위반할 경우, 그 영향이 API 키 소유자인 조직 전체에 미칠 위험이 있었습니다. User Profiles를 사용하면 조치의 범위를 위반한 본인에게만 한정할 수 있습니다.
조치 알림은 Webhook으로 받을 수 있습니다.
| ID | 변경 | 중요도 | 요 대응 |
|---|
| change-001 | User Profiles(/v1/user_profiles) 출시 | 🔴 high | 있음 |
| change-002 | Admin API에 조직 Webhook 추가 (베타) | 🟡 medium | 없음 |
| change-003 | Managed Agents의 web_search가 조직의 도메인 제한을 따름 | 🟡 medium | 있음 |
| change-004 | scheduled deployments 설명서 정비 (AWS) | ⚪ low | 없음 |
| change-005 | OpenTelemetry 내보내기 설명문 수정 | ⚪ low | 없음 |
이 기능은 플랫폼이나 게이트웨이를 운영하는 사업자, API 접근을 재판매하는 사업자를 위한 것입니다.
- 요청마다 최종 고객을 Anthropic에 전달할 수 있음
- 안전성 조치의 대상을 해당 최종 고객 1인으로 한정할 수 있음
- Claude SDK와 ant CLI가 새로운
/v1/user_profiles 엔드포인트에 대응 완료
💡 Tips
주요 목적은 '위반한 1명 때문에 전체 고객의 서비스가 중단되는' 위험을 줄이는 것입니다. 멀티테넌트 구성이라면, 고객별로 user profile을 할당하는 설계를 검토해 보세요.
| 항목 | 내용 |
|---|
| 엔드포인트 | /v1/organizations/webhooks (알림처 등록) |
| 베타 헤더 | webhooks-2026-10-07 |
| 이벤트 1 | Anthropic이 조직의 user profile을 제한하거나 BAN했을 때 |
| 이벤트 2 | 그 제한이나 BAN이 종료되었을 때 |
| 이용 시작 | Anthropic 계정 팀에 연락(접근 신청) 필요 |
User Profiles와 결합하여 최종 고객 단위의 조치를 자동으로 감지 및 처리하는 용도를 상정하고 있습니다.
⚠️ 주의사항
베타 기능입니다. 헤더만 추가한다고 사용할 수 없으며, 접근 신청이 필요합니다.
Claude Console에서 설정한 조직의 Web 검색 도메인 제한을 web_search 도구가 따르게 되었습니다 (2026년 10월 15일자 릴리스 노트에 추가).
- 두 가지 조건을 모두 충족한 결과만 에이전트에게 전달됩니다 (AND 조건)
- 그 결과, 검색 결과가 이전보다 좁혀질 가능성이 있습니다.
- 조직의 'Allow web search' 설정은 세션이 10월 6일부터 이미 따르고 있습니다.
⚠️ 동작 변경
에이전트가 이전에는 가져올 수 있었던 도메인 정보를 가져오지 못할 수 있습니다. '검색 결과가 줄었다', '특정 사이트를 불러올 수 없다'는 증상이 나타나면, 조직 설정을 확인해 주세요.
⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
scheduled deployments (Claude Platform on AWS): 기존 항목의 문장 끝에 마침표가 추가되었을 뿐, 기능 변경은 없습니다. -
OpenTelemetry Export (베타): 'observability backend'이 'observability platform'으로 용어가 바뀌었을 뿐입니다. 스팬 출력 지원 언어(Python, TypeScript, C#, Go, Java, PHP, Ruby)나 Claude Console에서 전송 대상을 추가하는 절차도 변하지 않습니다.
| 대상 | 조치 필요 사항의 예시 |
|---|
| 멀티테넌트/게이트웨이/재판매 사업자 | /v1/user_profiles로 최종 고객을 등록하고 요청에 연결합니다. SDK 및 ant CLI는 대응 완료했습니다. |
| 조치를 자동 처리하고 싶은 사업자 | 계정 팀에 연락하여 webhooks-2026-10-07 베타 사용을 신청합니다. |
Managed Agents + web_search 이용자 | Claude Console의 조직 도메인 제한과 툴 측의 allowed_domains / blocked_domains를 확인합니다. |
| 상기 외 | 특별한 조치는 없습니다. |
팀에서 Claude Code를 사용하는 경우, 다음과 같은 내용을 추가해 두면 편리합니다.
- API / 멀티테넌트 운영: 멀티테넌트 구성에서는
/v1/user_profiles로 최종 고객을 등록하고 요청에 연결해야 합니다 (안전 조치 영향 범위를 고객 단위로 한정하기 위함). SDK와 ant CLI는 대응 완료했습니다. -
- Admin API / 베타 헤더:
webhooks-2026-10-07를 목록에 추가합니다. /v1/organizations/webhooks의 두 가지 종류의 이벤트와, 접근 신청을 위해 계정 팀에 연락해야 한다는 점을 기재합니다. -
- Managed Agents / 툴 설정:
web_search 결과는 조직의 도메인 제한과 툴의 allowed_domains / blocked_domains의 AND 조건입니다. 10월 6일 이후부터 세션은 조직의 'Allow web search' 설정에 따릅니다.
릴리스 노트 범위에서는 user profile 생성 요청의 스키마나 요청 연결 방법의 상세 내용은 제시되지 않았습니다. 아래는 확정된 정보만을 보여주는 설정 예시입니다. 파라미터명 등은 반드시 공식 문서를 확인해 주십시오.
anthropic-beta: webhooks-2026-10-07
대상 엔드포인트는 /v1/organizations/webhooks입니다. 요청 본문의 필드는 릴리스 노트에 기재되어 있지 않으므로, 공식 문서를 참조해 주십시오.
# Before: 툴 측 지정만으로 결과가 결정됨
결과 = 툴의 allowed_domains / blocked_domains를 만족하는 것
# After: 조직 제한도 추가됨
...
💡 Tips
툴 측에서 allowed_domains에 추가하더라도, 조직 제한으로 허용되지 않은 도메인의 결과는 반환되지 않습니다. 먼저 Console 쪽 설정을 확인하는 것이 가장 빠릅니다.
- User Profiles: 최종 고객 단위로 안전 조치를 적용할 수 있어, 한 명의 위반이 조직 전체로 확산될 위험을 줄일 수 있습니다. 멀티테넌트/재판매 사업자는 도입을 검토할 가치가 높습니다. -
조직 Webhook (베타): webhooks-2026-10-07 헤더가 필요하며, 계정 팀에 연락하여 접근 신청이 전제됩니다. user profile의 제한/BAN 및 그 해제를 자동 감지할 수 있습니다. -
: 조직 설정과 툴 설정의 AND 조건이 되어 검색 결과가 좁혀질 수 있습니다. 해당되는 경우 설정을 확인해야 합니다. web_search의 도메인 제한 - OpenTelemetry 문구 수정 및 AWS scheduled deployments 마침표 추가: 기능 변경은 없으며, 대응할 필요는 없습니다.
특히 여러 최종 고객에게 서비스를 제공하는 분들은, 먼저 User Profiles 도입 가능 여부를 검토하고, 필요하다면 Webhook 접근 신청도 진행해 두시면 안심입니다.
