CostHQ：给AI编程的成本装上”保险丝”，超支自动熔断

你有没有过这种经历——AI 编程助手跑了 45 分钟，改了 15 个文件，提交了 4 次代码，结果你完全不知道它烧了你多少钱？

等到账单来的时候才发现：这个月 Claude API 支出怎么比上个月多了 3 倍？

CostHQ 就是来解决这个问题的。它是一个 AI 编程成本的「防火墙」，不只是记账，还能主动把你的支出上限锁死。

它到底能干什么？

1. 主动熔断，超支自动停
给每个任务设一个硬上限（比如 $5），当 Agent 快要超标的时候，CostHQ 直接把请求掐掉，而不是让你收到账单才发现已经爆了。官方的说法是「Margin Firewall」——就像你家的保险丝，烧断了才能保护整条线路。

这对那些容易跑进死循环的 autonomous agent 特别重要——你肯定不想看到自己的 GPT-4o 被一个 while(true) 循环跑了一整晚。

2. 语义缓存，同一个问题不付两次钱
同一个 prompt 第二次发出去，CostHQ 直接从本地缓存里取结果返回给你，价格是 $0.00。这对于反复调试、反复提问的工作流来说，能省下不少银子。

3. 追踪到每个 session、每个 Agent
你可以给不同的 Agent 起名字（--agent "Code Review Bot"），这样就能知道「代码审查 Bot」花了多少，「数据管道 Bot」花了多少。多人协作的时候也能分清楚钱都花哪儿去了。

4. 实时 Dashboard
跑一下 cs dashboard，就能在浏览器里看到所有 session 的成本、用量、每日趋势图。数据全存在本地 SQLite，完全隐私。

5. 跟 OpenClaw / Claude Code 无缝集成
只要装好 CLI，装好对应的 Skill，Agent 会自动开始追踪——你基本不需要手动做什么。

怎么用

第一步：安装

# 安装 CLI
npm install -g costhq

# 如果你用 OpenClaw，装 Skill
clawhub install codesession

（需要 Node.js 18+，以及 C/C++ 构建工具，Linux 上 sudo apt install build-essential python3，macOS 上 xcode-select --install）

第二步：开一个任务

cs start "修复用户认证 bug" --close-stale --json

第三步：让 AI 跑任务，文件变更和 git 提交会自动追踪。

第四步：结束任务，看花了多少钱

cs end -n "认证完成，测试全部通过" --json
# 输出：Session: 47m • 15 files • 4 commits • $8.47 AI cost

第五步：打开 Dashboard 看详细数据

cs dashboard
# 浏览器打开 http://localhost:3737

适合谁用

• 独立开发者 / bootstrapped SaaS 创始人：你需要对 API 成本有清醒的认知，不能被一张意外账单干趴下
• 团队管理者：想知道每个 AI Agent 到底花了多少钱，特别是在做 A/B 测试或并行实验的时候
• AI 编程爱好者：就是想知道每次让 Claude Code 干活的时候，token 都烧去哪儿了

免费版可以管理 1 个本地 Git 项目，Pro 版解锁无限项目 + 语义缓存 + 团队预算管控。

小结

CostHQ 做的事情其实很简单：让你看见钱花在哪里，并且确保钱不会花超。对于现在动不动就几十、上百美元一个月的 AI API 账单来说，花 5 分钟装一个 CLI，换来的是心里有数和钱包安全，这笔账怎么算都划算。

GitHub: https://github.com/brian-mwirigi/CostHQ

GitHub: https://github.com/brian-mwirigi/CostHQ