코딩 세션 중 가장 최악의 순간은 작업 중간에 속도 제한(rate limit)에 걸리는 것입니다.

리팩터링(refactor)에 깊이 몰입해 있는데, Claude Code가 멈추거나 Codex가 초기화됩니다. 그러면 다음 20분 동안 도구를 전환하거나, 문맥(context)을 놓치거나, 그저 기다리며 시간을 허비하게 됩니다. Hacker News의 "Codex Resets" 스레드는 270점의 추천과 175개의 댓글을 받았습니다. 이 고통은 널리 퍼져 있습니다.

문제는 제한 그 자체가 아니라, 제한에 걸리기 전까지 얼마나 남았는지 알 수 없다는 점입니다.

저는 이 문제를 해결하기 위해 quota를 만들었습니다.

기능

$ quota

  quota — 당신의 AI 사용량을 한눈에 확인하세요
...

단 하나의 명령어로 연결된 모든 AI 코딩 도구의 남은 사용량과 초기화 시간(reset times)을 보여줍니다.

또한 watch 모드로 실행할 수도 있습니다:

quota watch 30   # 30초마다 재확인

또는 스크립트에 파이프(pipe)로 연결할 수도 있습니다:

quota --json | jq '.providers.claude_code.percent_remaining'

작동 원리

quota는 제공자(provider)의 상태를 **로컬(locally)**에서 읽습니다. API 호출, 계정 로그인, 텔레메트리(telemetry)가 전혀 없습니다. 도구 자체가 기록하는 파일과 동일한 ~/.claude 및 ~/.codex를 직접 읽습니다. 모든 데이터는 사용자의 기기에만 머뭅니다.

npm install -g @ozperium/quota
quota

왜 그냥 앱에서 확인하지 않나요?

Claude Code와 Codex는 남은 할당량(quota)을 눈에 띄게 보여주지 않습니다. 브라우저 대시보드를 열거나 에러가 발생할 때까지 기다려야 합니다. 터미널에서 작업 중일 때는 둘 다 유용하지 않습니다.

quota는 당신이 작업하는 곳, 즉 코드 바로 옆인 터미널에 존재합니다.

향후 계획

• Cursor 및 Grok을 위한 OAuth 로그인 (이들은 로컬 읽기가 불가능함)
• 셸 프롬프트(Shell prompt) 통합 (starship/oh-my-posh에서 남은 % 표시)
• CI 체크 — 긴 테스트 실행 전에 할당량이 소진되면 빌드 실패 처리

GitHub: https://github.com/Ozperium/quota
npm: https://www.npmjs.com/package/@ozperium/quota

스택에 포함된 다른 도구들: AI 에이전트 (AI agent)의 동작을 테스트하기 위한 AgentSpec, 그리고 AI API에 지출하는 비용을 추적하기 위한 AICostTracker가 있습니다.