Claude Platform Docs
СообщенияПервые шаги

Получите ваш ключ API Claude

Находите, создавайте и управляйте вашими ключами API для Claude API в Claude Console.

Ключи API для Claude API (также называемые ключами API Anthropic) хранятся в Claude Console. Чтобы просмотреть существующие ключи или создать новый, перейдите на страницу API keys (platform.claude.com/settings/keys) в Console.

Выберите тип ключа

При создании ключа вы выбираете его тип, который определяет, что ключ может делать, где он работает и когда перестаёт работать. Персональный ключ (personal key) действует от вашего имени и перестаёт работать, если вы покидаете организацию. Ключ сервисного аккаунта (service account key) представляет сервисный аккаунт, который может использоваться рабочими нагрузками, такими как CI-конвейеры, производственные сервисы или агенты. Используйте персональный ключ для собственной разработки, а ключ сервисного аккаунта — для всего, что используется совместно.

Вы также можете создать ключ рабочего пространства (workspace key) — устаревший тип ключа без владельца: он принадлежит рабочему пространству, в котором вы его создаёте, и продолжает работать после ухода его создателя. Предпочтительнее использовать персональный ключ или ключ сервисного аккаунта, поскольку они автоматически перестают работать, когда связанный с ними аккаунт удаляется из организации.

Создайте ключ API

  1. Войдите в Claude Console

    Перейдите в Claude Console по адресу platform.claude.com и войдите в систему или создайте аккаунт, если у вас его ещё нет.

  2. Откройте страницу ключей API

    В Claude Console перейдите на страницу API keys (platform.claude.com/settings/keys).

  3. Создайте ключ

    Нажмите Create key, задайте имя ключа, выберите срок действия и укажите в поле Linked account себя или сервисный аккаунт. Вы также можете выбрать в Console рабочее пространство, которым будет ограничена область действия ключа.

  4. Скопируйте и сохраните ключ

    Console показывает полный ключ, который начинается с sk-ant-, только один раз — при создании. Скопируйте его и сохраните в надёжном месте, например в менеджере секретов. Если вы потеряете ключ, вы не сможете снова просмотреть его в Console. Вместо этого создайте новый ключ.

Если кнопка Create key на странице ключей API неактивна, возможно, ваша роль не позволяет создавать ключи там. Попросите администратора организации изменить вашу роль или создать ключ сервисного аккаунта для вашей рабочей нагрузки.

Используйте ваш ключ API

Установите ключ в качестве переменной окружения:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Клиентский SDK автоматически считывает ANTHROPIC_API_KEY. Прямые HTTP-запросы передают ключ в заголовке x-api-key. Если ваш ключ API работает в нескольких рабочих пространствах, вы также должны передавать заголовок anthropic-workspace-id в каждом запросе к Claude API, как показано в разделе Выбор рабочего пространства. Сведения об Admin API см. в разделе Ключи API и Admin API.

Чтобы выполнить ваш первый запрос, следуйте руководству Быстрый старт, а полную картину, включая краткосрочные учётные данные с Workload Identity Federation, см. в разделе Аутентификация.

Ключи API и Admin API

Admin API включает конечные точки для программного управления ключами API вашей организации, например Retrieve API Key и List API Keys. Эти конечные точки предназначены для администраторов организации, автоматизирующих управление ключами. Они принимают ключ Admin API, токен OAuth с областью org:admin или персональный ключ либо ключ сервисного аккаунта, не ограниченный конкретным рабочим пространством; ключи рабочих пространств там не работают. Эти конечные точки никогда не возвращают секретное значение ключа — только частично скрытую подсказку.

Was this page helpful?