> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code в России: как установить и пользоваться без VPN

> Работает ли Claude Code в России, как установить его без VPN и без аккаунта Anthropic, как оплатить и что делать с ошибками «Unable to connect to Anthropic services» и «Invalid API key».

**Коротко:** сама программа Claude Code бесплатная, и из России её можно поставить через npm. Не работает другое — аккаунт Anthropic: России нет в списке поддерживаемых стран, а с 1 октября 2026 года аккаунты из России снова массово блокируют. Поэтому Claude Code подключают к API-шлюзу: две переменные окружения — и он работает без VPN, без аккаунта и подписки Anthropic, а вы платите в USDT только за использованные токены.

## Работает ли Claude Code в России

| Способ | Работает из России? | Что мешает |
| - | - | - |
| Подписка Claude Pro / Max и вход в аккаунт Anthropic | Только с VPN — и с риском | России нет в списке поддерживаемых стран; российские карты не принимаются; с октября 2026 года — новая волна блокировок, в том числе платных аккаунтов |
| Ключ из консоли Anthropic (оплата API) | Только с VPN — и с риском | То же самое плюс нужна карта иностранного банка |
| Через API-шлюз (например, RuAPI) | **Да, без VPN** | Нужен ключ шлюза и баланс |

> [!NOTE]
>
> Список стран — страница [Supported Regions Policy](https://www.anthropic.com/supported-countries) (проверено 22.10.2026): «Any country or region not listed is unsupported», России в списке нет. О блокировках — по сообщениям The Moscow Times и The Bell, октябрь 2026 года.

## Как установить Claude Code в России

**1. Node.js 22 или новее**

Проверьте версию командой `node --version`. Если Node.js нет или он старше — поставьте LTS-версию с [nodejs.org](https://nodejs.org).

**2. Установка через npm**

```bash theme={null}
npm install -g @anthropic-ai/claude-code
claude --version
```

Команда одинаковая для macOS, Linux и Windows (PowerShell). Официальный установщик с `claude.ai` из России может не открыться — npm даёт тот же результат.

## Как подключить Claude Code без аккаунта Anthropic

**1. Ключ RuAPI**

Зарегистрируйтесь на [www.ruapi.ai](https://www.ruapi.ai/?utm_source=docs\&utm_campaign=ru-claude-code-russia) (по email, через Google или Яндекс), пополните баланс и в Консоли откройте **«API-ключи» → «Создать ключ»** — получите строку `sk-...`.

**2. Адрес и ключ в settings.json**

Откройте `~/.claude/settings.json` (Windows: `%USERPROFILE%\.claude\settings.json`; если файла нет — создайте) и впишите:

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.ruapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-ваш-ключ-RuAPI",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}
```

> [!WARNING]
>
> Адрес пишется **без** `/v1` на конце — Claude Code сам добавляет `/v1/messages`.

**3. Запуск**

Откройте новый терминал, перейдите в папку проекта и запустите `claude`. Входить в аккаунт Anthropic не нужно. Запрос появится в Консоли RuAPI → **«Журнал запросов»**.

Подробная настройка — модели для `/model opus` и `/model haiku`, переменные окружения вместо файла, Windows — в инструкции [Claude Code: подключение к RuAPI](/ru/integrations/claude-code.md).

## Как оплатить Claude Code в России

Подписка не нужна: вы платите только за токены, которые расходует Claude Code.

* **USDT или USDC** в сетях TRC20, BEP20 или Polygon, от 5 USDT — зарубежная карта не нужна. Если USDT ещё нет, его можно купить за рубли через СБП: [пошаговая инструкция](/ru/buy-usdt.md), в первый раз это 15–30 минут.
* **Карты иностранных банков** (Visa / Mastercard) тоже принимаются. Карты российских банков, включая «Мир», — нет.
* **Кэширование промптов работает:** Claude Code подключается через нативный Anthropic API, поэтому контекст, который он заново отправляет на каждом шаге, обходится минимум в 10 раз дешевле обычного ввода.

Как тратить меньше — в статье [Как платить за Claude Code и Cline в разы меньше](/ru/claude-code-cline-costs.md).

## Ошибки и что с ними делать

| Что видите | Почему | Что делать |
| - | - | - |
| `Unable to connect to Anthropic services` / `Failed to connect to api.anthropic.com: ERR_BAD_REQUEST` / `Claude Code might not be available in your country` | В некоторых версиях Claude Code при первом запуске проверяет связь с `api.anthropic.com` — даже если указан `ANTHROPIC_BASE_URL`. Из России этот адрес недоступен | Отметьте первый запуск как пройденный — см. ниже. Проверьте, что `ANTHROPIC_BASE_URL` задан |
| `Invalid API key · Please run /login` или `401` | Ключ уходит не туда или ключ не тот: не задан `ANTHROPIC_BASE_URL` (ключ RuAPI отправляется в Anthropic), вместо ключа RuAPI указан ключ Anthropic `sk-ant-...` или в окружении остался старый `ANTHROPIC_API_KEY` | Проверьте `/status` и переменные — см. ниже. Скопируйте ключ из Консоли RuAPI заново, без пробелов |
| Claude Code просит войти в аккаунт (`/login`) | Ключ не дошёл до Claude Code: например, он записан в `.claude/settings.json` внутри проекта, а такие настройки применяются только после первого запуска | Пропишите ключ в `~/.claude/settings.json` в домашней папке или в переменных окружения |
| Предупреждение `Auth conflict` / `auth may not work as expected` | Одновременно активны ключ RuAPI и сохранённый вход в аккаунт Anthropic | Выполните `/logout` в Claude Code — останется только ключ RuAPI |
| `403` — недостаточно средств | На балансе закончились деньги | [Пополните баланс](/ru/topup.md) |
| `404` | В конце `ANTHROPIC_BASE_URL` лишний `/v1` | Оставьте `https://www.ruapi.ai` |
| `503`, модель не найдена | Опечатка в имени модели | Сверьте имя со [страницей цен](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=ru-claude-code-russia) |

### «Unable to connect to Anthropic services»: как исправить

Это известная проблема Claude Code ([issue на GitHub](https://github.com/anthropics/claude-code/issues/26935)): в некоторых версиях при первом запуске он обращается к `api.anthropic.com`, не глядя на ваш `ANTHROPIC_BASE_URL`. Обходное решение описано в этом issue, а пользователи подтверждают его в [другом обсуждении](https://github.com/musistudio/claude-code-router/issues/494), — отметить первый запуск как пройденный:

1. Закройте Claude Code.
2. Откройте файл `~/.claude.json` (Windows: `%USERPROFILE%\.claude.json`) — это **другой** файл, не `settings.json`.
3. Добавьте строку `"hasCompletedOnboarding": true` внутрь фигурных скобок. Если файл пустой или его нет, его содержимое должно быть таким:

   ```json theme={null}
   {
     "hasCompletedOnboarding": true
   }
   ```

   Если в файле уже есть другие строки — допишите эту через запятую, иначе JSON сломается.
4. Запустите `claude` снова.

### «Invalid API key»: проверьте, куда и с каким ключом идут запросы

Внутри Claude Code выполните `/status` и посмотрите на две строки:

* `Anthropic base URL` должна показывать `https://www.ruapi.ai`. Если этой строки нет — `ANTHROPIC_BASE_URL` не дошла до Claude Code, и запросы идут в Anthropic.
* `Auth token` должна называть `ANTHROPIC_AUTH_TOKEN`. Если вместо неё строка `Login method` с аккаунтом claude.ai — ключ RuAPI не подхватился.

Затем посмотрите, какие переменные Anthropic заданы в системе:

```bash macOS / Linux theme={null}
env | grep ANTHROPIC
```

```powershell Windows (PowerShell) theme={null}
Get-ChildItem Env:ANTHROPIC*
```

* Должен быть `ANTHROPIC_BASE_URL=https://www.ruapi.ai`.
* Если там есть `ANTHROPIC_API_KEY` со старым ключом — удалите его (или укажите в нём ключ RuAPI). Ключ RuAPI лучше держать в `ANTHROPIC_AUTH_TOKEN`: с ним Claude Code не задаёт вопрос, использовать ли ключ.
* Переменные из `settings.json` команда не покажет — проверьте и сам файл. Если одна и та же переменная задана и в системе, и в `settings.json`, действует значение из `settings.json`.
* Если ключ лежит в `ANTHROPIC_API_KEY`, Claude Code один раз спрашивает, использовать ли его; если тогда ответили «нет», ключ молча игнорируется — включите его в `/config` → `Use custom API key`.

> [!TIP]
>
> Claude Code в фоне обращается к серверам Anthropic — проверка обновлений, телеметрия. Из России эти запросы могут не проходить; на работу через RuAPI это не влияет, но их можно отключить, добавив в `env` строку `"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"`. Автообновление при этом тоже выключится — обновляйте Claude Code командой `npm install -g @anthropic-ai/claude-code@latest`.

Все коды ошибок API — на странице [Коды ошибок](/ru/errors.md).

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

> **Работает ли Claude Code в России в 2026 году?**
>
> Да, если подключить его к RuAPI: Claude Code обращается к [www.ruapi.ai](http://www.ruapi.ai), а этот адрес открывается из России напрямую. Аккаунт Anthropic и подписка не нужны, поэтому блокировки аккаунтов вас не касаются.

> **Нужен ли VPN?**
>
> Нет. Ни для установки через npm, ни для работы: запросы к моделям идут только на [www.ruapi.ai](http://www.ruapi.ai).

> **Можно ли пользоваться Claude Code бесплатно?**
>
> Сама программа бесплатная, а за модели нужно платить. В RuAPI нет подписки: вы платите только за использованные токены. Новым пользователям мы обычно сразу даём \$0,05, чтобы попробовать deepseek-flash, — и Claude Code можно [запустить на DeepSeek](/ru/integrations/claude-code-deepseek.md), это в разы дешевле Claude.

> **Сколько стоит?**
>
> Зависит от модели и объёма работы. Например, claude-sonnet-5-5 — \$2,40 за 1 млн входных токенов, \$0,12 за 1 млн токенов из кэша и \$12 за 1 млн выходных (цены на странице цен на 22.10.2026; цена в вашем аккаунте может быть ниже). Все модели и цены — на [странице цен](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=ru-claude-code-russia).

> **Это оригинальные модели Claude?**
>
> Да. Это оригинальные модели Anthropic — claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5 и другие — без урезания качества и без подмены.

> **Можно ли одновременно пользоваться и аккаунтом Anthropic, и RuAPI?**
>
> Да — переключайтесь между ними в [CC Switch](/ru/integrations/ccswitch.md) одним кликом.

## Дальше

> **[Claude Code в России — без VPN и аккаунта](https://www.ruapi.ai/claude-code-v-rossii?utm_source=docs\&utm_campaign=ru-claude-code-russia)**
>
> Почему из России Claude Code лучше подключать через шлюз.

> **[Подробная настройка Claude Code](/ru/integrations/claude-code.md)**
>
> Модели, переменные окружения, Windows.

> **[Claude Code на DeepSeek](/ru/integrations/claude-code-deepseek.md)**
>
> Тот же Claude Code — в разы дешевле.

> **[Как купить USDT за рубли](/ru/buy-usdt.md)**
>
> Crypto Bot, Bybit P2P или обменник — три способа.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.