Claude Code по API-ключу вместо подписки: настройка

Чтобы Claude Code работал по API-ключу вместо подписки, задайте переменную ANTHROPIC_API_KEY, а если используете посредника — ещё и ANTHROPIC_BASE_URL. После этого запустите claude, подтвердите использование ключа и проверьте способ входа командой /status. Из России подписка и консоль Anthropic недоступны, поэтому ключ удобнее взять в AI для кода от PurpleSchool: VPN не нужен, оплата в рублях, тариф от 499 ₽ в месяц.

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

Подписка или API-ключ: в чём разница

Что выгоднее при вашем объёме работы, разобрано в статье Подписка Claude Pro, Max или API.

Шаг 1. Получите ключ

В AI для кода зарегистрируйтесь, выберите тариф и скопируйте ключ в кабинете. Тот же ключ и тот же баланс работают в Claude Code, Codex CLI, Cursor, VS Code и в вашем собственном коде.

Если хотите, чтобы настройку сделала программа, выполните команду. Понадобится Node.js 22 или новее:

npx @purpleschool/ai-for-code

Она сама пропишет ключ и адрес во все найденные инструменты. Ручной вариант — в следующем шаге.

Шаг 2. Задайте переменные

На macOS и Linux добавьте строки в ~/.zshrc или ~/.bashrc:

export ANTHROPIC_API_KEY="ваш ключ"
export ANTHROPIC_BASE_URL="https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic"

Затем перечитайте файл:

source ~/.zshrc

Адрес указывается без /v1 на конце: Claude Code допишет путь сам.

В Windows PowerShell сохранить переменные для всех новых окон можно так:

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "ваш ключ", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic", "User")

После этого откройте новое окно терминала.

Есть и вариант без правки профиля оболочки: задать переменные в файле ~/.claude/settings.json.

{
  "env": {
    "ANTHROPIC_API_KEY": "ваш ключ",
    "ANTHROPIC_BASE_URL": "https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic"
  }
}

Если файл уже существует, добавьте блок env в него, не заменяя остальные настройки. Не кладите ключ в файл настроек внутри репозитория: он может попасть в git.

Шаг 3. Запустите и проверьте

claude

В интерактивном режиме Claude Code один раз спросит, использовать ли найденный ключ. Согласитесь. Затем выполните внутри сессии:

/status

Команда покажет активный способ входа. Быстрая проверка без интерактивного режима:

claude -p "Ответь одним словом: ок" --model claude-haiku-5-5

Если в ответ пришло «ок», ключ, адрес и баланс в порядке. Эту команду мы проверили на актуальном Claude Code через адрес PurpleSchool.

Что важнее: подписка или ключ

По документации Claude Code приоритет такой: сначала облачные провайдеры, затем ANTHROPIC_AUTH_TOKEN, затем ANTHROPIC_API_KEY, и только потом сохранённый вход. На практике это значит:

• если вы вошли по подписке и задали ANTHROPIC_API_KEY, Claude Code возьмёт ключ после вашего подтверждения;
• в режиме claude -p ключ используется сразу, без вопроса;
• команда /login не поможет, пока ключ задан в переменной: окружение важнее;
• вход по подписке при этом не удаляется, он просто не используется.

Чтобы вернуться на подписку, уберите переменные и перезапустите Claude Code:

unset ANTHROPIC_API_KEY
unset ANTHROPIC_BASE_URL

Если строки записаны в ~/.zshrc или settings.json, удалите их и там, иначе в новом окне они появятся снова.

Как выбрать модель

Модель можно передать при запуске:

claude --model claude-sonnet-5-5

Внутри сессии её меняет команда /model. Через PurpleSchool на момент публикации доступны, например, claude-haiku-5-5, claude-sonnet-5-5, claude-opus-5-5 и claude-fable-5-1. Более сильные модели расходуют баланс быстрее. Как выбрать подходящую, рассказано в статье Haiku, Sonnet или Opus, а как сократить расход — в материале Как тратить меньше токенов в Claude Code.

Частые ошибки

Claude Code всё равно просит войти. Переменные заданы не в том окне или файл профиля не перечитан. Проверьте адрес:

echo $ANTHROPIC_BASE_URL

Пустой вывод означает, что переменная не видна этому терминалу.

401. Ключ неверный или отключён. Скопируйте его из кабинета заново и проверьте, что в кавычки не попал лишний пробел.

402. Закончился баланс. Дождитесь нового периода или докупите пакет токенов.

404 или Model not found. Такой модели нет в списке. Проверьте написание ID.

429. Модель перегружена у провайдера. Повторите запрос через несколько секунд.

«Your organization has disabled Claude subscription access for Claude Code». Администратор организации отключил вход по подписке. В сообщении предлагается использовать API-ключ, и настройка выше подходит, если правила вашей компании разрешают сторонний доступ.

Если проблема в запуске самой программы, посмотрите разбор Claude Code не запускается.

Частые вопросы

Можно ли использовать ключ из консоли Anthropic? Да, тогда ANTHROPIC_BASE_URL не нужен. Но консоль и API Anthropic не работают из России.

Нужен ли VPN с ключом PurpleSchool? Нет, запросы идут на адрес шлюза PurpleSchool, а не напрямую в Anthropic.

Можно ли попробовать бесплатно? Новым аккаунтам с почтой из белого списка доступен пробный баланс на 500 000 токенов на 7 дней.

Будут ли работать агенты и инструменты Claude Code? Да, со стороны Claude Code это обычный адрес с протоколом Anthropic.

Итог

Для перехода на API-ключ достаточно двух переменных и проверки через /status. Подписка при этом остаётся сохранённой, и к ней легко вернуться. Если вы в России, начните с AI для кода от PurpleSchool: ключ появится в кабинете сразу после оплаты, а работать он будет и в Claude Code, и в вашем собственном коде.