상태 표시줄에서
Claude Code 프롬프트 아래에서 컨텍스트가 얼마나 찼는지, 세션이 쓴 토큰과 비용, 그리고 두 한도와 초기화까지 남은 시간을 보여 줍니다. Claude Code가 실행되는 곳이면 어디서나 동작합니다.
Tokenmeter버전 1.1.0
Claude와 Codex 사용 한도, 늘 눈앞에
프롬프트 아래의 상태 표시줄과 데스크톱의 유리 질감 위젯이 5시간·주간 한도, 초기화 시점, 세션별 비용을 보여 줍니다.
Windows 10/11 · macOS 13 이상 · zip 하나에 설치 프로그램 두 개
- 무료
- 가입 불필요
- GitLab 소스 코드
지켜보는 두 가지 방법
데스크톱에서
작은 플로팅 카드가 두 한도를 초록·주황·빨강으로 보여 주고, 현재 구간이 얼마나 지났는지도 표시합니다. 이 속도로는 초기화 전에 한도가 바닥날 것 같으면 언제인지 알려 줍니다. Codex도 쓴다면 카드의 전환 버튼으로 Codex 한도를 볼 수 있습니다.
- 여유 있음
- 한도 근접
- 거의 소진
작지만 쓸모 있는 것들
원하는 곳에 두세요
트레이 또는 메뉴 막대 아이콘을 클릭하면 열리고, 다른 곳을 클릭하면 닫힙니다. 메뉴에서 떠 있는 창으로 바꾸면 어디로든 끌어다 놓고 다른 창 위에 고정할 수 있습니다.
Claude Code, Codex와 함께 실행
첫 Claude Code 또는 Codex 세션과 함께 시작되며, 원하면 로그인할 때 시작하도록 설정할 수 있습니다.
트레이 속 링
트레이·메뉴 막대 아이콘이 5시간 사용량에 따라 차오르고 색이 바뀝니다.
내 언어로
12개 언어를 지원하며, 시스템 언어를 따르거나 메뉴에서 고를 수 있습니다.
설정은 한 창에서
시작 옵션, 언어, 보기 방식, 동기화와 연결된 기기를 카드의 톱니바퀴 버튼 하나로 모두 관리합니다.
사라지지 않는 기록
위젯은 첫 실행부터 자체 장부를 남기고 서버에도 사본을 보관하므로, 재설치하거나 새 컴퓨터로 옮겨도 기록이 돌아옵니다. ID와 비밀번호로 기기를 연결하면 함께 볼 수 있고, 빼고 싶은 기기는 체크를 해제하면 됩니다.
노치 바로 옆에
노치가 있는 Mac에서는 Tokenmeter가 노치 양옆에 자리합니다. 한쪽에는 5시간 한도, 다른 쪽에는 초기화까지 남은 시간이 표시됩니다. 포인터를 올리면 펼쳐지면서 두 한도, 오늘의 지출, Claude / Codex 전환이 나타납니다. 노치가 없는 Mac에서는 화면 상단에 표시됩니다.
지출과 모델
통계 보기를 열면 전체 그림이 보입니다. Claude Code와 Codex 세션을 API 가격으로 계산한 일·주·월별 비용과 모델별 비중을 확인할 수 있습니다.
스크린샷: 데모 데이터를 사용한 macOS 위젯. Windows 위젯도 같은 기능을 제공합니다.
세션 하나하나 빠짐없이
Claude Code와 Codex 세션마다 한 줄씩: 제목, 프로젝트, 시간, 토큰, 비용을 최신순으로 보여 줍니다. 비용이 큰 세션은 한눈에 들어옵니다.
1분이면 설치 끝
zip 하나에 설치 프로그램이 둘 다 들어 있습니다. 사용 중인 시스템용을 실행하세요.
Windows 10 및 11내 시스템
- zip을 내려받아 압축을 풀고 tokenmeter 폴더를 엽니다.
- install.cmd를 더블클릭하거나 PowerShell에서 다음을 실행합니다.
powershell -ExecutionPolicy Bypass -File install.ps1 - Claude Code를 다시 시작하세요. 프롬프트 아래에 상태 표시줄이 나타나고, 첫 세션과 함께 트레이 또는 메뉴 막대에 위젯 아이콘이 나타납니다. 한도는 몇 초 안에 채워집니다.
macOS 13 이상내 시스템
- 내려받은 파일의 압축을 풀고, tokenmeter 폴더에서 터미널로 다음을 실행합니다.
bash install.sh - Claude Code를 다시 시작하세요. 프롬프트 아래에 상태 표시줄이 나타나고, 첫 세션과 함께 트레이 또는 메뉴 막대에 위젯 아이콘이 나타납니다. 한도는 몇 초 안에 채워집니다.
필요한 것만
상태 표시줄만 필요하세요? 위젯 없이 설치할 수 있습니다. 이미 설치했다면 위젯 메뉴에서 상태 표시줄을 끄거나, 위젯이 Claude Code와 함께 시작되지 않게 할 수 있으며 나머지는 계속 동작합니다.
Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -NoWidgetmacOS
bash install.sh --no-widget아이콘을 클릭하면 카드가 열리고, 오른쪽 클릭하면 메뉴가 열립니다. 위젯이 실행 중이 아니면 시작 메뉴(Windows) 또는 응용 프로그램(macOS)에서 Tokenmeter를 실행하세요.
업데이트 또는 제거
업데이트
위젯은 하루에 한 번 이 사이트에 새 버전이 있는지 물어봅니다. 있으면 새로 고침 버튼에 점이 나타나고 메뉴에 업데이트 항목이 생깁니다. 요청에는 버전과 시스템만 담기며, 메뉴에서 끌 수 있습니다.
- 이 페이지에서 새 zip을 내려받습니다.
- 설치 프로그램을 다시 실행하세요. 기록과 설정은 그대로 유지됩니다.
제거
mod, 위젯, 바로 가기를 제거합니다.
Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -UninstallmacOS
bash install.sh --uninstall기록을 남기려면 -KeepHistory(Windows) 또는 --keep-history(macOS)를 붙이세요.
숫자만 동기화, 작업은 내 컴퓨터에
일·모델·세션별 지출과 토큰 수는 tokenmeter.nextwell.top에 동기화되어, 재설치 후에도 기록이 남고 연결된 기기끼리 서로의 합계를 볼 수 있습니다. 세션 제목, 프로젝트 이름, 프롬프트는 컴퓨터 밖으로 나가지 않으며, 국가는 업로드할 때 IP 주소로 판단하고 주소 자체는 저장하지 않습니다. 설정에서 ‘서버와 동기화하지 않기’를 선택하면 모두 로컬에 남고, ‘기록 삭제’는 이 컴퓨터와 서버의 기록을 함께 지웁니다. 한도는 본인의 Claude Code 로그인 정보로 Anthropic에 묻습니다. 로그인 정보는 갱신하지 않으며 다른 곳으로 보내지 않습니다.
필요한 것
- Windows 10 또는 11, 또는 macOS 13 이상
- mod를 지원하는 Claude Code(2.1.296에서 테스트). mod API는 얼리 액세스 단계라 릴리스 사이에 바뀔 수 있습니다.
- Claude Pro 또는 Max 구독, 또는 Codex용 ChatGPT 요금제: 한도는 계정에서 가져옵니다.
- 지출 기록에는 Node.js가 필요합니다. 없어도 한도는 표시됩니다.
숫자 읽는 법
- 한도는 claude.ai의 Usage에 표시되는 계정 자체의 수치이며 5분마다 읽어 옵니다. claude.ai와 다른 기기에서의 사용도 포함됩니다.
- 비용은 같은 토큰을 API 가격으로 계산했을 때의 금액입니다. 구독은 이렇게 청구되지 않으며, 구독으로 얼마나 뽑아 쓰는지를 보여 줍니다.
- 기록은 Claude Code와 Codex의 로컬 세션 로그에서 읽습니다. 위젯은 첫 실행부터 자체 장부를 쌓으며, 그 이전 기간은 추정치로 연하게 표시됩니다.
바닥나기 전에 먼저 알아보세요.
무료, 오픈 소스, 조용함: 보기 전까지는 구석에 가만히 있습니다.
Windows 10/11 · macOS 13 이상 · zip 하나에 설치 프로그램 두 개