Fuel Gauge는 Claude Code와 Cowork에서 사용량 한도와 문맥 사용량을 보여주고, 사용량이 설정한 기준을 넘으면 작업을 멈추는 플러그인이다. 기본 기준은 각 사용량 창의 95%이며, 사용량 창이 초기화되면 잠금이 해제된다.

플러그인은 세션 응답에 포함된 정보를 읽어 5시간 사용량, 주간 사용량, 문맥 사용량을 Claude에 매 메시지 한 줄로 전달한다. 사용자는 입력창 옆 게이지와 패널에서 사용량과 초기화 시간을 확인할 수 있다. 80%와 90%에 도달하면 사용자에게 알림을 보내고 Claude에도 경고를 전달한다.

95%를 넘으면 하위 에이전트를 포함한 도구 호출과 새 요청을 거부한다. Claude는 완료한 일과 남은 일을 요약하며, 사용자가 continue로 메시지를 시작하거나 Unlock 1 request를 눌러야 한 번 더 진행한다. lockAt 설정으로 기준을 바꿀 수 있다.

설치는 Claude Code 터미널에서 /plugin install fuel-gauge --marketplace LuisPCFialho/claude-fuel-gauge를 입력하거나 셸에서 claude plugin install fuel-gauge --marketplace LuisPCFialho/claude-fuel-gauge를 실행한다. Cowork에서는 플러그인 파일을 내려받아 채팅에 첨부한 뒤 설치할 수 있다. 데스크톱 앱에서는 프롬프트 옆 + 메뉴에서 Plugins를 열고 마켓플레이스와 플러그인을 추가한다.

플러그인은 사용량을 확인하기 위해 별도 API를 호출하지 않으며, 한도 읽기와 게이지·경고·잠금에는 토큰이 들지 않는다고 안내한다. 매 메시지에 사용량 한도 메모를 보내는 기능은 메시지당 입력 토큰 약 50개를 쓰며 끌 수 있다. 도구 설명은 약 300토큰을 사용하고 프롬프트 캐시에 저장된다.

API 키 사용자는 5시간·주간 한도가 없으므로 문맥 사용량만 볼 수 있고, 자동 중단은 작동하지 않는다. Cowork에서는 프롬프트 옆 게이지가 표시되지 않지만 사용량 안내와 중단 기능은 작동한다. 제작자는 플러그인이 Anthropic과 제휴하거나 승인을 받은 제품이 아니라고 밝힌다. 플러그인 훅 모듈은 Claude Code에서 얼리 액세스 상태이며, Fuel Gauge는 Claude Code 2.1.299에서 제작·테스트됐다.

Fuel Gauge 저장소