crs-usage 0.2.1

Query claude-relay-service usage and limits using your local Codex config

crs-usage

通过本地 Codex 配置查询 claude-relay-service 用量、限额、速率窗口与模型细分的 CLI。零依赖，单文件实现。

读 ~/.codex/config.toml 的 [model_providers.*]，按 provider 的 env_key 或 ~/.codex/auth.json 解析 API key，并发调用：

• {base_origin}/apiStats/api/user-stats — 累计用量、限额、速率窗口
• {base_origin}/apiStats/api/user-model-stats — 按 daily / monthly / alltime 拆分的模型细分

快速开始

最简单的方式（无需安装）：

uvx crs-usage

或直接从 GitHub 跑：

uvx --from git+https://github.com/kadaliao/crs-usage crs-usage

也可以装到本地工具集：

uv tool install crs-usage
crs-usage

用法

crs-usage [--provider NAME] [--key KEY] [--base-url URL]
          [--config PATH] [--auth PATH] [--json] [--timeout SEC]
          [--period {daily,monthly,alltime,all}] [--top N]
          [--no-models] [--wide]

常用参数：

• --provider <name> 只查指定 provider
• --key <key> --base-url <url> 跳过 codex 解析，直接查任意 CRS 实例
• --period <p> 模型细分时段，默认 all（同时拉 daily / monthly / alltime）
• --top N 文本输出每个时段展示前 N 个模型，默认 5；0 表示全部
• --no-models 关闭模型细分查询（只看用量/限额）
• --wide 文本输出使用完整数字（默认按 K/M/B 紧凑显示）
• --json 输出原始 JSON（含模型细分，适合 jq）
• --timeout <sec> HTTP 超时，默认 15

Key 解析优先级

1. --key 命令行参数
2. [model_providers.<name>].env_key 指定的环境变量（如 CRS_OAI_KEY）
3. ~/.codex/auth.json 中的 OPENAI_API_KEY

输出示例

■ aihezu  https://cc.aihezu.dev  key 来源 env:CRS_OAI_KEY
  Key: Kada  id=07825a09-37f3-46f7-b65f-847795eeb2f2  启用  永不过期

  📊 累计用量
    请求 72.9K    Tokens 5.56B    费用 $2,977.1663
    输入 438M / 输出 29.6M / 缓存创建 64.9M / 缓存读取 5.03B

  💰 限额
    今日费用  $9.1212 / $100.0000  (9.1%)
    总费用    $2,977.1663（无上限）
    速率窗口  未配置

  🧠 模型细分
    [今日]  3 个模型
      模型          请求  Tokens   输入/输出  缓存写/读     费用
      ────────────  ────  ──────  ──────────  ─────────  ───────
      gpt-5.5         89    5.7M  553K/42.3K     0/5.1M  $6.5654
      gpt-5.4         57    2.4M  497K/35.6K     0/1.9M  $2.2545
      gpt-5.4-mini     6    388K   384K/2.9K     0/1.0K  $0.3014
    [本月]  4 个模型
      ...
    [累计]  23 个模型
      ...
      （还有 18 个模型未列出，--top 0 显示全部）

默认输出按 K/M/B 紧凑显示数字，宽度控制在约 80 列内。需要原始整数时加 --wide。 key 配置了 rate limit 窗口时，「速率窗口」会显示窗口长度（自动按 Hh/m 换算）、剩余时间，以及当前窗口内的请求数 / Tokens / 费用与对应限额。

要求

• Python ≥ 3.11（依赖 stdlib tomllib，零第三方依赖）
• 一个本地 ~/.codex/config.toml 配置（或通过 --key --base-url 直接指定）

License

MIT