Рабочие пространства

Рабочие пространства предоставляют способ организации использования API внутри организации. Используйте рабочие пространства для разделения различных проектов, окружений или команд, сохраняя при этом централизованное выставление счетов и администрирование.



Как работают рабочие пространства

Каждая организация имеет Default Workspace (рабочее пространство по умолчанию), которое нельзя переименовать, архивировать или удалить. Когда вы создаёте дополнительные рабочие пространства, вы можете назначать каждому из них ключи API, участников и лимиты ресурсов.

Ключевые характеристики:

• Идентификаторы рабочих пространств используют префикс wrkspc_ (например, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Максимум 100 рабочих пространств на организацию (архивированные рабочие пространства не учитываются)
• Default Workspace не имеет идентификатора и не отображается в конечных точках списка
• Ключи API привязаны к одному рабочему пространству и могут получать доступ только к ресурсам внутри этого рабочего пространства



Рабочее пространство Claude Code

Когда участник вашей организации впервые входит в Claude Code с помощью своей учётной записи Claude Console, 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 вы можете настроить:

• Ограничения скорости: установите лимиты для каждого уровня модели на запросы в минуту, входные токены или выходные токены
• Уведомления о расходах: настройте оповещения при достижении определённых порогов расходов



Архивирование рабочего пространства

Чтобы архивировать рабочее пространство, нажмите на меню с многоточием (...) и выберите 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 управляются с помощью OAuth-токена workspace:manage_tunnels, полученного через Workload Identity Federation, а не с помощью ключа API рабочего пространства. Туннели создаются в рабочем пространстве, а список MCP tunnels в Console и селектор серверов Managed Agent показывают туннели только в текущем рабочем пространстве; ограничение в 10 активных туннелей применяется на уровне всей организации. Управление туннелями требует роли с разрешениями на управление туннелями; разработчики организации могут просматривать их, но не изменять.
• Сами рабочие пространства и участники организации управляются на уровне организации через Admin API, для которого требуется ключ Admin API.



Лимиты рабочего пространства

Вы можете устанавливать индивидуальные лимиты расходов и ограничения скорости для каждого рабочего пространства, чтобы защититься от чрезмерного использования и обеспечить справедливое распределение ресурсов.



Установка лимитов рабочего пространства

Лимиты рабочего пространства могут быть установлены ниже (но не выше) лимитов вашей организации:

• Лимиты расходов: ограничьте месячные расходы для рабочего пространства
• Ограничения скорости: ограничьте запросы в минуту, входные токены в минуту или выходные токены в минуту

Подробную информацию об ограничениях скорости и о том, как они работают, см. в разделе Ограничения скорости. Вы также можете программно считывать текущие ограничения скорости организации и рабочего пространства с помощью 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"

Использование и затраты, отнесённые к Default Workspace, имеют значение null для workspace_id.



Распространённые сценарии использования



Разделение окружений

Создайте отдельные рабочие пространства для разработки, тестирования и продакшена:



Изоляция команд или отделов

Назначайте рабочие пространства разным командам для распределения затрат и контроля доступа:

• Команда инженеров с доступом разработчика
• Команда специалистов по данным с собственными ключами API
• Команда поддержки с ограниченным доступом для клиентских инструментов



Организация по проектам

Создавайте рабочие пространства для конкретных проектов или продуктов, чтобы отслеживать использование и затраты отдельно.



Рекомендации



Часто задаваемые вопросы



См. также

• Admin API
• Справочник по Admin API
• Ограничения скорости
• Usage and Cost API