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

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

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

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

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

• Идентификаторы рабочих пространств используют префикс wrkspc_ (например, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ).
• Максимум 100 рабочих пространств для каждой организации по умолчанию (архивированные рабочие пространства не учитываются). Если вам нужно больше, свяжитесь с вашей командой по работе с клиентами.
• Рабочее пространство по умолчанию имеет идентификатор wrkspc_, как и любое другое рабочее пространство (он возвращается в заголовке ответа anthropic-workspace-id и принимается методом Получить рабочее пространствоДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.), но появляется в результатах конечной точки «Список рабочих пространств»Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. только при передаче include_default=true. Usage and Cost Analytics API сообщает о его использовании и расходах под этим идентификатором, тогда как отчёты устаревшего Usage and Cost API показывают null для его workspace_id (поле scope ключа API содержит реальный идентификатор для ключа, привязанного к рабочему пространству по умолчанию).
• Ключи API могут быть ограничены одним рабочим пространством. В этом случае они могут получать доступ только к ресурсам внутри этого рабочего пространства. Другие ключи 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 применяется отдельное «rate limit» (ограничение скорости), и администраторы могут ограничить его долю в лимитах организации в разделе «Лимиты запросов» в Claude Console.
• Это единственное рабочее пространство, которое поддерживает ежемесячные лимиты расходов для отдельных пользователей.

Роли и разрешения в рабочих пространствах

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

Наследование ролей

• Администраторы организации автоматически получают доступ «Администратор рабочего пространства» ко всем рабочим пространствам.
• Участники организации с ролью выставления счетов автоматически получают доступ «Оплата рабочего пространства» ко всем рабочим пространствам.
• Пользователи и разработчики организации должны быть явно добавлены в каждое рабочее пространство.
• Сервисные аккаунты добавляются в рабочие пространства на странице Сервисные аккаунты (platform.claude.com/settings/service-accounts) в Claude Console: выберите Добавить в рабочее пространство в меню аккаунта или на его собственной странице. Чтобы увидеть аккаунты в одном рабочем пространстве, отфильтруйте список по рабочему пространству.

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

Использование Console

Создавайте рабочие пространства и управляйте ими на странице Рабочие пространства в Claude Console.

Создание рабочего пространства

1. 1

   Откройте настройки рабочих пространств

   В Claude Console перейдите на страницу Рабочие пространства (platform.claude.com/settings/workspaces).

2. 2

   Откройте страницу «Создать рабочее пространство»

   Нажмите Создать рабочее пространство, чтобы открыть страницу Создать рабочее пространство (platform.claude.com/settings/workspaces/new) в Console.

3. 3

   Настройте рабочее пространство

   Введите название рабочего пространства и выберите цвет для визуальной идентификации.

4. 4

   Завершите создание рабочего пространства

   Нажмите Создать рабочее пространство, чтобы завершить.

Редактирование сведений о рабочем пространстве

Чтобы изменить название или цвет рабочего пространства:

1. Выберите рабочее пространство из списка.
2. Откройте меню Другие действия (три точки) и выберите Изменить данные.
3. Обновите название или цвет и сохраните изменения.

Добавление участников в рабочее пространство

1. В Claude Console перейдите на страницу Участники (platform.claude.com/settings/members).
2. Нажмите Добавить в рабочее пространство.
3. Выберите рабочее пространство, участника организации, которого нужно добавить, и его роль в рабочем пространстве.
4. Нажмите Добавить в рабочее пространство для подтверждения.

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

1. На странице Участники в Claude Console выберите рабочее пространство в раскрывающемся меню Рабочее пространство. Если там отображается Все, действие Удалить участника удалит участника из вашей организации, а не из рабочего пространства.
2. В конце строки участника откройте меню Другие действия (три точки) и выберите Удалить участника.
3. Нажмите Удалить для подтверждения.

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

Ограничения скорости и лимиты расходов рабочего пространства задаются в разных местах:

• Ограничения скорости: в разделе «Лимиты запросов» в Claude Console выберите рабочее пространство в раскрывающемся меню Рабочее пространство и нажмите Изменить рядом с моделью, чтобы установить лимиты на количество запросов в минуту, входные токены или выходные токены.
• Лимиты расходов: на странице Рабочие пространства в Claude Console выберите рабочее пространство. В открывшейся панели нажмите Лимиты расходов, чтобы ограничить ежемесячные расходы и настроить оповещения при достижении расходами определённых порогов.

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

Чтобы архивировать рабочее пространство, откройте его меню Другие действия (три точки) и выберите Архивировать рабочую область. Архивирование:

• Сохраняет исторические данные для отчётности
• Деактивирует рабочее пространство и архивирует все ключи API, созданные для него
• Не может быть отменено

Использование Admin API

Управляйте рабочими пространствами программно с помощью Admin API.

Следующие примеры SDK и CLI создают клиент по умолчанию, который считывает ключ Admin API из переменной окружения ANTHROPIC_API_KEY; SDK предоставляет эти конечные точки в client.organization.workspaces. Методы получения списков в SDK загружают последующие страницы по требованию, поэтому limit задаёт размер страницы; примеры на PHP, Ruby и curl возвращают одну страницу.

Создание рабочего пространства:

client = anthropic.Anthropic()

workspace = client.organization.workspaces.create(name="Production")

print(f"id: {workspace.id}")
print(f"name: {workspace.name}")

Получение списка рабочих пространств:

client = anthropic.Anthropic()

workspaces = client.organization.workspaces.list(limit=10, include_archived=False)

for workspace in workspaces:
    print(f"{workspace.id}: {workspace.name}")

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

client = anthropic.Anthropic()

workspace = client.organization.workspaces.archive("wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ")

print(f"id: {workspace.id}")
print(f"archived_at: {workspace.archived_at}")

Полные сведения о параметрах и схемах ответов см. в справочнике API рабочих пространствДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..

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

Добавление участника в рабочее пространство:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.add(
    "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    user_id="user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_role="workspace_developer",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

Обновление роли участника:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.update(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    workspace_role="workspace_admin",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

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

client = anthropic.Anthropic()

removed_member = client.organization.workspaces.members.remove(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
)

print(f"user_id: {removed_member.user_id}")

Полные сведения о параметрах см. в справочнике API участников рабочих пространствДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..

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

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

• Ключ рабочего пространства (устаревший ключ без владельца) принадлежит рабочему пространству, в котором он был создан, и всегда выполняется в нём.
• Персональный ключ или ключ сервисного аккаунта действует от имени своего пользователя или сервисного аккаунта. Ключ, ограниченный одним рабочим пространством, всегда выполняется в рабочем пространстве, выбранном при его создании. Ключ, не ограниченный рабочим пространством, выполняется в рабочем пространстве, указанном в заголовке anthropic-workspace-id каждого запроса. Аккаунты должны иметь доступ к рабочему пространству, чтобы использовать его.

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

• Файлы, созданные через Files API
• Пакеты сообщений, созданные через Batch API
• Навыки (Skills), созданные через Skills API

Некоторые ресурсы управляются иначе:

• MCP-туннели управляются с помощью OAuth-токена workspace:manage_tunnels, полученного через Workload Identity Federation, а не ключа API. Туннели создаются в рабочем пространстве, а список MCP-туннели в Console и средство выбора сервера Managed Agent показывают туннели только в текущем рабочем пространстве; ограничение в 10 активных туннелей действует на уровне всей организации. Управление туннелями требует роли с разрешениями на управление туннелями; разработчики организации могут просматривать их, но не изменять.
• Сами рабочие пространства и участники организации управляются на уровне организации через Admin API с использованием ключа Admin API, OAuth-токена org:admin либо персонального ключа или ключа сервисного аккаунта, не ограниченного конкретным рабочим пространством.

Чтобы узнать идентификаторы рабочих пространств вашей организации, вызовите конечную точку Список рабочих пространствДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. (передайте include_default=true, чтобы включить рабочее пространство по умолчанию) или найдите их на странице Рабочие пространства в Claude Console.

Определение рабочего пространства, стоящего за ответом API

Ответы Claude API включают заголовок anthropic-workspace-id наряду с заголовками ответа request-id и anthropic-organization-id. Его значение — идентификатор с префиксом wrkspc_ того рабочего пространства, в которое разрешился ключ API или токен доступа запроса, в том числе когда им является рабочее пространство по умолчанию. Например, успешный ответ включает такие заголовки:

HTTP/1.1 200 OK
request-id: req_018EeWyXxfu5pfWkrYcMdjWG
anthropic-organization-id: 0d0e7a3b-52f1-4c7e-9a51-3f6f2f7c1b9e
anthropic-workspace-id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

Заголовок отсутствует, когда учётные данные не разрешаются в рабочее пространство (например, в запросах Admin API) или когда запрос завершается ошибкой до завершения аутентификации, например с ошибкой 401.

Следующие примеры отправляют запрос Messages API и считывают идентификатор рабочего пространства из заголовков ответа:

client = anthropic.Anthropic()

response = client.messages.with_raw_response.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
workspace_id = response.headers.get("anthropic-workspace-id")
print(f"Workspace ID: {workspace_id}")

Workspace ID: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

Те же методы доступа считывают этот заголовок и из других конечных точек Claude API, включая API Claude Managed Agents. Например, считайте anthropic-workspace-id из ответа, который создаёт сессию, чтобы зафиксировать, какому рабочему пространству принадлежит сессия.

Имея идентификатор рабочего пространства из ответа, вы можете:

• Подтвердить, в использование, расходы и ограничения скорости какого рабочего пространства был засчитан запрос
• Сопоставить его с полем workspace_id в строках Usage and Cost Analytics API, которые содержат этот же идентификатор для рабочего пространства по умолчанию, а также с полем scope ключей API в Admin API, которое содержит реальный идентификатор рабочего пространства, к которому привязан ключ, включая рабочее пространство по умолчанию
• Проверить, является ли он идентификатором вашего рабочего пространства по умолчанию, передав его в конечную точку Получить рабочее пространствоДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. с ключом Admin API: рабочее пространство по умолчанию возвращается с "name": "Default", хотя Список рабочих пространствДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. не включает его, если вы не передадите include_default=true
• Открыть это рабочее пространство в Console, чтобы найти ресурсы запроса, такие как сессии, файлы, пакеты сообщений и навыки

Лимиты рабочих пространств

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

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

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

• Лимиты расходов: ограничьте ежемесячные расходы рабочего пространства. Чтобы задать их, перейдите на страницу Рабочие пространства (platform.claude.com/settings/workspaces) в Claude Console и выберите рабочее пространство. В открывшейся панели нажмите Лимиты расходов.
• Ограничения скорости: ограничение количества запросов в минуту, входных токенов в минуту или выходных токенов в минуту. Чтобы установить их, перейдите в раздел «Лимиты запросов» в Claude Console, выберите рабочее пространство в раскрывающемся меню Рабочее пространство и нажмите Изменить рядом с моделью.

Подробную информацию об ограничениях скорости и о том, как они работают, см. в разделе Ограничения скорости. Вы также можете программно просматривать текущие ограничения скорости вашей организации и рабочего пространства, а также устанавливать ограничения скорости рабочего пространства с помощью API ограничений скорости, который сохраняет значение, превышающее ограничение организации, но по-прежнему применяет меньшее из двух.

Отслеживание использования и расходов

Отслеживайте использование и расходы по рабочим пространствам с помощью Usage and Cost Analytics API:

client = anthropic.Anthropic()

rows = client.beta.organization.analytics.usage.list(
    starting_at="2026-09-01T00:00:00Z",
    ending_at="2026-09-08T00:00:00Z",
    time_bucket_width="1d",
    workspace_ids=["wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"],
    group_by=["workspace_id"],
)

for row in rows:
    print(f"{row.starting_at} {row.group.workspace_id}: {row.usage.total_tokens}")

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

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

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

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

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

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

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

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

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

Лучшие практики

1. 1

   Спланируйте структуру рабочих пространств

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

2. 2

   Используйте осмысленные названия

   Называйте рабочие пространства понятно, чтобы отражать их назначение (например, «Production - Customer Chatbot» или «Dev - Internal Tools»).

3. 3

   Установите подходящие лимиты

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

4. 4

   Регулярно проверяйте доступ

   Периодически пересматривайте состав участников рабочих пространств, чтобы доступ имели только соответствующие пользователи.

5. 5

   Отслеживайте использование

   Используйте Usage and Cost Analytics API для отслеживания потребления на уровне рабочих пространств.

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

См. также

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