---
title: "Mac Claude Code에서 “Request timed out” · Kilobat 가이드"
url: "https://kilobat.app/ko/guides/claude-code-request-timed-out"
description: "Mac의 Claude Code가 Request timed out을 출력합니다. API가 제한 시간 안에 응답하지 않았습니다. 네트워크, 프록시, 제한 시간 설정을 확인하세요."
---

# Mac Claude Code의 “Request timed out”

Claude Code는 API가 연결 제한 시간 안에 응답하지 않으면 Request timed out을 출력합니다. 기본 요청 제한 시간은 10분입니다.

**에이전트로 해결하기**Claude Code, Codex 또는 터미널을 쓸 수 있는 에이전트용 프롬프트를 복사합니다.

제 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 점검은 직접 실행하고, 알아낸 내용을 알려 주세요. 저만 할 수 있는 단계는 목록으로 정리해 주세요. 설정을 바꾸기 전에는 먼저 물어봐 주세요.

적용 대상: 현재의 모든 macOS 버전의 터미널에서 실행하는 Claude Code. · 확인일: 2026년 10월 29일

## 증상

- 오래 기다린 뒤 Claude Code가 `Request timed out`를 출력합니다.
- 느린 네트워크, 프록시를 거칠 때 또는 큰 요청에서 발생합니다.
- 일부 재시도는 성공합니다.

## 가능한 원인

- **느린 네트워크 또는 프록시.** 문서에 따르면 느린 네트워크나 프록시가 원인일 수 있습니다.
- **멈춘 연결.** VPN이나 방화벽이 패킷을 붙잡아 응답이 오지 않을 수 있습니다.
- **큰 요청.** 스트리밍이 아닌 요청은 로컬 세션에서 300초 제한이 유지됩니다.
- **이전 버전의 제한 시간 0.** v2.1.305 이전 버전에서는 API_TIMEOUT_MS를 0으로 설정하면 모든 요청이 실패할 수 있습니다.

## 확인 방법

1. 같은 셸에서 API 호스트를 테스트하세요.

   ```
   curl -I https://api.anthropic.com
   ```
2. 버전을 확인하세요.

   ```
   claude --version
   ```
3. 프록시 변수를 표시합니다.

   ```
   env | grep -i proxy
   ```
4. Claude Code 안에서 설정 점검을 실행하세요.

   ```
   /doctor
   ```

## 해결 방법

1. 요청을 다시 시도하세요.
2. 느린 네트워크나 프록시에서는 제한 시간을 늘리세요.

   ```
   export API_TIMEOUT_MS=900000
   ```
3. 제한 시간을 0으로 설정했다면 Claude Code를 업데이트하세요.
4. 제한 시간 초과가 잦으면 다른 네트워크와 VPN을 테스트하세요.

## Kilobat 사용

1. Kilobat의 연결 진단은 API 호스트를 계층별로 테스트합니다. 실패하거나 느린 계층을 알려줍니다.

   ```
   kilobat why https://api.anthropic.com
   ```
2. 이 Kilobat 검사는 무료입니다. AI 에이전트는 MCP를 통해 `diagnose_connection` 및 `diagnose_network`(으)로 실행합니다. [특정 사이트나 API에 연결되지 않는 이유 찾기](https://kilobat.app/ko/guides/recipes/why-cant-it-connect)를 참조하세요.

## 질문

**기본 제한 시간은 얼마인가요?**

Claude Code 문서에는 요청 제한 시간이 10분으로 나와 있습니다.

**API_TIMEOUT_MS=0으로 하면 모든 제한 시간이 꺼지나요?**

아니요. 첫 바이트 제한 시간과 본문 유휴 제한 시간은 계속 적용됩니다.

## 출처

- [Claude Code: 오류 참고](https://code.claude.com/docs/en/errors.md)
- [Claude Code: 기업 네트워크 구성](https://code.claude.com/docs/en/network-config.md)

2026년 10월 29일 확인했습니다.

## 관련 가이드

- [Mac Claude Code의 “Unable to connect to API”](https://kilobat.app/ko/guides/claude-code-unable-to-connect-to-api): Claude Code는 요청이 api.anthropic.com에 도달하지 못하면 Unable to connect to API를 출력합니다.
- [Mac의 Chrome에서 ERR_CONNECTION_TIMED_OUT](https://kilobat.app/ko/guides/err-connection-timed-out): Chromium은 이 오류를 “연결 시도 시간이 초과되었습니다”라고 설명합니다. Chrome이 주소를 찾았지만 서버가 제때 응답하지 않았습니다.
- [버퍼블로트: 네트워크가 바쁠 때 통화가 지연됩니다](https://kilobat.app/ko/guides/bufferbloat-mac): 버퍼블로트는 네트워크 기기가 버퍼에 너무 많은 데이터를 보관할 때 발생하는 지연입니다.
- [Mac에서 ping으로 패킷 손실 테스트하기](https://kilobat.app/ko/guides/packet-loss-mac): 패킷 손실이 발생하면 통화가 끊기고 페이지 로딩이 멈춥니다.
