T3 Code用量分析实战：3个维度看懂AI编程Token成本与缓存节省
【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code
T3 Code 是一款开源的"Agent 控制面"工具，可统一管理你电脑上的 Claude Code、Codex、Cursor 等多个 AI 编程代理，并内置用量分析（Usage）页面：自动扫描各厂商 CLI 的本地会话记录，算出 Token 成本与缓存节省金额。
为什么需要用量分析？
AI 编程代理每天消耗大量 Token。很多用户按月订阅套餐，却从不清楚：
- 每个模型实际花了多少钱？
- 缓存（Prompt Cache）到底帮你省了多少？
- 哪个提供商（Claude / Codex）占比更高？
T3 Code 的 UsageService.ts 直接读取各提供商 CLI 自己的会话文件（而非仅统计经 T3 Code 发起的会话），因此连你在终端里手动跑的对话也被统计在内，数据覆盖完整。
维度一：时间维度 —— 24 小时到 90 天的用量趋势
用量页支持 4 个时间范围：
| 范围 | 图表粒度 | 适用场景 |
|---|---|---|
| 过去 24 小时 | 每小时 | 看今天的消耗节奏 |
| 7 天 | 每天 | 观察一周趋势 |
| 30 天 | 每天 | 月度成本复盘 |
| 90 天 | 每天 | 长期成本规划 |
核心逻辑在 usageAggregation.ts 中：每条记录会被折叠到(日期, 提供商, 模型)分桶中，并按你所在时区正确归日。官方说明见 docs/user/usage.md。
💡 小技巧：切换"成本 / Token"指标，顶部数字与图表会同步更新，刷新按钮会重新扫描所有已连接环境。
维度二：提供商维度 —— Claude 和 Codex 谁更贵？
用量页把 Codex 与 Claude Code 的活动合并展示，并给出：
- 提供商占比：每个提供商占总成本的百分比与 Token 数；
- 模型明细：按模型拆分的成本与 Token 排行，快速定位"烧钱主力"；
- 逐日对比表：每个时间段各提供商的横向成本对比。
相关实现位于 UsageProviderChart.tsx 与 usageProviders.ts。
维度三：成本与缓存维度 —— 看懂"缓存节省"
这是最容易被忽略、却最省钱的一个维度。
Token 分成三类计价（见 usagePricing.ts）：
| Token 类型 | 说明 | 计价方式 |
|---|---|---|
| 未缓存输入 | 每次都要完整发送的上下文 | 按全价输入费率 |
| 缓存读取 | 命中缓存的上下文 | 折扣价（如 Claude 大幅打折） |
| 缓存写入 | 首次建立缓存 | 溢价费率 |
| 输出 | 模型生成的内容 | 按输出费率 |
缓存节省 = 这些缓存 Token 若按全价计费的成本 − 实际成本，由cacheSavingsUsd()函数计算，直观告诉你 Prompt Cache 帮你省了多少钱。
其他几个值得知道的细节：
- 费率来源：采用 LiteLLM 社区维护的公开价格表，与 ccusage 工具同源，每天自动缓存一次，断网也能用；
- 优先采用官方账单：若会话记录中带有提供商上报的费用，则直接采用，不做估算；
- 诚实标注：无法确定代际的模糊模型名（如只写了"opus"）会被标记为"未计价"，而不是瞎猜，保证数字可信。
性能表现：扫描 1.4GB 会话只要几秒
会话文件是追加写入的，T3 Code 用(文件大小, 修改时间)做记忆化（见 usageScanCache.ts）：
- 冷启动扫描约 1.4GB 的 30 天会话，仅需2–3 秒；
- 之后的刷新只重解析有变化的文件，几乎瞬间完成；
- 扫描缓存最多保留 90 天，与界面最长范围一致。
快速上手
- 在终端执行
npx t3@latest免安装体验（需 Node.js 22.16+）； - 确保已安装并登录至少一个提供商 CLI（如
claude auth login或codex login）； - 打开 Web 界面的Usage页面，即可看到成本、Token、缓存节省三大板块；
- 用"7 天"范围 + "成本"指标，先建立你的成本基线，再逐周优化。
总结
用 T3 Code 的用量分析功能，三个维度即可摸清 AI 编程账单：时间维度掌握趋势，提供商维度看清占比，成本与缓存维度验证省钱空间。数据全部来自本机 CLI 的会话记录，隐私安全，且对任何使用方式（包括终端手动运行）都一视同仁地统计。
【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
