Claude 3.5 Sonnet 은퇴 후, Cursor API 429는 어떻게 진단할까? (2026)

먼저 429를 반환한 계층을 찾고, 응답 내용과 제한 관련 헤더, LiteLLM 로그를 대조하세요. Claude 3.5 Sonnet API 모델은 2025년 10월 28일 퇴역했으므로, 해당 모델 식별자를 계속 호출하는 설정은 재시도보다 모델 상태 확인이 우선입니다 (Anthropic 모델 퇴역 기록).
Cursor에서 Claude API를 호출하지만 오류가 어느 서비스에서 시작됐는지 모르는 개발자에게 적합합니다.
LiteLLM을 사용하는 엔지니어는 게이트웨이 제한과 상위 모델 제공자의 응답을 구분할 수 있습니다.
오래된 Claude 3.5 Sonnet 연동을 관리하는 팀은 모델 식별자부터 점검하면 됩니다.
요청 경로에 따라 달라지는 429의 책임
HTTP 429는 요청이 제한됐다는 상태 코드입니다. 하지만 이 코드만 보고 Anthropic의 속도 제한이라고 단정할 수는 없습니다. Cursor가 자체 서비스 경로로 요청했는지, 사용자의 API 키로 제공자에게 직접 보냈는지, LiteLLM을 통과했는지에 따라 확인할 로그와 문의할 대상이 달라집니다.
| 요청 경로 | 우선 확인할 증거 | 먼저 점검할 대상 |
|---|---|---|
| Cursor에서 사용자 API 키로 직접 호출 | 상위 제공자의 응답 내용과 제한 관련 헤더 | API 키, 모델 설정, 제공자 응답 |
| Cursor 내장 모델 서비스 | 클라이언트 오류 표시와 계정 서비스 상태 | 선택한 모델, 실제 호출 경로, 서비스 상태 |
| LiteLLM 게이트웨이 경유 | 게이트웨이 인바운드 로그와 상위 요청 결과 | 가상 키, 팀 제한, 배포 동시성, 라우팅 기록 |
Cursor의 사용자 API 키 설정은 Cursor API 키 안내에서 확인할 수 있습니다. 사용자가 자신의 키를 넣은 경로와 Cursor 내장 서비스를 이용하는 경로는 사용량과 장애 책임이 같지 않습니다. 따라서 “Cursor에서 429가 떴다”는 사실만으로 Cursor나 Anthropic 중 한쪽을 원인으로 지목하면 안 됩니다.
Cursor가 Claude API에 보낸 요청이 Anthropic 제한인지 어떻게 가리나요?
사용자 API 키를 통한 직접 호출이라면, 상위 제공자의 원본 응답을 확보해 본문과 제한 관련 헤더를 확인합니다. 응답에 제한 관련 정보가 없다면 클라이언트가 보여 주는 메시지만으로 RPM이나 계정 한도를 추정하지 마세요. 호출 경로와 원본 응답을 확인할 수 없는 경우에는 Cursor 내장 서비스 경로인지부터 구분해야 합니다.
직접 API 경로와 내장 서비스 경로의 증거 차이
Anthropic은 API 제한을 요청 수뿐 아니라 입력·출력 토큰 처리량 등 여러 차원으로 관리한다고 설명합니다. 429 응답과 retry-after 및 관련 상태 헤더의 의미도 문서에 안내되어 있습니다 (Anthropic API 제한 문서). 다만 실제로 어떤 제한이 적용됐는지는 해당 요청의 원본 응답을 확인해야 합니다. 문서에 나온 일반 규칙만으로 개별 계정의 한도를 추정할 수는 없습니다.
| 확인 자료 | 읽을 수 있는 내용 | 단독으로 확정할 수 없는 내용 |
|---|---|---|
| 응답 본문 | 오류 유형과 설명 | 계정 전체의 현재 사용량 |
retry-after |
제공자가 안내한 재시도 대기 시간 | 다른 제한 유형이 함께 걸렸는지 여부 |
| 제한 관련 상태 헤더 | 해당 응답에 포함된 제한 상태 정보 | 클라이언트나 게이트웨이가 원본 헤더를 그대로 전달했는지 여부 |
retry-after가 제공되면 임의로 짧은 간격으로 반복 호출하지 말고 안내된 대기 시간을 따르세요. 헤더가 보이지 않는다면 헤더가 없었다고 바로 결론 내리기보다, Cursor나 프록시가 응답 정보를 숨기거나 변환했는지도 확인해야 합니다. Anthropic의 API 오류 문서는 오류 응답을 해석할 때 참고할 공식 기준입니다.
Claude API 429 응답의 대기 시간과 제한 헤더는 어떻게 확인하나요?
직접 호출 경로에서는 가능한 한 원본 응답 본문과 헤더를 함께 기록합니다. 클라이언트 화면에 오류 문구만 보이고 응답 헤더가 없다면, 그 화면만으로 특정 요청 수 제한이나 토큰 한도를 단정할 수 없습니다. 이 경우 제공자 응답을 확인할 수 있는 경로인지 먼저 살피고, 계정 상태나 사용량 제한은 제공자 문서와 계정 정보를 별도로 대조합니다.
LiteLLM 경유 요청은 인바운드와 상위 응답을 분리
LiteLLM이 포함된 경로에서는 클라이언트에 보이는 429가 게이트웨이에서 생성됐는지, 상위 모델 제공자의 응답을 전달한 것인지 구분해야 합니다. LiteLLM의 프록시 요청 처리 구조와 사용자별 제한 설정 안내를 참고해 요청 단계와 제한 경계를 확인할 수 있습니다.
| 로그에서 확인할 지점 | 게이트웨이 쪽 가능성 | 상위 제공자 쪽 가능성 |
|---|---|---|
| 인바운드 요청 기록 | 요청은 도착했으나 가상 키·팀·배포 제한에서 거절됨 | 인바운드 이후 상위 요청이 발생함 |
| 상위 요청 결과 | 상위 호출 전에 차단되어 결과가 없음 | 상위 응답에 제한 오류가 기록됨 |
| 라우팅·재시도 기록 | 모델 그룹이나 로컬 제한 설정을 확인 | 상위 응답 이후 재시도 또는 대체 경로가 실행됐는지 확인 |
LiteLLM의 429가 게이트웨이 동시성 제한인지 상위 모델 제한인지 어떻게 구분하나요?
같은 요청의 인바운드 기록과 상위 요청 결과를 시간 순서대로 대조합니다. 상위 호출이 기록되지 않았다면 가상 키, 팀 제한, 배포 동시성 등 게이트웨이 설정을 먼저 살펴보세요. 상위 호출이 있고 그 결과가 제한 오류라면 제공자 응답을 확인합니다. 라우팅과 재시도는 LiteLLM Router 문서의 설명을 참고하되, 이 글의 목적은 설정 작성이 아니라 오류가 시작된 위치를 가리는 것입니다.
퇴역 모델 식별자와 실제 제한 오류를 구별
Claude 3.5 Sonnet API 모델은 Anthropic의 공식 퇴역 기록상 2025년 10월 28일 이후 사용할 수 없습니다. 따라서 오래된 식별자를 보낸 요청에서 발생한 실패를 현재의 속도 제한으로 해석하면 원인 분석이 어긋납니다. 특히 모델을 고정해 둔 클라이언트 설정, LiteLLM 모델 매핑, 애플리케이션 환경 설정을 각각 확인해야 합니다.
퇴역 뒤 옛 모델 식별자가 실패하면 무엇부터 확인하나요?
애플리케이션 설정과 배포 환경 변수에서 해당 식별자를 찾고, 이어서 LiteLLM 모델 매핑과 Cursor의 선택 모델을 대조합니다. 공식 퇴역 기록과 일치하는지 확인한 다음, 현재 사용할 수 있는 모델로 설정을 바꾸고 새 요청의 응답과 로그를 다시 살핍니다. 모델을 찾을 수 없다는 오류와 429 제한 응답은 같은 문제로 취급하지 마세요.
증거에 맞춰 다음 조치를 고르는 조건
- 응답에
retry-after가 있고 원본 상위 응답임을 확인했다면, 안내된 시간만큼 기다린 뒤 제한된 호출을 다시 확인합니다. - 상위 호출 기록이 없고 LiteLLM 인바운드 단계에서 거절됐다면, 가상 키와 팀·배포 제한을 점검합니다.
- 상위 응답에 제한 정보가 있지만 Cursor 화면에는 오류 문구만 보인다면, 클라이언트가 전달하는 정보와 제공자 원본 응답을 분리해 확인합니다.
- 오류가 모델을 찾을 수 없다는 내용이고 설정에 퇴역 식별자가 남아 있다면, 반복 호출을 멈추고 모델 설정부터 수정합니다.
- 어느 계층의 응답인지 확인할 자료가 없다면, 재시도 횟수부터 늘리지 말고 요청 경로와 로그 수집 상태를 확인합니다.
반복 재시도는 요청량을 더 키울 수 있습니다. 다른 모델로 대체 호출하는 방식도 응답의 품질이나 동작이 기존 모델과 같다고 보장하지 않습니다. 먼저 원인을 분류하고, 제한 오류라면 제공자 안내에 따르며, 모델 상태 오류라면 유효한 식별자로 바꾼 뒤 결과를 다시 확인해야 합니다.
개발 환경과 API 게이트웨이는 별개로 운영
개발용 맥 환경은 편집기와 테스트 도구를 실행하는 곳이고, 모델 API 게이트웨이는 요청을 전달하고 제한 및 라우팅을 관리하는 별도 계층입니다. 클라우드 맥으로 개발 환경을 옮겨도 상위 API의 제한이 해제되지는 않습니다. 환경 접속과 계정 운영을 따로 확인하려면 ProxyMac 콘솔 안내와 도움말을 참고할 수 있습니다.
기존 개발 환경에서 겪는 불편이 API 429인지, 원격 개발 환경의 접속·운영 문제인지부터 나누는 편이 낫습니다. 자체 장비는 물리 연결과 지속적인 로컬 작업이 필요한 경우에 적합하고, 클라우드 개발 환경은 필요한 기간에 원격 작업 공간을 쓰려는 경우에 검토할 수 있습니다. 다만 API 제한을 직접 해결하는 수단으로 클라우드 맥을 선택해서는 안 됩니다. 개발 환경을 분리해 시험할 필요가 있다면 ProxyMac의 클라우드 맥 환경을 살펴보고, 게이트웨이와 모델 제공자의 제한은 별도 로그로 계속 진단하세요.