AI 编码 Agent 花了一大笔钱，但你完全不知道？Aireceipts 给每笔 token 开一份明细账单

场景：Agent 跑了几个小时，你到底花了多少钱？

你让 Claude Code 重构了一个大型模块，它跑了 20 分钟，调用了 300 多次工具，输出了几万行代码。重构很成功——但你的 API 账单上这 20 分钟到底花了多少钱？你完全不知道。

这不是个例。使用 Claude Code、Codex、Cursor 或 OpenCode 的开发者，普遍面临一个尴尬局面：Agent 干活的时候你看不到费用，账单出来的时候又跟具体任务对不上。

传统的成本追踪方式各有各的短板：

Aireceipts：每个 Agent 会话的「打车小票」

Aireceipts（Apache-2.0，TypeScript，npm 包 aireceipts-cli）做的事情很简单：在你用 AI 编码 Agent 工作时，实时显示费用；会话结束时，打出一张明细账单；提交 PR 时，把账单贴在 PR 上作为可追溯的成本记录。

数据全部本地计算，不上传。它读取的是 Agent 本地的会话日志（transcript），用公开的 API 单价计算可得的最小费用（observable Standard-API floor），而不是真实的账单金额——但这样足够让你知道每一轮对话「至少花了多少钱」。

十秒上手：npx aireceipts-cli

Aireceipts 不需要注册账号、不需要 API Key，安装也只是一行命令：

npm install -g aireceipts-cli

安装后用 aireceipts --demo 可以立刻看到一张演示账单——即使你还没有任何 Agent 会话：

aireceipts --demo

你会看到这样的输出：

- - - - - - - - - - - - - - - - - - - - - - - - -
                AIRECEIPTS
 "Add email format validation to the signup for…"
 Claude Code · Jun 18 2026 09:30:30 UTC · 10m 30s
    claude-opus-4-8 87% · claude-sonnet-5 13%
         cache served 85% of input tokens

Bash......................≥ $0.0517  (3 calls)
Edit......................≥ $0.0455  (2 calls)
(thinking/reply)..........≥ $0.0310  (2 turns)
Write.....................≥ $0.0290  (2 calls)
Read......................≥ $0.0192  (1 call)
--------------------------------------------------
TOTAL..............................≥ $0.1764
standard API-equivalent floor; not an invoice
same tokens on claude-haiku-4-5......≥ $0.0392
  (78% lower observable floor)
- - - - - - - - - - - - - - - - - - - - - - - - -
           npx aireceipts-cli
    github.com/anandgupta42/receipts
- - - - - - - - - - - - - - - - - - - - - - - - -

这个账单告诉你的不仅是「花了多少钱」，还有：

• 哪个模型花了多少比例（Opus 87% vs Sonnet 13%）
• 缓存节省了多少（cache served 85% of input tokens）
• 每种工具花了多少钱（Bash 调用 3 次花了 $0.05，Edit 2 次花了 $0.045）
• 如果换成便宜模型要多少钱（用 Haiku 只需要 $0.039）

核心功能：从实时仪表盘到 PR 追溯

1. 实时仪表盘：边跑边看

在你用 Claude Code 工作时，Aireceipts 可以在状态栏显示实时费用。配置只需一行：

// ~/.claude/settings.json
{
  "statusLine": {
    "type": "command",
    "command": "aireceipts statusline"
  }
}

之后每次 Claude Code prompt，你都会看到：

[aireceipts] Opus · ≥$4.20 · ≥$9/hr · 128k · ctx 42% · 5h 24% ↺2h13m

这个状态行从左到右告诉你：当前模型、已花费金额下限、每小时费率、已用 token 数、上下文窗口使用率、5 小时上限消耗比例及重置时间。如果 Agent 陷入重试循环，状态行还会出现模式标记——比如 Bash loop ×5，提示你可能在浪费 token。

2. 会话结束账单

每次 Agent 会话结束时，直接运行 aireceipts 就能看到这次会话的完整账单。支持多种输出格式：

aireceipts

aireceipts --mini

aireceipts --json

aireceipts --svg

--details 参数会额外展示 token 构成、会话形状和模型分拆明细——适合需要深度分析单次会话的场景。

3. PR 成本追溯

最有价值的功能之一：aireceipts pr --post 会把当前分支背后所有 Agent 会话的账单作为评论贴到 PR 上。

aireceipts pr --post

这样每次代码审查者打开 PR，不仅能看到 diff，还能看到这次改动的「成本标签」——用了哪些模型、调用了多少次工具、总计花费多少。费用可见带来了对 Agent 成本的直接感知，长期来看会倒逼开发团队优化 Agent 使用方式。

你还可以配置 CI 检查，强制要求每个 PR 都附带成本账单：

steps:
  - run: npx aireceipts-cli pr --check

4. 周报与账单对比

aireceipts week 生成过去 7 天的汇总：总花费、按 Agent 分类的花费、被标记的异常模式（重试循环、上下文抖动等）。

aireceipts week

aireceipts compare 可以对比两个会话：模型选择、工具使用、费用差异——当你怀疑「这次怎么比上次贵了这么多」时，直接对比两张账单就知道答案。

支持的 AI 编码 Agent

与同类工具对比

注意事项

• Aireceipts 展示的是 API 原始定价参考的最小费用下限（observable floor），不是真实的账单金额。折扣、缓存写入不完整定价、路由费用等都不在计算范围内。它用来做相对比较和感知，不是做审计。
• Codex CLI 的 trace 不包含缓存写入的详细信息，因此 Codex 会话的账单可能偏低。
• Cursor 的日志只提供会话级汇总，无法拆到逐轮明细。
• 所有数据从本地 Agent 日志直接解析——如果你清除了 Agent 的本地日志（Claude Code 的 .claude/sessions、Codex 的运行记录等），账单自然不可用。
• Aireceipts 默认收集匿名的诊断信息（运行时长、解析失败签名、功能枚举），可通过环境变量 AIRECEIPTS_TELEMETRY=off 关闭。

总结

Aireceipts 解决了一个看似简单但长期被忽视的问题：让 AI 编码 Agent 的费用变得可见。它不做精确计费（那是 API 提供商的事），而是让你在每一次会话结束时都能看到「这一轮至少花了多少钱、花在了哪里」。这种可见性本身就是一种优化——当你能在状态栏看到费用实时跳动，在 PR 上看到每一行代码背后的成本标签，你自然会开始思考怎么让 Agent 更高效地工作。

如果你同时使用多个 Agent（Claude Code + Codex + Cursor）、或者团队多人都在使用 AI 编码工具、或者你只是好奇自己到底花了多少钱——npx aireceipts-cli --demo 十秒钟就能给你答案。

相关链接：

• GitHub 仓库
• npm 包