Codex CLI 用量查询

快速查看 Codex CLI API 使用量和额度信息。

功能说明

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

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

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

使用方法

基础用法

# 查看 Codex 用量
npx aihezu usage codex

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

输出示例

==================================================
=== Codex 用量统计 ===
==================================================

[查询中] 配置文件 - Token: ***xyz-5678

域名: https://cc.aihezu.dev
来源: 配置文件

日额度: $5.20 / $20.00 (26.0%) [████░░░░░░░░░░░░░░]
日剩余: $14.80

窗口:   $0.30 / $2.00 (15.0%) [██░░░░░░░░░░░░░░░░]
窗口剩余: $1.70

查看所有服务用量

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

npx aihezu usage

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

JSON 格式输出

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

npx aihezu usage codex --json

输出示例：

{
  "Codex": [
    {
      "source": "配置文件",
      "origin": "https://cc.aihezu.dev",
      "stats": {
        "currentDailyCost": 5.20,
        "dailyCostLimit": 20.00,
        "currentWindowCost": 0.30,
        "rateLimitCost": 2.00
      }
    }
  ]
}

配置来源

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

环境变量 + 配置文件（base_url）
- 环境变量：AIHEZU_OAI_KEY
- 配置文件：~/.codex/config.toml 中的 base_url

配置文件

~/.codex/config.toml

base_url = "https://cc.aihezu.dev/openai"

~/.codex/auth.json
```
{
  "AIHEZU_OAI_KEY": "your-api-key"
}
```

⚠️

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

进度条说明

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

█ 已使用额度
░ 剩余额度

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

额度提醒

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

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

常见问题

提示"未配置"

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

sudo npx aihezu install

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

Token 显示格式

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

查询失败

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

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

请检查配置并稍后重试。

企业独立域名

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

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

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