关于 Tare
Tare 分析本地编码 Agent 日志,估算 Token 成本并找出可避免的用量,还提供兼顾缓存的优化和成本凭据。它面向跟踪 Agent 用量的开发者,在本地运行,不上传数据,也不调用模型。
主要功能
- 01本地 Agent 日志成本分析
- 02Token 用量明细
- 03兼顾缓存的输出精简
- 04缓存状态与倒计时
- 05每次提交的成本凭据
- 06用于用量报告的 MCP 工具
适用场景
- 01按时间查看编码 Agent 成本
- 02查找重复或开销较大的上下文输出
- 03精简工具输出且不改写历史
- 04比较优化前后的每次提交成本
MCP 相关
Tare 可通过 stdio 作为 MCP 服务运行,并提供 `tare_wrapped`、`tare_receipt` 和 `tare_cache`。其 setup 命令可将 Tare 添加到检测到的 AI 编码应用中。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 1 天前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| days | number | 否 | 时间范围(天);0 表示全部时间。默认值为 30。 |
详细介绍
tare
完成相同工作,消耗更少令牌,还有凭据。
你的编码 Agent 会记录它发出的每次 API 调用。Tare 会读取这些日志,为每个令牌计价,并展示钱花在了哪里:Claude Code、Codex CLI、Gemini CLI,以及 VS Code 中的 Cline、Roo Code 和 Kilo Code,还有 Cursor、Windsurf 和其他基于 VS Code 的编辑器。对于 ChatGPT 计划中的 Codex,Tare 还会显示你距离计划用量上限还有多远。然后,它会在不破坏提示词缓存的前提下减少浪费,并用你自己的工作证明每一笔节省。它在本地运行,不会上传任何内容,也不会调用模型。
npx tarelab
YOUR AGENT, WRAPPED · last 30 days · 254 sessions · 79,905 API calls
$6,720 API-equivalent spend
$623 of it was avoidable (9%)
Where it went
Reading cached context ██████████████████████ $3,809
Writing to the cache ████████████ $2,072
Output (thinking incl.) █████ $838
The highlights
› ~82k tokens load before you type a word.
› Coffee-break tax: $722 re-caching after 636 pauses.
› Sub-agents spent $2,734 (41%).
Priberry 自己使用 Claude Code 的真实一个月记录。
命令
| 命令 | 功能 |
|---|---|
tare | 汇总最近 30 天的数据。--days N、--all、--json、--logs <dir> |
tare card | 生成可分享的 1200×630 卡片(SVG,附带 PNG 下载)和帖子文案。不会上传任何内容 |
tare fix | 安装输出精简功能和缓存状态行。--dry-run、--undo、--scope project |
tare receipt | 对比 tare fix 前后的每次提交成本,附带 90% 区间和完成率检查 |
tare status | 查看已安装的内容,以及输出精简功能目前削减了多少输出 |
tare setup | 将 Tare 添加到这台机器上的所有 AI 编码应用。--dry-run、--undo |
tare mcp | 通过 stdio 运行的 MCP 服务:tare_wrapped、tare_receipt、tare_cache |
数字的计算方式
- API 等效成本。 每次调用都按 Anthropic API 的公开价格计价:新输入、缓存写入(5 分钟缓存按输入价格的 1.25 倍计,1 小时缓存按 2 倍计)、缓存读取和输出。订阅采用固定费用;这里显示的是同样的工作通过 API 完成时的成本。
- 持续成本。 工具的输出会写入缓存一次,并在之后的每次调用中读取,直到对话被压缩。Tare 会按输出在上下文中保留的整个时长计费。
- 缓存重建。 如果提示词的大部分内容被重新写入缓存,而不是从缓存读取,Tare 会说明原因:空闲时间超过缓存有效期、切换模型、压缩,或中断。
- 重复内容。 工具调用返回的内容与 Agent 已有内容逐字节相同。
修复
Tare 会在浪费进入上下文时将其削减,并且绝不重写已有内容,因为重写历史会破坏提示词缓存,造成的成本会超过节省的成本。
- 输出精简(Bash 上的
PostToolUse钩子):超过约 2,500 个令牌的输出会被精简为前 40 行、所有看起来像失败的信息(附带上下文),以及最后 60 行。完整输出会保存到~/.tare/out/,并告知 Agent 文件位置。 - 缓存倒计时(状态行):显示缓存失效前的剩余时间,以及下一条消息在缓存可用和不可用时的成本。仅当你尚未设置状态行时才会安装。
设置会先备份到 ~/.tare/backups/,而 tare fix --undo 只会移除 Tare 添加的条目。
凭据
tare receipt 会比较修复前后各会话的每次提交成本,并提供 bootstrap 90% 区间,同时检查仍能完成提交的会话数量是否相同。如果任一侧已完成的会话少于 8 个,它会显示“数据不足”,不提供数字。
在你的 Agent 中使用
运行一条命令,即可将 Tare 添加到它找到的所有 AI 编码应用:Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Codex、Gemini CLI、Kiro、opencode、Amazon Q、LM Studio,以及 Cline、Roo Code 和 Kilo Code。条目会固定到确切版本,每个文件都会先备份,运行 --undo 即可移除。
npx tarelab setup
也可以一次配置一个应用:
- Claude Code 插件:
/plugin marketplace add priberry-data/tarelab,然后运行/plugin install tare@priberry。 - Gemini CLI 扩展:
gemini extensions install https://github.com/priberry-data/tarelab - 技能(Claude Code 或 Codex): 将
skills/tare复制到~/.claude/skills/或~/.codex/skills/。 - 任意 MCP 客户端:
{"command": "npx", "args": ["-y", "[email protected]", "mcp"]}。然后询问:“我的 Agent 这个月花了多少钱?”
限制
Tare 会读取 Agent 保存在你设备上的日志。Cursor 自带的 Agent、Windsurf 的 Cascade、Copilot 以及浏览器应用构建工具(Lovable、Bolt、v0、Replit)会将用量记录在自己的服务器上,因此 Tare 暂时无法查看;接下来将支持 opencode。Cline 系列的费用来自扩展自身记录的数据。fix 和 receipt 命令适用于 Claude Code,因为其中提供了钩子。工具输出的 token 数量根据文本长度估算(API 报告的是每次调用的总量,而非每个区块的数量)。Anthropic 的价格截至 2026-10-06,OpenAI 和 Google 的价格截至 2026-11-08,均记录在 src/prices.mjs 中。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。