Gemini CLI

Gemini CLI Token 用量怎么查?

Gemini CLI 几乎没有自带消耗统计,只能去 Google Cloud Console 看按天数据。这篇讲清官方途径的局限和怎么从本地日志补全画面。

我用 Gemini CLI 不算多——主要是 1M context 那个特性偶尔用一下,给它整个仓库让它分析。但每次用完都有一种"不知道自己烧了多少"的不安。

不像 Claude Code 有 /cost、Codex 有 codex usage,Gemini CLI 几乎是个统计盲区。这篇讲清现状。

自带的统计:基本没有

Gemini CLI 的当前版本没有自带的消耗查询命令。你跑 gemini --help 翻一遍 subcommands,找不到 usagecost 之类的入口。

每次模型调用结束之后,stderr 会简短打一行 Token 数:

[Gemini] tokens: input=234521, output=8932

但它只是打日志,不汇总、不持久化、不可查询。

唯一官方途径:Google Cloud Console

你想看 Gemini API 的真实消耗,唯一的官方途径是登录 Google Cloud Console,进 Vertex AI 或 AI Studio 的计量页。

它能告诉你:

  • 按 API key 的总 Token 数(按天)
  • 总费用(按月)
  • 模型分布(gemini-1.5-flash vs gemini-1.5-pro vs ...)

它告诉不了你:

  • 按 CLI session 拆分(Console 不知道你哪次调用是 CLI 跑的)
  • 按项目拆分(哪个项目最烧)
  • 哪些 Token 是"浪费"的(比如长上下文里没用上的部分)
  • 趋势对比(这周比上周高在哪)

而且 Console 的颗粒度刷新很慢——往往 24-48 小时之后才能看到准确数据。等你看到账单冒尖再优化已经晚了一两天。

一个被忽略的事实:本地日志

和 Claude Code、Codex CLI 一样,Gemini CLI 把会话信息也写在本地:

~/.gemini/sessions/<session-id>.json

每个 session 文件包含完整的输入输出和 Token 计数。只要有东西能解析这个目录,你就能在本地实时看自己的消耗。

我用的是 Vibe Usage——它原生支持 Gemini CLI 的本地日志格式,自动同步,零配置。装好之后 Gemini 跑过的每次会话立刻能在 Web 界面看到。

最有用的是它能把 Gemini 和我同时在用的 Claude Code、Codex CLI、OpenCode 的消耗放在同一个图里对比——我才意识到我用 Gemini 不算多,但每次用都是大上下文,单 session 平均消耗超过了 Claude Code。

Gemini 的特殊性:长上下文

Gemini 的招牌是 1M(部分版本到 2M)的上下文窗口。这意味着用 Gemini CLI 时,单次任务消耗很容易冲到几十万到几百万 Token。

我自己的真实数据:

  • 用 Claude Code 的会话中位数:约 100 万累计 Token(多轮)
  • 用 Codex CLI 的会话中位数:约 250 万累计 Token(Agent 循环)
  • 用 Gemini CLI 的会话中位数:约 50 万 Token(少轮但单次大)

Gemini 的会话次数少但单次贵。这种"低频高单价"的工具最容易让账单失控——因为你以为"我才跑了三次",但每次都几十万 Token。

一个具体优化

如果你用 Gemini CLI 主要是图它的长上下文,建议:

  1. 先用 Claude Code / Codex 做精确读取(5-10 个相关文件)
  2. 真的需要全局视角再切 Gemini(比如全仓库一致性检查、大规模代码迁移)

不要养成"反正 Gemini 1M 上下文便宜就一律用 Gemini"的习惯。Gemini 的单价不便宜,长上下文更不便宜——cached input 价格也不像 Claude / OpenAI 那样有 90% 的折扣。

怎么开始追踪

如果你用 Gemini CLI 频次不算高,每月几次到十几次——

把 Vibe Usage 装上看一眼。它免费,跑在本地,自动同步 Gemini 的会话日志。装上之后你的 Gemini 调用会和 Claude Code、Codex 等其他工具一起出现在统一面板里。

我个人的建议:这种"低频高单价"工具最值得装监控——因为偶发的大消耗最容易被忽略。等你某天看到 Google Cloud 账单 30 美元之后再问"我什么时候烧的"就晚了。

相关阅读

相关阅读

Gemini CLI Token 用量怎么查?