工作區

管理

工作區

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

工作區提供了一種在組織內組織 API 使用情況的方式。使用工作區可以分離不同的專案、環境或團隊，同時保持集中計費和管理。

工作區如何運作

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

主要特性：

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

工作區角色和權限

成員可以在每個工作區中擁有不同的角色，允許進行細粒度的存取控制。

角色	權限
工作區使用者	僅使用 Anthropic Workbench
工作區有限開發者	建立和管理 API 金鑰、使用 API。無法存取工作階段追蹤檢視或下載檔案。
工作區開發者	建立和管理 API 金鑰、使用 API
工作區管理員	對工作區設定和成員的完全控制
工作區計費	檢視工作區計費資訊（繼承自組織計費角色）

角色繼承

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

工作區計費角色無法手動分配。它是從擁有組織計費角色繼承而來的。

管理工作區

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

透過 Claude Console

在 Claude Console 中建立和管理工作區。

建立工作區

開啟工作區設定
在 Claude Console 中，前往設定 > 工作區。
建立工作區
點擊建立工作區。
設定工作區
輸入工作區名稱並選擇顏色以進行視覺識別。
建立工作區
點擊建立以完成。

若要在 Console 中的工作區之間切換，請使用左上角的工作區選擇器。

編輯工作區詳細資訊

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

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

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

將成員新增到工作區

導覽至工作區的成員標籤
點擊新增到工作區
選擇組織成員並為其分配工作區角色
確認新增

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

組織管理員和計費成員在擁有這些組織角色時無法從工作區中移除。

設定工作區限制

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

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

封存工作區

若要封存工作區，請點擊省略號菜單 (...)，然後選擇封存。封存會：

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

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

透過 Admin API

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

Admin API 端點需要 Admin API 金鑰（以 sk-ant-admin... 開頭），這與標準 API 金鑰不同。只有具有管理員角色的組織成員才能透過 Claude Console 佈建 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"

如需完整的參數詳細資訊和回應架構，請參閱 Workspaces 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"

如需完整的參數詳細資訊，請參閱 Workspace Members API 參考。

API 金鑰和資源範圍

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

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

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

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

若要擷取您組織的工作區 ID，請使用 List Workspaces 端點，或在 Claude Console 中找到它們。

工作區限制

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

設定工作區限制

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

支出限制：限制工作區的每月支出
速率限制：限制每分鐘的請求數、每分鐘的輸入令牌數或每分鐘的輸出令牌數

您無法在預設工作區上設定限制
如果未設定，工作區限制與組織的限制相符
組織範圍的限制始終適用，即使工作區限制加起來更多

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

使用情況和成本追蹤

使用 Usage and Cost 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 值。

常見使用案例

環境分離

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

工作區	用途
開發	使用較低速率限制進行測試和實驗
預備	使用類似生產的限制進行預生產測試
生產	具有完整速率限制和監控的即時流量

團隊或部門隔離

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

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

基於專案的組織

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

最佳實踐

規劃您的工作區結構
在建立工作區之前，考慮您將如何組織工作區。考慮計費、存取控制和使用情況追蹤需求。
使用有意義的名稱
清楚地命名工作區以指示其用途（例如「生產 - 客戶聊天機器人」、「開發 - 內部工具」）。
設定適當的限制
設定支出和速率限制以防止意外成本並確保公平的資源分配。
定期審計存取權限
定期檢查工作區成員資格，以確保只有適當的使用者有存取權限。
監控使用情況
使用 Usage and Cost API 追蹤工作區級別的消耗。

常見問題

另請參閱

Was this page helpful?

管理

工作區

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

工作區提供了一種在組織內組織 API 使用情況的方式。使用工作區可以分離不同的專案、環境或團隊，同時保持集中計費和管理。

工作區如何運作

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

主要特性：

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

工作區角色和權限

成員可以在每個工作區中擁有不同的角色，允許進行細粒度的存取控制。

角色	權限
工作區使用者	僅使用 Anthropic Workbench
工作區有限開發者	建立和管理 API 金鑰、使用 API。無法存取工作階段追蹤檢視或下載檔案。
工作區開發者	建立和管理 API 金鑰、使用 API
工作區管理員	對工作區設定和成員的完全控制
工作區計費	檢視工作區計費資訊（繼承自組織計費角色）

角色繼承

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

工作區計費角色無法手動分配。它是從擁有組織計費角色繼承而來的。

管理工作區

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

透過 Claude Console

在 Claude Console 中建立和管理工作區。

建立工作區

開啟工作區設定
在 Claude Console 中，前往設定 > 工作區。
建立工作區
點擊建立工作區。
設定工作區
輸入工作區名稱並選擇顏色以進行視覺識別。
建立工作區
點擊建立以完成。

若要在 Console 中的工作區之間切換，請使用左上角的工作區選擇器。

編輯工作區詳細資訊

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

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

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

將成員新增到工作區

導覽至工作區的成員標籤
點擊新增到工作區
選擇組織成員並為其分配工作區角色
確認新增

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

組織管理員和計費成員在擁有這些組織角色時無法從工作區中移除。

設定工作區限制

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

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

封存工作區

若要封存工作區，請點擊省略號菜單 (...)，然後選擇封存。封存會：

保留歷史資料以供報告使用
停用工作區和所有相關的 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"

如需完整的參數詳細資訊和回應架構，請參閱 Workspaces 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"

如需完整的參數詳細資訊，請參閱 Workspace Members API 參考。

API 金鑰和資源範圍

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

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

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

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

若要擷取您組織的工作區 ID，請使用 List Workspaces 端點，或在 Claude Console 中找到它們。

工作區限制

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

設定工作區限制

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

支出限制：限制工作區的每月支出
速率限制：限制每分鐘的請求數、每分鐘的輸入令牌數或每分鐘的輸出令牌數

您無法在預設工作區上設定限制
如果未設定，工作區限制與組織的限制相符
組織範圍的限制始終適用，即使工作區限制加起來更多

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

使用情況和成本追蹤

使用 Usage and Cost 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 值。

常見使用案例

環境分離

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

工作區	用途
開發	使用較低速率限制進行測試和實驗
預備	使用類似生產的限制進行預生產測試
生產	具有完整速率限制和監控的即時流量

團隊或部門隔離

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

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

基於專案的組織

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

最佳實踐

規劃您的工作區結構
在建立工作區之前，考慮您將如何組織工作區。考慮計費、存取控制和使用情況追蹤需求。
使用有意義的名稱
清楚地命名工作區以指示其用途（例如「生產 - 客戶聊天機器人」、「開發 - 內部工具」）。
設定適當的限制
設定支出和速率限制以防止意外成本並確保公平的資源分配。
定期審計存取權限
定期檢查工作區成員資格，以確保只有適當的使用者有存取權限。
監控使用情況
使用 Usage and Cost API 追蹤工作區級別的消耗。

常見問題

另請參閱

Was this page helpful?

工作區如何運作

工作區角色和權限

角色繼承

管理工作區

透過 Claude Console

建立工作區

編輯工作區詳細資訊

將成員新增到工作區

設定工作區限制

封存工作區

透過 Admin API

管理工作區成員

API 金鑰和資源範圍

工作區限制

設定工作區限制

使用情況和成本追蹤

常見使用案例

環境分離

團隊或部門隔離

基於專案的組織

最佳實踐

常見問題

什麼是預設工作區？

工作區有限制嗎？

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

哪些角色可以在工作區中分配？

組織管理員或計費成員的工作區角色可以更改嗎？

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

當使用者從工作區移除時，API 金鑰會發生什麼？

另請參閱

工作區如何運作

工作區角色和權限

角色繼承

管理工作區

透過 Claude Console

建立工作區

編輯工作區詳細資訊

將成員新增到工作區

設定工作區限制

封存工作區

透過 Admin API

管理工作區成員

API 金鑰和資源範圍

工作區限制

設定工作區限制

使用情況和成本追蹤

常見使用案例

環境分離

團隊或部門隔離

基於專案的組織

最佳實踐

常見問題

什麼是預設工作區？

工作區有限制嗎？

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

哪些角色可以在工作區中分配？

組織管理員或計費成員的工作區角色可以更改嗎？

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

當使用者從工作區移除時，API 金鑰會發生什麼？

另請參閱