흔한 오류 및 접속 점검
401 / invalid_api_key
요청이 본 사이트 Base URL로 전송되었는지, 그리고 Authorization에 Bearer sk-...를 사용했는지 확인합니다. Key가 완전한지, 철회되지 않았는지, 소속 그룹이 맞는지 점검합니다.
404 / model not found
모델 ID, 프로토콜 주소 및 Key 그룹을 순차적으로 확인합니다. OpenAI Compatible는 보통 /v1가 포함된 주소를 사용하며, Claude Code는 보통 /v1가 없는 루트 주소를 사용합니다.
403 또는 리스크 제어 차단
스크립트에 명확한 User-Agent를 설정하여 빈 User-Agent가 게이트웨이에 의해 차단될 확률을 줄입니다. 제한을 반복 시도로 우회하지 마세요.
요청이 느린 경우
우선 짧은 질문으로 테스트합니다. 짧은 질문은 빠르지만 복잡한 작업이 느리다면, 보통 문맥 또는 모델 추론에 시간이 걸리는 경우입니다. 짧은 질문도 느리다면, 로컬 네트워크, 라인 및 서비스 상태를 점검합니다.
연결은 성공했지만 클라이언트에 변화 없음
클라이언트를 완전히 종료한 후 다시 엽니다. 여러 구성 파일, 이전 환경 변수가 새 구성에 덮어쓰는지, 혹은 CC Switch가 실제로 목표 공급자를 활성화했는지 확인합니다.
출시 전 점검 목록
- 최소 요청으로 Key, Base URL, 모델 세 가지를 검증합니다.
- 타임아웃, 재시도, 동시 처리 및 예산 한도를 설정합니다.
- 예비 라인 또는 예비 모델을 준비합니다.
- 로그 탈감작 처리, Key를 완전하게 기록하지 않습니다.