Каждый API в разделе Admin этого руководства (Admin API, Analytics APIs, Compliance API, Spend Limits API, Usage and Cost API и Rate Limits API) аутентифицируется с помощью ключа Admin API. Вам не нужен отдельный ключ для каждого API.
Место создания ключа зависит от того, какой продукт Claude использует ваша организация.
| Ваша организация | Где создать ключ | Префикс ключа | Кто может его создать | Работает с |
|---|---|---|---|---|
Claude Console (Claude Platform, platform.claude.com) | Claude Console > Settings > Admin keys | sk-ant-admin01-... | Участники организации с ролью admin | Admin API, Usage and Cost API, Rate Limits API, Claude Code Analytics API и Activity Feed Compliance API |
Claude Enterprise (claude.ai) | claude.ai > Organization settings > API | sk-ant-api01-... | Основной владелец (primary owner) родительской организации (все связанные организации). Владелец организации (organization owner) может создать ключ только с областями действия Compliance API, ограниченный его собственной организацией | Compliance API, Claude Enterprise Analytics API и Spend Limits API, в соответствии с выбранными вами областями действия |
Ключ, созданный в одной организации, не может использоваться для управления другой организацией. Если ваша компания использует и Claude Console, и Claude Enterprise, создайте по одному ключу в каждой.
Войдите как администратор организации
Только участники организации с ролью admin могут создавать ключи Admin API. См. Роли и разрешения организации.
Откройте настройки Admin keys
Перейдите в Claude Console > Settings > Admin keys.
Создайте ключ
Нажмите Create key, задайте имя и нажмите Create. Ключи Claude Console не имеют выбираемых областей действия; каждый ключ предоставляет полный доступ к Admin API.
Скопируйте и сохраните секрет
Скопируйте отображаемый секрет (начинающийся с sk-ant-admin01-) и сохраните его в вашем менеджере секретов. Полный секрет отображается только один раз.
Войдите как основной владелец или владелец организации
Основной владелец родительской организации Claude Enterprise может создать ключ с доступом ко всем связанным организациям или ключ, ограниченный одной организацией. Владелец организации может создать ключ только с областями действия Compliance API, ограниченный его собственной организацией.
Откройте настройки API
Перейдите в claude.ai > Organization settings > API и найдите раздел Keys.
Нажмите + Create key
Задайте имя ключа и выберите необходимые области действия из таблицы областей действия. Основной владелец может объединить области действия из разных API (например, read:analytics и read:spend_limits) в одном ключе.
Скопируйте и сохраните секрет
Скопируйте отображаемый секрет (начинающийся с sk-ant-api01-) и сохраните его в вашем менеджере секретов. Полный секрет отображается только один раз.
При создании ключа Claude Enterprise выберите все области действия, которые требуются для API, которые вы планируете вызывать. Области действия фиксируются при создании; чтобы добавить область действия позже, создайте новый ключ.
| Чтобы вызвать... | Выберите эти области действия |
|---|---|
| Spend Limits API: чтение действующих лимитов расходов участников и запросов на увеличение | read:spend_limits |
| Spend Limits API: установка или сброс лимитов расходов для отдельных пользователей; одобрение или отклонение запросов на увеличение | write:spend_limits |
| Claude Enterprise Analytics API: отчёты о вовлечённости, внедрении, затратах и использовании | read:analytics |
| Compliance API Activity Feed: события активности по всей организации | read:compliance_activities |
| Конечные точки контента Compliance API: чтение чатов, файлов, проектов и пользователей | read:compliance_user_data |
| Конечные точки контента Compliance API: удаление чатов, файлов и проектов | delete:compliance_user_data |
| Конечные точки организации Compliance API: чтение метаданных организации и действующих настроек | read:compliance_org_data |
Compliance API и Analytics API должны быть включены для вашей организации, прежде чем можно будет использовать ключи с этими областями действия. См. Настройка Compliance API и Analytics APIs.
Передавайте ключ в заголовке x-api-key в каждом запросе. Полные примеры запросов см. в документации каждого API.
Вызов, превышающий области действия ключа, возвращает 403 Forbidden с сообщением, в котором перечислены области действия, которые есть у ключа, и области действия, необходимые конечной точке.
Управляйте участниками организации, рабочими пространствами и ключами API.
Устанавливайте лимиты расходов для отдельных участников и рассматривайте запросы на увеличение для вашей организации Claude Enterprise.
Создавайте отчёты о продуктивности Claude Code или о вовлечённости и внедрении Claude Enterprise.
Проводите аудит активности и получайте или удаляйте пользовательский контент по всей вашей организации.
Was this page helpful?