Claude Code в России: установка и работа без подписки Anthropic

Claude Code — консольный агент для разработки: он читает проект, правит файлы и запускает команды прямо в терминале. Вопрос «Claude Code в России» обычно упирается не в установку, а в доступ и оплату: зарубежная карта, аккаунт и подписка. Ниже — путь без подписки Anthropic: ставим программу и подключаем её к шлюзу двумя переменными окружения, а платим за токены. Пополнить баланс из России можно по СБП, картой MasterCard или криптой.

Что понадобится

• Терминал: macOS, Linux, Windows (PowerShell, CMD или WSL).
• Ключ вида fetch_.... Создаётся на странице API-ключей↗ после пополнения баланса (от $1). Полный ключ показывается один раз.
• Пара минут на настройку. Сам по себе Claude Code при таком подключении платным аккаунтом Anthropic не пользуется: токены оплачиваются с баланса шлюза.

Пополнение через СБП пошагово описано в статье оплата через СБП↗; платёжная страница добавляет комиссию 8,5% сверху.

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

Актуальные команды всегда смотрите в официальной документации Claude Code, раздел Setup: способы и версии меняются. На момент написания официальная документация предлагает следующее.

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Альтернатива через npm (нужен Node.js 22 или новее, не используйте sudo):

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

Откройте новое окно терминала и проверьте:

claude --version
claude doctor

claude --version печатает номер версии, claude doctor выводит диагностику установки. Если оболочка не находит claude, значит папка установки не попала в PATH: документация описывает, как это исправить. Если адрес установщика у вас не открывается, попробуйте вариант с npm.

Шаг 2. Подключение к шлюзу

Нужны две переменные. Адрес указывается без /v1: Claude Code сам дописывает путь к /v1/messages. И важно: ключ передаётся именно через ANTHROPIC_AUTH_TOKEN.

macOS, Linux, WSL (bash или zsh):

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

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.zukko.pro"
$env:ANTHROPIC_AUTH_TOKEN = "fetch_ваш_ключ"
$env:ANTHROPIC_MODEL = "claude-sonnet-5-5"

Чтобы не вводить переменные каждый раз, можно записать их в файл настроек Claude Code ~/.claude/settings.json в блок env (сверьтесь с разделом Settings официальной документации):

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

Не коммитьте этот файл и не публикуйте ключ. Пошаговая настройка есть в документации Zukko по Claude Code↗.

Шаг 3. Первый запуск

Перейдите в папку проекта и запустите агента:

cd ~/my-project
claude

Задайте простой вопрос: «Опиши структуру этого проекта в пяти пунктах». Если ответ пришёл, подключение работает. Расход видно на странице «Использование» в кабинете. Следующий шаг — описать правила проекта в файле CLAUDE.md в корне репозитория: агент читает его в начале сессии.

Выбор модели

Переменная ANTHROPIC_MODEL задаёт модель. Цены Zukko на 18 октября 2026, $ за 1M токенов:

Пример расчёта небольшой сессии (10 запросов, допущения: 20 000 токенов свежего входа, 20 000 записи в кэш, 150 000 чтения из кэша, 8 000 выхода):

• claude-sonnet-5-5: 20 000 × 0.4 + 20 000 × 0.5 + 150 000 × 0.05 + 8 000 × 2 = 8 000 + 10 000 + 7 500 + 16 000 = 41 500, то есть $0.0415.
• claude-opus-5-5: 20 000 × 0.8 + 20 000 × 1 + 150 000 × 0.08 + 8 000 × 4 = 16 000 + 20 000 + 12 000 + 32 000 = 80 000, то есть $0.08.

(Каждое слагаемое делится на 1 000 000.) Это расчёт на допущениях, а не обещание: реальный расход зависит от проекта. В формате Anthropic, то есть в Claude Code, шлюз видит чтение и запись кэша по отдельности, поэтому они тарифицируются по своим ценам. Подробнее: сколько стоит агент Claude Code↗.

Любую модель из каталога можно вызвать и в формате Anthropic, в том числе не от Claude. Но поведение агента с инструментами у разных моделей отличается, поэтому проверьте выбранную на своём проекте. Актуальный список — GET https://api.zukko.pro/v1/models.

Типичные ошибки первого запуска

Если запросы по-прежнему не проходят, проверьте ключ напрямую:

curl https://api.zukko.pro/v1/messages \
  -H "x-api-key: fetch_ваш_ключ" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":50,"messages":[{"role":"user","content":"ping"}]}'

Если curl отвечает, а Claude Code нет, проблема в переменных окружения.

Как не потратить лишнего

• Создайте отдельный ключ для Claude Code с дневным и месячным лимитом в долларах: если агент зациклится, он упрётся в лимит, а не в баланс.
• Следите за длиной сессий и очищайте контекст между задачами.
• Не отдавайте агенту рабочие секреты: держите .env вне проекта или запрещайте их чтение в настройках.

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

Нужен ли аккаунт Anthropic?

Нет: при подключении через ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN запросы идут на шлюз, а оплата — с баланса Zukko. Условия самой программы Claude Code определяет Anthropic, актуальную информацию смотрите в её документации.

Чем это отличается от подписки?

Подписка даёт доступ по тарифу сервиса, а здесь оплата по токенам, без подписки. Условия подписок смотрите на сайте сервиса, мы их не приводим.

Работает ли это в VS Code?

Да, Claude Code можно запускать во встроенном терминале редактора, а переменные окружения работают так же.

С чего начать?

Создайте ключ в кабинете Zukko↗, задайте две переменные и запустите claude в небольшом проекте.