Anthropic API: использование Claude Code и CLI-инструментов через прокси

8 мин чтенияобновлено 7 ноября

Из России запросы к Anthropic обычно не доходят: в терминале появляется unable to connect to api.anthropic.com или ожидание обрывается без ответа. Ключ при этом рабочий, и код написан правильно. Дело в маршруте: запрос уходит из России, и сервер его отклоняет.

Ниже: как получить ключ, как настроить Claude Code и другие инструменты для терминала и как пустить через прокси только их, не трогая остальные программы.

Что такое Anthropic API и ключ

Anthropic API, это HTTP-интерфейс к моделям Claude. Все запросы уходят на https://api.anthropic.com, аутентификация идёт по ключу вида sk-ant-..., который вы получаете в консоли. Один ключ работает со всеми доступными моделями семейства Claude, отдельного ключа под каждую модель заводить не нужно.

Формат запроса и заголовки

Ключ передаётся в заголовке запроса, а не в URL. Минимальный вызов через curl выглядит так:

curl https://api.anthropic.com/v1/messages \
 -H "x-api-key: $ANTHROPIC_API_KEY" \
 -H "anthropic-version: 2023-06-01" \
 -H "content-type: application/json" \
 -d '{"model":"claude-sonnet-4-20250514","max_tokens":1024,"messages":[{"role":"user","content":"ping"}]}'

Поле content внутри messages, это тело запроса от пользователя. Заголовок anthropic-version обязателен, без него сервер вернёт ошибку валидации.

Диагностика таймаута

Если этот запрос висит и обрывается по таймауту, дело не в теле запроса. Проверьте резолв: nslookup api.anthropic.com обычно отвечает, а вот TLS-сессия до хоста не устанавливается. Это как раз региональная блокировка, ключ и модель тут ни при чём.

Как получить API-ключ

Ключ создаётся в консоли Anthropic (console.anthropic.com), в разделе API Keys. Порядок стандартный: регистрация аккаунта, привязка способа оплаты, кнопка создания ключа. Ключ показывается один раз, скопируйте его сразу и сохраните, повторно посмотреть значение нельзя.

Про бесплатный доступ

Про «бесплатный» доступ честно: устойчивого бесплатного API-ключа Anthropic для постоянной работы нет, тарификация идёт по токенам. Актуальные цены смотрите на странице pricing в самой консоли, мы их здесь не дублируем, чтобы не вводить в заблуждение устаревшими цифрами.

Доступность консоли из России

Сама регистрация в консоли и создание ключа из России тоже упираются в доступность домена. Если консоль не открывается, канал до Anthropic нужно решать до того, как вы дойдёте до создания ключа. Открытие console.anthropic.com и вызовы api.anthropic.com идут на разные хосты, но упираются в одну региональную блокировку.

Настройка Claude Code

Claude Code — инструмент Anthropic для работы с кодом: терминал, расширения для VS Code и JetBrains, настольное приложение и веб. Ставится своим установщиком, npm и Node.js для этого не нужны:

irm https://claude.ai/install.ps1 | iex

Запуск на Windows и передача ключа

На Windows 10 1809 и новее он работает нативно, подсистема Linux не нужна. Ключ Claude Code берёт из переменной окружения ANTHROPIC_API_KEY или из своего профиля аутентификации. Если переменная не выставлена, вы получите ошибку про отсутствие профиля или про то, что не найден ключ для провайдера anthropic.

export ANTHROPIC_API_KEY=sk-ant-...
claude

Проверка моделей при старте

При первом запуске Claude Code проверяет доступность API и список моделей. Если хост недоступен, инструмент падает на этой проверке, и понять причину по сообщению трудно: выглядит как проблема аутентификации, хотя это блокировка сети. В списке доступных моделей вы увидите Opus, Sonnet, Haiku и Fable — набор зависит от вашего тарифа.

Совместимые провайдеры и совместимый адрес Anthropic

Формат Anthropic Messages поддерживают не только модели Claude. Ряд провайдеров отдаёт совместимый адрес API, на который можно направить Claude Code, переопределив базовый URL через ANTHROPIC_BASE_URL. Так работают, например, схемы вида https://api.deepseek.com/anthropic или https://api.z.ai/api/anthropic, а также связки Claude Code с GLM. Логика одна: инструмент говорит на протоколе Anthropic, а на другом конце стоит другая модель.

Один ключ на несколько моделей

Агрегаторы дают один API-ключ на все модели: вы создаёте ключ у провайдера-агрегатора и переключаете модель через параметр model в теле запроса. Это удобно, когда нужно сравнить ответы Claude, openai-совместимых моделей и GLM из одного клиента, не заводя ключ под каждого провайдера отдельно.

Разные хосты у разных инструментов

Это отдельная тема, но она важна для понимания маршрутов. Разные инструменты у вас в терминале могут ходить на разные хосты: сам Claude Code на api.anthropic.com, gemini CLI на свой адрес API, openai-совместимые клиенты на третий. Часть из них блокируется по региону, часть нет. Разводить их удобнее по процессам, чем гонять весь трафик машины через один туннель.

Почему не подходит общий VPN

Общий VPN уводит домой весь трафик, включая тот, которому это не нужно. Windows не умеет разводить трафик по приложениям штатными средствами: правило либо для всей системы, либо никак. В итоге под прокси уезжает и то, что должно идти напрямую, а отладить, каким каналом реально пошёл конкретный процесс, нечем.

Наше решение

Мы сделали Proxy Control под эту задачу. Программа перехватывает весь исходящий трафик компьютера и раздаёт его по вашим правилам. Сетевые параметры системы при этом менять не нужно.

Маршрутизация терминала по процессам

Каналов шесть: Дом (обычный интернет провайдера), Прокси (ваш купленный адрес), VPN (ваш собственный узел), За IP (закрепление за конкретным выходным адресом), Блок (соединение отклоняется) и Спросить (новая программа ждёт вашего решения).

Подробный разбор всех возможностей — на странице что умеет программа. Если нужно, чтобы несколько браузеров выходили с разных адресов, это отдельная тема: разные IP для разных браузеров. Каждому процессу вы назначаете свой канал. Терминал с Claude Code уводите в прокси, локальные утилиты оставляете дома, всё лишнее закрываете.

Неизвестное блокируется по умолчанию

Неизвестное блокируется намеренно. Новая программа появляется в списке со статусом «ожидает» и в интернет не выходит, пока вы вручную не назначите ей канал. Это сделано осознанно: лучше явный отказ, чем незаметная утечка запроса мимо прокси.

Запросы из вашего кода

Запросы к Anthropic Claude API из вашего кода на Python (requests, официальный SDK) идут тем же путём: важен не язык, а процесс интерпретатора, которому вы назначили канал. Если вы строите инструмент для анализа consumer behavior или прикладного research (скажем, обработку отзывов методами psychology), поведение маршрута то же: канал получает процесс python.exe, а не отдельный HTTP-вызов.

Fail-closed и защита от утечек

Для приложений на прокси мы заблокировали UDP и IPv6, иначе QUIC ушёл бы мимо HTTP-прокси. DNS работает по DoH. Если прокси недоступен, прокси-приложения уходят в блок, а не домой. Если узел VPN мёртв, то же самое для VPN-приложений. Пока туннель пересобирается, ставится блокирующее правило брандмауэра: трафик встаёт на несколько секунд, но не уходит мимо маршрутов.

Пробы каналов

Проверить, что канал действительно рабочий, помогают три пробы: копии curl, прибитые к каналам, запрашивают внешний IP и показывают три разных адреса. Если IP канала совпал с домашним, программа пишет про утечку, а не красит статус в зелёный.

Живая сверка каналов

программа показывает, что туннель делает на самом деле, а не что написано в конфиге:

claude.exe → прокси
chrome.exe → vpn
rustdesk.exe → дом

Сверка с логом

После каждого применения маршрутов мы сверяем живые каналы с конфигом и пишем расхождения в лог. Это единственная проверка, которая способна поймать реальное несоответствие: снимок из конфига с самим конфигом разойтись не может.

Запуск и типичные ошибки

Туннель поднимается сам при старте программы, проходя 15 шагов с проверками, в конце должно быть FAIL: 0. После смены канала у приложения нажмите «Применить маршруты»: появится подтверждение с отсчётом 10 секунд.

Чек-лист при ошибке подключения

Если Claude Code снова получает unable to connect to api.anthropic.com, проверьте по шагам:

Процесс терминала (или интерпретатора) назначен на канал прокси, а не «ожидает».
После назначения нажаты «Применить маршруты».
Проба прокси показывает не домашний IP.
Ключ передан через ANTHROPIC_API_KEY, иначе инструмент выдаст ошибку аутентификации, а не сети.

Как отличить ошибку сети от ошибки ключа

Если путаете ошибку доступа с ошибкой ключа, сначала повторите голый curl-запрос из того же процесса. Пройдёт curl, дело в конфиге инструмента. Не пройдёт, дело в маршруте. Ошибку Not found API key for provider anthropic даёт сам инструмент при пустой переменной, к сети она отношения не имеет.

Установка и лицензия

Установка простая: распаковать архив и запустить Install.bat. Всё нужное уже лежит внутри архива, интернет при установке не нужен, ставить заранее ничего не требуется. Ключ продукта имеет вид CPC-XXXXXX-XXXXXX, один ключ на один компьютер, по нему программа получает срок действия. Это ключ доступа к нашему прокси, не путайте его с sk-ant-... от Anthropic.

Удаление

Удаление через Uninstall.bat: снимает туннель, правило брандмауэра, задания планировщика, ярлык и папку продукта. Лицензия при этом остаётся привязанной к компьютеру.

Смежная документация

Отдельные разборы форматов и SDK, включая совместимые схемы вроде docs.openclaw.ai, мы держим в соседних материалах силоса. Быстрый старт по терминалу собран на странице продукта Proxy Control, там же лежит порядок первичной настройки маршрутов.

Proxy Control: что это и сколько стоит

Программа для Windows: Claude, ChatGPT и другие зарубежные сервисы работают из России через ваш прокси, а банк и Госуслуги идут напрямую. Программа стоит 500 ₽ в месяц, прокси и VPN у нас по 300 ₽, установим бесплатно.

Услуги и цены Установим бесплатно