Claude Code: как подключить свой API-ключ из России

Подключить Claude Code из России можно, прописав свой API-ключ и базовый URL стороннего провайдера. Через provod.ai ключ выдается быстро, запросы идут на совместимый endpoint, оплата в рублях. Полная совместимость всех версий и протоколов не гарантируется, поэтому связку проверяют на тестовой задаче перед работой.

Почти все, кто ставит Claude Code на свой ключ, спотыкаются в одном месте. Не в ключе, не в оплате, а в базовом URL: его задают не так, как написано на странице API, и инструмент возвращает 404. Ниже по шагам, как использовать Claude Code: что положить и куда, и как проверить связку одним запросом до того, как вы начнете реальную работу.

Claude Code из России работает на своем ключе программного интерфейса (API-ключе) и базовом URL стороннего провайдера, подписка для этого не нужна. Подписочный вход через OAuth Anthropic закрыл сторонним инструментам, а OpenRouter закрыл аккаунты из РФ.

Допустим, вы привыкли логиниться в инструмент и не думать про ключи. Этот путь из России сейчас не открывается, и чинить его подпиской бесполезно. Остается ровно один рабочий вариант: берете ключ у рублевого провайдера, прописываете его и его адрес, дальше инструмент ходит к моделям через этот адрес.

Юридическая сторона у провайдера на домене Provod закрыта офертой от 17.07.2026: лицензия действует на территории РФ, работа по предоплате. Способ входа в сам Claude Code задает Anthropic, и легален там только ключ, а не «вход по подписке через провайдера». Это важно держать в голове, чтобы не искать кнопку, которой нет.

До первого запроса достаточно трех вещей: ключ, базовый URL провайдера и понимание, на какую конечную точку (endpoint) идут модели Anthropic. Модели Claude принимают запросы на POST /v1/messages, в ответе есть поле stop_reason.

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

Ключ у provod.ai, по данным компании, выдается быстро, сразу после оплаты. Я специально не называю это секундами: проверяйте по факту у себя, а не по обещанию в тексте.

Самый частый провал прячется тут, поэтому читайте внимательно. Ключ в Claude Code кладется в переменную ANTHROPIC_AUTH_TOKEN, а не в ANTHROPIC_API_KEY; базовый URL в ANTHROPIC_BASE_URL, и задается он без /v1.

Причина, по которой адрес идет без хвоста, простая. Claude Code сам дописывает путь /v1/messages к базовому URL. Оставите /v1 в адресе, инструмент склеит /v1/v1/messages, и сервер вернет 404. То есть ключ рабочий, оплата прошла, а запрос падает только из-за лишних трех символов.

Покажу парой, как надо и как не надо.

Как надо:

``` ANTHROPIC_BASE_URL=https://api.provod.ai ```

Как не надо:

``` ANTHROPIC_BASE_URL=https://api.provod.ai/v1 ```

Настройки живут в ~/.claude/settings.json или в профиле вашей оболочки. Через файл это выглядит так:

``` { "env": { "ANTHROPIC_AUTH_TOKEN": "ВАШ_КЛЮЧ", "ANTHROPIC_BASE_URL": "https://api.provod.ai" } } ```

Обратите внимание: в примере стоит ваш ключ и адрес без /v1. Запомните эту пару, к ней я верну вас в финале перед первым запросом.

Проверка связки это один короткий запрос до реальной работы, а не запуск большого проекта сразу. «Работает» означает ровно две вещи: пришел ответ модели и в нем корректный stop_reason.

Самый быстрый способ, curl прямо на endpoint моделей Claude:

``` curl https://api.provod.ai/v1/messages \ -H "Authorization: Bearer ВАШ_КЛЮЧ" \ -H "content-type: application/json" \ -d '{ "model": "ИМЯ_МОДЕЛИ_ИЗ_КАТАЛОГА", "max_tokens": 64, "messages": [{"role": "user", "content": "ping"}] }' ```

Здесь curl ходит на полный путь /v1/messages вручную, поэтому /v1 в адресе уместен; это тест, а не конфиг Claude Code, и правила про хвост у них разные. Какое имя подставить в model, берите из рабочего каталога провайдера.

Как по мне, минута на этот пинг экономит час на разборе, почему «ничего не работает». Чужих замеров экономии я не видел, говорю про свою логику: пока связка не ответила на ping, большой запуск запускать рано.

Полная совместимость всех версий и протоколов не гарантируется, и это честная причина для теста, а не оговорка мелким шрифтом. Никакого SLA и обещания бесперебойности на этом пути нет, поэтому связку всегда проверяют заново после обновлений.

Что держать под контролем, пока вы работаете:

Про безопасность добавлю без пафоса. Относитесь к ключу как к карте: потерял, значит платит кто-то другой вашими деньгами, пока вы не отозвали. Отозвать и выпустить новый проще, чем объяснять списание.

Ошибка 404 на этом пути почти всегда означает неверный адрес, а не сломанный сервис. Источников у нее ровно два, и оба лечатся за минуту.

Первый источник, лишний /v1 в базовом URL Claude Code. Вернитесь к паре из третьего раздела: в ANTHROPIC_BASE_URL должно стоять https://api.provod.ai без хвоста. Второй источник, вы ушли за моделью на страницу, которой нет: на 04.11 /ru/models/claude отдавала 404, тогда как /ru/products/api, /ru/pricing и /ru/compare отвечали 200. За списком моделей идите в рабочий каталог провайдера, а не на несуществующую страницу.

Если хотите пройти это по шагам со стороны провайдера, можно посмотреть инструкцию по ключу: как получить ключ, пополнить баланс и где лежит рабочий каталог моделей. Сайт claude.ai против доступа по API я разбираю в соседней статье, а подписку Claude и ее лимиты тоже отдельно.

Собрать Claude Code из России можно за один вечер, если не путать два адреса. Весь путь укладывается в короткую цепочку, и каждый шаг проверяемый.

Дальше дело вкуса. Хотите сразу запустить агентную задачу, запускайте, но поглядывайте на расход. Хотите сначала погонять модель на мелочи, гоняйте, это ваш ключ и ваш баланс.

И последнее, самое дешевое действие из всех. Перед первым запросом сверить базовый URL: откройте конфиг и глазами проверьте, что в ANTHROPIC_BASE_URL стоит https://api.provod.ai, а не …/v1. Одна строка решает, ответит сервер или вернет 404.

А у вас на чем обычно спотыкается первая связка: на адресе, на имени модели или на балансе?