Vincent LauriatVincent LauriatVincent Lauriat 06 · ClaudeSessionView
GitHub

06ClaudeSessionView

A native macOS menu bar appUne app native pour la barre de menus macOS原生 macOS 選單列應用程式

See your real Anthropic usage in the macOS menu bar.Votre usage Anthropic réel, dans la barre de menus macOS.在 macOS 選單列看見你真實的 Anthropic 用量。

A macOS menu bar app that shows your real Anthropic account usage — how much of the 5-hour session window and the 7-day weekly window you have burned, and exactly when each one resets.Une app de barre de menus macOS qui affiche l'usage réel de votre compte Anthropic — la part déjà consommée de la fenêtre de session de 5 heures et de la fenêtre hebdomadaire de 7 jours, et le moment exact où chacune se réinitialise.一款 macOS 選單列應用程式,顯示你真實的 Anthropic 帳號用量——5 小時工作階段視窗與 7 天每週視窗各已用掉多少,以及各自重置的確切時間。

RequiresConfiguration系統需求
macOS 26+ · requires Claude CodemacOS 26+ · nécessite Claude CodemacOS 26+ · 需要 Claude Code
DistributionDistribution發行
Signed & notarized DMGDMG signé et notarié已簽章與公證的 DMG
LicenceLicence授權
Free & open source (MIT)Gratuit et open source (MIT)免費開源(MIT)

FeaturesFonctionnalités功能

  • Real usage, not an estimateL'usage réel, pas une estimation真實用量,而非估算

    The 5-hour session and 7-day window percentages come straight from your Anthropic account — the same numbers Claude Desktop shows, never a local reconstruction from your logs.Les pourcentages de la session de 5 heures et de la fenêtre de 7 jours viennent directement de votre compte Anthropic — les mêmes chiffres que ceux de Claude Desktop, jamais une reconstruction locale à partir de vos journaux.5 小時工作階段與 7 天視窗的百分比直接來自你的 Anthropic 帳號——與 Claude Desktop 顯示的數字相同,絕非從你的記錄在本機重建。

  • Exact reset countdownCompte à rebours exact精確的重置倒數

    Time remaining until each window resets, plus the clock time it resets at. No more guessing whether it is worth starting one more task.Le temps restant avant la réinitialisation de chaque fenêtre, ainsi que l'heure à laquelle elle a lieu. Plus besoin de deviner s'il vaut la peine de lancer une tâche de plus.每個視窗距離重置還剩多少時間,以及重置的時刻。不必再猜是否值得多開始一項任務。

  • Pick what the menu bar showsChoisissez ce qu'affiche la barre de menus自選選單列顯示內容

    Display the 5-hour percentage, the 7-day percentage, or just the icon. The full detail always stays one click away in the popover.Affichez le pourcentage sur 5 heures, celui sur 7 jours, ou seulement l'icône. Le détail complet reste toujours à un clic, dans le popover.顯示 5 小時百分比、7 天百分比,或只顯示圖示。完整細節永遠在彈出視窗中,點一下就到。

  • Remaining or consumedRestant ou consommé剩餘或已用

    Flip every percentage between “remaining” and “consumed” to match how you think. The severity color stays keyed to consumption, so red always means danger.Basculez chaque pourcentage entre « restant » et « consommé », selon votre façon de penser. La couleur de gravité reste indexée sur la consommation : le rouge signale toujours un danger.依你的思考習慣,把每個百分比在「剩餘」與「已用」之間切換。嚴重程度的顏色始終依用量而定,所以紅色永遠代表危險。

  • Three languages, liveTrois langues, en direct三種語言,即時切換

    English, French and Chinese, plus System / Light / Dark themes — all switchable on the spot, no relaunch. Liquid Glass UI, native to macOS 26.Anglais, français et chinois, plus les thèmes Système / Clair / Sombre — tous modifiables sur-le-champ, sans relancer. Interface Liquid Glass, native de macOS 26.英文、法文與中文,以及系統/淺色/深色主題——全部可當場切換,無須重新啟動。Liquid Glass 介面,macOS 26 原生。

  • Launch at loginLancement à l'ouverture de session登入時啟動

    Register the app with your system login items in one toggle, via SMAppService — no helper to install, no Dock icon, nothing left behind when you turn it off.Inscrivez l'app dans les éléments d'ouverture de session d'un seul interrupteur, via SMAppService — aucun utilitaire à installer, aucune icône dans le Dock, rien ne subsiste quand vous le désactivez.透過 SMAppService,一個開關就把應用程式加入系統登入項目——不必安裝輔助程式、沒有 Dock 圖示,關閉後也不留任何痕跡。

  • Honest error statesDes erreurs affichées honnêtement誠實的錯誤狀態

    If the credentials are missing or expired, or the API rate-limits, the app says so explicitly and keeps the last known values on screen instead of inventing a number.Si les identifiants sont absents ou expirés, ou si l'API limite les appels, l'app le dit explicitement et garde à l'écran les dernières valeurs connues au lieu d'inventer un chiffre.若憑證遺失或過期,或 API 觸發速率限制,應用程式會明確告知,並在畫面上保留最後已知的數值,而不是編造數字。

How it reads real dataComment il lit les vraies données它如何讀取真實資料

  1. It reuses the token Claude Code already stored. When you sign in to Claude Code, it saves an OAuth token in the macOS Keychain. ClaudeSessionView reads that entry — it never asks you for credentials and never stores any of its own.Il réutilise le jeton que Claude Code a déjà enregistré. Quand vous vous connectez à Claude Code, celui-ci enregistre un jeton OAuth dans le trousseau macOS. ClaudeSessionView lit cette entrée — il ne vous demande jamais d'identifiants et n'en stocke jamais lui-même.它沿用 Claude Code 已儲存的權杖。你登入 Claude Code 時,它會把 OAuth 權杖存進 macOS 鑰匙圈。ClaudeSessionView 讀取這個項目——從不向你索取憑證,也從不自行儲存任何憑證。

  2. It asks Anthropic directly. With that token it calls GET https://api.anthropic.com/api/oauth/usage, the endpoint behind the usage figures Claude Code and Claude Desktop show you. That is why the numbers match instead of approximating them.Il interroge directement Anthropic. Avec ce jeton, il appelle GET https://api.anthropic.com/api/oauth/usage, l'endpoint derrière les chiffres d'usage qu'affichent Claude Code et Claude Desktop. C'est pourquoi les chiffres concordent au lieu d'en être une approximation.它直接詢問 Anthropic。它用這個權杖呼叫 GET https://api.anthropic.com/api/oauth/usage,也就是 Claude Code 與 Claude Desktop 顯示用量數字背後的端點。所以數字是一致的,而非近似值。

  3. Read-only, and it stays on your Mac. Nothing is written back, nothing is stored, and no data goes anywhere except to Anthropic's own API. Polling runs every 5 minutes, with exponential backoff if the API rate-limits.En lecture seule, et tout reste sur votre Mac. Rien n'est réécrit, rien n'est stocké, et aucune donnée ne part ailleurs que vers l'API d'Anthropic elle-même. L'interrogation a lieu toutes les 5 minutes, avec un backoff exponentiel si l'API limite les appels.唯讀,而且留在你的 Mac 上。不回寫、不儲存,除了 Anthropic 自己的 API 之外,資料不會送往任何地方。每 5 分鐘輪詢一次,若 API 觸發速率限制則採指數退避。

Two deliberate limits. Claude Code must have been signed in at least once on this Mac, otherwise there is no token to read. And the app never refreshes that token itself — Claude Code does that during normal use, so if it has been idle for a long while, run claude once and the app picks the refreshed token back up.Deux limites délibérées. Claude Code doit avoir été connecté au moins une fois sur ce Mac, sinon il n'y a aucun jeton à lire. Et l'app ne renouvelle jamais ce jeton elle-même — Claude Code s'en charge en usage normal ; s'il est resté inactif longtemps, lancez claude une fois et l'app récupère le jeton renouvelé.兩項刻意的限制。這台 Mac 上必須至少登入過一次 Claude Code,否則沒有權杖可讀。而且應用程式從不自行更新權杖——Claude Code 會在正常使用時處理;若它已閒置很久,執行一次 claude,應用程式就會重新取得更新後的權杖。

InstallInstallation安裝

No release has been published yet — the signed & notarized DMG will land on the Releases page when it is ready. Until then, build it from source:Aucune version n'a encore été publiée — le DMG signé et notarié arrivera sur la page Releases quand il sera prêt. D'ici là, compilez-le depuis les sources :目前尚未發布任何版本——已簽章與公證的 DMG 準備好後會出現在 Releases 頁面。在那之前,請從原始碼建置:

brew install xcodegen        # if you don't have it
git clone https://github.com/vincentlauriat/ClaudeSessionView.git
cd ClaudeSessionView
xcodegen generate
xcodebuild -scheme ClaudeSessionView -configuration Debug CODE_SIGNING_ALLOWED=NO build
open build/Debug/ClaudeSessionView.app

The app lives in the menu bar and has no Dock icon. It needs macOS 26 or later (the UI relies on Liquid Glass APIs that do not exist before that) and Claude Code signed in at least once on the same machine. Architecture notes are in ARCHITECTURE_EN.md.L'app vit dans la barre de menus et n'a pas d'icône dans le Dock. Elle nécessite macOS 26 ou ultérieur (l'interface repose sur des API Liquid Glass qui n'existent pas avant) et Claude Code connecté au moins une fois sur la même machine. Les notes d'architecture sont dans ARCHITECTURE_EN.md.應用程式常駐於選單列,沒有 Dock 圖示。它需要 macOS 26 或以上版本(介面仰賴在此之前並不存在的 Liquid Glass API),且同一台機器上 至少登入過一次 Claude Code。架構說明請見 ARCHITECTURE_EN.md。

Real usage, not an estimateL'usage réel, pas une estimation真實用量,而非估算