token-wallpaper

token-wallpaper 是 GitHub 用户 lycfyi 开源的 macOS 小工具，README 的一句话介绍是“把你的 AI 编程 token 用量做成一张会自己更新的 Mac 壁纸”。它读取和开源统计工具 ccusage 相同的本地日志，涵盖 Claude Code、Codex、OpenCode、Gemini CLI 和 ccusage 认得的其他编程智能体，每 30 分钟在桌面上重画一张数据看板（dashboard）。看板上有估算费用，总 token 和输入、输出、缓存 token，活跃天数和连续使用天数，今天的用量和用得最多的一天，最近 30 天的每日用量柱状图，26 周的活跃热力图（heatmap），以及按工具、按模型分的用量占比；深色、浅色跟着系统外观走。用量历史存在你的电脑上，每天的数字只增不减，AI 工具清掉旧日志后壁纸上的历史还在。在这里 AI 是被统计的对象，工具本身不需要 AI 账号或 API key，作者也没有说明它是不是用 AI 写的。它特别的地方在于把用量放在桌面上，切换窗口时扫一眼就能看到，不用专门打开统计页面。

适合谁：天天用 Claude Code、Codex 这类 AI 编程工具、想随时知道自己用了多少的 Mac 用户。要在终端里安装，不写代码的读者用不上。

使用前提：只支持 macOS（作者在 macOS 26 上测过），需要 Python 3.9 以上、Node.js（用 npx 运行 ccusage），以及 Chrome 或其他 Chromium 内核浏览器（Chromium、Edge、Brave）。安装命令会在 ~/Library/LaunchAgents/ 写入一个后台任务（LaunchAgent），立刻运行一次，之后每 30 分钟更新；它用一个单独的浏览器配置在后台打开本地页面截图，再把截图设成每块屏幕的壁纸，旧的截图会被删掉。装好后要在系统设置的墙纸里打开 Show on all Spaces（在所有空间显示），否则只有当前桌面会换。README 说所有数据都留在你的 Mac 上，唯一的联网是 npx 下载 ccusage 这个第三方包（默认固定在 20.0.26 版），历史、日志和图片存在 ~/Library/Application Support/token-wallpaper/；ccusage 的代码本站没有另外核查。壁纸上的费用是按用量估算的，不是官方账单，也不代表剩余额度；README 里的截图用的是编出来的演示数据（render --demo），不是真实用量。壁纸会显示你的用量、费用和用了哪些模型，共享屏幕或别人看得到你桌面时要留意。卸载命令只移除后台任务，历史数据会留着。MIT 许可。

以上根据项目公开说明整理，本站没有实际测试。