문제 해결

AI 코딩 도구 오류 — Claude Code, Cursor, Codex, opencode, Cline, Zed

문제가 발생한 도구를 선택하세요. 모든 페이지는 도구가 출력하는 텍스트를 그대로 인용하고, 무엇이 그 오류를 만들었는지 설명하며, 정상 동작까지의 가장 짧은 경로를 제시합니다. 상태 코드별로 정리된 API 수준 레퍼런스는 Claude API 오류 코드 페이지를 참고하세요.

Claude Code 오류

Claude Code가 출력하는 모든 오류의 해결책: API Error 429 rate_limit_error, 401 invalid x-api-key, 529 Overloaded, 사용량 한도 메시지. 정확한 출력, 원인, 해결 방법.

Cursor 오류

커스텀 Anthropic 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 오류

Anthropic 키 사용 시 발생하는 Cline 오류의 해결책: API Request Failed 배너, 401 invalid x-api-key, 429 rate_limit_error 재시도 루프, 컨텍스트 한도 400. 각각의 원인과 해결 방법.

Zed 오류

Anthropic 모델 사용 시 Zed 어시스턴트 오류의 해결책: 401 invalid x-api-key, 429 레이트 리밋, 529 Overloaded, 커스텀 api_url 설정과 /v1/v1 404 함정.

Claude API 오류 코드

API 수준 레퍼런스: 모든 상태 코드와 응답 본문 원문을 도구가 아닌 코드 기준으로 정리했습니다.

잘못된 설정에 시간 낭비하지 마세요

apiToken.sale은 표준 Anthropic API를 제공합니다 — 같은 모델, 같은 SDK, 하나의 선불 잔액. 도구의 base URL만 지정하면 이 페이지의 설정이 적힌 그대로 작동합니다.