Claude를 사용하다 갑자기 멈추거나 빨간색 오류 메시지가 뜨면 누구나 짜증납니다. 이 글은 Claude에서 자주 발생하는 오류 코드와 해결 방법을 정리한 것으로, 로그인 실패, API 연결 문제, 모델 한도 초과까지 모두 다룹니다. 순서대로 따라 하면 대부분 해결할 수 있습니다.
로그인 실패 및 계정 잠금 해결 방법
Claude 로그인 시 가장 흔한 오류는 'Invalid credentials'이거나 비밀번호를 연속으로 잘못 입력해 계정이 잠기는 경우입니다. 이런 상황에서는 먼저 이메일에서 Anthropic이 보낸 잠금 해제 링크가 있는지 확인하세요. 대부분의 잠금은 몇 분 후 자동으로 풀리므로 비밀번호 재설정을 서두를 필요가 없습니다. 'Account temporarily disabled' 메시지가 나타나면 IP가 의심스러운 것으로 표시된 경우가 많으므로, 깨끗한 네트워크 환경에서 다시 로그인하세요. 또한 Google 계정이나 Apple ID로 로그인할 때는 타사 인증이 만료되지 않았는지 확인하세요. 때로는 Claude가 로그인 프로토콜을 업데이트하면서 이전 토큰이 무효화될 수 있으므로, 로그아웃 후 다시 인증하면 해결됩니다.
API 호출 오류: 코드 단계에서 자주 발생하는 함정
개발자가 Claude API를 사용할 때 '401 Unauthorized'는 전형적인 API 키 문제입니다. 사용 중인 키가 할당량을 초과하지 않았는지, 복사할 때 공백이나 누락된 문자가 없는지 확인하세요. 또 다른 빈번한 오류인 '429 Too Many Requests'는 짧은 시간에 너무 많은 요청을 보낸 경우로, 1~2초의 지연을 추가한 후 재전송하거나 더 높은 등급의 요금제로 업그레이드하여 속도 제한을 높이세요. 때로는 '400 Bad Request'가 지원되지 않는 매개변수를 전달할 때 발생합니다. 예를 들어 새로운 Claude 모델이 인터페이스 필드를 변경한 경우, 문서 페이지에서 매개변수 이름을 대조하면 해결됩니다.
