Claude API 推出「使用者檔案」：平台上一個客戶違規，不再拖累整個組織被封

一句話看懂：Anthropic 讓 Claude API 可以替每個終端客戶建立「使用者檔案」，平台上某個客戶違規時，處分只會落在那個客戶身上，不會整個組織一起被封。

先用白話講：為什麼平台業者需要這個？

想像你開了一家補習班，用自己的名義向圖書館辦了一張團體借書證，讓所有學生都能借書。某天有一個學生把書弄壞了，圖書館只看得到借書證上的名字，結果整張團體證被停用，全班一起不能借。

把 Claude 包進自家產品的平台，處境就像這家補習班。所有客戶的請求都用你的組織送出，Anthropic 會用自動化的安全分類器檢查流量，只要某一個客戶觸發處分，就可能影響整個組織。

使用者檔案（user profiles）就像替每位學生各辦一張附屬證：誰出問題，就只停誰的證。

發生什麼事

Anthropic 在 10 月 20 日的 Claude 平台更新日誌宣布：

• 推出 user profiles：平台、閘道或轉售 API 的業者，可以告訴 Anthropic 每個請求是替哪個終端客戶送的，安全處分就能只套用在該客戶
• 組織 webhooks（beta）：在 Admin API 新增，可以收到兩種事件：某個終端客戶被限制或封禁，以及限制解除；需要帶 webhooks-2026-10-07 beta 標頭，並向帳號團隊申請
• 費用：profile 不收費，也不影響價格

該替誰建 profile？

官方特別提醒：profile 屬於組織、不屬於工作區，所以只分工作區不夠，替客戶送的流量和自家內部用量要分在不同組織。

給開發者的技術細節

建立一次、把 ID 存在客戶資料裡，之後每個請求都帶上：

profile = client.user_profiles.create(
    name="範例客戶股份有限公司",
    access_type="passthrough",
    external_user_details={"reference_id": "cust-001", "country": "TW"},
)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
    user_profile_id=profile.id,
)

• 標頭：anthropic-user-profile-id，ID 以 uprof_ 開頭；SDK 參數 user_profile_id、CLI 用 --user-profile-id
• 不具冪等性：每呼叫一次建立就多一份，即使 reference_id 相同；數量沒有上限，但建立有速率限制
• 隱私：所有欄位選填，不能分享姓名或 email 時可只送自己算的雜湊值；profile 不包含對話內容
• 錯誤：ID 格式錯或不屬於你的組織會回 400；Message Batches 例外，建立時只檢查格式，錯的請求事後各自報錯
• 其他平台：Bedrock 與 Google Cloud 沒有建立端點，要在 Claude API 或 Claude Platform on AWS 建好，並先在 portal.anthropic.com 連結帳號
• 刪除：刪除後約 10 分鐘內，帶舊 ID 的請求仍可能成功

我的看法

接案幫客戶做「內建 AI 助手」的系統時，最讓人擔心的情境就是：一個使用者亂用，結果整個平台的 API 被停掉，所有正常客戶一起受害。這個功能正是在解這個問題，對做 SaaS 或代管 AI 服務的團隊非常重要。

我的建議是把它當成註冊流程的一部分：使用者一註冊就建 profile、把 ID 存進資料庫，所有 AI 請求一律帶上。另外，組織 webhooks 能在某個客戶被限制時通知你，最好接上去，讓自己的後台也能同步停用那個帳號，而不是等客戶來抱怨才發現。

名詞小辭典

• 終端客戶（End Customer）：真正使用你產品的人或公司，而不是你自己。
• 轉售（Resell）：把買來的 API 額度包裝後再賣給別人使用。
• 冪等性（Idempotency）：同一個請求送很多次結果都一樣；建立 profile 的 API 沒有這個特性，重送會多建一份。
• Webhook：服務在某件事發生時，主動打一個網址通知你的系統。

資料來源

• Claude Platform Release Notes（2026-10-20）
• Claude Docs：User profiles for end-customer attribution