Mac Claude Code의 “Request timed out”
Claude Code는 API가 연결 제한 시간 안에 응답하지 않으면 Request timed out을 출력합니다. 기본 요청 제한 시간은 10분입니다.
제 Mac에 이런 문제가 있습니다: Mac Claude Code의 “Request timed out”. https://kilobat.app/ko/guides/claude-code-request-timed-out.md을(를) 읽고 저와 함께 해결해 주세요. Kilobat CLI가 없으면 설치해 주세요: brew install seifip/kilobat/kilobat. 가이드의 터미널 및 kilobat 점검은 직접 실행하고, 알아낸 내용을 알려 주세요. 저만 할 수 있는 단계는 목록으로 정리해 주세요. 설정을 바꾸기 전에는 먼저 물어봐 주세요.
증상
- 오래 기다린 뒤 Claude Code가
Request timed out를 출력합니다. - 느린 네트워크, 프록시를 거칠 때 또는 큰 요청에서 발생합니다.
- 일부 재시도는 성공합니다.
가능한 원인
- 느린 네트워크 또는 프록시. 문서에 따르면 느린 네트워크나 프록시가 원인일 수 있습니다.
- 멈춘 연결. VPN이나 방화벽이 패킷을 붙잡아 응답이 오지 않을 수 있습니다.
- 큰 요청. 스트리밍이 아닌 요청은 로컬 세션에서 300초 제한이 유지됩니다.
- 이전 버전의 제한 시간 0. v2.1.305 이전 버전에서는 API_TIMEOUT_MS를 0으로 설정하면 모든 요청이 실패할 수 있습니다.
확인 방법
같은 셸에서 API 호스트를 테스트하세요.
curl -I https://api.anthropic.com버전을 확인하세요.
claude --version프록시 변수를 표시합니다.
env | grep -i proxyClaude Code 안에서 설정 점검을 실행하세요.
/doctor
해결 방법
요청을 다시 시도하세요.
느린 네트워크나 프록시에서는 제한 시간을 늘리세요.
export API_TIMEOUT_MS=900000제한 시간을 0으로 설정했다면 Claude Code를 업데이트하세요.
제한 시간 초과가 잦으면 다른 네트워크와 VPN을 테스트하세요.
Kilobat 사용
Kilobat의 연결 진단은 API 호스트를 계층별로 테스트합니다. 실패하거나 느린 계층을 알려줍니다.
kilobat why https://api.anthropic.com이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해
diagnose_connection및diagnose_network(으)로 실행합니다. 특정 사이트나 API에 연결되지 않는 이유 찾기를 참조하세요.
질문
기본 제한 시간은 얼마인가요?
Claude Code 문서에는 요청 제한 시간이 10분으로 나와 있습니다.
API_TIMEOUT_MS=0으로 하면 모든 제한 시간이 꺼지나요?
아니요. 첫 바이트 제한 시간과 본문 유휴 제한 시간은 계속 적용됩니다.
출처
2026년 10월 29일 확인했습니다.