FAQ 및 문제 해결초보자업데이트
연결이 느리거나 요청이 실패하면?
상태 코드와 오류 원문을 본 다음 주소를 바꿉니다. 예비 도메인은 Key, 모델, 엔드포인트 문제를 고치지 않습니다.
현상별로 확인
| 현상 | 먼저 확인할 것 |
|---|---|
| 400 | 엔드포인트, 모델 ID, 필드 형식 및 조합 확인 |
| 401 | Key가 빠지지 않았고, 교체되거나 비활성화되지 않았는지. 환경 변수가 새 터미널에 들어왔는지 |
| 402 | 잔액 또는 사용 가능한 플랜 한도 확인 |
| 403 / 모델 사용 불가 | 엔드포인트 선택에 그 모델 계열이 저장됐는지. 모델 ID가 기능 카탈로그에 있는지 |
| 429 | 요청 빈도·동시 요청 수 한도 또는 일시적 혼잡. 본문을 읽고 Retry-After가 있으면 따르며 대기 시간을 늘려 재시도 |
| 5xx | 오류와 요청 시간을 저장하세요. 작업 조회는 대기 후 재시도할 수 있습니다. 생성 요청 결과가 불확실하면 원래 작업부터 확인하세요 |
| 시간 초과, 연결 재설정, 계속 도는 표시 | 주소가 https://api.icodeeasy.cc인지. 그래도 느릴 때만 아래 예비 도메인으로 바꿉니다 |
| Gemini 경로가 404 | GOOGLE_GEMINI_BASE_URL은 도메인만. /v1beta를 붙이지 않음 |
예비 도메인. 경로와 Key는 그대로 둡니다.
text
https://jp.icodeeasy.cc
https://sg.icodeeasy.cc
바꿀 항목: Claude Code, GLM, MiniMax는 ANTHROPIC_BASE_URL. Codex는 base_url. Kimi Code CLI는 base_url이며 /v1을 유지. Gemini CLI는 GOOGLE_GEMINI_BASE_URL.
바꾼 뒤 확인
같은 클라이언트에서 짧은 대화를 한 번 보냅니다. 성공하면 요청 로그를 열어 모델, 상태, 요금이 이번 요청인지 확인합니다. 계속 실패하면 상태 코드와 오류 원문을 티켓으로 보내세요. API Key 전문은 넣지 마세요.
각 클라이언트 설정은 Claude Code, Codex, Gemini CLI, FAQ에 있습니다.
관련 가이드
FAQ
API 키, 401·429 응답, Windows 환경 변수, 클라이언트 연결, 사용 한도와 문의 방법에 관한 일반적인 문제를 해결합니다.
Claude Code 설치, API 설정 및 Windows 오류 해결
Claude Code 설치, API 키와 접속 주소 설정, Windows·macOS·Linux 환경 확인부터 인증 오류와 연결 문제 해결까지 안내하고 Desktop·Kimi·GLM 설정을 연결합니다.
Codex 설정
Codex CLI를 설치하고 auth.json에 API 키를 저장한 뒤 I Code Easy provider와 Base URL을 설정하여 첫 세션을 시작합니다.