工作區

「Workspaces」（工作區）提供了一種在組織內組織 API 使用情況的方式。使用工作區來區隔不同的專案、環境或團隊，同時維持集中式的計費與管理。



工作區的運作方式

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

主要特性：

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



Claude Code 工作區

當您組織的成員首次使用其 Claude Console 帳戶登入 Claude Code 時，Anthropic 會自動在組織中建立一個 Claude Code 工作區，並將該成員加入其中。之後每位登入 Claude Code 的成員都會以相同方式被加入。

Claude Code 工作區將 Claude Code 的流量與您其他的 API 工作負載分開：

• Claude Code 會在登入時於此工作區中為每位使用者產生一個 API 金鑰。您無法從 Console 手動在此工作區中建立金鑰。
• 與標準工作區金鑰不同，當 Claude Code 金鑰的擁有者從工作區或組織中被移除時，該金鑰將停止運作。
• Claude Code 的使用量會單獨進行速率限制，管理員可以在 Settings > Workspaces 下限制其佔組織限制的比例。
• 這是唯一支援每位使用者每月支出限制的工作區。



工作區角色與權限

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



角色繼承

• 組織管理員會自動獲得所有工作區的 Workspace Admin 存取權限
• 組織計費成員會自動獲得所有工作區的 Workspace Billing 存取權限
• 組織使用者和開發人員必須被明確加入每個工作區



管理工作區



使用 Console

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



建立工作區



編輯工作區詳細資訊

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

1. 從列表中選擇工作區
2. 點擊省略號選單（...）並選擇 Edit details
3. 更新名稱或顏色並儲存變更



將成員加入工作區

1. 導覽至工作區的 Members 分頁
2. 點擊 Add to Workspace
3. 選擇一位組織成員並為其指派工作區角色
4. 確認新增

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



設定工作區限制

在 Limits 分頁中，您可以設定：

• 速率限制： 針對每個模型層級設定每分鐘請求數、輸入 token 或輸出 token 的限制
• 支出通知： 設定當支出達到特定門檻時的警示



封存工作區

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

• 保留歷史資料以供報告使用
• 停用該工作區及所有相關的 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 建立的技能

某些資源是在組織層級管理的，無法使用工作區 API 金鑰進行管理：

• MCP 通道 是透過 Workload Identity Federation 取得的組織範圍 OAuth token（org:manage_tunnels）來管理，而非工作區 API 金鑰，且 10 個作用中通道的上限適用於整個組織。通道管理需要具有通道管理權限的角色；組織開發人員可以檢視但無法變更通道。通道是在工作區中建立的，而 Console 的 MCP tunnels 列表和 Managed Agent 伺服器選擇器僅顯示目前工作區中的通道。
• 工作區本身和組織成員是透過 Admin API 管理的，這需要 Admin API 金鑰。



工作區限制

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



設定工作區限制

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

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

如需速率限制及其運作方式的詳細資訊，請參閱速率限制。您也可以使用 Rate Limits API 以程式化方式讀取目前的組織和工作區速率限制。



使用量與成本追蹤

使用 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: $ANTHROPIC_ADMIN_KEY"

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



常見使用案例



環境區隔

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



團隊或部門隔離

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

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



基於專案的組織方式

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



最佳實務



常見問題



另請參閱

• Admin API
• Admin API 參考文件
• 速率限制
• Usage and Cost API