AI 코딩 도구 오류 — Claude Code, Cursor, Codex, opencode, Cline, Zed
문제가 발생한 도구를 선택하세요. 모든 페이지는 도구가 출력하는 텍스트를 그대로 인용하고, 무엇이 그 오류를 만들었는지 설명하며, 정상 동작까지의 가장 짧은 경로를 제시합니다. 상태 코드별로 정리된 API 수준 레퍼런스는 API 오류 코드 페이지를 참고하세요.
Claude Code 오류
Claude Code가 apiToken.sale을 통해 GPT와 Gemini 모델을 실행할 때 출력하는 오류의 해결책: API Error 429 rate_limit_error, 401 authentication_error, 402 잔액 부족, 529 Overloaded. 정확한 출력, 원인, 해결 방법.
Cursor 오류
커스텀 OpenAI base URL과 API 키 사용 시 발생하는 Cursor 오류의 해결책: unable to reach model provider, 검증 시 invalid API key, 프로바이더의 401, 레이트 리밋. 각각의 원인과 해결 방법.
Codex CLI 오류
커스텀 모델 프로바이더 사용 시 Codex CLI 실패의 해결책: Missing OPENAI_API_KEY, config.toml 프로필 실수, auth.json 로그인 상태, stream error: unexpected status 401.
opencode 오류
커스텀 프로바이더에서 발생하는 opencode 실패의 해결책: AI_APICallError, 프로바이더 목록에 없는 모델, 인식되지 않는 API 키, 조용히 무시되는 이미지 첨부.
Cline 오류
OpenAI Compatible 프로바이더 사용 시 발생하는 Cline 오류의 해결책: API Request Failed 배너, 401 invalid API key, 429 rate_limit_error 재시도 루프, 400 context_length_exceeded. 각각의 원인과 해결 방법.
Zed 오류
OpenAI 프로바이더로 GPT와 Gemini 모델을 쓸 때 Zed 어시스턴트 오류의 해결책: 401 invalid API key, 429 레이트 리밋, 커스텀 api_url 설정과 /v1 누락으로 인한 404.
API 오류 코드
API 수준 레퍼런스: 모든 상태 코드와 응답 본문 원문을 도구가 아닌 코드 기준으로 정리했습니다.