# usage：macOS 選單列 Claude／Codex 用量：技能書與協作來源

在 Mac 選單列看 Claude／Codex 用量與概算成本，數字來自本機紀錄。

## 工坊收錄說明

作品與開源

在 Mac 上使用 Claude Desktop、Claude Code 或 Codex 的人、想看本機用量來源與推算方式的開發者。

一張 Mac 用量面板的 mock 核對表，標明每欄資料來源、哪些是推算值，以及 app／LaunchAgent／hook 的移除方式。

和夥伴比較「本機推算」與實際帳務的差異，只交流合成或 mock 紀錄，再回修改版 repo 補文件。

先讀 NOTICE.md 和 README 的用量來源順序，列出自己使用哪一種工具，以及哪些欄位可能沒有資料。

## 封面與來源署名

維護：ken-kk

封面插畫：/art/skills/usage.webp

原作 GitHub：https://github.com/kieiken/usage

登入自由工坊並連結自己的 GitHub，即可在技能書加星或取消星星。

原作數據：/api/v1/github/books/usage/metrics

Stars、Forks、追蹤數、未結 Issues 與 PR 合計、最近程式更新時間以 GitHub 回覆為準；數據附核對時間，讀取失敗不冒充零。

## 讀者與格式

macOS 本機用量檢視工具

- 在 Mac 上使用 Claude Desktop、Claude Code 或 Codex 的人

- 想看本機用量來源與推算方式的開發者

## 功能與使用範圍

限 macOS。ken-kk 自述為維護者；此版修改自 lollapalooza 的 aqua5230/usage，原始歸屬見 NOTICE.md。AGPL-3.0-only，散布與網路提供修改版時須核對授權義務；本書不複製程式碼。安裝包未簽章，會新增每分鐘更新的 LaunchAgent。本機日誌推算值與概算成本不是官方帳單；README 表示不呼叫 Anthropic／OpenAI API、不讀 Keychain。工坊未安裝，也未讀取個人日誌。

- 選單列常駐，點開看工作階段、每週用量與重置剩餘時間。

- 依序讀取 Claude Desktop 推算資料或 Claude Code statusLine 資料；Codex 讀本機 sessions，沒有紀錄就隱藏該欄。

- 顯示專案 token、今日 token 與概算成本，提供 python3 main.py --mock／--tui --mock 預覽。

## 開始前準備

- 一台 Mac；研究原始碼需依原作準備 Python 3.13 與套件。

- README 與 NOTICE.md；先看 LaunchAgent、hook 及解除安裝章節。

- 第一次只用 --mock；日後是否接自己的日誌，由本人決定，不用別人的 session 檔。

## 第一個練習

1. 先讀 NOTICE.md 和 README 的用量來源順序，列出自己使用哪一種工具，以及哪些欄位可能沒有資料。

2. 在自己的 macOS 開發環境用 python3 main.py --mock 預覽；要看終端版可用 python3 main.py --tui --mock。

3. 若決定安裝，再核對 usage.app、LaunchAgent 與可選 statusLine hook 各自做什麼；用 README 的移除步驟寫下回復方式。

## 練習成果

一張 Mac 用量面板的 mock 核對表，標明每欄資料來源、哪些是推算值，以及 app／LaunchAgent／hook 的移除方式。

## 專案與授權

原作 Repo：https://github.com/kieiken/usage
從原作建立自己的版本：https://github.com/kieiken/usage/fork
工坊整合參考：https://github.com/kieiken/usage
記錄的授權：AGPL-3.0

## 一起改這本技能書

向 kieiken/usage 的 Issues 回報 mock 畫面、日文說明或來源判讀問題，附 macOS 與 Python 版本；保留維護者 ken-kk、lollapalooza 與 aqua5230/usage 的歸屬，不貼私人日誌。

原作 Repo：https://github.com/kieiken/usage
預設 PR 目標：kieiken/usage:main
從原作建立自己的版本：https://github.com/kieiken/usage/fork
原作 PR：https://github.com/kieiken/usage/pulls

工坊整合參考：https://github.com/kieiken/usage
工坊整合任務專用 Fork：https://github.com/kieiken/usage/fork
工坊任務：https://github.com/kieiken/usage/issues
工坊 PR：https://github.com/kieiken/usage/pulls
GitHub Milestones：https://github.com/kieiken/usage/milestones

先閱讀原作現行的貢獻規則。Fork 不會自動回饋原作；修改要以 PR 提交，由原作維護者決定是否合併。工坊整合任務可在工坊審查，另外記錄回饋原作的 PR 或未回送原因。

以下是入口與建議，不代表已認領或已完成。以 GitHub 最新 Issue、PR 與維護者確認為準。

- 第一份可重用的共同成果（建議里程碑）：提交可重現案例、來源與驗證結果，由維護者審查；這是建議里程碑，尚未建立為 GitHub milestone。

### 改善macOS 本機用量檢視工具的第一個案例 · 建議任務

向 kieiken/usage 的 Issues 回報 mock 畫面、日文說明或來源判讀問題，附 macOS 與 Python 版本；保留維護者 ken-kk、lollapalooza 與 aqua5230/usage 的歸屬，不貼私人日誌。

- 驗收：一張 Mac 用量面板的 mock 核對表，標明每欄資料來源、哪些是推算值，以及 app／LaunchAgent／hook 的移除方式。 記錄實際驗證與未執行項目；以原作 Issue／PR 協調。

Agent Skill：/development/skills/usage/SKILL.md
協作 JSON：/api/v1/skills/usage/collaboration

## 參與開發

向 kieiken/usage 的 Issues 回報 mock 畫面、日文說明或來源判讀問題，附 macOS 與 Python 版本；保留維護者 ken-kk、lollapalooza 與 aqua5230/usage 的歸屬，不貼私人日誌。

工坊 Issue／PR 協調入口：https://github.com/kieiken/usage/issues

先讀該 Repo 根目錄 README.md、AGENTS.md、CONTRIBUTING.md；原始程式、測試及來源授權留在該專案。平台介紹與公會收錄則在 freedom-platform 的 modules/community 維護。

要改善平台介紹：https://github.com/FreeTWAI/freedom-platform/issues

## 閱讀與來源

閱讀原始專案：https://github.com/kieiken/usage/blob/e6298d1af0e2127b587b2ff609942896635bdd66/README.md
核對日期：2026-10-20
核對版本：e6298d1af0e2127b587b2ff609942896635bdd66

- README.md：https://github.com/kieiken/usage/blob/e6298d1af0e2127b587b2ff609942896635bdd66/README.md

- LICENSE：https://github.com/kieiken/usage/blob/e6298d1af0e2127b587b2ff609942896635bdd66/LICENSE

- NOTICE.md：https://github.com/kieiken/usage/blob/e6298d1af0e2127b587b2ff609942896635bdd66/NOTICE.md

## 共創原則

GitHub Issue 是待辦與協調來源，PR 是審查與合併紀錄。先確認任務範圍，再用自己的分支完成相關驗證；保留上游與實際貢獻者。Fork 不等於平台認證、已測試運行或新授權。

完整結構化目錄：/api/v1/development-map