☰
让AI自己盯开销:把CodeBurn MCP Server接入Claude Code,会话中实时追问Token去向
2026/10/1 23:29:07 网站建设 项目流程

让AI自己盯开销:把CodeBurn MCP Server接入Claude Code,会话中实时追问Token去向

【免费下载链接】codeburnFree, local tool to track AI coding token usage and cost across 37 tools and agents (Claude Code, Cursor, Codex, Gemini and more), by model, project, and task. npx codeburn项目地址: https://gitcode.com/gh_mirrors/co/codeburn

还在为 AI 编码账单"只看到总数、看不清去向"而头疼?CodeBurn 是一个免费、本地运行的开源工具,可以追踪 Claude Code、Cursor、Codex、Gemini 等 37+ 款 AI 编码工具的Token 用量与花费,并按模型、项目、任务拆解。更妙的是,它内置了一个CodeBurn MCP Server——把它接入 Claude Code 后,你只需在对话里问一句"我这周 Token 都花哪了",AI 就会直接调用本地数据,实时给你一份账单分析报告,还能顺手指出哪些钱白花了。

什么是 CodeBurn MCP Server?为什么值得接?

CodeBurn 通过读取各 AI 工具留在本地磁盘上的会话文件来统计开销,不需要包装器、代理或 API Key,数据永远不离开你的机器。

而 MCP(Model Context Protocol)的作用,是把这份"本地账本"变成 AI 能直接调用的工具。接入后,Claude Code 在你写代码的间隙就能回答两类问题:

  • 花哪了?(usage & cost,按工具/模型/项目/任务拆分)
  • 怎么省?(savings:重试税、路由浪费、优化建议)

MCP 服务端的实现只有两个核心工具,代码非常清晰,可以看看 src/mcp/server.ts 中的createServer,以及入口命令定义 src/main.ts。完整设计思路见 docs/design/codeburn-mcp.md。

一键接入步骤:3 条命令把 MCP Server 装进 Claude Code

整个过程不到一分钟,前提是你的机器已安装Node.js 22.13+并至少有一款受支持的 AI 编码工具:

# 1. (可选)全局安装 codeburn,也可以直接用 npx npm install -g codeburn # 2. 一条命令注册 MCP Server(stdio 模式,本地常驻) claude mcp add codeburn -- npx -y codeburn mcp # 3. 在 Claude Code 会话中确认工具可用 claude mcp list

注册完成后,在 Claude Code 里正常聊天,就可以直接追问开销了。

💡 如果你用的是 Cursor 或其他支持 MCP 的客户端,只需配置一个 stdio 服务器:命令为npx,参数为-y codeburn mcp,效果完全一样。

两个内置工具:get_usage 快查账单,get_savings 深挖浪费

MCP 服务端暴露了两个只读工具(详见 src/mcp/server.ts),你不需要记参数,用自然语言提问即可,Claude Code 会自动选对工具:

📊 get_usage —— 快速看花费(秒级返回)

  • 时间范围:今天、近 7 天、近 30 天、本月、近 6 个月(最大窗口)
  • 拆分维度(by参数):按project/model/task/provider任选
  • 返回内容:总花费、调用次数、会话数、缓存命中率、一次通过率、Top 模型/项目

💰 get_savings —— 深度找浪费(更慢但更值)

  • 优化建议(optimize findings):每条建议带预估节省金额
  • 重试税(Retry tax):把已经失败重来的工作又付了一遍钱的部分
  • 路由浪费(Routing waste):如果当时用更便宜的模型本可以省下的钱

返回的表格由 src/mcp/tables.ts 渲染成 Markdown,Claude Code 拿到后能直接排版成报告给你。

会话里怎么问?这些句式直接抄

接入后,在 Claude Code 里这样问最自然:

  • "帮我看看今天的 AI 编码花费,按项目拆一下"
  • "这 7 天哪个模型最烧钱?缓存命中率多少?"
  • "帮我分析一下最近 7 天的节省机会,有没有重试税或路由浪费?"
  • "对比一下本月各项目花了多少,哪个项目会话数最多?"

一个小细节:MCP 服务端启动时会预热"今天"的数据,并且对相同参数的并发请求做合并,所以连续追问基本是秒回;而get_savings会跑一次更深的优化分析,稍慢一些,但它默认查"近 7 天"而不是最大的时间窗口,避免一次问太久。

隐私设计:项目名默认打码,路径绝不外泄

很多人担心:让 AI 读取本地数据,项目名会不会被带出去?CodeBurn 在 src/mcp/redact.ts 中做了默认脱敏:

  • 项目/会话名默认替换为稳定伪名(如project-1a2b3c),排序对比依然连贯
  • 只有 Claude Code 显式传入include_project_names: true时才返回真实名称
  • 绝对路径永远不会出现在返回数据中

换句话说,即使你把 MCP 配给云端 Agent,它也只能看到"某匿名项目花了 $12.30",看不到你磁盘上的任何路径。

小结

项目说明
安装claude mcp add codeburn -- npx -y codeburn mcp
工具get_usage(快查)+get_savings(省钱分析)
数据来源本地会话文件,不上传、不需要 API Key
隐私项目名默认哈希打码,路径永不暴露
环境要求Node.js 22.13+

把 CodeBurn MCP Server 接进 Claude Code 之后,"Token 都去哪了"不再是一个事后翻账单的麻烦事——它变成了对话里随手一问就能得到答案的普通问题。AI 写代码、AI 看账单,这套本地闭环大概是目前最省心的开销追踪方式了。🔥

【免费下载链接】codeburnFree, local tool to track AI coding token usage and cost across 37 tools and agents (Claude Code, Cursor, Codex, Gemini and more), by model, project, and task. npx codeburn项目地址: https://gitcode.com/gh_mirrors/co/codeburn

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询