Claude Code API 연결 오류: 시간 초과 및 해결 방법

오류 텍스트

API Error (Connection error.) · Unable to connect to API (ECONNREFUSED) · Request timed out

단계별 해결 방법

1. 1. 주소 확인

   /status를 실행하세요. 엔드포인트는 https를 사용하는 api.aicodewith.ai여야 하며, /v1이나 오타가 없어야 합니다.

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

2. 2. 네트워크 테스트

   같은 터미널에서 curl -I https://api.aicodewith.ai를 실행하세요. 멈추거나 실패하면 문제는 Claude Code가 아니라 네트워크입니다.

3. 3. 프록시 및 방화벽

   프록시를 사용한다면 해당 터미널에서 HTTPS_PROXY를 export하세요(또는 env 블록에 추가하세요). 회사 방화벽에서는 api.aicodewith.ai를 허용해야 할 수 있습니다.

4. 4. 타임아웃 높이기

   느리거나 긴 요청에서는 env 블록에 "API_TIMEOUT_MS": "600000"을 추가하고 재시작하세요.

일반적인 원인

실패한 요청에 요금이 부과되나요?

실패한 요청(4xx/5xx, 시간 초과, 끊긴 연결)에는 요금이 부과되지 않습니다 — 성공적으로 완료된 요청에만 청구됩니다. 업스트림 실패가 자동으로 재시도되어 성공하면 한 번만 청구됩니다.

계속 실패하나요?

• •aicodewith의 모델 페이지에서 각 채널의 최근 상태를 확인하세요.
• •대시보드 사용 기록에서 요청을 찾아 모델, 상태, 비용을 확인하세요.
• •support@aicodewith.com으로 오류 발생 시간, 모델, 오류 텍스트를 보내주세요(전체 API 키는 절대 보내지 마세요).

모델 상태 및 가격지원 문의문서

FAQ