К содержимому
Блог

Claude Code: установка и три способа оплаты

Claude Code: установка и три способа оплаты

Claude Code ставится одной командой, а вот с оплатой у новичков вопросов больше, чем с установкой. Программа бесплатна. Деньги просят за модель, которая работает внутри агента, и заплатить за неё можно тремя способами: подпиской Anthropic, токенами у самого вендора или токенами через ключ шлюза. Дальше установка по шагам, сравнение способов и настройка клиента на ключ Relay.

Коротко

  • Агент ставится командой npm install -g @anthropic-ai/claude-code, нужен Node.js 22 или новее.

  • Платить приходится за модель: подписка вендора, токены у вендора или токены через шлюз.

  • В Relay подписки нет, деньги списываются с баланса за каждый запрос, расход виден в консоли.

  • Клиент переключается на шлюз переменными окружения, возврат к подписке сводится к их удалению.

Что понадобится до установки

Агент работает в терминале, а пакет требует Node.js версии 22 или новее. Так написано в инструкции Relay: этого требует текущая версия Claude Code. На Windows дополнительно нужен Git for Windows. Запускать Node.js и Git после установки отдельно не надо.

Ключ создаётся в консоли Relay. Полный ключ показывается один раз, поэтому сохраните его сразу и держите вне репозитория. Для каждого ключа можно задать суточный лимит расходов, лимит запросов в минуту и список доступных моделей. На первые дни поставьте небольшой суточный лимит: так вы увидите реальный расход агента, не рискуя балансом.

Установка Claude Code по шагам

Установка и проверка

  1. Откройте терминал

    На macOS это приложение Terminal, на Windows 11 приложение Terminal, на Windows 10 командная строка Command Prompt.

  2. Поставьте пакет

    Выполните npm install -g @anthropic-ai/claude-code и дождитесь окончания установки.

  3. Проверьте версию

    Команда claude --version печатает номер вида x.x.xxx. Если номер появился, агент установлен.

Anthropic распространяет Claude Code и другими путями: собственным установщиком, пакетами Homebrew и WinGet. Актуальные команды вендор держит в разделе установки своей документации на официальном сайте Claude Code. Здесь выбран npm, потому что именно его описывает инструкция Relay.

Скачивайте только из документации вендора или Relay. «Разблокированные» сборки с форумов обещают то, чего агенту не требуется: установка и так бесплатна, обходить нечего. Зато вредоносный пакет получит доступ к вашему коду и ключам.

Как подключить ключ Relay

Клиент Anthropic дописывает путь запроса сам, поэтому адрес указывается без /v1. Ниже конфигурация для macOS и Linux по документации Relay. Ключ берётся из переменной RELAY_API_KEY.

bash
export ANTHROPIC_BASE_URL=https://relay-llm.ru
export ANTHROPIC_AUTH_TOKEN="$RELAY_API_KEY"
export ANTHROPIC_MODEL=claude-haiku-5.5
export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-haiku-5.5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-haiku-5.5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-haiku-5.5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5.5
export CLAUDE_CODE_SUBAGENT_MODEL=claude-haiku-5.5
export CLAUDE_CODE_EFFORT_LEVEL=xhigh

Чтобы настройки пережили перезапуск терминала, документация дописывает их в ~/.zshrc или ~/.bashrc, после чего выполняется source. На Windows те же значения задаются командой setx в PowerShell, готовые строки лежат на странице интеграции с Claude Code. Затем в папке проекта запустите claude.

Четыре переменные ANTHROPIC_DEFAULT_*_MODEL отвечают за псевдонимы Fable, Opus, Sonnet и Haiku, ещё одна за субагентов. Задайте их все. Иначе агент запросит собственные названия моделей, и шлюз может ответить ошибкой выбора модели.

В примере везде стоит claude-haiku-5.5: для первых опытов подойдёт модель поменьше. Для сложных задач подставьте claude-sonnet-5-5 или другой идентификатор из каталога, цену смотрите в карточках.

Каталог моделей

Claude Sonnet 5.50,52 $ за 1 млн входных токенов

Уровень усилий xhigh заставляет модель рассуждать дольше, а рассуждения тарифицируются как выходные токены, так описывает вендор. На простых задачах его можно понизить. Если у маршрута модели нет формата Anthropic Messages, шлюз ответит 503 model_unavailable: смените модель, а для других клиентов используйте Chat Completions, подробности в описании Messages API. Вендор сторонние шлюзы не поддерживает и не проверяет, поэтому при сбое сначала сверьте адрес, ключ и имя модели, а идентификатор запроса из заголовка x-request-id найдёт строку в журнале.

Три способа оплатить доступ к модели

Условия подписок ниже взяты со страницы тарифов на официальном сайте Anthropic по состоянию на 29 октября 2026 года. Суммы вендор указывает в долларах и меняет, поэтому сверьте их перед покупкой.

СпособЧто вы платитеКто задаёт лимитыЧто учесть
Подписка Anthropic (Pro, Max, Team)Фиксированную сумму в месяц, у Pro при оплате за год она ниже, у Max выше в несколько разВендор: окно на пять часов и недельный потолокВ бесплатном тарифе Claude Code нет, доступность зависит от страны
Аккаунт Console у AnthropicТокены по ставкам вендораВендор, по уровню аккаунтаНужен аккаунт в поддерживаемой стране
Ключ RelayТокены с баланса, подписки нетВы: лимиты расхода и запросов на каждый ключВендор не поддерживает сторонние шлюзы

Подписка удобна, пока вы работаете каждый день и не упираетесь в окна: счёт фиксирован. Токены лучше ложатся на неровную нагрузку. В месяц, когда вы почти не открывали агент, платить нечего, а в разгар проекта не приходится ждать сброса окна. Свой профиль проверяется без риска: неделю поработайте на ключе с небольшим дневным лимитом и сравните расход с ценой подписки. Как устроены окна и недельный потолок, вендор описывает в справке по тарифам.

Список стран, где Anthropic предлагает свои продукты, вендор публикует на официальном сайте. Через Relay вы платите самому шлюзу с баланса, а правовой режим использования и условия вендора каждый оценивает для себя сам.

Почему счёт растёт быстрее, чем кажется

Одно сообщение в агенте превращается в несколько обращений к модели. Сначала агент просит модель понять задачу, потом читает файлы и планирует правки, после запуска инструмента возвращается к модели снова. Биллинг фиксирует каждый реальный вызов, поэтому на одно сообщение в журнале бывает несколько строк. Это описано в разделе резерва и списания.

Контекст растёт вместе с проектом, и каждый следующий запрос несёт его целиком. Три привычки снижают расход заметнее всего:

  • начинайте новый диалог, когда прежний контекст больше не нужен;

  • не просите агента читать весь проект без причины;

  • на простые правки переключайтесь на модель поменьше командой /model.

Токены чтения кэша и фактическое списание сверяйте в журнале запросов: цена чтения кэша указана в каталоге, а запись кэша отдельной ценой там не публикуется.

Нужна ли подписка Claude, чтобы запустить Claude Code через Relay?

Нет. Нужны ключ и положительный баланс: на нулевом балансе запросы получают ошибку 402. Подписки у Relay нет, деньги списываются за токены.

Почему после одного сообщения в журнале несколько записей?

Агент делает по одному сообщению несколько обращений к модели: понять задачу, прочитать файлы, вернуться после запуска инструмента. Каждое обращение тарифицируется отдельно, а выбранную вами модель клиент иногда подменяет для вспомогательных шагов.

Как вернуться к подписке Anthropic?

Удалите добавленные строки из ~/.zshrc или ~/.bashrc и откройте новый терминал. Без ANTHROPIC_BASE_URL клиент снова обращается к вендору.

Создать ключ

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.