강력한 AI 어시스턴트인 Claude를 사용하다 보면 API 호출 오류, 계정 잠금 또는 로그인 실패와 같은 문제에 자주 직면하게 됩니다. 이 글에서는 가장 빈번히 발생하는 장애 시나리오와 그에 맞는 해결 방법을 모아, 작은 문제로 업무 흐름이 끊기지 않도록 신속하게 도와드립니다.
Claude API 호출 오류: 429 및 500 오류 해결 방법
Claude API를 호출할 때 429 상태 코드는 일반적으로 요청이 너무 빈번하여 속도 제한(Rate Limit)이 발생했음을 의미합니다. 현재 API 키의 할당량 사용량을 확인하고, 한도에 가까워지면 몇 분간 멈췄다가 다시 시도하거나 Pro 요금제로 업그레이드하여 호출 한도를 높일 수 있습니다. 500 오류는 대개 서버 측 일시적 장애이므로, 30초 간격을 두고 재시도하는 것이 좋습니다. 지속적으로 발생하면 Anthropic 공식 상태 페이지에서 유지보수 공지가 있는지 확인하세요. 일부 사용자는 구형 API 엔드포인트를 잘못 사용하여 500 오류가 발생하기도 하니, URL이 v1/messages와 같은 최신 버전을 가리키는지 확인하십시오.
Claude 계정 로그인 실패: 비밀번호 재설정 및 이메일 인증
로그인 시 "비밀번호 오류" 또는 "계정이 존재하지 않음" 메시지가 뜨면, 올바른 이메일로 가입했는지 먼저 확인하세요. Claude는 '비밀번호 찾기' 기능을 통해 재설정을 지원하며, 재설정 링크는 15분 동안 유효합니다. 이메일이 도착하지 않으면 스팸 편지함을 확인하거나 다른 이메일 서비스를 사용해 보세요. 계정이 잠긴 경우(여러 번 잘못된 시도로 인해) 30분 후 자동으로 해제되며, 그동안 재입력하지 않는 것이 좋습니다. Google 또는 Apple 계정으로 로그인하는 사용자는 브라우저에 해당 계정이 로그인되어 있는지, 시크릿 모드가 켜져 있지 않은지 확인하십시오.
