Claude Code 用量查询

快速查看 Claude Code API 使用量和额度信息。

功能说明

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

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

该命令会自动读取环境变量和配置文件中的 API 配置，无需手动输入。

使用方法

基础用法

# 查看 Claude Code 用量
npx aihezu usage cc
 
# 或使用完整名称
npx aihezu usage claude

无需 sudo 权限，普通用户即可运行。

输出示例

==================================================
=== Claude Code 用量统计 ===
==================================================

[查询中] 环境变量 - Token: ***ant-1234

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

日额度: $2.35 / $10.00 (23.5%) [████░░░░░░░░░░░░░░]
日剩余: $7.65

窗口:   $0.15 / $1.00 (15.0%) [██░░░░░░░░░░░░░░░░]
窗口剩余: $0.85

查看所有服务用量

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

npx aihezu usage

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

JSON 格式输出

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

npx aihezu usage cc --json

输出示例：

{
  "Claude Code": [
    {
      "source": "环境变量",
      "origin": "https://cc.aihezu.dev",
      "stats": {
        "currentDailyCost": 2.35,
        "dailyCostLimit": 10.00,
        "currentWindowCost": 0.15,
        "rateLimitCost": 1.00
      }
    }
  ]
}

配置来源

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

环境变量
- ANTHROPIC_BASE_URL
- ANTHROPIC_AUTH_TOKEN

配置文件 ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cc.aihezu.dev/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-ant-xxx"
  }
}

⚠️

如果同时存在环境变量和配置文件，且配置不同，会分别查询两个账号的用量。

进度条说明

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

█ 已使用额度
░ 剩余额度

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

额度提醒

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

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

常见问题

提示"未配置"

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

sudo npx aihezu install

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

Token 显示格式

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

查询失败

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

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

请检查配置并稍后重试。