Клодыч Открыть в Telegram

01.08.2026

Claude Code в России: установка и настройка

Половина русскоязычных гайдов по Claude Code либо устарела, либо скопирована с англоязычных статей и требует того, что давно не нужно: например, WSL на Windows. В этой статье разберу, как поставить Claude Code на macOS, Windows и Linux без лишних шагов, чем отличается авторизация через Claude Pro/Max от авторизации по API-ключу и как настроить settings.json, чтобы CLI работал через оплату в рублях.

Что такое Claude Code

Claude Code: агентный CLI-инструмент от Anthropic, который живёт прямо в терминале и умеет не просто отвечать на вопросы, а делать работу руками. Он читает файлы проекта, пишет и редактирует код, запускает тесты, коммитит в git, ставит зависимости. По сути это Claude, которому дали доступ к твоей файловой системе и shell, а не только к текстовому полю ввода.

Разница с обычным чат-интерфейсом (claude.ai или Claude в Telegram) принципиальная. В чате ты копируешь код туда-обратно вручную, а в Claude Code модель сама открывает нужные файлы, видит структуру репозитория и вносит изменения напрямую. Ты формулируешь задачу на человеческом языке, например «добавь валидацию email в форму регистрации», а агент сам решает, какие файлы трогать и в каком порядке. Это удобно для рефакторинга, ревью PR, написания тестов и рутинных задач, которые иначе съедают полдня.

Здесь стоит сделать оговорку: Claude Code не работает бесплатно и без доступа к аккаунту или API. Ему подходит либо подписка Claude Pro/Max через OAuth, либо API-ключ. Про разницу расскажу ниже, а подключение через Клодыча настраивается в settings.json из примера дальше в статье.

Claude Code скачать и установить

Чтобы claude code скачать и запустить, нужен всего один инструмент: Node.js версии 18 или новее. Дальше команды почти одинаковые на всех системах, различия только в способе установки самого Node.js и в том, из какой оболочки запускать команду.

macOS

Поставь Node.js через brew (brew install node) или через nvm, если хочешь управлять версиями параллельно. После этого установи Claude Code одной командой:

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

Запусти командой claude в терминале, находясь в папке с проектом. При первом запуске CLI спросит, как авторизоваться, об этом ниже. На macOS всё работает из коробки, никаких дополнительных системных разрешений не требуется.

Windows

Тут начинается путаница: половина статей в интернете утверждает, что для Claude Code на Windows обязательно нужен WSL, Windows Subsystem for Linux. Это не так. Claude code windows поддерживает нативно, через обычный PowerShell, без установки Linux-подсистемы, Docker или виртуальных машин.

Достаточно поставить Node.js (скачать установщик с официального сайта или выполнить winget install OpenJS.NodeJS), открыть PowerShell и выполнить ту же команду:

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

Дальше команда claude запускается прямо из PowerShell или Windows Terminal, без переключения в чужую среду. Если у тебя уже есть WSL и привычнее работать в нём, это тоже сработает, но обязательным условием не является: держать в голове лишний слой виртуализации ради одного CLI смысла нет.

Linux

На Linux, будь то Ubuntu, Debian, Fedora или Arch, порядок такой же: сначала Node.js через менеджер пакетов дистрибутива или через nvm, потом та же команда установки:

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

Если в системе стоит запрет на глобальную установку npm-пакетов без sudo, проще настроить nvm и поставить Node в домашнюю директорию: тогда права root не нужны вообще, и CLI обновляется без лишних разрешений.

Авторизация: Claude Pro/Max или API-ключ

После установки Claude Code спросит, как получать доступ к модели. Вариантов два, и они по-разному считают деньги и лимиты.

Через Claude Pro/Max (OAuth)

Если у тебя есть подписка Claude Pro или Max, можно авторизоваться через OAuth: CLI откроет браузер, ты логинишься на claude.ai, и Claude Code работает в рамках лимитов подписки. Это подходит для небольших задач: Telegram-ботов, лендингов, сайтов-визиток, магазинов и несложных сервисов на Haiku или Sonnet. Для большого репозитория, постоянной агентной работы и долгих сессий лимита Pro обычно недостаточно: он общий с остальными сценариями подписки и может закончиться в процессе работы.

Клодыч помогает оформить такую подписку за 1990 рублей в месяц с оплатой через СБП, карту или криптовалюту (открыть Claude Pro). Активация выполняется автоматически после оплаты, но её фактический срок зависит от поставщика.

Через API-ключ

Второй вариант: авторизация по API-ключу, переменная ANTHROPIC_API_KEY или совместимый токен. Оплата здесь идёт по факту использования, за токены на входе и на выходе, без месячной абонентки. Такой подход подходит для больших репозиториев, агентов, долгих задач и неравномерной нагрузки: сегодня запускаешь большой рефакторинг, завтра вообще не трогаешь CLI, и платишь за фактический объём работы.

У Клодыча API-ключ удобен, если нужна гибкость: баланс пополняется в рублях и не привязан к календарным циклам (создать ключ в Telegram). Про сам процесс получения ключа и настройку переменных окружения подробнее рассказано в статье про API-ключ Claude, а что выгоднее по деньгам между подпиской и API, разобрано отдельно в материале Claude Pro или API.

Настройка settings.json для Claude Code

Как заставить CLI ходить не напрямую в Anthropic, а через сторонний совместимый шлюз вроде Клодыча? Всё завязано на файле конфигурации.

Claude Code читает настройки из ~/.claude/settings.json на macOS и Linux и из %USERPROFILE%\.claude\settings.json на Windows. Два ключевых параметра лежат в блоке env:

  • ANTHROPIC_BASE_URL: адрес, куда CLI отправляет запросы вместо стандартного эндпоинта Anthropic.
  • ANTHROPIC_AUTH_TOKEN: токен авторизации, по которому шлюз проверяет доступ и считает баланс.

Пример полного файла для подключения через Клодыча:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://app.claudich.dev/v1",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_AUTH_TOKEN": "ВАШ_КЛЮЧ_CLAUDICH"
  },
  "model": "claude-sonnet-5"
}

Сохрани файл и перезапусти терминал (или просто открой новую сессию), и Claude Code начнёт стучаться на app.claudich.dev вместо стандартного адреса Anthropic. Поле ANTHROPIC_API_KEY в примере оставлено пустым специально: если оно не пустое, некоторые версии CLI используют его в приоритете перед ANTHROPIC_AUTH_TOKEN, и подключение через шлюз просто не сработает.

Та же схема годится не только для Claude Code. Cursor, Cline и OpenAI SDK, умеющие работать по Anthropic-совместимому протоколу, настраиваются через ту же пару переменных, только в своём формате конфига.

Как это работает у Клодыча

Клодыч принимает оплату в рублях через СБП, карту или криптовалюту и даёт Anthropic-совместимый доступ к Claude. Для Claude Code всё сводится к двум шагам: получить ключ в Telegram-боте @claudichbot и вставить его в settings.json по образцу выше, поменяв только значение ANTHROPIC_AUTH_TOKEN.

В интерфейсе бота (Mini App) видно баланс и статистику по расходу токенов, так что не придётся гадать, сколько ушло на сегодняшний рефакторинг. Если пользуешься одновременно Claude Pro для повседневных чатов и API-ключом для Claude Code, оба продукта управляются из одного бота: баланс и подписка не размазаны по десяти разным личным кабинетам, а вся статистика видна в одном месте (посмотреть тарифы и статус-строку с балансом).

С чего начать

Для небольших задач можно начать с Claude Pro через OAuth, а для постоянной разработки, крупных репозиториев и агентов использовать API-ключ. Получить ключ у Клодыча можно в Telegram: вставь его в settings.json из примера выше и выбери модель под задачу. Актуальные условия и лимиты смотри на странице тарифов или в разделе Claude Code у Клодыча; с вопросами по подключению можно обратиться в поддержку.

Получить API-ключ →
Получить API-ключ