r/ClaudeCode•5개월 전•48•58

Claude Code가 자신의 사용량 제한을 인식하도록 만들었습니다

I made Claude Code aware of its own usage limits

핵심 요약

로컬 프록시로 Claude Code가 실시간 API 사용량을 파악하고 스스로 행동을 조절하게 만드는 도구입니다.

로컬 프록시 구축 — Claude Code와 API 서버 사이에 프록시를 두어 응답 헤더의 사용량 정보를 가로챔.
사용량 자동 인식 — 가로챈 정보를 파일로 저장해 Claude가 읽게 함으로써 모델이 자신의 남은 쿼터를 알게 함.
지능적 행동 조절 — 사용량이 높으면 가벼운 모델로 전환하거나 복잡한 작업을 거부하도록 CLAUDE.md 규칙 설정 가능.
통합 쿼터 확인 — Opus와 Sonnet이 별도 제한이 아닌 하나의 통합된 풀(pool)을 사용한다는 사실을 발견함.

한동안 저를 짜증 나게 했던 것: Claude Code는 자신이 쿼터를 얼마나 썼는지 전혀 모릅니다. UI에서는 사용량 바를 볼 수 있지만, 모델 자체는 그것을 전혀 보지 못합니다. 대화 중에 현재 레이트 리밋 상태를 노출하는 API도, 도구도, 훅도 없습니다.

알고 보니 Anthropic은 모든 추론 응답에 레이트 리밋 헤더(anthropic-ratelimit-unified-5h-utilization, anthropic-ratelimit-unified-7d-utilization 등)를 반환합니다. Claude Code는 내부적으로 이를 수신하여 UI 바를 렌더링하지만, 모델이 볼 수 있는 곳으로는 절대 전달하지 않습니다.

그래서 저는 Claude Code와 api.anthropic.com 사이에 위치하는 작은 로컬 HTTP 프록시를 만들었습니다. Claude Code는 이미 ANTHROPIC_BASE_URL을 준수하므로, 이를 http://127.0.0.1:4080으로 설정하면 모든 트래픽이 프록시를 통과하게 됩니다. 프록시는 응답 헤더를 가로채서 ~/.claude/usage-status.md에 한 줄짜리 상태 파일을 작성합니다.

5h=9% 7d=99%! overage=0% bottleneck=seven_day (10/05/2026, 16:19:04)

Claude는 필요할 때 해당 파일을 읽을 수 있으며, 또는 UserPromptSubmit 훅을 통해 자동으로 주입하여 모든 프롬프트에 포함시킬 수도 있습니다. CLAUDE.md에 규칙을 추가하면 Claude는 제한에 가까워졌을 때 큰 작업을 시작하기 전에 경고를 하거나, 90% 이상일 때 경량 모드로 전환하거나, 98%에서 새로운 구현 작업을 아예 거부하게 됩니다.

참고: 이것은 Claude Code(CLI)에서만 작동합니다. 웹 채팅과 브라우저 확장은 Anthropic의 자체 인프라를 통해 요청을 보내므로 가로챌 로컬 프록시가 없습니다.

흥미로운 발견: 테스트하는 동안 Opus와 Sonnet 요청 모두에서 모든 anthropic-ratelimit-* 헤더를 덤프해 보았습니다. 모델별 헤더는 없으며, 하나의 통합된 풀이 모든 것을 커버합니다. Claude Code UI의 별도 Sonnet 사용량 바는 실제 별도의 제한을 반영하지 않습니다. GitHub 이슈 #57050에 따르면, Anthropic은 Sonnet에 자체 버킷을 부여할 계획이었으나(2025년 11월 발표), 백엔드에 반영되지 않았습니다. Sonnet을 사용하면 Opus와 동일한 통합 풀이 소모됩니다.

프록시는 npm 의존성이 전혀 없는 순수 Node.js 표준 라이브러리로 제작되었습니다. Windows에서는 NSSM을 통해 서비스로 설치됩니다. macOS 및 Linux 설정(launchd/systemd)은 README에 있습니다.

https://github.com/InertiaUK/claude-quota-proxy

README에는 Claude가 사용량 수준에 따라 자동으로 동작을 조정하도록 하려는 경우를 위한 몇 가지 CLAUDE.md 규칙 예시도 있습니다.

원문

커뮤니티 목록

r/ClaudeCode•5개월 전•48•58

Claude Code가 자신의 사용량 제한을 인식하도록 만들었습니다

I made Claude Code aware of its own usage limits

핵심 요약

로컬 프록시로 Claude Code가 실시간 API 사용량을 파악하고 스스로 행동을 조절하게 만드는 도구입니다.

로컬 프록시 구축 — Claude Code와 API 서버 사이에 프록시를 두어 응답 헤더의 사용량 정보를 가로챔.
사용량 자동 인식 — 가로챈 정보를 파일로 저장해 Claude가 읽게 함으로써 모델이 자신의 남은 쿼터를 알게 함.
지능적 행동 조절 — 사용량이 높으면 가벼운 모델로 전환하거나 복잡한 작업을 거부하도록 CLAUDE.md 규칙 설정 가능.
통합 쿼터 확인 — Opus와 Sonnet이 별도 제한이 아닌 하나의 통합된 풀(pool)을 사용한다는 사실을 발견함.

5h=9% 7d=99%! overage=0% bottleneck=seven_day (10/05/2026, 16:19:04)

https://github.com/InertiaUK/claude-quota-proxy

README에는 Claude가 사용량 수준에 따라 자동으로 동작을 조정하도록 하려는 경우를 위한 몇 가지 CLAUDE.md 규칙 예시도 있습니다.

주요 댓글

r/claudecode

Claude Code의 사용량 제한을 모델이 직접 인지하게 만드는 시도에 대해 유용하다는 반응과, 오히려 모델의 환각이나 패닉을 유발할 수 있다는 우려가 섞여 있음.

Claude가 한도 얼마 안 남은 거 알면 더 급하게 작업할지 궁금함. 싼 구현 방식 선택한다거나? 추론 로직 뜯어봐야 알 듯.

세션 종료 처리(핸드오프나 압축 등) 워크플로우 만들고 Claude한테 절대 서두를 필요 없다고 주입하면 됨. 세션 컨텍스트 끝나기 전에 '일 끝내야 한다'는 압박 안 느끼게 하는 게 핵심임.

길이 제한으로 뒷부분이 생략된 댓글입니다 · 원문에서 전체 보기 →

나도 비슷한 거 해봤는데 컨텍스트 상태 알려주니까 확실히 차이 있더라. 압축 전에 마무리하려고 하거나 메모리에 더 자주 기록함. 전체 시스템에 어떻게 통합하느냐가 관건임.

이미 75% 넘으면 '컨텍스트 빡빡하니까 새 세션에서 하자' 이런 소리 하던데. 이미 컨텍스트 윈도우 인식하고 있는 거 아님? 아니면 그냥 찍는 건가?

LLM 어텐션 보존하려면 컨텍스트 한도 75~90% 됐을 때만 알려주는 게 좋을 듯. 안 그러면 아직 필요도 없는데 컨텍스트 고민하느라 토큰이랑 어텐션 낭비함. 그리고 급하게 일하지 말고 한도 안 될 거 같으면 핸드오프 준비하라고 명시하는 게 좋음.

내가 어제 딱 이거 하다가 고생해서 말해주는데, 그거 생각하게 만드는 거 자체가 모델한테 패닉 유발함. 설정한 임계값 넘어가면 세션 종료하겠다고 징징대거나, 작업 급하게 처리하고 안 한 걸 했다고 환각 일으킴. 그냥 그 시스템 다 치워버려. 진짜임. 실전에서는 오히려 상황만 더 악화됨.

길이 제한으로 뒷부분이 생략된 댓글입니다 · 원문에서 전체 보기 →

대부분 동의함. 근데 90% 됐을 때 구현 마무리하지 말고 핸드오프 준비하라고 알림 주는 건 나쁘지 않을 것 같은데.

아니지, 그건 확실히 유효함. 풀 스탑 훅 만들면 됨. 일반 훅은 그냥 제안일 뿐이지만 풀 스탑 훅은 진짜 멈추게 만듦. 압축 대비해서 중요한 부분 저장하는 훅도 만들 수 있고.

드디어 내 프로젝트에도 쓸 수 있는 게 나왔네. 다음 단계는 CC가 프롬프트 비용 보면서 스스로 최적화하게 만드는 거임. 나중에 CC 한도 차면 Kimi나 Codex로 자동 전환되는 기능까지 나오면 진짜 대박일 듯.

그냥 posttooluse랑 userpromptsubmit 훅 추가해서 세션 마지막 사용량 메시지 읽어와서 additionalContext로 넣으면 됨. 5시간/주간 한도도 조금만 더 손보면 가능함.

맞는 말인데, 프롬프트마다 컨텍스트 계속 넣으면 좀 그렇지. 사람마다 원하는 게 다를 텐데, 내 방식은 Claude가 얼마나 자주 확인할지 결정할 수 있음. 훅 쓰는 것도 좋지만 내 방식이 통제권이 더 큼. 복잡하거나 비싼 작업 할 때만 확인하게 할 수 있고 데이터도 정확함.

난 모델 브로커 써서 Claude Code가 Claude Code를 구현하게 만들고 있음. 어떻게 될지 지켜보는 중.

난 https://github.com/nsanden/claude-rate-monitor 쓰는데 꽤 괜찮음. Claude가 한도 걸려서 작업 중간에 멈추는 일 방지해 줌.

그거 모델이 결과물 보고 판단하는 거임? 모델이 상황을 인지하는지 모르겠네. 좋아 보이긴 하는데 내가 놓친 게 있나? 그냥 사람이 모니터링하는 용도 같은데, 모델이 상황에 따라 다르게 행동하게 만들 순 없지 않나? 그리고 보니까 하이쿠 토큰 쓰는 1회성 요청이던데, 여전히 API 비용은 나가는 거 아님?

원문r/ClaudeCode