AI配额到底被谁吃掉了？Codenotch成本归因功能：本地索引Claude会话，定位烧钱的项目
【免费下载链接】codenotchA macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge.项目地址: https://gitcode.com/gh_mirrors/co/codenotch
你是不是也遇到过这种情况：早上看 Claude Code 的周配额还剩 60%，中午一抬头直接掉到 20%——到底是谁在烧？Codenotch 是一款 macOS 菜单栏应用，把 Claude Code、Codex、Cursor、Antigravity 等 AI 工具的用量配额钉在屏幕边缘，而它的成本归因功能更进一步：在本地索引 Claude / Codex 的会话记录，告诉你哪个项目、哪个文件夹吃掉了你的 AI 配额。全程本地计算，无需任何额外账号。
为什么配额总是"莫名其妙"地变少？
订阅制 AI 工具只告诉你"剩了多少"，从不告诉你"花在哪了"：
- 多项目并行：上午改老仓库、下午开新实验，配额混在一起扣；
- 子代理与后台任务：Agent 自动跑脚本、批量重构，消耗远超肉眼可见的对话；
- 缓存读写不透明：input / output / cache token 各自计费，账单难以直观对应。
结果是：月底看着账单，却说不清钱花在了哪个代码库上。
成本归因：把"用了多少"变成"谁用的"
Codenotch 的成本层（源码位于 Sources/Costs/）解决的就是这个问题。核心思路：
配额数字只告诉你"少了多少"，成本归因把每一次观测到的配额下降，与同一时间段里本地发生的对话轮次配对，从而说出"是哪个项目花掉的"。
一切数据都来自 Claude Code / Codex 自己写到磁盘上的会话转录文件，不发送任何额外请求。
一键上手：无需配置，无需账号
- 安装并启动 Codenotch，它会显示在屏幕顶部刘海/边缘位置；
- 只要你在本机跑过 Claude Code（或 Codex），转录目录自动被识别；
- 悬停配额卡片，即可看到"What used it"（谁用掉的）区块：按项目列出配额占比和对应金额；
- 从菜单打开Activity 窗口，可切换到"今天 / 本周 / 本月"等多个时间范围查看明细。
如果你同时使用多个账号（例如~/.claude-<slug>的第二个登录），成本归因会按账号分别建库，互不串账（逻辑见 CostAccounts.swift）。
它是怎么本地索引会话的？
实现核心在 CostIndexer.swift，几个关键设计对新手很友好：
- 增量读取：记录每个文件的字节偏移，只解析新增内容，不重复扫描历史；
- 实时监听：通过文件系统事件，Claude 写完一轮对话，面板很快就更新；
- 只取数字：每条记录只提取时间戳、工作目录、git 分支、sessionId 和 token 用量，从不读取消息正文；
- 隐私保证：转录文件可能包含你项目里的机密信息，该功能确保这些数据"永远不离开这台机器"。
项目归属的判定也很聪明：会话目录名本身编码了启动会话时的文件夹，比深层的 cwd 更可靠；再配合 git 根目录缓存，把每轮对话落到具体项目上。
费用是怎么算出来的？
很多用户担心：我的 Claude 是订阅制，根本没有按 token 收费，还能算钱吗？答案是可以，而且是估算值：
| 计费方式 | 计算逻辑 |
|---|---|
| API 按量计费 | 用真实模型单价 × token 数（价格表见 Pricing.swift） |
| 订阅制（有周配额） | 周费用 = 月费 ÷ 4.35；某项目占本周配额 4%，即花了周费的 4% |
| 订阅制（积分制席位） | 积分上限的 1% = 上限 ÷ 100，按占比折算 |
| 无滚动限额的套餐 | 把月费平摊到当月 token 上，按项目 token 占比分摊 |
价格表每天自动从公开渠道刷新（无需 API key），并自动换算成你 Mac 的区域货币；离线时使用内置兜底价格 prices-default.json。套餐档位会自动从登录信息中检测，也可以在设置里手动覆盖月费。
在界面上找到这些数据
- 悬停卡片：最多展示 5 行项目消耗（CostSection.swift），支持"今天 / 本周 / 本月"切换；
- Activity 窗口：完整时间线视图，含每日 token 图表与项目汇总（ActivityWindow.swift）；
- 模型驱动：每一行数据如何从配额采样变成"项目 → 占比 → 金额"，可以看 CostModel.swift 的注释，写得相当清楚；
- 测试覆盖：相关行为均有单测，如 CostTests.swift，方便你确认口径。
常见疑问
Q：支持哪些工具？目前成本归因覆盖 Claude Code 与 Codex 的本地转录；Cursor、Antigravity 等其他提供商照常享有配额监控（详见 Sources/Providers/）。
Q：会上传我的代码或对话吗？不会。索引只在本机 SQLite 中完成，路径位于~/Library/Application Support/Codenotch/costs/，token 内容不落地。
Q：费用数字是账单吗？是估算值。对订阅用户，它回答的是"这笔月费被谁用掉了"，帮助你决定把算力投向哪个项目。
小结
配额监控回答"还有多少"，成本归因回答"被谁吃掉"。Codenotch 用本地索引 Claude / Codex 会话的方式，把每个项目的配额占比和折算金额钉在刘海旁——当你的 AI 账单再次暴涨时，答案一眼可见。
【免费下载链接】codenotchA macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge.项目地址: https://gitcode.com/gh_mirrors/co/codenotch
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
