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

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