管理與監控

工作區

使用工作區來組織 API 金鑰、管理團隊存取權限並控制成本。

工作區提供了一種在組織內組織 API 使用的方式。使用工作區來分隔不同的專案、環境或團隊，同時維持集中化的帳單和管理。

工作區如何運作

每個組織都有一個預設工作區，無法重新命名、封存或刪除。當您建立額外的工作區時，您可以為每個工作區指派 API 金鑰、成員和資源限制。

主要特性：

工作區識別碼使用 wrkspc_ 前綴（例如 wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ）
每個組織最多 100 個工作區（已封存的工作區不計入）
預設工作區沒有 ID，且不會出現在列表端點中
API 金鑰限定於單一工作區，只能存取該工作區內的資源

工作區角色與權限

成員可以在每個工作區中擁有不同的角色，實現細緻的存取控制。

角色	權限
Workspace User	僅使用 Workbench
Workspace Developer	建立和管理 API 金鑰、使用 API
Workspace Admin	完全控制工作區設定和成員
Workspace Billing	檢視工作區帳單資訊（從組織帳單角色繼承）

角色繼承

組織管理員自動獲得所有工作區的 Workspace Admin 存取權限
組織帳單成員自動獲得所有工作區的 Workspace Billing 存取權限
組織使用者和開發者必須被明確新增到每個工作區

Workspace Billing 角色無法手動指派。它是從擁有組織帳單角色繼承而來的。

管理工作區

只有組織管理員可以建立工作區。組織使用者和開發者必須由管理員新增到工作區。

透過主控台

在 Claude 主控台中建立和管理工作區。

建立工作區

開啟工作區設定
在 Claude 主控台中，前往設定 > 工作區。
新增工作區
點擊新增工作區。
設定工作區
輸入工作區名稱並選擇一個顏色以便視覺識別。
建立工作區
點擊建立以完成。

要在主控台中切換工作區，請使用左上角的工作區選擇器。

編輯工作區詳細資訊

要修改工作區的名稱或顏色：

從列表中選擇工作區
點擊省略號選單（...）並選擇編輯詳細資訊
更新名稱或顏色並儲存變更

預設工作區無法重新命名或刪除。

將成員新增到工作區

導覽至工作區的成員標籤
點擊新增到工作區
選擇一個組織成員並指派工作區角色
確認新增

要移除成員，請點擊其名稱旁邊的垃圾桶圖示。

組織管理員和帳單成員在持有這些組織角色期間無法從工作區中移除。

設定工作區限制

在限制標籤中，您可以設定：

速率限制：按模型層級設定每分鐘請求數、輸入 token 數或輸出 token 數的限制
支出通知：設定當支出達到特定閾值時的警報

封存工作區

要封存工作區，請點擊省略號選單（...）並選擇封存。封存會：

保留歷史資料以供報告使用
停用工作區及所有相關的 API 金鑰
無法復原

封存工作區會立即撤銷該工作區中的所有 API 金鑰。此操作無法復原。

透過 Admin API

使用 Admin API 以程式化方式管理工作區。

Admin API 端點需要 Admin API 金鑰（以 sk-ant-admin... 開頭），與標準 API 金鑰不同。只有擁有管理員角色的組織成員才能透過 Claude 主控台佈建 Admin API 金鑰。

# 建立工作區
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# 列出工作區
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 封存工作區
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

如需完整的參數詳細資訊和回應結構描述，請參閱工作區 API 參考。

管理工作區成員

新增、更新或從工作區移除成員：

# 將成員新增到工作區
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# 更新成員的角色
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# 從工作區移除成員
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

如需完整的參數詳細資訊，請參閱工作區成員 API 參考。

API 金鑰與資源範圍

API 金鑰限定於特定工作區。當您在工作區中建立 API 金鑰時，它只能存取該工作區內的資源。

限定於工作區的資源包括：

透過 Files API 建立的檔案
透過 Batch API 建立的訊息批次
透過 Skills API 建立的技能

自 2026 年 2 月 5 日起，提示快取也將按工作區隔離（僅適用於 Claude API 和 Azure）。

要擷取您組織的工作區 ID，請使用列出工作區端點，或在 Claude 主控台中查找。

工作區限制

您可以為每個工作區設定自訂的支出和速率限制，以防止過度使用並確保公平的資源分配。

設定工作區限制

工作區限制可以設定為低於（但不能高於）您組織的限制：

支出限制：為工作區設定每月支出上限
速率限制：限制每分鐘請求數、每分鐘輸入 token 數或每分鐘輸出 token 數

您無法在預設工作區上設定限制
如果未設定，工作區限制將與組織的限制相同
組織範圍的限制始終適用，即使工作區限制的總和超過組織限制

如需速率限制及其運作方式的詳細資訊，請參閱速率限制。

使用量與成本追蹤

使用使用量與成本 API 按工作區追蹤使用量和成本：

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

歸屬於預設工作區的使用量和成本，其 workspace_id 值為 null。

常見使用案例

環境分離

為開發、預備和生產環境建立獨立的工作區：

工作區	用途
Development	使用較低速率限制進行測試和實驗
Staging	使用類似生產環境的限制進行預生產測試
Production	使用完整速率限制和監控處理正式流量

團隊或部門隔離

將工作區指派給不同的團隊以進行成本分配和存取控制：

工程團隊擁有開發者存取權限
資料科學團隊擁有自己的 API 金鑰
支援團隊擁有有限的存取權限以使用客戶工具

基於專案的組織

為特定專案或產品建立工作區，以分別追蹤使用量和成本。

最佳實踐

規劃您的工作區結構
在建立工作區之前，考慮如何組織它們。思考帳單、存取控制和使用量追蹤的需求。
使用有意義的名稱
清楚地命名工作區以表明其用途（例如「Production - Customer Chatbot」、「Dev - Internal Tools」）。
設定適當的限制
設定支出和速率限制以防止意外成本並確保公平的資源分配。
定期稽核存取權限
定期檢視工作區成員資格，確保只有適當的使用者擁有存取權限。
監控使用量
使用使用量與成本 API 追蹤工作區層級的消耗量。

常見問題

另請參閱

Was this page helpful?

管理與監控

工作區

使用工作區來組織 API 金鑰、管理團隊存取權限並控制成本。

工作區提供了一種在組織內組織 API 使用的方式。使用工作區來分隔不同的專案、環境或團隊，同時維持集中化的帳單和管理。

工作區如何運作

每個組織都有一個預設工作區，無法重新命名、封存或刪除。當您建立額外的工作區時，您可以為每個工作區指派 API 金鑰、成員和資源限制。

主要特性：

工作區識別碼使用 wrkspc_ 前綴（例如 wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ）
每個組織最多 100 個工作區（已封存的工作區不計入）
預設工作區沒有 ID，且不會出現在列表端點中
API 金鑰限定於單一工作區，只能存取該工作區內的資源

工作區角色與權限

成員可以在每個工作區中擁有不同的角色，實現細緻的存取控制。

角色	權限
Workspace User	僅使用 Workbench
Workspace Developer	建立和管理 API 金鑰、使用 API
Workspace Admin	完全控制工作區設定和成員
Workspace Billing	檢視工作區帳單資訊（從組織帳單角色繼承）

角色繼承

組織管理員自動獲得所有工作區的 Workspace Admin 存取權限
組織帳單成員自動獲得所有工作區的 Workspace Billing 存取權限
組織使用者和開發者必須被明確新增到每個工作區

Workspace Billing 角色無法手動指派。它是從擁有組織帳單角色繼承而來的。

管理工作區

只有組織管理員可以建立工作區。組織使用者和開發者必須由管理員新增到工作區。

透過主控台

在 Claude 主控台中建立和管理工作區。

建立工作區

開啟工作區設定
在 Claude 主控台中，前往設定 > 工作區。
新增工作區
點擊新增工作區。
設定工作區
輸入工作區名稱並選擇一個顏色以便視覺識別。
建立工作區
點擊建立以完成。

要在主控台中切換工作區，請使用左上角的工作區選擇器。

編輯工作區詳細資訊

要修改工作區的名稱或顏色：

從列表中選擇工作區
點擊省略號選單（...）並選擇編輯詳細資訊
更新名稱或顏色並儲存變更

預設工作區無法重新命名或刪除。

將成員新增到工作區

導覽至工作區的成員標籤
點擊新增到工作區
選擇一個組織成員並指派工作區角色
確認新增

要移除成員，請點擊其名稱旁邊的垃圾桶圖示。

組織管理員和帳單成員在持有這些組織角色期間無法從工作區中移除。

設定工作區限制

在限制標籤中，您可以設定：

速率限制：按模型層級設定每分鐘請求數、輸入 token 數或輸出 token 數的限制
支出通知：設定當支出達到特定閾值時的警報

封存工作區

要封存工作區，請點擊省略號選單（...）並選擇封存。封存會：

保留歷史資料以供報告使用
停用工作區及所有相關的 API 金鑰
無法復原

封存工作區會立即撤銷該工作區中的所有 API 金鑰。此操作無法復原。

透過 Admin API

使用 Admin API 以程式化方式管理工作區。

# 建立工作區
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# 列出工作區
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# 封存工作區
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

如需完整的參數詳細資訊和回應結構描述，請參閱工作區 API 參考。

管理工作區成員

新增、更新或從工作區移除成員：

# 將成員新增到工作區
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# 更新成員的角色
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# 從工作區移除成員
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

如需完整的參數詳細資訊，請參閱工作區成員 API 參考。

API 金鑰與資源範圍

API 金鑰限定於特定工作區。當您在工作區中建立 API 金鑰時，它只能存取該工作區內的資源。

限定於工作區的資源包括：

透過 Files API 建立的檔案
透過 Batch API 建立的訊息批次
透過 Skills API 建立的技能

自 2026 年 2 月 5 日起，提示快取也將按工作區隔離（僅適用於 Claude API 和 Azure）。

要擷取您組織的工作區 ID，請使用列出工作區端點，或在 Claude 主控台中查找。

工作區限制

您可以為每個工作區設定自訂的支出和速率限制，以防止過度使用並確保公平的資源分配。

設定工作區限制

工作區限制可以設定為低於（但不能高於）您組織的限制：

支出限制：為工作區設定每月支出上限
速率限制：限制每分鐘請求數、每分鐘輸入 token 數或每分鐘輸出 token 數

您無法在預設工作區上設定限制
如果未設定，工作區限制將與組織的限制相同
組織範圍的限制始終適用，即使工作區限制的總和超過組織限制

如需速率限制及其運作方式的詳細資訊，請參閱速率限制。

使用量與成本追蹤

使用使用量與成本 API 按工作區追蹤使用量和成本：

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

歸屬於預設工作區的使用量和成本，其 workspace_id 值為 null。

常見使用案例

環境分離

為開發、預備和生產環境建立獨立的工作區：

工作區	用途
Development	使用較低速率限制進行測試和實驗
Staging	使用類似生產環境的限制進行預生產測試
Production	使用完整速率限制和監控處理正式流量

團隊或部門隔離

將工作區指派給不同的團隊以進行成本分配和存取控制：

工程團隊擁有開發者存取權限
資料科學團隊擁有自己的 API 金鑰
支援團隊擁有有限的存取權限以使用客戶工具

基於專案的組織

為特定專案或產品建立工作區，以分別追蹤使用量和成本。

最佳實踐

規劃您的工作區結構
在建立工作區之前，考慮如何組織它們。思考帳單、存取控制和使用量追蹤的需求。
使用有意義的名稱
清楚地命名工作區以表明其用途（例如「Production - Customer Chatbot」、「Dev - Internal Tools」）。
設定適當的限制
設定支出和速率限制以防止意外成本並確保公平的資源分配。
定期稽核存取權限
定期檢視工作區成員資格，確保只有適當的使用者擁有存取權限。
監控使用量
使用使用量與成本 API 追蹤工作區層級的消耗量。

常見問題

另請參閱

Was this page helpful?

工作區如何運作

工作區角色與權限

角色繼承

管理工作區

透過主控台

建立工作區

編輯工作區詳細資訊

將成員新增到工作區

設定工作區限制

封存工作區

透過 Admin API

管理工作區成員

API 金鑰與資源範圍

工作區限制

設定工作區限制

使用量與成本追蹤

常見使用案例

環境分離

團隊或部門隔離

基於專案的組織

最佳實踐

常見問題

什麼是預設工作區？

工作區有數量限制嗎？

組織角色如何影響工作區存取權限？

工作區中可以指派哪些角色？

組織管理員或帳單成員的工作區角色可以變更嗎？

組織角色變更時，工作區存取權限會發生什麼？

當使用者從工作區移除時，API 金鑰會怎樣？

另請參閱

工作區如何運作

工作區角色與權限

角色繼承

管理工作區

透過主控台

建立工作區

編輯工作區詳細資訊

將成員新增到工作區

設定工作區限制

封存工作區

透過 Admin API

管理工作區成員

API 金鑰與資源範圍

工作區限制

設定工作區限制

使用量與成本追蹤

常見使用案例

環境分離

團隊或部門隔離

基於專案的組織

最佳實踐

常見問題

什麼是預設工作區？

工作區有數量限制嗎？

組織角色如何影響工作區存取權限？

工作區中可以指派哪些角色？

組織管理員或帳單成員的工作區角色可以變更嗎？

組織角色變更時，工作區存取權限會發生什麼？

當使用者從工作區移除時，API 金鑰會怎樣？

另請參閱