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 по шагам
Установка и проверка
- Откройте терминал
На macOS это приложение Terminal, на Windows 11 приложение Terminal, на Windows 10 командная строка Command Prompt.
- Поставьте пакет
Выполните
npm install -g @anthropic-ai/claude-codeи дождитесь окончания установки. - Проверьте версию
Команда
claude --versionпечатает номер вида x.x.xxx. Если номер появился, агент установлен.
Anthropic распространяет Claude Code и другими путями: собственным установщиком, пакетами Homebrew и WinGet. Актуальные команды вендор держит в разделе установки своей документации на официальном сайте Claude Code. Здесь выбран npm, потому что именно его описывает инструкция Relay.
Скачивайте только из документации вендора или Relay. «Разблокированные» сборки с форумов обещают то, чего агенту не требуется: установка и так бесплатна, обходить нечего. Зато вредоносный пакет получит доступ к вашему коду и ключам.
Как подключить ключ Relay
Клиент Anthropic дописывает путь запроса сам, поэтому адрес указывается без /v1. Ниже конфигурация для macOS и Linux по документации Relay. Ключ берётся из переменной RELAY_API_KEY.
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 или другой идентификатор из каталога, цену смотрите в карточках.
Уровень усилий 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 клиент снова обращается к вендору.