문제 해결
Cline API 오류 — API Request Failed, 401, 429, 컨텍스트 한도 해결
Cline은 대부분의 실패를 "API Request Failed" 배너와 그 아래 프로바이더 응답으로 표시합니다. 배너 자체는 진단이 아닙니다 — 본문의 상태 코드와 error.type이 진단입니다. 아래 페이지는 각 본문을 해결책으로 연결합니다.
| 오류 | 의미 |
|---|---|
API Request Failed | Cline의 API Request Failed 배너는 프로바이더 응답을 감싼 래퍼입니다. 그 아래의 상태 코드와 error.type을 읽고 실제 해결책으로 가는 방법. |
{"error":{"message":"Invalid or missing API key.","type":"invali… | OpenAI 호환 엔드포인트가 키를 거부하면 Cline은 401을 반환합니다: 잘못된 base URL 필드, 키의 공백, 또는 폐기된 키. 해결 체크리스트. |
{"error":{"message":"Rate limit reached. Please retry shortly.",… | Cline 에이전트 실행은 요청을 연달아 보내다가 429 재시도 루프에 빠집니다. 에이전트 작업이 왜 계정의 요청 속도 한도에 닿는지, 실행을 끝까지 마치는 방법. |
{"error":{"message":"This model's maximum context length was exc… | Cline에 누적된 작업 컨텍스트가 선택한 모델의 창에 더 이상 들어가지 않으면 400 context_length_exceeded가 나타납니다. 복구하는 방법과 다음 작업을 한도 안에 두는 방법. |
Cline API Request Failed — 진짜 오류를 진단하는 방법
Cline의 API Request Failed 배너는 프로바이더 응답을 감싼 래퍼입니다. 그 아래의 상태 코드와 error.type을 읽고 실제 해결책으로 가는 방법.
Cline 401 Invalid API Key (OpenAI Compatible) 해결
OpenAI 호환 엔드포인트가 키를 거부하면 Cline은 401을 반환합니다: 잘못된 base URL 필드, 키의 공백, 또는 폐기된 키. 해결 체크리스트.
Cline 429 rate_limit_error — 재시도 루프 멈추기
Cline 에이전트 실행은 요청을 연달아 보내다가 429 재시도 루프에 빠집니다. 에이전트 작업이 왜 계정의 요청 속도 한도에 닿는지, 실행을 끝까지 마치는 방법.
Cline 최대 컨텍스트 길이 초과 (context_length_exceeded) 해결
Cline에 누적된 작업 컨텍스트가 선택한 모델의 창에 더 이상 들어가지 않으면 400 context_length_exceeded가 나타납니다. 복구하는 방법과 다음 작업을 한도 안에 두는 방법.