Создание ключа Admin API
Создайте ключ Admin API для вашей организации Claude Console или Claude Enterprise.
Ключ Admin API используется для аутентификации во всех API из раздела Администрирование этого руководства: Admin API, API аналитики, Compliance API, Plugins API, Claude Tag API, Spend Limits API, Usage and Cost Analytics API, Usage and Cost API и API ограничений скорости. Отдельный ключ для каждого API не нужен. Единственное исключение — конечные точки Admin API для сервисных аккаунтов, издателей федерации и правил федерации, которые принимают только OAuth bearer-токен с областью действия org:admin. См. Получение OAuth bearer-токена.
Где создавать ключ, зависит от того, какой продукт Claude использует ваша организация.
Какой ключ вам нужен?
| Ваша организация | Где создать ключ | Префикс ключа | Кто может его создать | Работает с |
|---|---|---|---|---|
Claude Console (Claude Platform, platform.claude.com) | Страница Ключи администратора (platform.claude.com/settings/admin-keys) в Claude Console | sk-ant-admin01-... | Участники организации с ролью Администратор | Admin API, Usage and Cost Analytics API, Usage and Cost API, API ограничений скорости, Claude Code Analytics API и лента активности в Compliance API |
Claude Enterprise (claude.ai) | claude.ai > Настройки организации > API | sk-ant-api01-... | Основной владелец родительской организации (все связанные организации). Владелец организации может создать ключ только с областями действия Compliance API, ограниченный его собственной организацией | Управление пользователями (конечные точки Admin API для участников, приглашений и групп), Plugins API, Claude Tag API, Compliance API, Claude Enterprise Analytics API, Usage and Cost Analytics API и Spend Limits API — в соответствии с выбранными вами областями действия |
Ключ, созданный в одной организации, нельзя использовать для управления другой организацией. Если ваша компания использует и Claude Console, и Claude Enterprise, создайте по одному ключу в каждой.
Создание ключа для организации Claude Console
Войдите как администратор организации
Только участники организации с ролью Администратор могут создавать ключи Admin API. См. Роли и разрешения в организации.
Откройте настройки «Ключи администратора»
В Claude Console перейдите на страницу Ключи администратора (
platform.claude.com/settings/admin-keys).Создайте ключ
Нажмите Создать ключ администратора, задайте ему имя, выберите срок действия ключа и нажмите Добавить. Для ключей Claude Console нельзя выбрать области действия: каждый ключ предоставляет полный доступ ко всем конечным точкам, принимающим ключи Admin API (конечные точки для сервисных аккаунтов и федерации, упомянутые в начале этой страницы, не принимают ключи Admin API).
Скопируйте и сохраните секрет
Скопируйте отображённый секрет (начинающийся с
sk-ant-admin01-) и сохраните его в вашем менеджере секретов. Полный секрет показывается только один раз.
Создание ключа для организации Claude Enterprise
Войдите как основной владелец или владелец организации
Основной владелец родительской организации Claude Enterprise может создать ключ с доступом ко всем связанным организациям или ключ, ограниченный одной организацией. Владелец организации может создать ключ только с областями действия Compliance API, ограниченный его собственной организацией.
Откройте настройки API
Перейдите в claude.ai > Настройки организации > API и найдите раздел Ключи.
Нажмите «+ Создать ключ»
Задайте имя ключа и выберите нужные вам области действия из таблицы областей действия. Основной владелец может объединять области действия из разных API (например,
read:analyticsиread:spend_limits) в одном ключе.Скопируйте и сохраните секрет
Скопируйте отображённый секрет (начинающийся с
sk-ant-api01-) и сохраните его в вашем менеджере секретов. Полный секрет показывается только один раз.
Выбор областей действия для ключа Claude Enterprise
При создании ключа Claude Enterprise выберите все области действия (scopes), которые требуются API, которые вы планируете вызывать. Области действия фиксируются при создании; чтобы добавить область действия позже, создайте новый ключ.
| Чтобы вызывать... | Выберите эти области действия |
|---|---|
| Управление пользователями Admin API: получение списка и поиск участников и приглашений; чтение пользовательских ролей и их разрешений | read:members |
Управление пользователями Admin API: изменение ролей участников, удаление участников, выход участников на всех устройствах (бета), создание и отзыв приглашений (чтобы назначать роль managed при смене роли или в приглашении, также выберите write:rbac_groups) | write:members |
| Управление пользователями Admin API: чтение групп и их участников | read:rbac_groups |
Управление пользователями Admin API: создание, переименование и удаление групп; добавление и удаление участников групп; вместе с write:members — назначение роли managed (в приглашении или при смене роли) или назначение групп в приглашении | write:rbac_groups |
| Plugins API: чтение плагинов, версий, настроек установки, предоставлений доступа и маркетплейсов; скачивание файлов плагинов, включая файлы личных плагинов участников; проверка маркетплейса перед его подключением | read:plugins |
Plugins API: загрузка плагинов и версий; выбор версии, которую получают участники; удаление плагинов, включая личные плагины участников; установка и удаление настроек установки; установка настройки установки по умолчанию для маркетплейса; проверка маркетплейса перед его подключением (для чтения плагинов также выберите read:plugins) | write:plugins |
| Claude Tag API: чтение настроек Claude Tag для каналов Slack и рабочих пространств Slack; просмотр списка пакетов доступа (Access bundles) и мест их подключения (никакая другая область действия не предоставляет доступ к Claude Tag API) | read:claude_tag |
Claude Tag API: настройка и удаление каналов; изменение настроек; прикрепление и открепление пакетов доступа (для чтения также выберите read:claude_tag) | write:claude_tag |
| Spend Limits API: чтение действующих лимитов расходов участников и запросов на увеличение | read:spend_limits |
| Spend Limits API: установка или сброс лимитов расходов для отдельных пользователей; одобрение или отклонение запросов на увеличение | write:spend_limits |
| Claude Enterprise Analytics API: отчёты о вовлечённости, внедрении, затратах и использовании; Usage and Cost Analytics API: отчёты об использовании токенов и затратах | read:analytics |
| Лента активности Compliance API: события активности по всей организации | read:compliance_activities |
| Конечные точки Compliance API для чатов, файлов и проектов и конечные точки Compliance API для сессий: чтение чатов, файлов, проектов, транскриптов сессий и пользователей организации | read:compliance_user_data |
| Конечные точки Compliance API для чатов, файлов и проектов: удаление чатов, файлов и проектов | delete:compliance_user_data |
Конечные точки Compliance API для организации: чтение метаданных организации и действующих настроек; Plugins API: все конечные точки GET, включая загрузку файлов | read:compliance_org_data |
Конечные точки чтения управления пользователями в Admin API, все конечные точки чтения Compliance API и все конечные точки GET Plugins API, включая загрузку файлов, с помощью одной области действия только для чтения (для интеграций аудита безопасности; не включает Spend Limits API и Analytics API) | read:org_audit |
Compliance API и Analytics API должны быть включены для вашей организации, прежде чем можно будет использовать ключи с этими областями действия. См. Настройка Compliance API и Получение доступа к Claude Enterprise Analytics API.
Создавать и использовать ключи с read:plugins или write:plugins можно, только если ваша организация может использовать Plugins API. В руководстве по Plugins API указано, какие организации могут его использовать. В таких организациях ключи с read:org_audit или read:compliance_org_data также могут вызывать конечные точки чтения Plugins API, включая скачивание файлов, но не проверку маркетплейса. Области действия read:plugins и write:plugins действуют только в той организации, в которой был создан ключ. См. Области действия Plugins API и Чтение другой организации с тем же родителем.
Использование ключа
Передавайте ключ в заголовке x-api-key в каждом запросе. Полные примеры запросов см. в документации каждого API.
Вызов, выходящий за пределы областей действия ключа, возвращает 403 Forbidden с сообщением, в котором перечислены области действия, имеющиеся у ключа, и области действия, необходимые конечной точке.
Следующие шаги
Управляйте участниками организации, рабочими пространствами и ключами API.
Устанавливайте лимиты расходов для отдельных участников и рассматривайте запросы на увеличение для вашей организации Claude Enterprise.
Получайте отчёты о продуктивности Claude Code или о вовлечённости и внедрении Claude Enterprise.
Проводите аудит активности и получайте или удаляйте пользовательский контент по всей вашей организации.
Эта страница была полезной?