繁體中文

新功能

HTML 報表換新版面,圖表文字從 9px 放大到 12px

打開 usage 產出的 HTML 報表,現在每個區塊都收進外框一致的儀表板卡片裡。以前整頁報表只靠細線分段,頁面一長很難看清哪裡是哪裡;現在上方四張摘要卡共用同一個三列格線,數字整齊切齊。內文與數值一律換成無襯線字體配等寬數字,等寬字體只留給頂部的指令與 [usage]> 前綴。整體色調轉為中性,token(AI 處理與計費的文字單位)用量不再是土黃色,綠色則專門留給趨勢與尖峰。圖表上的文字也同步變大,坐標軸標籤從 9px 放大到 12px、圖例從 .7rem 放大到 .8rem,時段軸與熱力圖的月份及星期標籤都變大了,解決以前在普通螢幕上看不清的困擾。

問題修復

Windows 上切換 Claude 帳號不再殘留前一個人的額度

家裡或公司共用一台 Windows 電腦,各自登入不同的 Claude 帳號?Claude Code 會把查到的用量額度存在 ~/.claude.json 檔案中,並在快取(把查過的結果暫存起來直接用)裡標註抓取時的帳號名稱;只要一換帳號,Claude Code 就會自動忽略該筆暫存。以前 usage 讀取檔案時沒有檢查這個帳號標籤,而 Windows 上查詢 Claude 額度又主要仰賴這份快取,才導致換了帳號卻依然顯示前一位使用者的剩餘用量。現在只要發現帳號不符就會主動跳過該快取;至於舊版 Claude Code 寫入、沒有帶帳號標籤的快取資料,依然會正常讀取。

新功能

報表測試時間一律固定為 UTC,排除時區不同造成的驗證失敗

這是給開發者的修正,一般使用者不會感覺到差別。以前有 6 支報表測試只能在時區設為 UTC 的電腦上通過,導致線上持續整合(CI,自動驗證程式的機制)明明是綠燈,開發者在 UTC+8 的 Windows 電腦上跑測試卻固定失敗。這是因為程式先前直接在行內轉換工作階段的開始時間,測試環境沒辦法把時間固定住;現在這段時間轉換邏輯獨立了出來,讓測試能把時間基準牢牢鎖在 UTC,軟體本身的功能與行為則完全維持不變。

新功能

官網視覺排版重整,手機更好點按並加入面板預載圖

逛 usage 官方網站時,現在用手機點選連結或按鈕順手多了。首頁功能區改用三排圖文左右交錯呈現,分別介紹各工具額度、HTML 報表與外觀主題,其餘功能則整理成雙欄卡片,原本獨立的報表區塊也直接併入第二排。進度管家改採紙卡質感呈現,主題預覽外框會跟著面板高度自動縮放,短面板下方不再留下一大塊尷尬空白,安裝教學則移到頁面最下方。

頂部導覽列、手機複製按鈕與頁尾連結都放大了點擊有效範圍,而且面板預覽在載入完成前會先顯示靜態預載海報,中文網頁也配上中文版海報。

English

FEATURE

The HTML report gets a new layout, with chart text up from 9px to 12px

When you open the HTML report generated by usage, each section is now neatly organized inside a consistent dashboard card. Previously, the entire report was split only by thin divider lines, making it hard to navigate down a long page; now the four summary cards at the top share a single three-row grid, keeping numbers aligned. Body text and numbers uniformly share a sans-serif typeface paired with tabular figures, keeping monospace only for the command line at the top and the [usage]> prefix. The color palette shifted to neutral tones, token counts are no longer amber, and green is reserved exclusively for trends and peaks. Chart text is also larger: axis labels grew from 9px to 12px, legends grew from .7rem to .8rem, and the hour axis alongside the heatmap's month and weekday labels were also enlarged, fixing the previous issue where text was unreadable on ordinary screens.

BUGFIX

Switching Claude accounts on Windows no longer shows previous quota

Sharing one Windows PC and signing in to different Claude accounts? Claude Code stores retrieved quota in ~/.claude.json and tags the cache (temporary storage for fetched results) with the account name that retrieved it, automatically ignoring the cache whenever the account switches. Previously, usage did not verify this account tag, and Windows relies primarily on this cache file for Claude quota, causing the tool to keep displaying the previous user's remaining balance after a switch. Now, any cache with a mismatched account is skipped; caches written by older Claude Code versions without account tags continue to be read normally.

FEATURE

Report tests pin session start times to UTC to avoid time zone failures

This one is for developers; as a user you won't notice a difference. Previously, 6 report tests passed only on machines configured for the UTC time zone, so continuous integration (CI) stayed green while tests consistently failed on Windows machines in UTC+8. This happened because the code converted session start times inline where test fixtures could not freeze the clock; that conversion logic is now separated out so tests can pin the reference time directly to UTC, while the software's functional behavior remains completely unchanged.

FEATURE

Website visual redesign with larger tap targets and preloaded panel posters

Browsing the usage official website on a mobile phone is now much easier on your fingers. The homepage feature section now alternates image and text across three rows to present tool quotas, HTML reports, and visual themes, while secondary features are arranged into two-column cards, and the standalone report section is merged into the second row. The pacing section adopts a paper card look, the theme preview frame dynamically fits panel height so shorter panels leave no awkward empty space, and installation instructions moved to the very bottom.

Navigation links, the mobile copy button, and footer links all feature larger tap target areas, and panel previews display a static poster image until fully loaded, with Chinese posters served on Chinese pages.

原始 CHANGELOG

Original changelogHTML 報表換新版面,圖表文字從 9px 放大到 12px
**The HTML report is laid out as dashboard cards.** Each section sits in a card of the same shape instead of being split by thin rules, which were hard to follow down a long page. Body text and numbers share one sans-serif face with tabular figures; monospace is kept for the `[usage]>` prefix and the command line at the top. The palette is neutral, token counts are no longer amber, and green is kept for trends and peaks. The four summary cards share one three-row grid, so their numbers line up.
**Chart labels in the HTML report are larger.** Axis labels went from 9px to 12px and legends from .7rem to .8rem, and the hour axis and the heatmap's month and weekday labels grew with them. The old sizes were unreadable on an ordinary screen.
Original changelogWindows 上切換 Claude 帳號不再殘留前一個人的額度
**Switching Claude accounts no longer shows the previous account's quota on Windows.** Claude Code tags the quota it caches in `~/.claude.json` with the account that fetched it and ignores the cache after a switch. usage did not check the tag, and on Windows that cache is the main source of Claude quota. A cache from another account is now skipped. Caches written by older Claude Code versions carry no tag and are still read.
Original changelog報表測試時間一律固定為 UTC,排除時區不同造成的驗證失敗
**Report tests pin session start times to UTC.** Six report tests passed only on UTC machines, so CI stayed green while they failed on Windows at UTC+8. Session start times were converted with an inline `.astimezone()` the tests could not replace; that conversion is now `_session_start_text()`, and the fixtures pin it to UTC next to `_entry_date`. Behavior is unchanged. (#144)
Original changelog官網視覺排版重整,手機更好點按並加入面板預載圖
**Website visual refresh.** The feature section alternates image and text in three rows (quota for every tool, the HTML report, themes) with the remaining features as two-column cards, and the standalone report section merged into the second row. The pacing section is a paper card, the theme preview sizes its frame to the panel so short panels leave no empty space, and install moved to the end. Nav links, the mobile copy button and footer links have larger tap targets, and panel previews show a static poster until they load, in Chinese on the Chinese pages.