Claude Code — это официальный CLI-агент от Anthropic, который превращает терминал в полноценную пару для разработчика: читает репозиторий, правит файлы, запускает тесты, открывает PR. Проблема одна — из России к нему не подключиться напрямую: Anthropic блокирует регистрацию по IP и не принимает российские карты. В этой статье — как установить Claude Code на Windows, macOS и Linux, как обойти блокировку без VPN и как оплатить подписку через СБП или карту МТС.
Почему Claude Code не работает из России напрямую
При попытке логина в claude.ai/code Anthropic проверяет три вещи: страну по IP, поддерживаемость номера телефона и страну выпуска карты. Если хотя бы один сигнал указывает на Россию, СНГ или часть других регионов — аккаунт не создаётся, а уже существующие ключи через несколько дней деактивируются. VPN решает только первую проверку — карту и номер всё равно нужно американские.
Claudexia делает иначе: вы получаете API-ключ формата sk_cdx_… на нашем шлюзе, оплачиваете СБП или картой РФ, а Claude Code работает с тем же протоколом Anthropic Messages API через другой BASE_URL. Никаких VPN, виртуальных карт и аккаунтов Anthropic.
Установка Claude Code: пошагово для каждой ОС
Windows 10/11
В PowerShell от обычного пользователя:
irm https://claude.ai/install.ps1 | iex
Если в корпоративной сети заблокирован claude.ai, скачайте claude-windows-x64.exe с GitHub-релизов Anthropic и положите в C:\Users\<you>\bin, добавив папку в PATH. Перезапустите PowerShell.
macOS
curl -fsSL https://claude.ai/install.sh | bash
Через Homebrew:
brew install anthropic-ai/claude/claude
Linux (Ubuntu, Debian, Fedora, Arch)
curl -fsSL https://claude.ai/install.sh | bash
Скрипт ставит бинарь в ~/.local/bin/claude. Если этой папки нет в PATH, добавьте в ~/.bashrc или ~/.zshrc:
export PATH="$HOME/.local/bin:$PATH"
Проверьте установку: claude --version. Должно вывести что-то вида claude 1.x.x.
Подключение Claudexia к Claude Code (без VPN)
Claude Code читает две переменные окружения: ANTHROPIC_API_KEY и ANTHROPIC_BASE_URL. Подменив их на значения Claudexia, вы получаете рабочий Claude Code из России без VPN и аккаунта Anthropic.
macOS / Linux
Добавьте в ~/.zshrc или ~/.bashrc:
export ANTHROPIC_BASE_URL="https://api.claudexia.tech"
export ANTHROPIC_API_KEY="sk_cdx_ВАШ_КЛЮЧ"
Перезапустите терминал или выполните source ~/.zshrc.
Windows (PowerShell, постоянно)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.claudexia.tech", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk_cdx_ВАШ_КЛЮЧ", "User")
Закройте окно и откройте новое — переменные подхватятся.
Только на одну сессию
Если не хотите трогать профиль:
ANTHROPIC_BASE_URL=https://api.claudexia.tech ANTHROPIC_API_KEY=sk_cdx_… claude
Запустите claude в любом репозитории — агент начнёт работать через Claudexia. Никаких VPN, прокси, доменных файлов hosts.
Где взять API-ключ Claudexia
- Регистрация на claudexia.tech — занимает 60 секунд, нужен только email.
- Пополнение баланса через СБП, карту РФ, МТС-кошелёк, ЮKassa, Platega или крипту (USDT/BTC/ETH через CryptoCloud и CryptoBot). Минимального депозита нет.
- В личном кабинете → раздел «API-ключи» → «Создать ключ». Можно ограничить ключ конкретными моделями (например, только Sonnet 4.6) или дневным лимитом — для безопасности.
- Скопируйте ключ формата
sk_cdx_…и подставьте вANTHROPIC_API_KEY.
Какую модель выбрать для Claude Code
В CLI и в ~/.config/claude/settings.json можно зафиксировать модель:
{
"model": "claude-sonnet-4.6-20251001"
}
Рекомендации по моделям в Claude Code:
- Claude Sonnet 4.6 — баланс цены и качества, дефолт для большинства задач разработки.
- Claude Opus 4.7 — длинные рефакторинги, многомодульные задачи, контекст до 1M токенов. Дороже в 5 раз, но в сложных PR качество ощутимо выше.
- Claude Haiku 4.5 — быстрые правки, генерация коммитов, авто-комплит. Дёшево, идеально для агентов с большим количеством мелких вызовов.
Сколько стоит Claude Code через Claudexia
Подписки нет — только оплата по факту за миллион токенов на каждой модели. На практике активный разработчик с 30-40 PR в неделю на Sonnet 4.6 тратит 8-15$ в месяц с включённым prompt caching. Это в разы дешевле подписки Claude Pro (20$/мес) или Claude Max (200$/мес), если вы не упираетесь в лимиты постоянно.
Кэширование снижает счёт ещё на 60-80%: Claudexia пробрасывает заголовки cache_control напрямую, так что Claude Code платит за кэш-чтение по тарифу 0.10x от обычного.
Частые проблемы и как их решать
claude не запускается, ошибка command not found — папка установки не в PATH. Откройте новый терминал; если не помогло, проверьте echo $PATH (Linux/macOS) или $env:PATH (PowerShell).
401 Unauthorized или invalid_api_key — ключ скопирован с пробелом или подставлен старый. Создайте новый ключ в личном кабинете Claudexia, замените переменную, перезапустите терминал.
429 rate_limit_exceeded — стоит дневной лимит на ключе или закончился баланс. Откройте дашборд Claudexia → пополните или поднимите лимит.
getaddrinfo ENOTFOUND api.anthropic.com — переменная ANTHROPIC_BASE_URL не подцепилась. Запустите echo $ANTHROPIC_BASE_URL — должно вывести https://api.claudexia.tech. Если пусто — перезапустите редактор и терминал.
Claude Code в Cursor/VS Code-расширении не видит ключ — расширения иногда читают только переменные на момент старта IDE. Полностью закройте редактор (Cmd+Q на macOS, не просто закрытие окна) и откройте заново.
Часто задаваемые вопросы
Работает ли Claude Code без VPN из России? Да, через Claudexia. Anthropic не видит, что запрос идёт из РФ — для него это обычный API-вызов с американского IP нашего шлюза.
Нужен ли аккаунт Anthropic для Claude Code через Claudexia? Нет. Claudexia выдаёт собственные ключи sk_cdx_…, отдельная регистрация в Anthropic не нужна.
Можно ли использовать Claude Code на Windows 7 / Windows Server? Официально Anthropic поддерживает Windows 10+ и Windows Server 2019+. На более старых системах CLI может не запуститься — рекомендуем macOS или Linux.
Что с MCP-серверами и skills? Полностью совместимо. Claudexia пробрасывает MCP-протокол прозрачно — все ваши serenity, gitnexus, firecrawl и прочие MCP работают как с обычным Anthropic-ключом.
Какой формат ключа? Claudexia использует sk_cdx_…. Anthropic-родной sk-ant-… тоже сработает, если у вас уже есть рабочий ключ Anthropic — но смысл Claudexia именно в том, чтобы не иметь дела с Anthropic напрямую.