Ключ API Claude Code. Небольшой физический ключ вставлен в замок в форме терминала; рядом — аккуратная панель настроек и короткий кабель.

Ключ API Claude Code — ANTHROPIC_API_KEY: как получить, настроить и когда вместо него использовать claude setup-token

Для работы Claude Code нужен API-ключ. Независимо от того, настраиваете ли вы Claude Code впервые или переходите с прямого аккаунта Anthropic на шлюз с фиксированной оплатой, процесс включает создание ключа, настройку двух переменных окружения и проверку подключения.

API-ключ Claude Code: кратко

API-ключ Claude Code — это обычный ключ в формате Anthropic (sk-...), который Claude Code считывает из ANTHROPIC_API_KEY. Получите его в консоли Claude (Настройки → API-ключи; показывается только один раз) или в панели управления этого шлюза (доступен для просмотра в любое время), задайте его командой export — и Claude Code запустится без входа через браузер. При использовании ключа шлюза также задайте ANTHROPIC_BASE_URL адрес хоста шлюза. На этом настройка завершена; далее на странице приведены подробности: различия между API-ключом, OAuth-токеном из /login и ключом сессии claude.ai, инструкции для каждой ОС и ошибки, с которыми сталкиваются пользователи.

Что такое API-ключ Claude Code

API-ключ Claude Code — это учётные данные для аутентификации, которые позволяют CLI Claude Code отправлять запросы провайдеру моделей Claude. Без него каждая команда, выполняемая в Claude Code, возвращает ошибку аутентификации. Ключ представляет собой строку, которую вы храните в переменной окружения: либо ANTHROPIC_API_KEY (передаётся в заголовке x-api-key), либо ANTHROPIC_AUTH_TOKEN (передаётся как Bearer-токен). Оба варианта работают с AI Prime Tech.

Если вы используете шлюз, например AI Prime Tech, вместо прямого подключения к Anthropic, ключ нужно получить в панели управления шлюза, а не в консоли Anthropic. Формат ключа может отличаться, но процесс настройки в Claude Code одинаков: задайте ключ в окружении, укажите шлюз в качестве базового URL, а остальное Claude Code сделает сам. Ваш ключ привязан к балансу аккаунта или подписке на шлюзе, а не к биллингу Anthropic.

Один ключ можно одновременно использовать на нескольких компьютерах и в нескольких сессиях Claude Code. Однако если команда использует общий ключ, всё использование учитывается в лимитах частоты запросов и балансе одного аккаунта. Для командной работы создайте в панели управления отдельный ключ для каждого разработчика, чтобы отслеживание использования и ограничение частоты запросов работали корректно для каждого участника.

API-ключ и OAuth-токен — и что такое «ключ сессии»

Claude Code принимает два вида учётных данных. При использовании API-ключа (ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN, передаваемого как Bearer-токен) оплата за токены списывается с баланса API — именно этот вариант используется со шлюзом. OAuth-токен связан с подпиской Claude Pro или Max: /login в Claude Code выполняет вход в аккаунт, а claude setup-token создаёт долгоживущий токен, который можно использовать в CI или на компьютере без графического интерфейса, чтобы расходовать ресурсы подписки вместо баланса API.

«Ключ сессии Claude» не относится ни к одному из этих вариантов: это cookie браузерной сессии с claude.ai, который некоторые неофициальные клиенты извлекают для работы через интерфейс чата. Он не является учётными данными API, его использование нарушает пользовательские условия, срок его действия истекает, а аккаунт могут заблокировать. Если вам нужен программный доступ, используйте API-ключ из консоли Anthropic или от шлюза, такого как этот.

Шаг 1 — Получите ключ: консоль Claude или панель управления шлюза

Ключ, который принимает Claude Code, можно получить в двух местах. В консоли Claude (платформа Claude по адресу platform.claude.com) откройте Настройки → API-ключи, нажмите «Создать ключ», задайте имя и скопируйте секретное значение ключа. Консоль показывает его только один раз, а затем отображает лишь имя и префикс, поэтому управление ключами там предполагает создание нового ключа, а не получение старого.

Для Claude Code нужен обычный ключ; административный API-ключ — это другие учётные данные для управления организацией, которые не подходят для аутентификации запросов. Затем выполните export ANTHROPIC_API_KEY=sk-ant-... в командной оболочке, и Claude Code будет использовать его без /login. Anthropic взимает плату за токены, и сначала к аккаунту нужно добавить способ оплаты.

Более быстрый вариант — ключ шлюза: зарегистрируйтесь на aiprimetech.io, откройте раздел «API-ключи» в панели управления и нажмите «Создать». Ключ будет доступен для просмотра в панели управления в любое время — вы сможете снова скопировать его, переименовать или отозвать, когда захотите. Он имеет тот же формат sk- и используется в той же переменной; единственный дополнительный шаг — ANTHROPIC_BASE_URL, описанный в шаге 2.

На этом этапе у вас есть ключ, но на балансе ещё нет средств. Перед тестированием пополните баланс на небольшую сумму — на странице моделей указано, какой объём работы с каждой моделью можно получить за доллар. Или выберите безлимитный тариф на /plans/, если уже знаете, что будете пользоваться Claude Code весь день.

Шаг 2 — Настройте переменные окружения

Claude Code считывает две переменные окружения для настройки шлюза: ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY. Укажите в ANTHROPIC_BASE_URL корневой адрес хоста шлюза без каких-либо суффиксов пути. SDK Anthropic автоматически добавляет /v1/messages — если включить /v1 в базовый URL, запросы будут отправляться на /v1/v1/messages и возвращать ошибки 404.

В Linux или macOS добавьте в профиль командной оболочки (~/.bashrc, ~/.zshrc или ~/.profile) следующие строки: export ANTHROPIC_BASE_URL="https://aiprimetech.io" и export ANTHROPIC_API_KEY="ваш-ключ". В Windows задайте их как системные переменные окружения через Параметры > Система > Дополнительные параметры системы > Переменные среды или добавьте их в $PROFILE PowerShell.

Для настройки отдельного проекта создайте файл .env в корневом каталоге проекта с теми же переменными. Claude Code загружает файлы .env из рабочего каталога, и они имеют приоритет над системными переменными. Это удобно, если вы используете разных провайдеров API для разных проектов. Обязательно добавьте .env в .gitignore, чтобы случайно не сохранить ключ в системе контроля версий.

Шаг 3 — Проверьте подключение

После настройки переменных окружения откройте новую сессию терминала, чтобы переменные загрузились, и запустите Claude Code. Введите простое сообщение, например: «Привет, подтверди, что можешь отвечать». Если Claude ответит, значит, вся цепочка подключения работает: ключ действителен, базовый URL указан верно, а шлюз успешно направляет ваш запрос к Claude.

Если проверка не удалась, сообщение об ошибке подскажет причину. Ошибка 401 или 403 означает, что API-ключ недействителен или срок его действия истёк — скопируйте его заново из панели управления. Ошибка 404 почти всегда означает, что базовый URL указан неверно — проверьте, не добавлен ли случайно суффикс /v1 или завершающие косые черты. Ошибка отказа в подключении означает, что шлюз недоступен — проверьте сеть, VPN или настройки брандмауэра.

Также можно выполнить программную проверку, обратившись к эндпоинту статуса шлюза через curl: curl -H 'Authorization: Bearer YOUR_KEY' https://aiprimetech.io/v1/models — если ключ действителен, команда вернёт список доступных моделей. Если эта проверка работает, а Claude Code — нет, проблема в загрузке переменных окружения, а не в самом ключе или шлюзе.

Шаг 4 — Настройте предпочтительные модели

По умолчанию Claude Code использует встроенный выбор моделей для каждого уровня (Sonnet, Opus, Haiku). Его можно переопределить с помощью дополнительных переменных окружения: ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL и ANTHROPIC_DEFAULT_FABLE_MODEL. Укажите в них точные идентификаторы моделей, поддерживаемых шлюзом.

Для большинства разработчиков достаточно задать ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 и ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6. Claude Code по умолчанию использует Sonnet для большинства взаимодействий и обращается к Opus, когда вы выбираете его командой /model или когда режим планирования переключается на более мощную модель. Шлюз поддерживает все актуальные версии моделей Claude.

Включите обнаружение моделей через шлюз, задав CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1. Это указывает Claude Code запрашивать у шлюза доступные модели вместо использования жёстко заданного списка. Также задайте CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, чтобы запросы телеметрии не отправлялись на шлюз: это уменьшает количество лишних запросов и немного снижает задержку.

Устранение распространённых ошибок аутентификации

Самая частая проблема — переменные окружения не загружаются. После их настройки в профиле нужно открыть новый терминал: уже открытые терминалы используют прежнее окружение. В Windows может потребоваться полностью перезапустить приложение терминала, а не просто открыть новую вкладку. Проверьте значения командой echo $ANTHROPIC_BASE_URL (bash/zsh) или echo $env:ANTHROPIC_BASE_URL (PowerShell).

Если при исправном подключении возникают ошибки «модель не найдена», идентификатор модели не соответствует тому, что предлагает шлюз. Идентификаторы моделей чувствительны к регистру и зависят от версии. Проверьте точные поддерживаемые идентификаторы в панели управления или через эндпоинт /v1/models. Среди распространённых ошибок — использование 'claude-3-opus' вместо 'claude-opus-4-6' или лишние пробелы в значении переменной окружения.

Проверьте баланс в панели управления. Чтобы продолжить работу без перерывов, пополните баланс для оплаты по мере использования или перейдите на безлимитный тариф — 1 день ($9) или 1 неделя ($39) для доступа ко всем моделям по фиксированной цене без оплаты за токены.

# Add to ~/.bashrc or ~/.zshrc:
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="your-key-from-dashboard"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Verify connection:
# $ source ~/.bashrc && claude
# Or test the gateway directly:
# $ curl -H "x-api-key: $ANTHROPIC_API_KEY" https://aiprimetech.io/v1/models

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

ANTHROPIC_API_KEY — как получить?

Создайте ключ в консоли Claude (Настройки → Ключи API → Создать ключ; скопируйте секретное значение ключа, которое показывается только один раз) или в панели управления этого шлюза, где оно остаётся доступным для просмотра. Экспортируйте его как ANTHROPIC_API_KEY; при использовании ключа шлюза также задайте ANTHROPIC_BASE_URL.

Нужен ли отдельный ключ для Claude Code и других инструментов?

Нет. Один и тот же ключ API подходит для Claude Code, Cursor, Cline, Aider и любого другого инструмента, использующего Anthropic Messages API или совместимую с OpenAI конечную точку. Один ключ — несколько инструментов.

Сессионный ключ Claude — это то же самое, что ключ API?

Нет. Сессионный ключ — это cookie claude.ai в браузере, используемый неофициальными клиентами; ключ API — это учётные данные, которые ожидают API и Claude Code. Только ключ API поддерживается официально, используется для оплаты и обеспечивает стабильную работу.

Как получить ANTHROPIC_API_KEY?

В консоли Anthropic (оплата по стандартным ценам с вашего аккаунта Anthropic) или в панели управления этого шлюза (оплата кредитами, купленными дешевле номинала, либо по безлимитному тарифу). В обоих случаях ключ указывается в переменной окружения ANTHROPIC_API_KEY.

Что делает claude setup-token делает?

Создаёт долгосрочный токен OAuth для подписки Claude, чтобы Claude Code мог работать в CI или без графического интерфейса и интерактивного входа. При этом расходуются лимиты подписки, а не кредиты API; при работе через шлюз вместо этого используется ключ API.

Нужно ли включать /v1 в ANTHROPIC_BASE_URL?

Нет. Укажите только корневой адрес хоста: https://aiprimetech.io — Anthropic SDK автоматически добавляет /v1/messages. Если включить /v1, путь продублируется, что приведёт к ошибкам 404.

Можно ли использовать один ключ на нескольких компьютерах?

Да. Один ключ работает одновременно на всех ваших устройствах. Всё использование учитывается в балансе и лимитах частоты запросов одного аккаунта. Для команд создавайте отдельные ключи для каждого разработчика, чтобы отслеживать использование независимо.

Начните использовать Claude за несколько минут

Получите ключ API — учётная запись Anthropic и запись в лист ожидания не нужны.

Получить ключ API

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.