К содержимому

Claude API через прокси: base_url, SDK и ошибки

Где в клиенте Claude API указывается прокси, чем он отличается от base_url и как читать ошибку, если запрос не прошёл.

base_url и прокси — две разные настройки

base_url (или переменная ANTHROPIC_BASE_URL) определяет, на какой хост SDK отправляет запросы. В документации Python SDK он стоит рядом с http_client в одном конструкторе. Прокси определяет, каким сетевым путём запрос идёт к этому хосту. Тем, кто ищет «Claude API через прокси», обычно нужно именно второе.

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

Куда что прописывается

Куда что прописывается
ПунктЧто меняетГде это в документации
base_url / ANTHROPIC_BASE_URLХост, на который идёт запросСтраница Python SDK: аргумент base_url или переменная
Прокси в PythonСетевой путь одного клиентаhttp_client=DefaultHttpxClient(proxy=...)
Прокси в NodeСетевой путь одного клиентаfetchOptions.dispatcher с ProxyAgent из undici
Claude CodeКонсольный инструмент, не SDKПеременные прокси и settings.json: см. руководство по прокси для Claude Code

Источник: страницы Python и TypeScript SDK в документации Claude Platform, прочитаны 17 ноября 2026. В них нет HTTPS_PROXY, поэтому передавайте прокси самому клиенту.

Шаг 1: проверьте маршрут через curl

Запустите команды на той машине, с которой пойдут запросы. Первая должна показать ожидаемую страну. Вторая намеренно без ключа: JSON-ответ 401 authentication_error в документации соответствует проблеме с ключом, значит запрос дошёл до API (наше прочтение). Третья с вашим ключом показывает, что он работает через прокси.

Шаг 1: проверка через curl

# 1) Which IP and country does Anthropic see? (the proxy's exit)
curl -x "http://USERNAME:PASSWORD@HOST:PORT" https://ipinfo.io/json

# 2) Does the request reach the API? No key on purpose: a JSON 401 authentication_error
#    means the network path works and only the key is missing
curl -s -x "http://USERNAME:PASSWORD@HOST:PORT" https://api.anthropic.com/v1/messages \
  -H "anthropic-version: 2026-10-21" -H "content-type: application/json" \
  -d '{"model":"MODEL_ID","max_tokens":16,"messages":[{"role":"user","content":"Hello, Claude"}]}'

# 3) With your key: a normal message response (use a model ID from Anthropic's models page)
curl -x "http://USERNAME:PASSWORD@HOST:PORT" https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2026-10-21" \
  -H "content-type: application/json" \
  -d '{"model":"MODEL_ID","max_tokens":16,"messages":[{"role":"user","content":"Hello, Claude"}]}'

Подставьте HOST, PORT, USERNAME и PASSWORD из раздела «Мои активы», а вместо MODEL_ID идентификатор модели со страницы моделей Anthropic. Значение anthropic-version взято со страницы ошибок Anthropic.

Шаг 2: Python SDK

В документации Python SDK сказано, что запросы отправляются через httpx2, а прокси настраивается передачей собственного клиента в http_client. Используйте DefaultHttpxClient: так сохраняются тайм-ауты и лимиты соединений по умолчанию. Клиент из отдельного пакета httpx вызывает TypeError.

Тот же клиент сначала запрашивает ipinfo.io, поэтому первая строка показывает реальный выход SDK. По умолчанию SDK дважды повторяет запрос при ошибках соединения, 408, 409, 429 и 5xx; в примере повтор один, чтобы неисправный прокси быстрее давал ошибку.

Шаг 2: Python SDK

# pip install anthropic          (Python 3.10 or later; reads ANTHROPIC_API_KEY from the environment)
import anthropic
from anthropic import Anthropic, DefaultHttpxClient

PROXY = "http://USERNAME:PASSWORD@HOST:PORT"   # percent-encode special characters in the password

http = DefaultHttpxClient(proxy=PROXY)

# 1) Which exit does this client use?
print(http.get("https://ipinfo.io/json").text)

# 2) Same client for the API. Leave base_url alone: this is a proxy, not a gateway.
client = Anthropic(http_client=http, max_retries=1, timeout=30.0)
try:
    message = client.messages.create(
        model="MODEL_ID",              # a model ID from Anthropic's models page
        max_tokens=16,
        messages=[{"role": "user", "content": "Hello, Claude"}],
    )
    print(message.content[0].text, message._request_id)
except anthropic.APIConnectionError as e:
    print("Could not reach the API through the proxy:", e.__cause__)
except anthropic.APIStatusError as e:
    print("HTTP", e.status_code, e.response.headers.get("request-id"))

# SOCKS5: pip install "httpx2[socks]", then PROXY = "socks5://USERNAME:PASSWORD@HOST:PORT"

Подставьте HOST, PORT, USERNAME и PASSWORD из «Мои активы». Для SOCKS5 установите httpx2[socks] и используйте строку с socks5://.

Шаг 3: Node SDK

В документации TypeScript SDK для Node.js описано так: создайте ProxyAgent из undici и передайте его как fetchOptions.dispatcher. undici строит авторизацию на прокси из логина и пароля в адресе, предварительно декодируя их. Bun использует fetchOptions.proxy, а Deno клиент из Deno.createHttpClient; обе схемы есть на той же странице.

Шаг 3: Node SDK

// npm install @anthropic-ai/sdk undici      (reads ANTHROPIC_API_KEY from the environment)
// Save as check.mjs and run: node check.mjs
import Anthropic from '@anthropic-ai/sdk';
import * as undici from 'undici';

// Wrap special characters of the password with encodeURIComponent()
const proxyAgent = new undici.ProxyAgent('http://USERNAME:PASSWORD@HOST:PORT');

const client = new Anthropic({
  fetchOptions: { dispatcher: proxyAgent },
  maxRetries: 1,
  timeout: 30 * 1000,
});

try {
  const message = await client.messages.create({
    model: 'MODEL_ID',                 // a model ID from Anthropic's models page
    max_tokens: 16,
    messages: [{ role: 'user', content: 'Hello, Claude' }],
  });
  console.log(message.content[0].text, message._request_id);
} catch (err) {
  if (err instanceof Anthropic.APIError) console.log(err.status, err.name);
  else console.log('Network error:', err.message);
}

// SOCKS5: new undici.ProxyAgent('socks5://USERNAME:PASSWORD@HOST:PORT')

Подставьте значения из «Мои активы». Для SOCKS5 используйте адрес socks5:// из последнего комментария.

Как читать ошибку

APIConnectionError, тайм-аут или полное отсутствие ответа

Проверьте Отвечает ли ipinfo.io через тот же прокси и действительно ли клиент его использует? В Python исходная ошибка лежит в __cause__.

Решение Проверьте HOST, PORT и протокол (у Proxy302 HTTP на 2222, SOCKS5 на 3333), затем передайте прокси клиенту, как в шагах 2 и 3.

Когда остановиться Если curl без ключа тоже не достаёт до API, причина в прокси или сети, а не в коде.

407 Proxy Authentication Required

Проверьте Нет ли в пароле неэкранированного спецсимвола и не истёк ли срок аренды IP?

Решение Закодируйте пароль в URL (percent-encoding) или заново скопируйте данные из «Мои активы» и проверьте дату окончания.

401 authentication_error

Проверьте Страница ошибок Anthropic связывает 401 с API-ключом: неверный формат, отозван или истёк.

Решение Проверьте ключ в Claude Console. Ответ 401 значит, что запрос дошёл до Anthropic, то есть сам прокси работает.

403 permission_error

Проверьте Страница ошибок описывает 403 как отсутствие у ключа прав на ресурс; ошибки, специфичной для региона, в ней нет. Не ограничен ли ключ рабочим пространством или ресурсом, которые вы не вызываете?

Решение Проверьте доступ организации и рабочего пространства в Console. Отдельно сверьте страну выхода из шага 1 со списком поддерживаемых регионов.

Когда остановиться Если страны выхода нет в списке, это не изменить настройками клиента. Используйте API только из поддерживаемого региона.

429, 500, 504 или 529

Проверьте 429 — лимит запросов или расходов, 529 — временная перегрузка, 500 и 504 — ошибки на стороне Anthropic.

Решение Это не неисправность прокси. SDK уже повторяет запрос дважды; если ошибка не уходит, сохраните заголовок request-id и приложите его к обращению в поддержку.

Ошибки региона: что может и чего не может прокси

Anthropic публикует список поддерживаемых стран, регионов и территорий и пишет, что всё, чего нет в списке, не поддерживается. Политика касается и людей, физически находящихся в неподдерживаемом регионе, и компаний, зарегистрированных, расположенных или находящихся в собственности там. Прокси меняет сетевой выход, но не политику.

Ни страница ошибок, ни политика не описывают, как определяется местоположение запроса, и не называют кода ошибки, специфичного для региона. Поэтому страна выхода — лишь один из пунктов проверки, а не гарантия: узнайте её через ipinfo.io с прокси, сверьте со списком и используйте API только там, где это разрешено. Про сторону аккаунта (номер телефона, страна платежа) читайте руководство о регионах Claude.

Как это сделать с Proxy302

  1. Шаг 1

    Откройте страницу для Claude и выберите IP в стране из списка Anthropic. Статический ISP IP стоит $7,99 за 30 дней, одинаково во всех странах; на странице заказа видно, в каких странах сейчас есть IP.

  2. Шаг 2

    Откройте «Мои активы» и скопируйте HOST, PORT, USERNAME и PASSWORD. У каждого IP один протокол, он выбирается при покупке: HTTP на порту 2222, SOCKS5 на порту 3333.

  3. Шаг 3

    Выполните три команды curl из шага 1, затем впишите прокси в клиент Python или Node. Один аккаунт — один IP, соблюдайте условия Anthropic и список поддерживаемых регионов.

    Ожидаемый результат Первая команда показывает купленную страну, вторая возвращает JSON с 401.

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

Нужно ли задавать ANTHROPIC_BASE_URL для прокси?

Нет. ANTHROPIC_BASE_URL задаёт хост, к которому обращается SDK, а прокси передаётся HTTP-клиенту, как показано в документации Python и TypeScript. Меняйте base_url только для шлюза, который вы развернули или которым вам разрешено пользоваться.

Работает ли HTTPS_PROXY с SDK Claude?

В прочитанной нами документации SDK его нет, поэтому передавайте прокси клиенту. Для Claude Code, который является другим инструментом, переменные прокси документированы; см. руководство по прокси для Claude Code.

Какой протокол выбрать: HTTP или SOCKS5?

HTTP проще всего: оба примера принимают его сразу. SOCKS5 работает в Python с httpx2[socks] и в Node через ProxyAgent из undici, но IP должен быть куплен как SOCKS5.

Через прокси приходит 403. Это регион?

Не обязательно. Страница ошибок Anthropic описывает 403 как отсутствие у ключа прав на ресурс и не называет ошибки, специфичной для региона. Сначала проверьте права ключа, затем страну выхода по списку поддерживаемых регионов.

Заработает ли Claude API из моей страны через прокси?

Нет. Прокси меняет только сетевой выход. Список поддерживаемых регионов и политика Anthropic продолжают действовать, а политика касается и физического местонахождения человека.

Ссылки и источники

8
  1. Документация Claude Platform: Python SDK

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: SDK отправляет запросы через httpx2; base_url или переменная ANTHROPIC_BASE_URL; http_client=DefaultHttpxClient(proxy=...); рекомендуется DefaultHttpxClient, а не «голый» клиент; клиент из отдельного пакета httpx вызывает TypeError; по умолчанию два автоматических повтора (max_retries); APIConnectionError и APIStatusError; свойство _request_id.

    Страница не описывает HTTP_PROXY и HTTPS_PROXY для SDK.

  2. Документация Claude Platform: TypeScript SDK

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: раздел Configuring proxies: в Node.js создайте undici.ProxyAgent и передайте его как fetchOptions.dispatcher; Bun использует fetchOptions.proxy, Deno клиент из Deno.createHttpClient; параметры maxRetries (по умолчанию 2) и timeout; при тайм-ауте APIConnectionTimeoutError.

  3. Ошибки Claude API

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: 400 invalid_request_error, 401 authentication_error (проблема с ключом), 402 billing_error, 403 permission_error (у ключа нет прав на ресурс), 404, 413, 429 rate_limit_error, 500 api_error, 504 timeout_error, 529 overloaded_error; тело ошибки в JSON с request_id; заголовок ответа request-id; SDK по умолчанию повторяет запрос дважды с экспоненциальной паузой.

    На странице нет ошибки, специфичной для страны или региона.

  4. Документация Claude Platform: поддерживаемые регионы

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: список стран, регионов и территорий, из которых Anthropic может поддерживать доступ, например Япония, Сингапур, Великобритания и США; Украина указана, кроме Крыма, Донецкой и Луганской областей.

  5. Anthropic: Supported Regions Policy

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: страны и регионы, которых нет в списке, не поддерживаются; политика касается людей, физически находящихся в неподдерживаемом регионе, и организаций, зарегистрированных, расположенных или которыми большинство владельцев находится там. Как определяется местоположение, на странице не сказано, прокси не упоминаются.

  6. Документация HTTPX2: Proxies

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: параметр proxy при создании клиента; логин и пароль в части userinfo URL прокси; для SOCKS нужны pip install 'httpx2[socks]' и адрес socks5://.

  7. Документация undici: ProxyAgent

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: строка или URL, переданные в ProxyAgent, являются адресом прокси; без token и auth заголовок proxy-authorization строится из логина и пароля в URI после URL-декодирования; адреса socks5: обрабатывает Socks5ProxyAgent.

  8. Информация о продуктах и цены Proxy302

    Наблюдение за продуктом · Проверено:

    Файл с данными о продуктах сайта, сверен 10 ноября 2026 с консолью, бэкендом и прайс-листом: статический ISP, аренда за IP, $7,99 за 30 дней, одинаково во всех странах; HTTP порт 2222 и SOCKS5 порт 3333; один протокол на IP; бесплатного пробного периода нет.

Готовы попробовать?

Создайте аккаунт, пополните баланс и выберите ротируемый резидентный, статический ISP или дата-центр IP — настроить его в браузере можно за несколько минут.