Как запустить Claude Code на сервере (VPS) из России в 2026

Обновлено 6 октября 2026 года.

Claude Code можно поставить на любой VPS, в том числе в российском дата-центре, но схема «зарубежный сервер плюс свой аккаунт Anthropic», которую советовала и прежняя версия этой инструкции, больше не годится. Anthropic не обслуживает Россию, и зарубежный IP сервера этого не меняет: в волну блокировок 1–5 октября 2026 года аккаунты потеряли в том числе подписчики Max за $200 в месяц, которые больше года работали с одного зарубежного адреса. На сервере Claude Code сейчас запускают с моделями другого провайдера — DeepSeek, Kimi или GLM через их Anthropic-совместимый API — либо с моделями Claude через российский агрегатор GPTunnel. Если не хотите зависеть от Anthropic совсем, ставьте на сервер открытый OpenCode.

Коротко:

• Зарубежный VPS не делает доступ к Claude легальным. России нет в списке стран Anthropic, а в системных требованиях Claude Code указано «Location: Anthropic supported countries». Что делать, если аккаунт уже заблокировали, — в статье «Claude заблокировал аккаунт: что делать».
• Установка: curl -fsSL https://claude.ai/install.sh | bash или npm-пакет @anthropic-ai/claude-code, которому нужен Node.js 22+. Node 18, как писали раньше, уже не подходит.
• DeepSeek: адрес https://api.deepseek.com/anthropic, ключ из консоли DeepSeek, модель deepseek-flash. API DeepSeek отвечает с российского IP — проверили 6 октября 2026 года.
• GPTunnel: модели Claude без аккаунта Anthropic, оплата в рублях. Адрес — https://gptunnel.ru, без /v1 на конце.
• Сервер: от 2 vCPU и 4 ГБ RAM, Ubuntu 22.04 или 24.04. Для DeepSeek и GPTunnel зарубежный IP не нужен, поэтому дата-центр в Москве или Петербурге подходит.

Почему зарубежный VPS больше не решение

Логика прежних инструкций была такой: API Anthropic отвечает ошибкой 403 на российские IP (так было и 6 октября 2026 года, когда мы проверяли api.anthropic.com с российского IP), значит, Claude Code надо унести на сервер в Нидерландах или Финляндии и войти там по подписке. Запросы при этом действительно проходили. Но правила Anthropic смотрят не на адрес сервера, а на то, где находится пользователь. Россия не входит в список поддерживаемых стран ни для claude.ai, ни для API. В справке Anthropic создание аккаунта из неподдерживаемого региона прямо названо основанием для блокировки, а Usage Policy запрещает предоставлять доступ к Claude в обход политики поддерживаемых регионов. А в документации по установке Claude Code поддерживаемая страна стоит в одном ряду с версией ОС и объёмом памяти.

В 2026 году эти правила начали применять волнами. 8 мая CNews сообщил об отключении нескольких сотен российских аккаунтов. С 1 октября под блокировки попали пользователи из России, Гонконга и Китая. По данным Inc., среди пострадавших есть подписчики Max, «которые больше года работали с одного зарубежного IP-адреса», а часть подключалась через виртуальный сервер. The Moscow Times описала пользователя, который заходил через сервер в Хельсинки и всё равно лишился аккаунта. Anthropic волну публично не комментировала.

Поэтому сервер в России или за рубежом — вопрос пинга и оплаты, а не доступа к Claude. Входить на сервере по подписке Pro или Max, ключом из Anthropic Console или через купленный аккаунт мы не советуем: всё это нарушает правила с первого дня, а риски покупки разобраны в статье о покупке аккаунтов ChatGPT и Claude.

Какие варианты работают на сервере в 2026 году

Оговорка про варианты А и Б. Подменяя адрес API, вы меняете модель, но не сам клиент. Anthropic описывает такую подмену как штатную функцию для подключения LLM-шлюзов (документация LLM gateway), однако требование о поддерживаемых странах из документации к Claude Code никуда не делось. Кроме того, часть служебного трафика идёт мимо выбранного адреса: проверка версий, телеметрия и release notes уходят к Anthropic и на GitHub, а проверка fast mode обращается к api.anthropic.com напрямую. Первые три отключаются переменной CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, но вместе с ними выключатся и автообновления. Кому нужен инструмент вообще без Anthropic, тому подойдёт вариант В.

Какой VPS выбрать

Claude Code — лёгкий процесс: модель работает у провайдера, а сервер держит терминал, ваш репозиторий, сборку и тесты. По документации нужны 4 ГБ RAM или больше, процессор x64 или ARM64 и Ubuntu 20.04+, Debian 10+ или Alpine 3.19+.

• Ресурсы. 2 vCPU и 4 ГБ RAM хватает на один проект. Если держите несколько проектов, собираете тяжёлый фронтенд или запускаете Docker, берите 4 vCPU и 8 ГБ.
• Диск. 30–50 ГБ NVMe: node_modules и кэши растут быстрее, чем кажется.
• ОС. Ubuntu 22.04 или 24.04 LTS — меньше всего возни с зависимостями.
• Локация. Для DeepSeek и GPTunnel зарубежный IP не нужен: API DeepSeek и сайт GPTunnel отвечают с российского IP (проверили 6 октября 2026 года). Сервер в Москве или Петербурге даёт меньший пинг из России и оплату в рублях.

Ещё один вариант — Aeza, её локации и тарифы смотрите при заказе. Цены и доступность локаций меняются, перед оплатой сверьтесь с панелью провайдера. Общая логика выбора сервера под агентов разобрана в материале о запуске нейросетей и AI-агентов на VPS из России.

Установка Claude Code на сервер

Шаг 1. Подключитесь по SSH и создайте пользователя

После оплаты провайдер пришлёт IP-адрес, логин (обычно root) и пароль. Подключаемся с локальной машины:

ssh root@ВАШ_IP

На Windows подойдёт встроенный OpenSSH в PowerShell, PuTTY или Termius. Сначала обновите систему и заведите отдельного пользователя — работать под root постоянно не стоит:

apt update && apt upgrade -y
adduser dev
usermod -aG sudo dev
su - dev

Шаг 2. Поставьте Claude Code

Anthropic рекомендует нативный установщик: Node.js для него не нужен, программа обновляется сама в фоне.

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

claude doctor выводит диагностику установки и настроек, не запуская сессию. Обновить вручную можно командой claude update; она понадобится, если вы отключите служебный трафик (см. выше).

Второй официальный способ — npm. Он удобен, если на сервере уже есть Node.js или нужна конкретная версия. Пакету нужен Node.js 22 или новее:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v

Глобальную установку не запускайте через sudo — так прямо сказано в документации Anthropic. Чтобы npm не упирался в права, настройте пользовательский каталог для глобальных пакетов:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code
claude --version

Обновляют npm-версию командой npm install -g @anthropic-ai/claude-code@latest, а не npm update -g. На 6 октября 2026 года последняя версия — 2.1.291.

Шаг 3. Подключите модель

При заданных переменных ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN Claude Code стартует без экрана входа в аккаунт Anthropic. Токен уходит в заголовке Authorization: Bearer и по приоритету стоит выше ANTHROPIC_API_KEY, который к тому же один раз запрашивает подтверждение. Переменные удобнее всего прописать в блоке env файла ~/.claude/settings.json в домашнем каталоге: он действует для всех проектов, а значения из него перекрывают одноимённые export в терминале. Дальше — два варианта.

Вариант А: DeepSeek, Kimi или GLM через Anthropic-совместимый API

У трёх китайских провайдеров есть свои адреса в формате Anthropic Messages API и официальные инструкции для Claude Code. Пишет код в этом случае модель провайдера, не Claude. По замеру автора Habr от 1 октября 2026 года, API DeepSeek, Kimi и Z.ai (GLM) отвечали с домашнего московского IP; DeepSeek мы перепроверили 6 октября.

DeepSeek

Ключ создаётся в консоли DeepSeek. Набор переменных взят из официальной инструкции DeepSeek, последняя строка добавлена из документации Anthropic:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "ключ DeepSeek",
    "ANTHROPIC_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "786432",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Заполняйте все слоты моделей. Если оставить в каком-то из них имя вроде claude-opus, DeepSeek подставит deepseek-v4-pro и посчитает запросы по цене Pro. Встроенный веб-поиск Claude Code с DeepSeek работает, но тратит дополнительные токены.

Цены DeepSeek за 1 млн токенов в часы пик: у deepseek-flash (V4.1 Flash) $0,30 на вход без кэша и $1,20 на выход, у deepseek-v4-pro $1,32 и $3,96. Пиковые часы — 01:00–04:00 и 06:00–10:00 UTC с понедельника по пятницу, по Москве это 04:00–07:00 и 09:00–13:00. В остальное время вдвое дешевле. Баланс пополняется в долларах, российские карты, по опыту пользователей, не проходят. Нужна карта зарубежного банка или виртуальная, например «Плати по миру»; способы оплаты разобраны в статье о DeepSeek в России, а тарифы и возможности модели собраны в карточке DeepSeek в каталоге.

Kimi и GLM

Схема та же, меняются адрес и имена моделей:

В инструкции Kimi прямо предупреждают: если заполнить только часть переменных, соответствующие сценарии (фоновые задачи, субагенты) молча падают. Там же советуют убрать старые значения ANTHROPIC_* из ~/.claude/settings.json и из ~/.bashrc, иначе они перебьют новую настройку. Z.ai добавляет в блок env ещё "API_TIMEOUT_MS": "3000000". Лимиты Coding Plan считаются в кредитах: у тарифа Lite — 2 000 за 5 часов и 10 000 в неделю (Z.ai). Чем эти модели отличаются друг от друга, рассказываем в обзоре китайских нейросетей.

После правки файла перезапустите claude и выполните /status: в строках «Anthropic base URL» и «Auth token» должен стоять адрес провайдера и ваш токен.

Локальная модель через Ollama

Если у сервера есть видеокарта, Claude Code можно подключить к модели, запущенной на нём же. Ollama отдаёт Anthropic-совместимый API на своём порту: быстрый запуск — ollama launch claude, вручную — ANTHROPIC_BASE_URL=http://localhost:11434, ANTHROPIC_AUTH_TOKEN=ollama, пустой ANTHROPIC_API_KEY и claude --model с именем скачанной модели. Для больших репозиториев в Ollama советуют контекст от 64 тыс. токенов. На VPS без GPU такой вариант будет очень медленным; как выбрать сервер под локальные модели, мы разбирали в статье о развёртывании LLM на сервере.

Вариант Б: модели Claude через GPTunnel

Если нужен именно Claude, его отдаёт российский агрегатор GPTunnel (gptunnel.ru) с оплатой в рублях. У него есть Anthropic-совместимый эндпоинт /v1/messages. По документации сервиса, запросы через него не переводятся в другой формат: тело запроса уходит к Anthropic как есть, а SDK и Claude Code начинают работать после подмены адреса и ключа. Через этот эндпоинт доступны только модели Claude, инструмент code_execution не поддерживается. По промокоду AILIST10 начисляют +10% к пополнению.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gptunnel.ru",
    "ANTHROPIC_AUTH_TOKEN": "ключ из личного кабинета GPTunnel",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Главная ошибка в старых инструкциях, включая прежнюю версию этой статьи, — адрес https://gptunnel.ru/v1. Claude Code сам дописывает к базовому адресу /v1/messages, и запрос уходит на /v1/v1/messages. 6 октября 2026 года такой адрес вернул нам ошибку 405, а правильный /v1/messages — ошибку авторизации, то есть маршрут на месте. GPTunnel принимает ключ и в заголовке x-api-key, и как Bearer-токен, поэтому подходит ANTHROPIC_AUTH_TOKEN. Актуальные имена моделей Claude смотрите в личном кабинете: если нужна конкретная модель, задайте её в ANTHROPIC_MODEL.

Обратная сторона: Usage Policy Anthropic запрещает давать доступ к Claude пользователям из неподдерживаемых регионов, и это требование касается посредников. Работа любого агрегатора с моделями Claude зависит от его отношений с Anthropic, поэтому держите запасной вариант из раздела А или В. Похожие сервисы — BotHub, VseGPT, ProxyAPI, AITunnel; есть ли у них Anthropic-совместимый протокол, сверяйте по их документации, сравнение — в обзоре агрегаторов нейросетей без VPN и в материале про доступ к API из России.

Вариант В: OpenCode вместо Claude Code

OpenCode — открытый агент для терминала под лицензией MIT, по логике работы близкий к Claude Code. Сам сервис из России доступен, модели подключаются по ключу провайдера, в том числе DeepSeek и GPTunnel (через OpenAI-совместимый API). Скиллы из .claude/skills он читает сам; первая версия берёт инструкции из CLAUDE.md, если нет AGENTS.md, а вторая понимает только AGENTS.md.

Для сервера у OpenCode есть режимы, которых нет у Claude Code (документация):

• opencode serve — HTTP-сервер без интерфейса, к нему подключаются командой opencode attach http://адрес:4096;
• opencode web --port 4096 --hostname 0.0.0.0 — веб-интерфейс в браузере; пароль задаётся переменной OPENCODE_SERVER_PASSWORD, без неё сервер открыт для всех;
• opencode run "задача" — неинтерактивный запуск для скриптов и cron.

Установка, тарифы Go и Zen и пример конфига с GPTunnel — в нашей статье «OpenCode в России».

Запуск в фоне через tmux

Если просто запустить claude в SSH-сессии и закрыть терминал, процесс умрёт. Чтобы агент пережил отключение и долгие задачи шли своим чередом, используют tmux (или screen). tmux держит сессию на сервере живой, а вы к ней «прицепляетесь» и «отцепляетесь».

sudo apt install -y tmux

# создать именованную сессию
tmux new -s claude

# внутри сессии запускаем агента
cd ~/myproject
claude

Чтобы выйти из сессии, не убивая её, нажмите Ctrl+b, затем d (detach). Теперь можно закрыть SSH — Claude Code продолжит работу. Вернуться позже:

# список сессий
tmux ls

# подключиться обратно
tmux attach -t claude

С телефона к той же сессии удобно заходить через SSH-клиент вроде Termius. Встроенный Remote Control Claude Code тут не поможет: по документации, он отключается, когда ANTHROPIC_BASE_URL указывает не на Anthropic. Для нескольких проектов заведите по сессии на каждый и переключайтесь между ними по именам. Если на том же сервере живут и другие агенты, общие рекомендации по конфигурации — в заметке о том, на каком VPS запускать AI-агентов.

Безопасность ключей и сервера

На сервере лежат ключ провайдера и доступ к вашим репозиториям. Минимальный набор мер:

• SSH по ключу, а не паролю. Сгенерируйте пару ssh-keygen, добавьте публичный ключ на сервер (ssh-copy-id dev@IP) и отключите вход по паролю в /etc/ssh/sshd_config (PasswordAuthentication no).
• Ключ — только в домашнем ~/.claude/settings.json. Проектный .claude/settings.json обычно коммитится в git, ключ туда класть нельзя; для локальных настроек проекта есть .claude/settings.local.json. Файл с ключом закройте правами chmod 600.
• Файрвол. Включите ufw и оставьте открытым только SSH: sudo ufw allow OpenSSH && sudo ufw enable. Если запускаете opencode web, открывайте порт только вместе с паролем.
• Права агента. Claude Code выполняет команды в системе. Запускайте его под обычным пользователем, а не под root, и читайте, что он собирается выполнить, прежде чем подтверждать. Режимы подтверждения на боевом окружении не отключайте.
• Ротация ключей. Если ключ мог утечь, отзовите его в кабинете провайдера или агрегатора и выпустите новый.

FAQ

Нужен ли VPN для Claude Code на VPS?

Нет. С DeepSeek, Kimi, GLM или GPTunnel Claude Code обращается к адресу провайдера, а эти адреса из России доступны. VPN или зарубежный сервер не решают главную проблему с аккаунтом Anthropic: Россия не входит в число поддерживаемых стран, доступ в обход региона нарушает правила компании и ведёт к блокировке. В октябре 2026 года блокировали в том числе тех, кто больше года работал с одного зарубежного адреса.

Какого сервера хватит для Claude Code?

Для одного проекта — 2 vCPU, 4 ГБ RAM (это минимум по документации Anthropic), 30–50 ГБ NVMe и Ubuntu LTS. Модель работает на стороне провайдера, поэтому видеокарта не нужна. Ресурсы стоит увеличить до 4 vCPU и 8 ГБ, если держите несколько проектов, собираете тяжёлые фронтенды или запускаете Docker.

Как платить за Claude Code из России?

Программа Claude Code ставится бесплатно, платите вы провайдеру модели. GPTunnel пополняется рублями. DeepSeek и Z.ai считают цены в долларах, а российские карты DeepSeek, по опыту пользователей, не принимает. Для оплаты нужна карта зарубежного банка или виртуальная; варианты — в статье о виртуальных картах для оплаты нейросетей. Подписку Claude Pro или Max для работы из России оформлять не стоит: аккаунт из неподдерживаемого региона — основание для бана.

Можно ли использовать российский ключ вместо аккаунта Anthropic?

Да, если агрегатор отдаёт модели Claude по Anthropic-совместимому API. У GPTunnel это https://gptunnel.ru в ANTHROPIC_BASE_URL и его ключ в ANTHROPIC_AUTH_TOKEN; аккаунт Anthropic не нужен. Учтите оговорку из раздела Б: доступность Claude у посредника может измениться.

Что выбрать — tmux или systemd?

tmux подходит для интерактивной работы: вы периодически возвращаетесь в сессию, смотрите вывод, отвечаете агенту. systemd-сервис имеет смысл, только если вы оборачиваете Claude Code в полностью автоматический неинтерактивный скрипт. Для большинства сценариев разработки tmux удобнее.

Другие инструменты для кода, которые работают из России, собраны в разделе каталога «Работа с кодом», шлюзы с оплатой в рублях — в разделе «Агрегаторы нейросетей».

Сергей Васильев

Редактор каталога нейросетей ailist.ru. Пишет про AI-инструменты: генерацию текста, изображений и видео, автоматизацию, чат-ботов и доступ к зарубежным сервисам из России. Тестирует новые сервисы и помогает выбирать рабочие инструменты под конкретные задачи. В AI с 2023 года — помнит времена, когда на сгенерированных нейросетью фотографиях у людей было по шесть пальцев.