CodeArts CLI用量不模糊：codearts stats把token和成本算得明明白白

一、为什么非要关心用量

用 AI 编程工具，最容易"糊里糊涂"：问了多少次、花了多少token、哪个模型最烧、哪个项目最费，全没概念。等月底一看账单才发现超支，或者 token 额度莫名其妙用完。

CodeArts CLI 自带stats命令，把这些数字直接摊在终端里，不用去控制台翻。而且它不是只有一个"总览"，官方给了一组子命令，能从时间、模型、工具、项目四个维度拆开看。下面逐个说。

二、stats 全家桶

最常用的是直接敲：

codearts stats

它会展示 token 用量、会话数、成本统计等总览。但真正有用的是后面这几个维度开关：

一个容易踩的坑（--project）

--project 必须在 Git 仓的根目录下执行（进入仓根目录，右键"在终端中打开"，再敲命令）。官方明确说了：若目标代码仓没有 Git 提交记录，系统会展示全部非 Git 仓项目的数据——也就是说它认的是 Git 仓，不是随便一个文件夹。我之前就踩过，在普通目录跑 --project 出来的是一堆别的仓数据，还以为出 bug 了，其实是没提交记录。

三、三个实战场景

光看命令没感觉，说几个我实际会用的场景。

场景 1：揪出最烧钱的模型

codearts stats --models

这命令会把每个模型的 token 消耗列出来。如果你像我一样，日常顺手都用旗舰大模型，偶尔才用轻量模型，一看明细就会发现：复杂任务确实该用强的，但"帮我写个 commit message""解释下这段报错"这种小事也走旗舰模型，纯属烧钱。

对策就是上一篇《模型管理与切换》聊的 codearts models 看可用模型 + -m 切模型：把日常轻量问题切到便宜模型，重活才上贵的。两个命令配合，效果最好。

场景 2：按项目分摊成本

如果你同时撸好几个项目（比如我这种主业 + 副业一堆），想知道钱花在哪：

cd /path/to/your/git/repo   # 先进 Git 仓根目录
codearts stats --project

每个仓单独看，谁最费一眼清。团队里要是多人共用额度，这个尤其好用，能公平算账。

场景 3：每周看趋势，防超支

codearts stats --days 7

我现在的习惯是周五下班前敲一次，看这周比上周涨了多少。一旦某天数字异常飙高（比如手滑让 AI 在超大文件上反复改），能马上意识到，而不是等月底爆雷。

四、和 models 命令联动

stats 告诉你"哪儿烧钱"，models 告诉你"还有哪些更便宜的能换"：

codearts models            # 看所有供应商的可用模型
codearts models huaweicloud-maas   # 只看华为云 MaaS 下的模型

先用 stats --models 定位烧钱大户，再用 models 找平替，最后 -m 切过去。这条"定位 → 选型 → 切换"的链路，比单纯喊"要省钱"实在得多。

五、小结

codearts stats 是个"润物细无声"的命令。它不改变你用什么功能，但让你对自己的使用状况心里有数。记住四个维度开关（--days / --models / --tools / --project），再配合 models 切模型，基本就把用量管明白了。建议每周敲一次，养成看数据的习惯——别等账单来教你做人。