Claude Code "Credit balance is too low": 원인과 해결법 (잔액 / 구독 인증)
지금 장애가 있나요?
Claude Code 공식 상태는 정상입니다. 이 오류가 계속되면 구현(코드) 또는 사용자 환경 문제일 가능성이 높습니다.
업데이트: 2026. 6. 6. AM 4:45 UTC
Claude Code의 가동 상태 보기 →오류의 의미
"Credit balance is too low"는 종량제 API 크레딧 잔액이 부족하다는 의미입니다. 혼동하기 쉬운 점은, Pro/Max 구독을 사용할 의도라 해도 API 키(ANTHROPIC_API_KEY)로 인증하면 Claude Code가 API 사용으로 청구된다는 것입니다. 따라서 잔액이 0이면 이 오류가 발생합니다. 실제로 크레딧이 소진된 경우일 수도 있고, 구독 인증으로 전환해야 하는 경우일 수도 있습니다.
자주 있는 원인
- •종량제 API 선불 잔액이 0이거나 부족함
- •구독(Pro/Max/Team/Enterprise)을 사용하려 했으나 API 키로 인증되어 있음
- •등록된 결제 수단이 없거나 만료됨
- •auto-reload가 설정되지 않아 잔액이 소진됨
- •조직/워크스페이스의 잔액 또는 한도 문제
해결 방법
- 1.구독을 사용하려면 API 키를 제거하고 /login으로 구독 인증을 하세요(환경에 ANTHROPIC_API_KEY가 설정되어 있지 않은지 확인)
- 2.API를 사용하려면 platform.claude.com → Billing에서 크레딧을 추가하세요
- 3.재발을 막기 위해 auto-reload를 활성화하세요
- 4.결제 수단을 등록하거나 갱신하세요
- 5./status 또는 /doctor를 실행해 현재 인증 방식(구독 vs API 키)을 확인하세요
- 6.이 페이지 상단에서 Anthropic 측 장애가 아닌지 확인하세요
기다리면 되는 경우 / 기다려도 안 되는 경우
이는 잔액/인증 문제이므로 기다린다고 해결되지 않습니다. 구독을 쓰려면 /login을, API를 쓰려면 크레딧 추가를 하세요. "구독이 있는데도" 나타난다면, ANTHROPIC_API_KEY가 로그인을 덮어쓰고 있지는 않은지 확인하세요.
Claude Code을(를) 쓸 수 없을 때의 대체
관련 오류
자주 묻는 질문
Credit balance is too low은(는) 무엇인가요?
"Credit balance is too low"는 종량제 API 크레딧 잔액이 부족하다는 의미입니다. 혼동하기 쉬운 점은, Pro/Max 구독을 사용할 의도라 해도 API 키(ANTHROPIC_API_KEY)로 인증하면 Claude Code가 API 사용으로 청구된다는 것입니다. 따라서 잔액이 0이면 이 오류가 발생합니다. 실제로 크레딧이 소진된 경우일 수도 있고, 구독 인증으로 전환해야 하는 경우일 수도 있습니다.
Credit balance is too low은(는) 어떻게 해결하나요?
구독을 사용하려면 API 키를 제거하고 /login으로 구독 인증을 하세요(환경에 ANTHROPIC_API_KEY가 설정되어 있지 않은지 확인) / API를 사용하려면 platform.claude.com → Billing에서 크레딧을 추가하세요 / 재발을 막기 위해 auto-reload를 활성화하세요 / 결제 수단을 등록하거나 갱신하세요 / /status 또는 /doctor를 실행해 현재 인증 방식(구독 vs API 키)을 확인하세요 / 이 페이지 상단에서 Anthropic 측 장애가 아닌지 확인하세요