Claude Code Usage Status Line (업데이트)
Claude Code 사용 현황 상태 표시줄
Claude Code, z.ai GLM 및 DeepSeek 사용량을 실시간으로
터미널에서 바로 확인하세요.
무료, 오픈 소스, 설정 불필요.
100% 무료 WindowsWindowsLinuxmacOS
세 가지 시스템 각각에 대해 x64 및 ARM64, 총 6개의 아카이브가 제공됩니다.
1.4.1의 새로운 기능
DeepSeek가 Claude와 z.ai에 합류했고, 세션 사용 금액에도 드디어 의미 있는 숫자가 표시됩니다.
Claude 계정마다 한 줄
CLAUDE_CONFIG_DIR 변수로 두 개의 Claude Code 계정을 오가는데, 실제로 어떤 계정이 활성화되어 있든 statusline에는 첫 번째 계정의 수치가 꼬박꼬박 표시되고 있었다. 이제는 이 변수를 읽으며, 캐시와 backoff도 계정별로 분리된다.
감수한 결과는 이렇다 : 계정이 증명되지 않은 데이터는 만료된 데이터라고 표시되어 있더라도 이제 전혀 표시되지 않는다. 다른 사람의 퍼센티지가 표시되는 것보다는 세그먼트 하나가 사라지는 편이 낫다.
잘못된 토큰은 그 사실을 말해 준다
401이 지금까지는 일반적인 오류 속에 묻혀 있었다 : API가 고장 난 건지 토큰이 만료된 건지 알 수 없는 채 줄이 조용해졌다.
이제는 별도로 처리된다 : 계정의 캐시가 무효화되고 메시지도 명확해진다. 토큰을 한 번 교체하는 것만으로 더 이상 아무것도 막히지 않으며, 표시는 다음 항목에서 다시 시작된다.
세 번째 provider : DeepSeek
내 작업의 일부를 DeepSeek으로 보내고 있는데, 다른 서비스와 똑같은 편의성을 원했다 : 계정 잔액을 눈앞에서 확인하는 것. 이제 줄에 잔액이 표시되며, API가 반환한 통화 그대로이고 변환하지 않는다.
DeepSeek은 지출 내역을 전혀 공개하지 않고 잔액만 공개한다. 그래서 이 줄에는 z.ai와 마찬가지로 잔액이 표시된다. 이를 감지하는 데는 작업이 조금 더 필요했다 : 내 런처는 Claude Code에 Claude 모델을 알리지만 트래픽은 다른 곳으로 보내고 있으며, statusline은 유효한 키인데도 Anthropic 식별자를 찾다가 credentials missing 앞에서 멈추곤 했다. 이제는 런처에서 물려받은 API 주소도 확인해서 실제로 누구와 이야기하고 있는지 알아낸다.
아이콘 범례
- ⌛ 5시간의 슬라이딩 윈도우
- 📅 모델을 가리지 않는 7일
- F 현재 모델의 게이지, 여기서는 Fable
- 💰 남은 잔액 또는 크레딧
- 💸 세션 지출액 (API로 청구되는 계정의 실제 비용, z.ai와 DeepSeek의 잔액 차이)
- 🧠 컨텍스트 윈도우
모델별 게이지는 아이콘이 아니라 이니셜 하나를 유지한다 (F, s, o) : 이름은 API에서 오고 모델에 따라 바뀌므로, 고정된 아이콘은 결국 거짓말을 하게 된다. 최소 구성의 Linux 배포판에서는 fonts-noto-color-emoji를 설치하면 전부 표시된다.
모델별 게이지와 크레딧
마이그레이션된 계정에서는 Anthropic이 더 이상 Sonnet과 Opus의 고정 게이지 두 개를 반환하지 않고 현재 모델에 연결된 주간 창을 반환합니다. 따라서 표시되는 문자는 모델을 따라가며, F는 Fable을 뜻합니다.
창이 가득 차고 크레딧이 대신 사용되기 시작하면 💰 세그먼트가 상세 모드로 전환되어 사용 금액, 한도, 잔액을 보여줍니다 : 💰 €12.56/€14 (left €1.44). 마이그레이션되지 않은 계정은 예전 표시를 유지하며, s와 o가 표시됩니다.
세션 비용, 진짜로
Claude Code가 계산하는 세션 비용은 선언된 모델의 요금으로 추정됩니다. 제 경우에는 전체 계정이 $8.13였고 세션 비용은 $0.26 정도였는데 💸 $24.64라고 표시됐습니다. 100배 차이니, 쓸모 있는 정보라고 하기는 어렵습니다.
이제 세션 비용은 실제 계정 잔액을 기준으로 측정되며, 첫 번째 프롬프트에서 잔액을 기록한 다음 새로 고칠 때마다 비교합니다. 그리고 z.ai도 이 기회를 이용합니다 : 지금까지는 세션 비용을 전혀 표시하지 않았습니다.
표시되는 모델이 실제로 돌아가는 모델입니다
이름도 마찬가지입니다 : 백엔드가 DeepSeek을 제공하는 동안 줄에는 Opus 4.7이 표시되고 있었습니다. 이제 표시되는 이름은 실제 provider를 따라갑니다.
그리고 선언된 대응 항목이 없어도 아무것도 망가지지 않습니다 : 빈 칸으로 두는 대신 예전 이름이 계속 표시됩니다.
Claude Code 하단의 상태 줄
한눈에 필요한 모든 것
상태 줄 하나. Claude, z.ai, DeepSeek의 모든 사용 데이터.
자동 감지된 프로젝트
현재 디렉터리의 이름을 표시합니다 (경로의 마지막 부분). 전체 경로로 줄을 어지럽히지 않고, 어떤 프로젝트에서 작업 중인지 언제나 알 수 있습니다.
활성 모델
어떤 모델이 사용되고 있는지(Opus, Sonnet, Haiku, GLM 또는 DeepSeek)를 상태 표시줄에서 바로 확인하세요. 프로바이더는 자동으로 감지됩니다.
사용률
5시간, 7일 창과 현재 모델의 게이지가 표시되며(이전 계정에서는 Sonnet과 Opus가 분리됨), 색상 표시기는 초록색, 노란색, 빨간색입니다.
카운트다운
한도가 정확히 언제 초기화되는지 알 수 있습니다. 각 관련 지표 옆에 ↻ 카운트다운이 표시됩니다.
컨텍스트 창
대화 중에 한도에 도달하지 않도록 컨텍스트 창의 사용량을 확인하세요.
z.ai / GLM 및 DeepSeek 지원
z.ai 계정 잔액(💰 9.88$)을 표시하고 선택한 통화(EUR, GBP, CAD…)로 자동 변환합니다. DeepSeek 잔액도 기본 통화로, 변환 없이 표시됩니다.
오래된 데이터 표시기
값 앞의 ~ 접두사는 캐시가 만료되었지만 API를 사용할 수 없다는 뜻입니다(429 백오프). 지금 읽고 있는 내용이 무엇인지 언제나 알 수 있습니다.
스마트 캐시와 백오프
API에 부담을 주지 않도록 프로바이더별로 1분간 캐시합니다. 429가 발생하면 rate limit이 터지는 것을 막기 위해 5분간 자동으로 백오프합니다.
설정 제로(Claude)
설치 프로그램을 실행하면 끝입니다. ~/.claude/.credentials.json에서 Claude 인증 정보를 자동으로 읽습니다(macOS에서는 Keychain에서도 읽습니다).
구독에 따라 Status Line에 표시되는 내용
Status Line은 사용 중인 요금제에 자동으로 맞춰지고 관련 지표를 표시합니다.
z.ai 설정(GLM 모델)
z.ai를 통해 Claude Code에서 GLM 모델(glm-5.1 등)을 사용한다면 잔액을 표시하기 위해 약간의 추가 설정이 필요합니다.
ZAI_API_KEY)를 받지 않습니다: 대신 다른 웹 세션 JWT를 요구합니다. 그리고 로그인 엔드포인트는 모든 자동화(Selenium, Playwright 등)를 차단하는 TianCaptcha(Aliyun)로 보호됩니다. 따라서 유일하게 신뢰할 수 있는 방법은 실제 브라우저에서 토큰을 복사하는 것입니다.1단계: JWT 가져오기
- 평소 사용하는 브라우저에서 z.ai/manage-apikey/billing 열기
- 로그인하기(요청되면 captcha 해결하기)
- F12로 DevTools를 열고 Network 탭으로 이동하기
- F5로 페이지 새로 고침하기
accountBalance라는 이름의 요청 클릭하기- Headers에서
Authorization값을Bearer접두사 없이 복사하기(토큰은eyJhbGciOiJIUzUxMiJ9로 시작합니다)
2단계: JWT 저장하기
ClaudeUsageStatusline.ZaiRefresh 동반 바이너리가 설치에 함께 제공됩니다. 이 바이너리는 토큰 형식을 검증하고 ~/.claude/.zai-credentials.json에 기록합니다.
Windows :
& "$env:LOCALAPPDATA\ClaudeUsageStatusLine\ClaudeUsageStatusline.ZaiRefresh.exe"Linux / macOS :
~/.local/bin/ClaudeUsageStatusline.ZaiRefresh3단계 (선택 사항) : 표시 통화
잔액은 기본적으로 USD로 반환됩니다. EUR 또는 다른 통화로 표시하려면 실행 파일 옆의 appsettings.json을 편집하세요 :
{
"Zai": {
"NativeCurrency": "USD",
"DisplayCurrency": "EUR",
"ExchangeRateCacheHours": 24
}
}환율은 무료 API에서 하루에 한 번 가져와 로컬에 캐시합니다.
JWT는 언제 새로 고쳐야 할까?
세션 JWT에는 명시적인 만료일이 없습니다 : 수명은 z.ai 서버가 관리합니다. 일정 기간 활동이 없거나 명시적으로 연결을 끊으면 결국 무효화됩니다.
갱신해야 한다는 신호 :
- statusline에
z.ai: token missing이 표시되고 새 창의 안내를 따르라는 메시지가 나옵니다 - 오래된 데이터 접두사 (
~💰)가 계속 표시됩니다 - 로그에
401 Unauthorized가 포함됩니다
두 경우 모두 ZaiRefresh가 창에서 저절로 열립니다 : 새 JWT를 붙여넣기만 하면 됩니다.
DeepSeek 설정 (API 키)
z.ai보다 간단합니다 : API 키 하나면 충분하고, 이 과정에는 captcha도 없습니다.
키 만들기
DeepSeek 계정의 API keys 섹션에서 키를 하나 만드세요. sk-로 시작하며 한 번만 표시됩니다: 바로 복사하세요.
statusline에 전달하기
두 가지 방법이 있습니다. 환경 변수 DEEPSEEK_API_KEY를 사용하거나, statusline이 알아서 읽는 작은 파일을 사용하는 방법입니다:
{"apiKey": "sk-votre-cle"}~/.claude/.deepseek-credentials.json에 저장하세요. 이후 새로 고칠 필요는 없습니다: API 키는 저절로 만료되지 않습니다.

대화에 참여하세요
이 글에 댓글을 달려면 계정이 있어야 합니다. 계정 생성은 무료이며 1분도 걸리지 않습니다.
현재 댓글이 없습니다.