Claude Code는 사용 한도에 가까워지면 경고를 보냅니다. 문제는 그때가 되면 이미 상황이 벌어진 후라는 점입니다. 나중에 해도 되었을 일 때문에 이미 5시간 사용 시간의 절반을 써버린 상태일 것입니다.

그래서 저는 usage-guard라는 작은 로컬 플러그인을 만들었습니다. 이 플러그인은 단 한 가지 일을 합니다. Claude Code가 노출하는 실제 5시간 및 주간 할당량(quota) 백분율을 읽고, 한계에 부딪히기 전에 현재 속도로 리셋 시점까지 버틸 수 있을지 알려줍니다.

이것은 무료이며, 로컬에서 작동하고(데이터가 기기를 벗어나지 않음), 계속 무료로 유지됩니다.

실제 기능

• 추측이 아닌 상태 표시줄(status line)에서 실제 rate_limits 데이터를 읽습니다.
• 임계값이 넘었을 때 Stop 훅(hook)을 통해 그 즉시 알림을 줍니다. 따라서 대시보드를 확인해야 한다는 사실을 기억할 필요가 없습니다.
• 사용자의 설정에서 실제 할당량 경로를 사용할 수 없는 경우, 오류를 내지 않고 로컬 가중치 예산 추정치(local weighted-budget estimate)로 전환합니다. 세션을 절대 끊지 않습니다.

설치

/plugin marketplace add eltonylfgi-blip/claude-code-usage-guard
/plugin install usage-guard@cc-guard

그런 다음 README에 있는 작은 상태 표시줄 심(shim)을 ~/.claude/settings.json에 추가하세요. 메시지를 하나 보내고 /usage-guard:usage를 실행했을 때, 최신 5시간 및 주간 백분율과 리셋 시간이 보인다면 실제 경로가 작동하고 있는 것입니다.

전체 설정 가이드: https://github.com/eltonylfgi-blip/claude-code-usage-guard

솔직한 이야기

처음 2주 동안 267명이 설치했는데, 이는 저를 놀라게 했습니다. 하지만 설치 수보다 흥미로운 숫자는 **활성화(activation)**입니다. 제가 답하고자 하는 진짜 질문은 이것입니다: 설정 후에 /usage-guard:usage가 실제로 실제 할당량을 보여주나요, 아니면 추정치로 전환되나요? 직접 시도해 보신다면, 어떤 결과가 나오는지 그리고 어떤 OS를 사용하는지 정말 알고 싶습니다.

숨기지 않을 한계점도 있습니다: usage-guard는 Claude Code가 노출하는 정보만 읽을 수 있습니다. 숨겨진 제한(hidden caps)을 밝혀내거나 한계에 절대 부딪히지 않을 것이라고 약속할 수는 없습니다. 단지 그 한계가 더 일찍 보이도록 만들어 줄 뿐입니다.

Anthropic과 관련이 없는 독립적인 프로젝트입니다. 리포지토리(repo)를 통해 피드백과 이슈를 환영합니다.