Claude Platform Docs
MessagesПервые шаги

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

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

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

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

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

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

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

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

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

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

    Перейдите в Settings → API keys.

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

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

  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?