문제 해결

Cline API 오류 — API Request Failed, 401, 429, 컨텍스트 한도 해결

Cline은 대부분의 실패를 "API Request Failed" 배너와 그 아래 프로바이더 응답으로 표시합니다. 배너 자체는 진단이 아닙니다 — 본문의 상태 코드와 error.type이 진단입니다. 아래 페이지는 각 본문을 해결책으로 연결합니다.

오류	의미
`API Request Failed`	Cline의 API Request Failed 배너는 프로바이더 응답을 감싼 래퍼입니다. 그 아래의 상태 코드와 error.type을 읽고 실제 해결책으로 가는 방법.
`{"type":"error","error":{"type":"authentication_error","message"…`	Anthropic 호환 엔드포인트가 키를 거부하면 Cline이 401 invalid x-api-key를 반환합니다: 잘못된 base URL 필드, 키의 공백, 폐기된 키. 해결 체크리스트.
`{"type":"error","error":{"type":"rate_limit_error","message":"Th…`	Cline 에이전트 실행은 분당 토큰 예산을 빠르게 소진한 뒤 429 재시도 루프에 빠집니다. 에이전트 워크로드가 왜 레이트 리밋을 유발하는지, 실행을 통과시키는 방법.
input length and `max_tokens` exceed context limit: 199999 + 819…	400 input length and max_tokens exceed context limit는 Cline이 누적한 작업 컨텍스트와 출력 예약분이 더 이상 모델 윈도우에 들어가지 않을 때 나타납니다. 복구 방법.

Cline API Request Failed — 진짜 오류를 진단하는 방법

Cline의 API Request Failed 배너는 프로바이더 응답을 감싼 래퍼입니다. 그 아래의 상태 코드와 error.type을 읽고 실제 해결책으로 가는 방법.

Anthropic 호환 엔드포인트가 키를 거부하면 Cline이 401 invalid x-api-key를 반환합니다: 잘못된 base URL 필드, 키의 공백, 폐기된 키. 해결 체크리스트.

Cline 에이전트 실행은 분당 토큰 예산을 빠르게 소진한 뒤 429 재시도 루프에 빠집니다. 에이전트 워크로드가 왜 레이트 리밋을 유발하는지, 실행을 통과시키는 방법.

400 input length and max_tokens exceed context limit는 Cline이 누적한 작업 컨텍스트와 출력 예약분이 더 이상 모델 윈도우에 들어가지 않을 때 나타납니다. 복구 방법.

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