아직도 Claude Code를 사용하면서 토큰을 얼마나 사용했는지 확인하느라 /usage 명령어를 입력하고 계신가요? 혹은 Claude 설정에서 사용량 페이지를 떠나지 못하고 계신가요?
터미널에서 Claude Code 사용량을 쉽게 확인하는 방법을 공유합니다.
이 글은 2026년 1월 30일 기준으로 작성되었습니다.
문서 내 Plugin 링크를 통해 최신 업데이트를 확인하세요.
claude-dashboard는 터미널에서 Claude Code 사용량을 쉽게 확인할 수 있는 Plugin입니다. 26년 1월 30일 기준, GitHub에서 91개의 Star를 보유하고 있습니다.
선택만으로 쉽게 설정 가능
- 컨텍스트 프로그레스바: 초록 → 노랑 → 빨강으로 사용률이 한눈에 보입니다. 새 대화를 시작할 타이밍을 직관적으로 판단할 수 있습니다.
- Rate Limit 카운트다운: 5시간 세션 제한까지 남은 시간과 리셋 시점을 실시간으로 보여줍니다. Max 플랜이라면 7일 사용량도 함께 확인됩니다.
- 세션 비용 추적: 누적 비용이 USD로 표시되어, API 사용 비용을 의식하며 작업할 수 있습니다.
이 외에도 모델명, 토큰 수, git 브랜치, Todo 진행률 등 16종의 위젯을 제공합니다. 전체 위젯 목록은 Available Widgets에서 확인하세요.
우선 가장 따끈한 기능은 여러 AI Agent들의 진행률을 한눈에 볼 수 있다는 점입니다. 최근 Thread를 보면서 우연히 Maintainer의 업데이트 포스트를 접할 수 있었습니다.
업데이트가 활발하게 이루어지고 있습니다.
compact(1줄, 기본), normal(2줄), detailed(4줄) preset을 지원합니다.
Compact (default)
Normal
detailed 모드에서는 위에서 언급한 Multi Agent 기능을 확인할 수 있습니다.
Detailed
custom모드로 위젯 배치를 직접 구성할 수도 있습니다.- 한국어도 지원됩니다.
자세한 설정법은 Configuration을 참고하세요.
참고: Installation
/plugin marketplace add uppinote20/claude-dashboard
/plugin install claude-dashboard
/claude-dashboard:setupclaude-dashboard와 claude-hud의 장점을 결합한 Plugin입니다. 26년 1월 30일 기준, GitHub에서 23개의 Star를 보유하고 있습니다.
claude-dashboard는 앞서 소개한 Plugin이고, claude-hud는 터미널에서 Claude Code 상태를 한눈에 볼 수 있는 Plugin으로, GitHub에서 2.8k의 Star를 보유하고 있습니다.
claude-dashboard의 핵심 기능(컨텍스트 프로그레스바, Rate Limit 카운트다운, 토큰 수)에 더해, claude-hud에서 가져온 기능들이 추가됩니다.
- 툴 활동 추적: 현재 실행 중인 도구와 완료된 도구의 횟수를 실시간으로 표시합니다.
- 에이전트 상태: 서브에이전트의 진행 상황을 확인할 수 있습니다.
- TODO 진행률: 현재 작업 내용과 완료율을 보여줍니다.
전체 기능 목록은 기능에서 확인하세요.
claude-dashboard는 사용량/비용 모니터링에, claude-hud는 작업 상태 추적에 각각 강점이 있습니다. claude-ultimate-hud는 이 둘을 하나로 합쳐, 별도로 두 Plugin을 설치할 필요 없이 모든 정보를 한 화면에서 확인할 수 있습니다.
Pro, Max $100, Max $200 플랜에 맞춘 설정을 인터랙티브 메뉴로 제공합니다. Max 플랜에서는 7일 전체 모델 및 Sonnet 전용 사용량까지 확인할 수 있습니다. (참고: 플랜별 차이)
| 기능 | pro | max100 | max200 |
|---|---|---|---|
| 5시간 rate limit | ✅ | ✅ | ✅ |
| 리셋 카운트다운 | ✅ | ✅ | ✅ |
| 7일 전체 모델 | ❌ | ✅ | ✅ |
| 7일 Sonnet 전용 | ❌ | ✅ | ✅ |
참고: 설치
/plugin marketplace add hadamyeedady12-dev/claude-ultimate-hud
/plugin install claude-ultimate-hud
/claude-ultimate-hud:setup저는 claude-ultimate-hud를 사용하고 있습니다. 코어 기능인 사용량/비용 모니터링과 함께 claude-hud의 작업 상태 추적 기능까지 한눈에 사용할 수 있다는 게 굉장히 큰 매력으로 다가왔거든요.
만약 여러 AI Agent를 사용하고 있다면 claude-dashboard를 사용하는 것도 고려해봤을 겁니다. 하지만, 저는 Claude Code만 사용하고 있어서 크게 옮길 이유가 되지는 않았습니다. 무엇보다 claude-hud의 기능 융합이 너무 깡패예요.
이 포스트를 정리하면서 이제는 원하는 것을 개인이 만들고 공유하는 시대임을 강하게 느낍니다. Star가 100개도 안 되는 서비스들입니다. 그런데 사람들에게 편의를 제공하고 있고, 누군가 이렇게 포스트로 소개하고 있습니다. AI로 얼마든지 필요한, 원하는 것을 만들 수 있는 시대입니다.
AX(AI Transformation, 인공지능 대전환)의 시대입니다. AI를 단순히 도구로써 사용하지 않고 조직·산업 운영 전반에 통합해, 구조 자체를 AI 중심으로 재설계하는 전환입니다. (출처: Flex AX) 사내에서는 채용/인사/마케팅 등 비개발자들도 AI 서비스와 챗봇을 만들어 실무에 활용하고 있습니다. 당연히 효율화와 생산성은 폭발적으로 증가합니다. 정말 매력적인 세상이고, 한편으로는 빠르게 바뀌는 세상이라 두렵기도 합니다. 잡아 먹히지 말고 적응합시다.
이번 포스트는 매우 국소적인 주제를 다뤘습니다. 제가 한때 불편을 겪었던 경험이 있고, 손쉽게 이를 해결하는 솔루션이라 빠르게 공유하고 싶었습니다.
다음 포스트는 제가 어떻게 Claude Code를 활용하고 있는지 overview를 작성하고, 그 이후에는 토픽마다 개발 의도를 깊이감 있게 다뤄보려 합니다. 읽어주셔서 감사합니다.
