工作区

工作区

工作区提供了一种在组织内组织 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 跟踪工作区级别的消费。

工作区

工作区如何工作

工作区角色和权限

角色继承

管理工作区

通过 Claude Console

创建工作区

编辑工作区详情

向工作区添加成员

设置工作区限制

存档工作区

通过 Admin API

管理工作区成员

API 密钥和资源作用域

工作区限制

设置工作区限制

使用情况和成本跟踪

常见用例

环境分离

团队或部门隔离

基于项目的组织

最佳实践

常见问题

另请参阅

工作区如何工作

工作区角色和权限

角色继承

管理工作区

通过 Claude Console

创建工作区

编辑工作区详情

向工作区添加成员

设置工作区限制

存档工作区

通过 Admin API

管理工作区成员

API 密钥和资源作用域

工作区限制

设置工作区限制

使用情况和成本跟踪

常见用例

环境分离

团队或部门隔离

基于项目的组织

最佳实践

常见问题

什么是默认工作区？

工作区有限制吗？

组织角色如何影响工作区访问？

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

可以更改组织管理员或计费成员的工作区角色吗？

当组织角色更改时，工作区访问权限会发生什么？

从工作区删除用户时，API 密钥会发生什么？

另请参阅