요청 시간 초과 해결

시간 초과는 첫 바이트가 오지 않거나, 클라이언트 timeout / response header timeout 오류, 또는 이후 503 쿨다운 응답으로 나타납니다. 잘못된 토큰과는 다릅니다.

가능한 원인

1. 긴 reasoning 또는 짧은 업스트림 혼잡 — 쿨다운 및 재시도 참고.
2. 로컬 네트워크 / 프록시 — .com vs .net 시도; 기업 프록시와 TLS 가로채기 도구 점검.
3. 클라이언트 timeout이 너무 짧음 — 긴 작업은 클라이언트 한도를 올리고 bounded backoff 사용.
4. 과도한 병렬 — 동시 Codex / Claude Code / 배치 작업을 1–3개로 줄이기.

단계

1. 다른 릴레이 호스트에서 한 번 재시도(토큰은 공유).
2. 같은 모델로 아주 짧은 프롬프트로 재현.
3. Status에서 점검 여부 확인.
4. no_account_available / cooling down이면 기다리기 — 연속 재시도 금지.
5. 약 15분 후 support@4aicode.com에 시각, 모델, 도구, trace_id(토큰은 제외)를 보냅니다.

401 / 429 vs 시간 초과

관련 문서

• 성능
• 모델
• Codex 설정