문제 해결

Claude Code API 오류 — 429, 401, 402, 529 해결

여기서 Claude Code는 Messages API로 GPT와 Gemini 모델을 호출하며, API 실패를 "API Error:"로 시작하는 한 줄과 원본 응답 본문으로 표시합니다. 아래 페이지는 각 형태의 정확한 텍스트, 발생 이유, 해결 방법을 다룹니다.

오류의미
API Error: 429 {"type":"error","error":{"type":"rate_limit_error…계정의 요청 속도 또는 동시성 한도에 도달하면 Claude Code는 API Error: 429 rate_limit_error를 출력합니다. GPT와 Gemini 모델에서 병렬 에이전트가 왜 이를 유발하는지, 어떻게 해결하는지 설명합니다.
API Error: 401 {"type":"error","error":{"type":"authentication_e…Claude Code는 연결 중인 엔드포인트에 유효한 키가 하나도 도달하지 않으면 API Error: 401 authentication_error를 출력합니다. 이를 일으키는 환경 변수 규칙과 해결 방법.
API Error: 529 {"type":"error","error":{"type":"overloaded_error…선택한 GPT 또는 Gemini 모델의 업스트림 용량이 포화되면 Claude Code는 API Error: 529 Overloaded를 출력합니다. 요청 탓이 아닌 이유, 몰려서 발생하는 이유, 실제로 도움이 되는 방법.
API Error: 402 {"type":"error","error":{"type":"invalid_request_…선불 잔액이나 키의 지출 한도가 요청을 감당하지 못하면 Claude Code는 API Error: 402를 출력합니다. 충전하세요. 402를 레이트 리밋처럼 재시도하지 마세요.

Claude Code API Error 429 (rate_limit_error) 원인과 해결 방법

계정의 요청 속도 또는 동시성 한도에 도달하면 Claude Code는 API Error: 429 rate_limit_error를 출력합니다. GPT와 Gemini 모델에서 병렬 에이전트가 왜 이를 유발하는지, 어떻게 해결하는지 설명합니다.

Claude Code API Error 401 authentication_error 해결 방법

Claude Code는 연결 중인 엔드포인트에 유효한 키가 하나도 도달하지 않으면 API Error: 401 authentication_error를 출력합니다. 이를 일으키는 환경 변수 규칙과 해결 방법.

Claude Code API Error 529 Overloaded의 의미

선택한 GPT 또는 Gemini 모델의 업스트림 용량이 포화되면 Claude Code는 API Error: 529 Overloaded를 출력합니다. 요청 탓이 아닌 이유, 몰려서 발생하는 이유, 실제로 도움이 되는 방법.

Claude Code API Error 402 — 잔액 부족

선불 잔액이나 키의 지출 한도가 요청을 감당하지 못하면 Claude Code는 API Error: 402를 출력합니다. 충전하세요. 402를 레이트 리밋처럼 재시도하지 마세요.

잘못된 설정에 시간 낭비하지 마세요

apiToken.sale은 OpenAI 호환, Messages(Anthropic 형식), 네이티브 Gemini 엔드포인트로 GPT와 Gemini 모델을 제공합니다 — 표준 SDK, 하나의 키, 하나의 선불 잔액. 도구의 base URL만 지정하면 이 페이지의 설정이 적힌 그대로 작동합니다.