Claude Code «Request timed out»: API_TIMEOUT_MS и проблемы с прокси

Wokey Team · 2026-09-24

Коротко: Request timed out означает, что Claude Code не получил ответа от API до истечения срока ожидания, который по умолчанию равен 10 минутам (API_TIMEOUT_MS=600000). Если вы работаете через шлюз, обычно дело не в медленной модели. Чаще что-то посередине придерживает потоковый ответ или обрывает соединения, по которым слишком долго не идут данные. Это может быть локальный прокси, корпоративная сеть или сам шлюз. Сначала проверьте через curl, что поток приходит по частям, и только потом решайте, увеличивать ли тайм-аут.

Что именно вы видите

Первые четыре сообщения выдаёт сам Claude Code, последние два приходят от сервера.

Ошибки тайм-аута Wokey

Все ошибки тайм-аута Wokey — это 504 в стандартном формате ошибок. По полю code видно, на каком этапе застрял запрос:

Например:

{"error":{"code":"upstream_gateway_timeout","message":"Upstream gateway timed out before producing a response.","type":"invalid_request_error"}}

Если тайм-аут случается уже после того, как ответ начал передаваться потоком, он приходит не как HTTP 504, а как событие error внутри потока.

Когда вывода долго нет — например, пока модель долго думает, — Wokey периодически записывает в поток SSE-комментарий, чтобы поддерживать соединение:

: wokey-transport-keepalive-v1

Клиенты игнорируют строки-комментарии. Если вы видите такую строку при тестировании через curl, соединение живо и модель всё ещё работает.

Шаги диагностики

1. Проверьте через curl, что поток приходит по частям.

curl -N https://api.wokey.ai/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":300,"stream":true,"messages":[{"role":"user","content":"Count from 1 to 60"}]}'

-N отключает собственную буферизацию curl.

• Строки event: и data: появляются по мере поступления: весь путь в порядке.
• Всё появляется разом после долгого ожидания: что-то посередине буферизует ответ, и на таком пути Claude Code склонен падать по тайм-ауту.

2. Проверьте локальный прокси. Claude Code учитывает HTTPS_PROXY и системные настройки прокси. Режим TUN, прокси с правилами маршрутизации и корпоративные шлюзы могут буферизовать потоковые ответы или обрывать простаивающие соединения. Если ваша сеть может напрямую достучаться до api.wokey.ai, исключите этот домен из прокси и попробуйте снова. Если без прокси не обойтись, сравните с другим узлом.

3. Увеличьте тайм-аут. Если путь проверен, а запросы действительно долгие, поднимите лимит в блоке env файла ~/.claude/settings.json:

{
  "env": {
    "API_TIMEOUT_MS": "1200000"
  }
}

• API_TIMEOUT_MS — тайм-аут одного запроса в миллисекундах. По умолчанию 600000 (10 минут).
• Если прокси в вашей сети придерживает ответы до их завершения, сообщение об ошибке Claude Code предлагает также увеличить CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS.
• Обнаружение потока, который застрял на середине, управляется переменной CLAUDE_STREAM_IDLE_TIMEOUT_MS. Значения меньше 5 минут поднимаются до 5 минут, максимум — 30 минут.

4. Уменьшите контекст. Чем больше контекст, тем медленнее он загружается и тем позже приходит первый токен. Выполните /compact, чтобы сжать сессию, или начните новую.

5. Если вы получили 408. 408 означает, что тело запроса перестало поступать во время загрузки и шлюз прекратил ожидание. Почти всегда это бывает только с очень большим контекстом в нестабильной сети. Обычно простой повтор проходит успешно. Если ошибка повторяется, проверьте прокси, как в шаге 2, затем уменьшите запрос с помощью /compact.

Тайм-ауты в Codex

Тайм-аут простоя потока в Codex по умолчанию составляет 300000 мс (5 минут). Когда он срабатывает, вы видите idle timeout waiting for SSE или stream disconnected before completion, а при автоматических повторах — Reconnecting... n/max. Эти параметры задаются в таблице провайдера:

[model_providers.wokey]
name = "Wokey"
base_url = "https://api.wokey.ai"
env_key = "WOKEY_API_KEY"
wire_api = "responses"
stream_idle_timeout_ms = 600000
stream_max_retries = 10

stream_max_retries по умолчанию равен 5, а request_max_retries — 4; оба ограничены значением 100. Полную настройку смотрите в руководстве по config.toml для Codex.