Типичные ошибки подключения к API-шлюзу и как их найти

Опубликовано 2026-10-17 · данные обновлены 17.10, 16:57 МСК · цены в ₽ за 1M токенов, курс ЦБ 83.6177 ₽/$

Большинство ошибок подключения — это одна неверная строка в настройках. Ниже — ошибки, которые шлюзы сами описывают в своих инструкциях. Идите по списку сверху вниз и проверяйте по одной правке за раз.

1. Лишний /v1 в адресе

Симптом: инструмент не может подключиться или получает ответ «не найдено».

AITunnel и Provod прямо пишут, что их адрес указывается без /v1. У других шлюзов правило может быть обратным. Не угадывайте: скопируйте адрес из инструкции именно вашего шлюза.

2. Ключ записан не в ту переменную

Симптом: Claude Code предлагает войти в аккаунт Anthropic вместо работы через шлюз.

Для Claude Code шлюзы из наших инструкций указывают переменную ANTHROPIC_AUTH_TOKEN. Если ключ положить в ANTHROPIC_API_KEY, Claude Code может повести себя иначе. Какая переменная нужна вашему шлюзу, смотрите в его готовом конфиге в статье про Claude Code из России.

3. У Codex нет слеша в конце или не указан wire_api

Симптом у Codex: ошибка stream disconnected, то есть поток ответа оборвался.

Polza указывает две причины этой ошибки. Первая — в блоке провайдера не задан wire_api = "responses". Вторая — у base_url нет слеша в конце адреса.

wire_api — это настройка формата API в конфиге Codex. Значение "responses" означает формат Responses API. Готовые блоки для шлюзов лежат в статье про Codex CLI из России.

4. Конфиг Codex лежит не там

Провайдера Codex нужно описывать в пользовательском конфиге ~/.codex/config.toml. По документации OpenAI, Codex игнорирует model_provider и model_providers в проектном конфиге.

Также нельзя называть своего провайдера openai. Это зарезервированное имя. Дайте провайдеру другое имя, например имя шлюза.

5. Настройки изменены, но терминал старый

Симптом: вы исправили адрес или ключ, а инструмент работает по-старому.

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

6. Проверка не сделана внутри инструмента

Не проверяйте подключение «на глаз» по открывшемуся окну. Запустите claude или codex и выполните команду /status.

У Claude Code в статусе должен быть адрес шлюза и токен шлюза. Если виден вход через аккаунт claude.ai, переменные шлюза не подхватились. У Codex статус должен показывать вашего провайдера.

7. От Cursor ждут то, что свой ключ не включает

Симптом: чат Cursor работает через шлюз, а автодополнение Tab — нет.

Это не поломка. По документации AITunnel и ProxyAPI, Tab и Apply остаются на моделях самого Cursor и своим ключом не переключаются. Отдельная известная ошибка — Input required у моделей gpt-* у AITunnel: для них у шлюза есть отдельный адрес, он указан в статье про Cursor со своим ключом.

Короткий порядок проверки

Сверьте адрес шлюза с его инструкцией, включая /v1 и слеш в конце.
Проверьте, в той ли переменной лежит ключ.
Для Codex проверьте wire_api = "responses".
Откройте новый терминал.
Выполните /status и сверьте адрес.
Сделайте один короткий запрос и посмотрите расход в кабинете шлюза.

Если расход появился, подключение работает. Если нет — вернитесь к пункту 1 с инструкцией вашего шлюза из каталога.

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

С чего начать, если подключение не работает?

Сначала выполните /status внутри Claude Code или Codex. Команда показывает, какой адрес и способ входа реально подхватил инструмент.

Адрес шлюза всегда должен заканчиваться на /v1?

Нет. Часть шлюзов прямо пишет, что адрес указывается без /v1. Берите адрес ровно из инструкции вашего шлюза.

Почему после правки настроек ничего не изменилось?

Переменные окружения читаются при запуске. Откройте новый терминал и запустите инструмент заново.

Узнавать об изменениях цен

Раз в день: изменения цен и сбои шлюзов. Без рекламы, отписка в один клик.