Google Gemini 用量查询

快速查看 Google Gemini API 使用量和额度信息。

功能说明

ccusage 命令可以帮助你实时查看 Google Gemini 的 API 用量统计，包括：

• 日额度使用情况
• 日剩余额度
• 窗口限制使用情况
• 窗口剩余额度
• 直观的进度条显示

使用方法

基础用法

# 查看 Gemini 用量
npx aihezu usage gemini

输出示例

==================================================
=== Google Gemini 用量统计 ===
==================================================

[查询中] 环境变量 - Token: ***key-9012

域名: https://cc.aihezu.dev
来源: 环境变量

日额度: $3.80 / $15.00 (25.3%) [████░░░░░░░░░░░░░░]
日剩余: $11.20

窗口:   $0.25 / $1.50 (16.7%) [███░░░░░░░░░░░░░░░]
窗口剩余: $1.25

查看所有服务用量

如果你同时配置了多个服务，可以一次性查看所有用量：

npx aihezu usage

这会显示所有已配置服务（Claude Code、Codex、Gemini）的用量信息。

JSON 格式输出

如果需要程序化处理用量数据，可以使用 JSON 格式输出：

npx aihezu usage gemini --json

输出示例：

{
  "Google Gemini": [
    {
      "source": "环境变量",
      "origin": "https://cc.aihezu.dev",
      "stats": {
        "currentDailyCost": 3.80,
        "dailyCostLimit": 15.00,
        "currentWindowCost": 0.25,
        "rateLimitCost": 1.50
      }
    }
  ]
}

配置来源

命令会按以下顺序查找配置：

1. 环境变量

   • GOOGLE_GEMINI_BASE_URL
   • GEMINI_API_KEY

2. 配置文件 ~/.gemini/.env

   GOOGLE_GEMINI_BASE_URL="https://cc.aihezu.dev/gemini"
   GEMINI_API_KEY="your-api-key"

进度条说明

进度条使用不同的符号表示使用情况：

• █ 已使用额度
• ░ 剩余额度

同时会显示百分比和具体金额，帮助你直观了解额度使用情况。

额度提醒

系统会自动提示额度状态：

• [!] 接近上限 - 使用量超过 90%
• [!] 已超出限制 - 使用量达到或超过 100%

常见问题

提示"未配置"

如果显示未配置，请先运行配置命令：

sudo npx aihezu install

按提示选择 Gemini 并输入 API Key。

Token 显示格式

为了安全，命令会隐藏 Token 的大部分内容，只显示最后 8 位，例如：***key-9012

查询失败

如果遇到查询错误，可能的原因：

1. API Key 无效或已过期
2. 网络连接问题
3. API 服务暂时不可用

请检查配置并稍后重试。

企业独立域名

如果你使用的是企业独立域名，配置时请指定完整的域名：

sudo npx aihezu install --provider gemini --api your-org.aihezu.dev

这样配置后，ccusage gemini 会自动从你的企业域名查询用量。

与其他服务对比

ccusage 命令支持多个服务的用量查询：

更多帮助

查看完整的帮助信息：

npx aihezu usage --help