Source: https://aiprimetech.io/ru/learn/claude-code-api-key-setup/

[Главная](/ru/) / [Обучение](/ru/learn/) / API-ключ Claude Code — ANTHROPIC_API_KEY: как получить, настроить и когда вместо него использовать claude setup-token 

# Ключ 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](/register) 

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

## Другие руководства по Claude API

[Как получить ключ Claude API](/ru/learn/how-to-get-a-claude-api-key/)[Как устроены цены Claude API](/ru/learn/claude-api-pricing-explained/)[Самый дешевый способ использования API Claude](/ru/learn/cheapest-way-to-use-claude-api/)[Безлимитный Cursor с API Claude](/learn/use-claude-api-with-cursor/)[Безлимитный доступ к Claude Code](/ru/learn/use-claude-api-with-claude-code/)[Шлюз API Claude и прямой доступ к Anthropic: сравнение](/ru/learn/claude-api-vs-anthropic-direct/)[Использование Claude через API, совместимый с OpenAI](/ru/learn/openai-compatible-claude-api/)[Объяснение моделей Claude: сравнение Claude Opus, Sonnet, Haiku и Fable — все модели Claude API, названия моделей Anthropic и цены (2026)](/ru/learn/claude-api-models-compared/)[Оплата API Claude криптовалютой](/ru/learn/claude-api-with-crypto-payment/)[Доступ к API Claude без листа ожидания](/ru/learn/claude-api-without-waitlist/)[Как сократить расход токенов Claude](/ru/learn/how-to-reduce-claude-token-usage/)[Безлимитный Cline с API Claude](/ru/learn/use-claude-api-with-cline/)[Безлимитный Roo Code с API Claude](/ru/learn/use-claude-api-with-roo-code/)[Безлимитный Claude в IDE JetBrains](/ru/learn/use-claude-api-with-jetbrains/)[Aider без ограничений с Claude API](/ru/learn/use-claude-api-with-aider/)[Безлимитный Claude в VS Code](/ru/learn/use-claude-api-with-vscode/)[OpenCode без ограничений с Claude API](/ru/learn/use-claude-api-with-opencode/)[Запуск агента Hermes без ограничений на Claude](/ru/learn/run-hermes-agent-with-claude-api/)[Запуск OpenClaw с Claude без ограничений](/ru/learn/run-openclaw-with-claude-api/)[Что означает API, совместимый с Anthropic](/ru/learn/anthropic-compatible-api/)[Расходы на API Claude Code — цены и способы их снизить](/ru/learn/claude-code-api-costs/)[Объяснение ошибок API Claude: ошибка сервера 500, перегрузка 529, лимит запросов 429, некорректный запрос 400 — и исправление каждой из них](/ru/learn/claude-api-errors-troubleshooting/)[Как купить кредиты Claude API — и почему кредиты Claude лучше любого предложения «купить аккаунт Claude»](/ru/learn/buy-claude-api-credits/)[Бесплатный API Claude: существует ли бесплатный ключ API Claude и что действительно бесплатно в 2026?](/ru/learn/claude-api-free-trial/)[API Claude или подписка Claude Pro/Max — что выбрать](/ru/learn/claude-api-vs-subscription/)[Запуск Codex CLI на Claude](/ru/learn/use-claude-api-with-codex/)[Подключение Claude к n8n](/ru/learn/use-claude-api-with-n8n/)[Маршрутизация LiteLLM к Claude](/ru/learn/use-claude-api-with-litellm/)[Использование Claude в Kilo Code](/ru/learn/use-claude-api-with-kilo-code/)[Подключение Claude к GitHub Copilot](/ru/learn/use-claude-api-with-github-copilot/)[Подключите Zed к Claude через шлюз](/ru/learn/use-claude-api-with-zed/)[Подключите Cherry Studio к Claude](/ru/learn/use-claude-api-with-cherry-studio/)[Подключение LangChain к Claude через шлюз](/ru/learn/use-claude-api-with-langchain/)[Используйте Factory Droid с Claude](/ru/learn/use-claude-api-with-factory-droid/)[Как устроен API Claude Code](/ru/learn/claude-code-api/)[Интеграция API Claude в ваше приложение](/ru/learn/claude-api-integration/)[Как пользоваться Claude без ограничений — и почему «взломанного Claude Code» не существует](/ru/learn/get-unlimited-claude-usage/)