Как настроить Claude Code в 2026: пошагово для России и глобально

Пошаговая установка Claude Code: env-переменные, settings.json, Windows/macOS/Linux, проверка подключения и рабочая конфигурация через Claudexia.

Если вы пишете код в 2026 году, вы почти наверняка пробовали Claude Code — официальный CLI от Anthropic, который превращает Claude в настоящего пэйр-программера: он живёт у вас в терминале, читает репо, запускает тесты и редактирует файлы. За два года итераций он стал дефолтным агентным инструментом для большой части индустрии, оставив позади IDE-ассистентов начала 2020-х.

Единственная шероховатость — биллинг. Прямой API Anthropic требует американскую или европейскую корпоративную карту, ежемесячный счёт и аккаунт в Console, который неудобно шарить на команду и который просто не открывается из стран, где форма карты отказывается отправляться. Claudexia убирает это трение: те же модели Claude, тот же Anthropic-совместимый эндпоинт, но оплата по факту через крипту, карту или СБП. Настройка за 5 минут, без контракта и без минимального ежемесячного платежа.

Этот гайд проводит вас через настройку от и до на macOS, Linux и Windows, плюс GUI-инсталлятор, подход через settings.json для постоянной конфигурации, выбор модели, отслеживание расходов и короткий список ошибок, которые могут встретиться при первом запуске.

Зачем гонять Claude Code через Claudexia

Три причины в порядке частоты, с которой их называют клиенты:

Не нужен биллинг-аккаунт Anthropic. Не нужна корпоративная карта США и подписка Console. Пополните Claudexia тем способом оплаты, который реально работает в вашей стране, и начните пользоваться Claude Code в ту же минуту.
Прозрачная цена за токен. Claudexia матчит ставки Anthropic один к одному по каждой модели. Вы платите ровно за использованные токены, в дашборде виден каждый запрос с разбивкой input/output/cache, и в счёте больше ничего нет.
Один ключ на весь стек. Тот же ключ cx_... работает с Claude Code, с Python и TypeScript SDK от Anthropic, с Claude Agent SDK и с любым OpenAI-совместимым клиентом, который говорит на /v1/messages или /v1/chat/completions. Одно пополнение, один лог расходов, все инструменты.

Если у вас уже есть аккаунт Anthropic и он вас устраивает — продолжайте им пользоваться. Claudexia для тех разработчиков и команд, которым нужен Claude Code без бюрократического обхода.

Шаг 1 — Установить Claude Code

Claude Code поставляется как standalone-бинарник и как npm-пакет. Выбирайте то, что ближе к вашему workflow.

npm (везде, где есть Node ≥ 18):

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

Инсталлятор macOS / Linux (Node не нужен):

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

GUI-инсталлятор для Windows: скачайте claude-code-setup.exe с официальной страницы Claude Code и запустите. Инсталлятор добавит claude в PATH и создаст ярлык в меню «Пуск».

Проверьте установку:

claude --version

Должно появиться что-то вроде claude-code 2.x.x. Если команда не найдена — перезапустите шелл, чтобы новый PATH подхватился.

Шаг 2 — Направить Claude Code на Claudexia

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

ANTHROPIC_BASE_URL — хост API. По умолчанию — продакшн-эндпоинт Anthropic. Установите https://api.claudexia.tech, чтобы гонять через Claudexia.
ANTHROPIC_API_KEY — ваш ключ. Замените любой sk-ant-... на ключ cx_... из дашборда Claudexia.

macOS / Linux (zsh или bash):

export ANTHROPIC_BASE_URL="https://api.claudexia.tech"
export ANTHROPIC_API_KEY="cx_live_yourkeyhere"

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

Windows PowerShell (текущая сессия):

$env:ANTHROPIC_BASE_URL = "https://api.claudexia.tech"
$env:ANTHROPIC_API_KEY  = "cx_live_yourkeyhere"

Windows PowerShell (постоянно, переживёт перезагрузку):

setx ANTHROPIC_BASE_URL "https://api.claudexia.tech"
setx ANTHROPIC_API_KEY  "cx_live_yourkeyhere"

setx пишет в пользовательское окружение, поэтому закройте и откройте терминал заново, чтобы новые значения подхватились. Если предпочитаете GUI: откройте Свойства системы → Дополнительно → Переменные среды и добавьте две записи в Переменные пользователя. Этот путь — то, чем пользуются нетехнические коллеги по команде, и он работает идентично.

Шаг 3 — Проверить соединение

Откройте свежий терминал, чтобы новые env-переменные подгрузились, и:

claude --version
claude /status

claude /status делает реальный round-trip к настроенному базовому URL и печатает активную модель, аккаунт и префикс ключа. Если вы видите api.claudexia.tech в выводе и ненулевой баланс — всё готово.

Прогоните one-shot-промпт, чтобы убедиться end-to-end:

claude -p "Суммируй diff в этом репо с момента main."

Подход через settings.json (рекомендуется для команд)

Переменные окружения отлично подходят для одного разработчика на одной машине. Для команд — или для любой машины, где конфиг должен пережить смену шелла — используйте settings.json от Claude Code. Файл лежит в ~/.claude/settings.json на macOS и Linux и в %USERPROFILE%\.claude\settings.json на Windows.

{
  "apiBaseUrl": "https://api.claudexia.tech",
  "apiKey": "cx_live_yourkeyhere",
  "defaultModel": "claude-sonnet-4.6",
  "telemetry": false
}

CLI читает settings.json при каждом запуске, поэтому можно менять модель или ротировать ключ, не трогая профиль шелла. Для общих рабочих станций ставьте права 600 на файл, чтобы другие пользователи машины не могли прочитать ваш ключ.

Выбор модели

Claude Code по умолчанию использует Sonnet 4.6 — это правильный ответ примерно для 90% задач: рефакторинги, генерация тестов, ревью кода, мультифайловые правки, отладка. Sonnet достаточно быстрый, чтобы ощущаться интерактивно, и достаточно дешёвый, чтобы вы не дёргались от длинных сессий.

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

claude --model claude-opus-4.7 -p "Спроектируй стратегию шардинга для этой таблицы."

Для высокочастотной малозначимой работы (правки линта, переписывание документации, генерация коммит-сообщений) опускайтесь до Haiku:

claude --model claude-haiku-4.6 -p "Перепиши это коммит-сообщение."

Выбор модели работает и в интерактивной сессии: введите /model и выберите из списка.

Отслеживание расходов

Каждый запрос, который попадает на api.claudexia.tech, появляется в дашборде Claudexia в течение нескольких секунд с разбивкой по:

timestamp и request ID,
использованной модели,
input-токенам, output-токенам и кэшированным input-токенам,
точной долларовой стоимости вызова,
API-ключу, который сделал вызов (удобно, когда вы выдаёте разные ключи на разные машины или членам команды).

Можно фильтровать по диапазону дат, по модели или по ключу и выгружать журнал в CSV для бухгалтерии. Никаких ежемесячных счетов, никакого минимума, никаких сюрпризов — когда баланс уходит в ноль, следующий запрос возвращает 402, и вы пополняете.

Траблшутинг

Короткий список ошибок, которые скорее всего встретятся в первый день:

401 Unauthorized — неверный или просроченный ключ. Убедитесь, что ANTHROPIC_API_KEY начинается с cx_ и совпадает со значением в дашборде. Если вы недавно ротировали ключ — старый мёртв.
429 Too Many Requests — вы упёрлись в rate limit на минуту. Подождите несколько секунд и повторите. Тяжёлые параллельные агенты должны уважать заголовок Retry-After.
402 Payment Required — баланс исчерпан. Пополните в дашборде.
502 Bad Gateway / сетевые таймауты — транзитная проблема апстрима. Проверьте статус-страницу на status.claudexia.tech, прежде чем дебажить свой код.
Команда claude не найдена после установки — перезапустите шелл, чтобы подхватить новый PATH, или на Windows перелогиньтесь после завершения GUI-инсталлятора.

Итог

Пять минут от npm install до первого claude /status против Claudexia. Две переменные окружения или один settings.json — и лучший AI-пэйр-программер 2026 года подключён к биллингу, который реально работает для вас.

Полный референс — все флаги, все поля конфига, все поддерживаемые модели — смотрите в /docs/guides/claude-code.