Claude Code без подписки: как подключить по API-ключу

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

Чем режимы отличаются

Подписка — это фиксированная сумма в месяц и квоты, которые обнуляются по расписанию. Когда квота заканчивается, агент останавливается, и ускорить это никак нельзя.

Ключ — это баланс. Сколько положили, столько и работаете; закончился — пополнили. Никаких недельных окон, но и никакого «безлимита»: каждый запрос стоит денег, и в интенсивной работе счёт растёт быстро. Именно поэтому важна цена за токен.

Настройка

Claude Code читает ~/.claude/settings.json при каждом запуске. На Windows файл лежит в %USERPROFILE%\.claude\settings.json.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zukko.pro",
    "ANTHROPIC_AUTH_TOKEN": "fetch_ваш_ключ"
  }
}

Две детали, на которых спотыкаются чаще всего.

Адрес без /v1. Claude Code добавляет путь сам. Если написать https://api.zukko.pro/v1, запросы уйдут на несуществующий адрес и вы получите 404.

Именно ANTHROPIC_AUTH_TOKEN, а не ANTHROPIC_API_KEY. Первый отправляется как Bearer-токен, второй Claude Code считает признаком официального аккаунта и начинает просить логин.

Если settings.json уже существует, добавьте блок env внутрь, а не заменяйте файл целиком.

Слоты моделей

В меню /model у Claude Code три фиксированных слота — Opus, Sonnet, Haiku. Их можно переназначить на конкретные модели:

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

Это удобный рычаг: в Zukko Opus 5.5 и Sonnet 5 стоят одинаково ($0.30/$0.30), а для экономии на слот Haiku можно поставить более дешёвую модель, например glm-5.3-flash ($0.04/$0.04). Какая модель справляется с вашими задачами — проверьте на своих задачах.

Разовый запуск

Если хочется просто проверить, не трогая конфиг:

export ANTHROPIC_BASE_URL="https://api.zukko.pro"
export ANTHROPIC_AUTH_TOKEN="fetch_ваш_ключ"
claude

Переменные живут до закрытия терминала.

Расширение для VS Code

Расширение читает тот же ~/.claude/settings.json. Дополнительно включите в настройках VS Code опцию Claude Code: Disable Login Prompt, иначе оно будет предлагать вход в Anthropic, и перезагрузите окно.

Что ломается чаще всего

Просит войти в Anthropic. Токен не виден: проверьте, что переменная называется ANTHROPIC_AUTH_TOKEN, и что в JSON нет лишней запятой — она тихо ломает весь файл.

401 invalid_api_key. Ключ с опечаткой, отозван или вокруг него пробелы.

402. Пустой баланс, запросы не уходят.

404 при каждом запросе. Почти всегда лишний /v1 в адресе.

Сколько это стоит

Через Zukko↗ Claude Opus 5.5 обходится в $0.30/$0.30 за миллион токенов против официальных $4 за входные и $20 за выходные у Anthropic. Для агентской работы, где за сессию улетают сотни тысяч входных токенов, разница получается ощутимой. Оговорка: у вендоров чтение из кэша промптов стоит ~10% цены входа, а у нас кэшированные токены идут по обычной цене, так что для агентов с большим контекстом реальная разница меньше, чем «в лоб».

Ключ выдаётся в кабинете. Стартового баланса нет: пополнение — от $1, плюс $0.50 один раз за подписку на канал @zukkopro↗ (привязка Telegram в кабинете). Этого хватит, чтобы прогнать Claude Code на своей задаче и посмотреть, сколько он расходует именно у вас.