문제 해결 · Cursor
자체 API 키 사용 시 Cursor 레이트 리밋 / 429
커스텀 API 키를 쓰면 Cursor의 429는 Cursor 요금제 한도가 아니라 그 키 뒤 계정의 요청 속도 또는 동시성 한도입니다. 에이전트 실행이 왜 이를 유발하는지, 루프를 멈추는 방법.
표시되는 내용
HTTP 429
{"error":{"message":"Rate limit reached. Please retry shortly.","type":"rate_limit_error","param":null,"code":"rate_limit_exceeded"}}발생 원인
- 키가 속한 계정의 요청 속도 또는 동시성 한도를 넘었습니다. 커스텀 키를 쓰면 Cursor 자체 요금제 한도는 관계가 없습니다 — 이것은 당신 키의 예산입니다.
- 에이전트 실행과 여러 바쁜 채팅 탭이 동시에 요청을 보내고, 합쳐서 한도에 닿습니다.
- 같은 키를 다른 도구나 팀원과 공유하고 있어, 그들의 트래픽이 같은 한도에 합산됩니다.
- 첫 429 이후 연달아 재시도하면 창이 계속 가득 찬 상태로 유지됩니다.
해결 방법
- 한 키에서 동시에 실행하는 에이전트 작업과 채팅 수를 줄이세요.
- Cursor에서 긴 실행이 도는 동안 같은 키를 쓰는 다른 도구는 잠시 멈추세요.
- 다시 시도하기 전에 Retry-After 간격만큼 기다리세요. 촘촘한 수동 재시도는 상태를 길게 만들 뿐입니다.
관련 검색어
cursor rate limit exceeded custom api keycursor 429 custom api key
자주 묻는 질문
이것이 Cursor의 fast requests 한도인가요?+
아니요. 자체 키를 쓰면 요청이 Cursor 요금제 계량을 완전히 우회합니다. 429는 키 뒤의 엔드포인트에서 옵니다.
에이전트 실행이 채팅보다 429에 더 자주 걸리는 이유는?+
에이전트 실행은 많은 요청을 연달아, 그리고 자주 병렬로 보내므로 단일 채팅보다 먼저 요청 속도나 동시성 한도에 닿습니다.
Cursor 요금제를 업그레이드하면 도움이 되나요?+
이 오류에는 도움이 되지 않습니다. 한도는 API 키 뒤의 계정에 속합니다. 병렬 사용을 줄이거나 Retry-After 간격만큼 기다리세요.