macOS menu bar · Claude Code

한도에 걸려 멈추기 전에,
메뉴바에서 먼저 안다.

Q: ANTHROPIC_API_KEY로만 Claude Code를 쓰는데도 한도가 보이나요?

보이지 않습니다. 한도 표시는 Claude 구독(Pro·Max) 계정으로 로그인한 경우에만 동작합니다. API 키 환경에서는 토큰 사용량과 API 환산 비용 집계만 표시됩니다.

UniToken은 Claude Code가 로컬에 남기는 세션 트랜스크립트를 읽어 토큰 사용량과 API 환산 비용을 집계하고, 5시간 세션·주간 한도의 소진율을 메뉴바에 상주시킵니다.

UniToken 1.0 내려받기 (.dmg) 요구사항 확인

macOS 26.5+ · 유니버설 바이너리 · Developer ID 서명 · 공증 완료 · 4MB

한도 표시는 Claude 구독 계정으로 로그인한 경우에만 동작합니다. ANTHROPIC_API_KEY로만 쓰는 환경에서는 사용량·비용 집계만 표시됩니다.

UniToken Max 20×

플랜 한도

5시간 세션3시간 27분 후6%

주간 · 전체 모델5일 14시간 후10%

주간 · Opus5일 14시간 후2%

추가 사용 크레딧$0 / $50.00

사용량

오늘

7일

30일

전체

API 환산 비용

$68.73

102.9M토큰

98.9%캐시 적중

$451캐시 환산 차액

6세션

일별

모델

Opus 4.678.4M$52.10

Sonnet 4.624.5M$16.63

서브에이전트 포함 11:22:37

문제

Claude Code의 /usage는 하던 대화를 멈추고 명령을 쳐야 보입니다.

그래서 대부분은 확인하지 않고, 한도에 걸려 응답이 막힌 뒤에야 남은 시간을 계산합니다. UniToken은 같은 정보를 메뉴바에 상주시켜, 확인 비용을 0으로 만듭니다.

한도를 미리 안다

5시간 세션82%

주간 · 전체 모델41%

주간 · 모델별17%

5시간 세션 / 주간(전체 모델) / 주간(모델별) 소진율을 게이지로 상주시킵니다. 50 · 80 · 90 · 95% 중 고른 지점을 넘으면 시스템 알림이 옵니다.

소진 여부는 5분 간격으로 조회하므로 경고는 최대 5분 늦게 도착할 수 있습니다.

모델 · 프로젝트 · 일자로 쪼갠다

api-gateway$31.02

ios-client$18.44

infra-scripts$6.11

어느 프로젝트가 토큰을 쓰는지 목록으로 보여주고, 캐시 적중률과 캐시로 인한 환산 차액을 함께 표시합니다.

금액은 API 정가 환산값입니다. 구독 사용자의 실제 청구액이 아니라 “정가로 치면 얼마어치를 썼는지”입니다.

전부 이 맥 안에서

읽는 것: ~/.claude/projects/**/*.jsonl
보내는 것: api.anthropic.com — 한도 조회 1건

트랜스크립트 파싱과 집계는 로컬에서만 일어납니다. 계정 서버도 텔레메트리도 없습니다.

단 하나의 외부 통신은 한도 조회를 위한 Anthropic API 호출입니다. 아래 프라이버시 항목에 그대로 적었습니다.

한도 알림

초기화 알림에는 게이트를 뒀습니다.

5%만 쓴 세션이 초기화됐다는 알림은 정보가 아니라 소음입니다. 하루에 여러 번 울리고, 울릴 때마다 사용자는 알림을 무시하는 습관을 배웁니다.

그래서 초기화 알림은 기본적으로 “많이 쓴 세션만”에 걸어 두고, 기준(50% 이상 등)을 넘긴 세션이 풀릴 때만 보냅니다. 실제로 막혀 있었던 사람에게만 의미가 있는 알림이기 때문입니다.

초기화 알림은 시스템에 예약되므로 창을 닫아도 정시에 도착합니다.
소진 경고는 5분 간격 조회 시점에 감지되므로 최대 5분까지 늦을 수 있습니다.
같은 한도 창에서 같은 기준은 한 번만 알립니다. 창이 초기화되면 다시 무장합니다.

알림 설정

소진 경고

한도 소진 경고 받기

한도가 아래 비율을 넘어설 때 알립니다. 행동을 바꿀 수 있는 시점에 오는 알림입니다.

50%

80%

90%

95%

주간 한도에도 적용

초기화 알림

5시간 세션 초기화 시 알림

많이 쓴 세션만

기준50% 이상 ⌄

끄면 5% 차 있던 세션에도 알림이 옵니다. 실제로 막혔던 세션이 풀릴 때만 받는 편을 권합니다.

동작 방식

· 초기화 알림은 시스템에 예약되므로 창을 닫아도 정시에 도착합니다.
· 소진 경고는 5분 간격 조회 시점에 감지됩니다. 최대 5분까지 늦을 수 있습니다.
· 같은 한도 창에서 같은 기준은 한 번만 알립니다.

경고 이력 초기화

프라이버시

트랜스크립트는 이 맥을 떠나지 않습니다.

로컬에서만 읽고 집계합니다

~/.claude/projects/**/*.jsonl을 읽어 토큰 수와 환산 비용을 계산합니다. 대화 내용은 저장하지 않고, 집계 결과만 로컬에 캐시합니다.

계정 서버 없음 · 텔레메트리 없음

가입 절차가 없고, 사용 통계나 크래시 리포트를 수집하지 않습니다.

예외는 하나입니다

플랜 한도 소진율을 가져오기 위해 Anthropic API를 5분 간격으로 호출합니다. 이때 Claude 구독 계정의 인증 정보가 사용되며, 인증 정보는 시스템 키체인에 보관됩니다. 이 호출을 끄면 사용량·비용 집계만 동작합니다.

설치 & 요구사항

.dmg를 열고 Applications로 옮기면 끝입니다.

macOS	26.5 이상
아키텍처	유니버설 바이너리 (Apple Silicon · Intel)
배포	Developer ID 서명 + 공증을 거친 직접 배포 (.dmg, 4MB). Mac App Store에는 없습니다 — 샌드박스 제약 없이 홈 디렉터리의 트랜스크립트를 읽기 위한 선택입니다.
Claude Code	설치되어 있고 최소 1회 실행된 적이 있어야 합니다. 트랜스크립트 파일이 없으면 집계할 대상이 없습니다.
한도 표시 조건	Claude 구독(Pro · Max) 계정으로 로그인한 경우에만 동작합니다. ANTHROPIC_API_KEY로 Claude Code를 쓰는 환경에서는 한도가 표시되지 않습니다.

첫 실행

키체인 접근을 한 번 허용해야 합니다

“UniToken”이(가) 키체인에 저장된 기밀 정보를 사용하려고 합니다.

허용하려면 키체인 암호를 입력하십시오.

거부항상 허용

“항상 허용”을 고르면 이후 다시 묻지 않습니다. 허용 전까지는 한도 항목이 비어 있고, 사용량·비용 집계는 정상 동작합니다.

UniToken 1.0 내려받기 (.dmg · 4MB)

SHA-256 체크섬은 릴리스 노트에 함께 게시됩니다.

자주 묻는 질문

먼저 확인해두면 좋은 것들

UniToken이 보여주는 금액은 실제 청구액인가요?

아닙니다. API 정가로 환산한 값으로, “정가로 치면 얼마어치를 썼는지”를 나타냅니다. Claude 구독 사용자의 실제 청구액과는 무관합니다.

ANTHROPIC_API_KEY로만 Claude Code를 쓰는데도 한도가 보이나요?

보이지 않습니다. 한도 표시는 Claude 구독(Pro · Max) 계정으로 로그인한 경우에만 동작합니다. API 키 환경에서는 토큰 사용량과 API 환산 비용 집계만 표시됩니다.

대화 내용이 외부로 전송되나요?

전송되지 않습니다. 트랜스크립트 파싱과 집계는 전부 로컬에서 일어나고 대화 내용은 저장하지 않습니다. 외부 통신은 플랜 한도 소진율을 가져오기 위한 Anthropic API 호출 한 건뿐이며, 이 호출을 끄면 사용량·비용 집계만 동작합니다.

한도 경고는 얼마나 빨리 오나요?

소진 여부를 5분 간격으로 조회하므로 경고는 최대 5분까지 늦게 도착할 수 있습니다. 반면 세션 초기화 알림은 시스템에 예약되므로 창을 닫아도 정시에 도착합니다.

Mac App Store에서 받을 수 있나요?

없습니다. 홈 디렉터리의 Claude Code 트랜스크립트를 샌드박스 제약 없이 읽기 위해 Developer ID 서명과 공증을 거친 .dmg 직접 배포를 택했습니다.

한도에 걸려 멈추기 전에,메뉴바에서 먼저 안다.