CLI 한도 소진, 폴백 순서를 어떻게 정하나

Cursor CLI·Agent를 쓰다 보면 요청이 갑자기 거절되거나, 배너가 “usage limit / out of usage”를 띄우고 Auto·다른 모델로 바꾸라고 안내합니다. 재설치로 풀리지 않습니다. 어느 풀이 비었는지를 본 뒤, 남은 풀의 모델로 명시 전환하거나 작업을 끊고 재개하는 순서가 핵심입니다.

이 글은 **증상은? · 모델 전환 기준은? · 작업은 어떻게 끊나?**만 다룹니다. 근거는 Usage and limits, CLI overview, CLI parameters, Slash commands입니다. 요금·플랜 가격 숫자는 적지 않습니다. 한도 UI(풀·잔여·리셋일·on-demand 토글)만 말합니다. 개인 후기·창작 스토리는 없습니다.

증상은?

한 줄 답: CLI·에디터에 usage / rate limit 알림이 뜨고, 같은 모델로 재시도해도 거절되면 계정 한도(풀) 쪽을 먼저 봅니다. 로컬 버그·로그인 만료와 구분합니다.

자주 보이는 신호:

신호의미에 가까운 것먼저 할 일
“You’ve hit your usage limit” / “You’re out of usage”포함 사용량(풀) 소진 또는 해당 모델 한도Spending 또는 CLI 사용량 UI 확인
Auto·특정 모델로 전환하라는 배너지금 고른 모델/풀이 막힘어느 풀인지 확인 후 명시 전환
같은 프롬프트 재전송만 반복 실패네트워크보다 서버측 거절 가능성재시작·재설치보다 풀·모델부터
agent는 뜨는데 첫 응답만 거절세션은 살아 있고 요청만 막힘/model, --model, agent models

공식 안내에 따르면 대부분의 유료 플랜은 두 개의 월간 사용 풀을 둡니다.

  • Cursor Models — Cursor 쪽 모델(문서 예: Grok 계열, Composer 계열)
  • Other Models — 서드파티 모델(제공자 단가 기준으로 집계)

에디터에서는 알림이 뜨고, 대시보드 Spending 탭에서 풀별 실시간 사용·잔여·온디맨드 여부를 봅니다. CLI 쪽은 changelog 기준으로 사용량 미터·리셋일을 보여주는 명령이 갱신되어 왔으므로, 현재 빌드에서는 /help·문서의 usage 관련 항목을 확인합니다. 모델 목록은 agent models 또는 --list-models, 전환은 /model·--model입니다.

로그인·권한과 헷갈리지 않기:

  1. agent status / agent about로 계정·세션이 살아 있는지 본다.
  2. Spending(또는 CLI usage UI)에서 어느 풀이 비었는지를 본다.
  3. 풀이 남아 있는데도 특정 모델만 막히면 모델·모드 선택 문제일 수 있다(예: Auto 라우팅이 다른 풀을 씀).
  4. 팀/엔터프라이즈면 관리자 spend limit·Impose Auto 정책도 Spending·팀 설정에 나타난다.

재시작·재설치는 서버측 한도를 고치지 않습니다. 증상 확인의 끝은 “로컬이 깨졌다”가 아니라 **“지금 막힌 축이 Cursor Models인가, Other Models인가, on-demand 캡인가”**입니다.

모델 전환 기준은?

한 줄 답: 빈 풀을 피하고 남은 풀의 모델을 명시합니다. 배너 자동 전환만 믿지 말고, /model 또는 agent --model …으로 의도한 ID를 고릅니다.

전환 결정 트리(개념만):

상황(UI)우선 폴백피할 것
Other Models만 소진Cursor Models 풀 모델(문서의 Composer / Grok 계열)같은 서드파티 ID로 재시도 루프
Cursor Models만 소진Other Models 잔여가 있으면 그쪽, 없거나 정책상 불가하면 대기·온디맨드·범위 축소“아무 모델이나” 연타
특정 frontier만 한도Auto 또는 남은 풀의 다른 모델Auto가 또 막힌 풀로만 라우팅되는지 미확인 상태
Auto/배너 전환이 또 한도피커에서 수동으로 남은 모델 선택배너 버튼만 반복 클릭
읽기·설계만 필요CLI Ask / Plan(--mode=ask, --plan)으로 도구 쓰기 축소한도 상황에서 불필요하게 Agent+강제 실행

실무 순서:

  1. Spending / usage UI에서 빈 풀을 확인한다. 문서: 모델 선택이 포함 사용량 소모 속도에 영향을 준다. Router(Auto) 요청은 실제로 라우팅된 모델 비용·풀을 탈 수 있다.
  2. 남은 풀의 모델을 명시한다. 예: 대화 중 /model, 또는 agent --model <id> "…". 목록은 agent models / --list-models.
  3. 자동 폴백만 믿지 않는다. 커뮤니티·지원 스레드에서 한도 시 배너가 의도한 Auto가 아닌 다른 모델로 바뀌거나, Auto가 일시적으로 불가해 루프가 난 사례가 보고된 바 있다. 운영 원칙은 **“남은 풀 → 명시적 --model//model → 한 번 검증”**이다.
  4. 모드를 낮춘다. 탐색·질문만이면 Ask, 설계만이면 Plan. Agent는 도구·패치 루프가 길어져 같은 작업이라도 요청이 더 나간다(가격 숫자 없이 요청 횟수·범위 관점).
  5. 온디맨드·업그레이드·대기는 UI에 나온 선택지다. 문서: 포함 사용량이 끝나면 온디맨드를 켜거나 상위 플랜으로 가거나, 청구 주기 리셋까지 기다린다. 리셋일은 Spending에 표시되고, 미사용분은 이월되지 않는다. 이 글은 금액·플랜가를 적지 않는다.
  6. BYOK는 개인 플랜에서 풀 차감과 별도 축으로 안내된다(팀/엔터프라이즈는 Token Rate 등 별도 규칙). 키·단가 값은 다루지 않는다.

폴백 한 줄 공식:

1) 어느 풀이 비었는지 확인 (Spending / usage UI)
2) 남은 풀 모델로 명시 전환 (/model 또는 --model)
3) 그래도 막히면 Ask/Plan·범위 축소 또는 리셋/온디맨드 UI
4) 긴 작업이면 아래 절처럼 상태를 남기고 끊기

작업은 어떻게 끊나?

한 줄 답: 한도가 보이면 새 큰 패치를 시작하지 말고, 디스크에 재개 가능한 상태를 남긴 뒤 세션을 닫습니다. 나중에 agent resume / --continue로 이어갑니다.

깨끗이 끊는 체크리스트:

  1. 진행 중 편집을 멈춘다. 반쯤 적용된 다중 파일 변경을 더 밀어 넣지 않는다. 가능하면 마지막 성공 단위(컴파일·테스트 한 덩어리)에서 멈춘다.
  2. progress를 레포(또는 티켓)에 남긴다. Goal / Done / Next / Blocked / Paths. context-budget 축과 같다. CLI 대화만 믿고 끄면 한도 리셋 후 컨텍스트가 비싸다.
  3. git 상태를 고정한다. 워킹 트리가 더러우면 커밋·stash·worktree 중 팀 규칙에 맞는 것으로 재현 가능한 스냅샷을 만든다. “에이전트가 어디까지 고쳤는지”를 diff로 남긴다.
  4. 세션 ID를 기록한다. CLI는 agent ls, agent resume, agent --continue, --resume=<chat-id>로 이전 대화를 이어 간다(CLI overview). 한도 해제 후 같은 줄을 이을 때 새 프롬프트로 처음부터 설명하지 않아도 된다.
  5. 범위를 잘라 다음 프롬프트를 적어 둔다. 예: “progress.md의 Next만 수행. Out of scope: …” 폴백 모델로 돌아올 때 좁은 Done when이 토큰·요청을 아낀다.
  6. 병렬·클라우드 핸드오프는 별도 축이다. &로 Cloud Agent에 넘기는 기능은 로컬 CLI 한도와 청구·실행 환경이 다를 수 있다. 이 글의 폴백 순서(풀 확인 → 명시 모델 → 끊고 재개)와 섞지 말고, 클라우드로 넘길지 의도적으로 정한다.

끊은 뒤 재개 순서:

한도 알림
  → progress + git 스냅샷
  → 세션 종료(또는 새 요청 중단)
  → (리셋/다른 풀/온디맨드 UI)
  → agent resume 또는 --model <남은풀> 로 좁은 Next만

한도 상황에서 새 기능 전체를 다른 모델에 통째로 맡기기보다, 이미 검증된 조각 + 다음 한 조각만 넘기는 편이 실패 비용을 줄입니다.

FAQ

Spending과 CLI 알림이 다르면?

Spending 탭의 풀·잔여·리셋일을 기준으로 해석합니다. CLI 배너 문구는 짧고, Auto 권유와 실제 남은 풀이 어긋나 보일 수 있습니다. 대시보드와 agent models로 지금 쓸 수 있는 ID를 확인한 뒤 명시 전환합니다.

재설치하면 한도가 풀리나요?

아닙니다. 문서상 사용량은 계정·청구 주기 쪽입니다. 로컬 캐시 삭제는 서버 풀을 채우지 않습니다.

Ask/Plan으로 바꾸면 항상 안전한가요?

읽기·설계 범위에서는 도구 쓰기가 줄어 같은 목표를 더 적은 왕복으로 끝낼 여지가 있습니다. 구현·패치가 필요하면 결국 Agent(또는 동등 모드)로 돌아가야 합니다. 한도 직전에는 계획만 남기고 끊는 용도로 쓰는 것이 안전합니다.

요금·플랜 가격은?

이 글 범위 밖입니다. Spending UI의 풀·온디맨드·리셋일만 보고, 금액은 대시보드·공식 Pricing 문서를 따릅니다.

출처 (Sources)