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

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



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

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

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

• Идентификаторы рабочих пространств используют префикс wrkspc_ (например, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Максимум 100 рабочих пространств на организацию (архивированные рабочие пространства не учитываются)
• Default Workspace не имеет ID и не отображается в конечных точках списка
• Ключи 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 -X POST "https://api.anthropic.com/v1/organizations/workspaces" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -d '{"name": "Production"}'

# Список рабочих пространств
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Архивирование рабочего пространства
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Полные сведения о параметрах и схемах ответов см. в справочнике Workspaces API.



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

Добавляйте, обновляйте или удаляйте участников из рабочего пространства:

# Добавить участника в рабочее пространство
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -d '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Обновить роль участника
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -d '{"workspace_role": "workspace_admin"}'

# Удалить участника из рабочего пространства
curl -X DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Полные сведения о параметрах см. в справочнике Workspace Members API.



Ключи API и область действия ресурсов

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

Ресурсы, привязанные к рабочим пространствам, включают:

• Файлы, созданные через Files API
• Пакеты сообщений (Message Batches), созданные через Batch API
• Навыки (Skills), созданные через 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

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



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



Разделение сред

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



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

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

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



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

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



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



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



См. также

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