ChatGPT, Claude, Gemini를 서드파티 클라이언트나 봇 플러그인에 연결할 때 가장 흔히 터지는 지점이 바로 API 키 오류다. 분명 복사해서 붙여넣었는데도 invalid key, 401, unauthorized가 뜬다. 아래 점검 순서대로 하면 나는 거의 매번 살려냈다.
일단 재설치부터 하지 말자: 자주 나오는 원인 5가지
1 키를 복사할 때 공백이나 줄바꿈이 같이 들어감
특히 웹에서 설정 파일로 복사할 때 끝에 공백 하나만 붙어도 인생이 의심스러워진다. 키를 수동으로 다시 한 번 입력하는 게 가장 속 편하다.
2 위치를 잘못 넣음: 환경 변수가 적용되지 않음
많은 도구가 “설정 파일”과 “환경 변수”를 동시에 지원하는데, A를 수정했는데 실제로는 B를 읽는 경우가 있다. 로그에서 key from을 검색하거나 플러그인 문서의 읽기 우선순위를 확인하는 것을 권한다.
3 공급자 또는 모델명을 잘못 선택함
멀티 모델 클라이언트는 OpenAI 모델명을 Claude에 요청해버리기 쉬운데, 에러가 또 그럴듯하게 나온다. 모델 목록은 기억에 의존하지 말고 콘솔에서 복사하는 게 가장 확실하다.
4 권한 또는 할당량 문제
일부 키는 기본으로 과금이 켜져 있지 않거나/카드가 연결되어 있지 않거나/해당 API 권한이 열려 있지 않아서 “무효”로 취급될 수 있다. 에러만 붙잡고 있기보다 콘솔의 Usage와 Billing을 보는 게 낫다.
