管理与监控

工作区

使用工作区组织 API 密钥、管理团队访问权限并控制成本。

工作区提供了一种在组织内组织 API 使用的方式。使用工作区可以分隔不同的项目、环境或团队，同时保持集中的计费和管理。

工作区的工作原理

每个组织都有一个默认工作区，不能重命名、归档或删除。当您创建额外的工作区时，可以为每个工作区分配 API 密钥、成员和资源限制。

主要特征：

工作区标识符使用 wrkspc_ 前缀（例如 wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ）
每个组织最多 100 个工作区（已归档的工作区不计入）
默认工作区没有 ID，不会出现在列表端点中
API 密钥限定于单个工作区，只能访问该工作区内的资源

工作区角色和权限

成员可以在每个工作区中拥有不同的角色，从而实现细粒度的访问控制。

角色	权限
工作区用户	仅使用 Workbench
工作区开发者	创建和管理 API 密钥，使用 API
工作区管理员	对工作区设置和成员拥有完全控制权
工作区计费	查看工作区计费信息（从组织计费角色继承）

角色继承

组织管理员自动获得所有工作区的工作区管理员访问权限
组织计费成员自动获得所有工作区的工作区计费访问权限
组织用户和开发者必须被显式添加到每个工作区

工作区计费角色不能手动分配。它是从拥有组织计费角色继承而来的。

管理工作区

只有组织管理员可以创建工作区。组织用户和开发者必须由管理员添加到工作区。

通过控制台

在 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。

常见用例

环境分离

为开发、预发布和生产创建单独的工作区：

工作区	用途
开发	使用较低速率限制进行测试和实验
预发布	使用类似生产的限制进行预生产测试
生产	具有完整速率限制和监控的实时流量

团队或部门隔离

将工作区分配给不同的团队以进行成本分摊和访问控制：

工程团队具有开发者访问权限
数据科学团队拥有自己的 API 密钥
支持团队对客户工具具有有限的访问权限

基于项目的组织

为特定项目或产品创建工作区，以单独跟踪使用量和成本。

最佳实践

规划您的工作区结构
在创建工作区之前，考虑如何组织它们。思考计费、访问控制和使用量跟踪的需求。
使用有意义的名称
清晰地命名工作区以表明其用途（例如"生产 - 客户聊天机器人"、"开发 - 内部工具"）。
设置适当的限制
配置支出和速率限制以防止意外成本并确保公平的资源分配。
定期审核访问权限
定期审查工作区成员资格，确保只有适当的用户拥有访问权限。
监控使用量
使用使用量和成本 API 跟踪工作区级别的消耗。

常见问题

另请参阅

Was this page helpful?

管理与监控

工作区

使用工作区组织 API 密钥、管理团队访问权限并控制成本。

工作区提供了一种在组织内组织 API 使用的方式。使用工作区可以分隔不同的项目、环境或团队，同时保持集中的计费和管理。

工作区的工作原理

每个组织都有一个默认工作区，不能重命名、归档或删除。当您创建额外的工作区时，可以为每个工作区分配 API 密钥、成员和资源限制。

主要特征：

工作区标识符使用 wrkspc_ 前缀（例如 wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ）
每个组织最多 100 个工作区（已归档的工作区不计入）
默认工作区没有 ID，不会出现在列表端点中
API 密钥限定于单个工作区，只能访问该工作区内的资源

工作区角色和权限

成员可以在每个工作区中拥有不同的角色，从而实现细粒度的访问控制。

角色	权限
工作区用户	仅使用 Workbench
工作区开发者	创建和管理 API 密钥，使用 API
工作区管理员	对工作区设置和成员拥有完全控制权
工作区计费	查看工作区计费信息（从组织计费角色继承）

角色继承

组织管理员自动获得所有工作区的工作区管理员访问权限
组织计费成员自动获得所有工作区的工作区计费访问权限
组织用户和开发者必须被显式添加到每个工作区

工作区计费角色不能手动分配。它是从拥有组织计费角色继承而来的。

管理工作区

只有组织管理员可以创建工作区。组织用户和开发者必须由管理员添加到工作区。

通过控制台

在 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。

常见用例

环境分离

为开发、预发布和生产创建单独的工作区：

工作区	用途
开发	使用较低速率限制进行测试和实验
预发布	使用类似生产的限制进行预生产测试
生产	具有完整速率限制和监控的实时流量

团队或部门隔离

将工作区分配给不同的团队以进行成本分摊和访问控制：

工程团队具有开发者访问权限
数据科学团队拥有自己的 API 密钥
支持团队对客户工具具有有限的访问权限

基于项目的组织

为特定项目或产品创建工作区，以单独跟踪使用量和成本。

最佳实践

规划您的工作区结构
在创建工作区之前，考虑如何组织它们。思考计费、访问控制和使用量跟踪的需求。
使用有意义的名称
清晰地命名工作区以表明其用途（例如"生产 - 客户聊天机器人"、"开发 - 内部工具"）。
设置适当的限制
配置支出和速率限制以防止意外成本并确保公平的资源分配。
定期审核访问权限
定期审查工作区成员资格，确保只有适当的用户拥有访问权限。
监控使用量
使用使用量和成本 API 跟踪工作区级别的消耗。

常见问题

另请参阅

Was this page helpful?

工作区的工作原理

工作区角色和权限

角色继承

管理工作区

通过控制台

创建工作区

编辑工作区详情

向工作区添加成员

设置工作区限制

归档工作区

通过 Admin API

管理工作区成员

API 密钥和资源作用域

工作区限制

设置工作区限制

使用量和成本跟踪

常见用例

环境分离

团队或部门隔离

基于项目的组织

最佳实践

常见问题

什么是默认工作区？

工作区有数量限制吗？

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

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

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

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

用户从工作区移除时 API 密钥会怎样？

另请参阅

工作区的工作原理

工作区角色和权限

角色继承

管理工作区

通过控制台

创建工作区

编辑工作区详情

向工作区添加成员

设置工作区限制

归档工作区

通过 Admin API

管理工作区成员

API 密钥和资源作用域

工作区限制

设置工作区限制

使用量和成本跟踪

常见用例

环境分离

团队或部门隔离

基于项目的组织

最佳实践

常见问题

什么是默认工作区？

工作区有数量限制吗？

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

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

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

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

用户从工作区移除时 API 密钥会怎样？

另请参阅