ChatGPT, Claude, Gemini를 코드로 연동할 때 가장 미치겠는 건 모델이 똑똑하지 않은 게 아니라, 아예 너를 상대도 안 한다는 것: 401, 403, 429가 번갈아 튀어나온다. 아래 점검 루틴은 내가 가장 자주 쓰는 방식인데, 기본적으로 “API가 안 됨”을 미신의 영역에서 현실로 끌어내린다.
1) 401 오류: 키가 무효이거나 서명이 틀림
invalid_api_key, Unauthorized가 보이면 인생을 의심하기 전에, 십중팔구 복사할 때 공백이 들어갔거나, 접두사가 빠졌거나, 테스트 환경의 키를 운영에 넣었거나 그렇다.
- 키가 올바른 플랫폼에서 발급된 것인지 확인: OpenAI, Anthropic, Google은 섞어 쓰지 말 것
- 요청 헤더 확인: Bearer 형식이 맞는지
- 처음부터 파라미터를 잔뜩 붙이지 말고, 최소 요청으로 검증
2) 429 오류: 레이트 리밋 또는 크레딧/쿼터 소진
429는 네트워크 문제처럼 보이지만, 사실은 “너무 세게 썼다”에 가깝다.
- 동시성 제어, 지수 백오프로 재시도
- 청구서와 할당량 확인: Gemini와 Claude의 프로젝트/조직을 잘못 선택하지 않았는지
- 긴 텍스트는 가능하면 분할, 프롬프트는 KISS 원칙: 단순할수록 오히려 더 안정적
3) 403 오류: 지역 제한 또는 리스크/보안 차단
403은 많은 경우 네 권한이 없어서가 아니라, 플랫폼이 너를 “수상하다”고 판단해서다. 회사 내부망, 데이터센터 IP, 잦은 노드 변경은 쉽게 트리거가 된다.
