Claude Code без подписки: подключение через API и стоимость

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

Как работает Claude Code без подписки

Claude Code — терминальный агент Anthropic. Он читает файлы проекта, предлагает правки, запускает команды и тесты. Официально агент умеет работать с подпиской или с Anthropic API. Во втором случае приложение отправляет запросы на ANTHROPIC_BASE_URL с токеном в ANTHROPIC_AUTH_TOKEN.

CheApi принимает запросы в формате Anthropic на https://cheapi.ru и в формате OpenAI на https://cheapi.ru/v1. Для Claude Code нужен первый адрес, без /v1 на конце: SDK добавит путь сам. Если указать /v1, запрос уйдёт на несуществующий /v1/v1/messages и вернёт 404.

Шаг 1. Установите Claude Code

npm install -g @anthropic-ai/claude-code
claude --version

Если npm недоступен, установите Node.js с официального сайта или через Homebrew. Для Windows используйте WSL: переменные окружения и пути будут такими же, как в macOS и Linux.

Шаг 2. Создайте ключ

Создайте ключ в кабинете: полная строка показывается один раз, дальше хранится только хеш. Если ключ попал в терминал с историей или в лог, отзовите его и выпустите новый.

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

Для одной сессии достаточно экспортировать две переменные. Для постоянной работы добавьте их в ~/.zshrc или ~/.bashrc, но не храните ключ в репозитории.

export ANTHROPIC_BASE_URL="https://cheapi.ru"
export ANTHROPIC_AUTH_TOKEN="che_sk_ваш_ключ"

claude

Шаг 4. Проверьте запрос

curl https://cheapi.ru/v1/messages \
  -H "x-api-key: che_sk_ваш_ключ" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Ответь одним словом: работает"}]
  }'

Если ответ пришёл, запускайте claude в папке проекта. Если 401 — проверьте ключ и заголовок; если 402 — баланс; если 404 — base URL и модель.

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

Для Claude Code удобно держать две модели: Sonnet по умолчанию и Opus для задач, где Sonnet зацикливается. Переключение — одна строка в запросе, отдельный ключ не нужен. Каталог с ценами и характеристиками — в разделе моделей.

Сколько стоит день работы

Один запрос агента редко ограничивается вопросом и ответом: в контекст попадают файлы, история и результаты инструментов. Для расчёта возьмём средний запрос 12 000 входных и 2 000 выходных токенов. Это ориентир, а не гарантия: фактический расход виден в истории кабинета.

Подписка Claude Pro стоит фиксированную сумму в валюте и требует зарубежной карты. API в рублях не даёт безлимита, зато не списывает деньги за дни простоя и позволяет переключаться на более дешёвую модель. Если вы работаете с агентом каждый день по несколько часов, посчитайте оба варианта на своей истории запросов.

Ошибки, которые встречаются чаще всего

• Base URL с `/v1`. Claude Code добавляет /v1/messages сам. Укажите https://cheapi.ru.
• Ключ в `ANTHROPIC_API_KEY` вместо `ANTHROPIC_AUTH_TOKEN`. Задайте оба имени или используйте ANTHROPIC_AUTH_TOKEN.
• Старая модель в конфиге. Проверьте ID в каталоге: названия вроде claude-3-5-sonnet могут быть недоступны.
• Закончился баланс. API вернёт 402, агент покажет ошибку. Пополните баланс в разделе оплаты.
• Ключ попал в git. Отзовите его и создайте новый. Не храните ключ в .env, который коммитится.

Безопасность и лимиты

Claude Code может выполнять команды в терминале и менять файлы. Запускайте его в проекте с чистой веткой git и подтверждайте опасные операции вручную. Ключ CheApi даёт доступ только к API и балансу, но утечка ключа означает расход ваших токенов. Ограничьте права ключа на уровне проекта и отзывайте его после эксперимента.

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