# 在 Claude Code 里显示你的 llmapi.pro 套餐用量(5 小时 / 每周)

Claude Code 自带的 `/usage` 和用量条只对 **Anthropic 官方订阅(OAuth 登录)** 生效。
用 API key 接入第三方端点(比如 llmapi.pro)时，Claude Code 不会显示 5 小时 / 每周用量。

这里提供两种方式，把你在 llmapi.pro 的真实套餐用量显示在 Claude Code 底部状态栏，
数据来自 `https://api.llmapi.pro:99/v1/usage`（用你自己的 API key 查询，和网页控制台「我的套餐」完全一致）。

前提：你已经在用 Claude Code 接 llmapi.pro，即环境里有：
- `ANTHROPIC_BASE_URL=https://api.llmapi.pro:99`
- `ANTHROPIC_AUTH_TOKEN=sk-...`（你的密钥）

需要本机有 `node`（Claude Code 本身就依赖 Node，一般都有）。

---

## 方式 A：用我们的状态栏脚本（最简单，推荐，无需任何插件）

1. 下载 `llmapi-statusline.js` 到本机，例如 `~/.claude/llmapi-statusline.js`。
2. 在 `~/.claude/settings.json` 里加：
   ```json
   {
     "statusLine": { "type": "command", "command": "node ~/.claude/llmapi-statusline.js" }
   }
   ```
   （Windows 用绝对路径，例如 `node C:/Users/你的名字/.claude/llmapi-statusline.js`）
3. 重开 Claude Code。底部会显示类似：
   ```
   claude-sonnet-4-6  │  ultra  5h 9.7% █░░░░░░░░░ 582/6000 ⟳2h13m  7d 0.2% ░░░░░░░░░░ 18.8k/10M ⟳1d8h
   ```

脚本每 60 秒最多查一次（带本地缓存），查不到时用上次结果兜底，**永不让状态栏报错**。

---

## 方式 B：继续用 claude-hud（喂给它本地快照文件）

claude-hud 支持从本地快照文件读用量（`display.externalUsagePath`）。我们提供一个更新器
`llmapi-usage-snapshot.js`，按 claude-hud 要求的格式写快照。

1. 下载 `llmapi-usage-snapshot.js` 到本机，例如 `~/.claude/llmapi-usage-snapshot.js`。
2. 让它定期运行刷新快照。最简单用 Claude Code 的 **Stop hook**（每轮对话结束跑一次）。
   在 `~/.claude/settings.json`：
   ```json
   {
     "hooks": {
       "Stop": [
         { "hooks": [ { "type": "command", "command": "node ~/.claude/llmapi-usage-snapshot.js" } ] }
       ]
     }
   }
   ```
   （或用系统定时任务每 1–2 分钟跑一次，快照默认 5 分钟内有效）
3. 配置 claude-hud 指向同一个文件（`~/.claude/llmapi-usage-snapshot.json`）：
   ```json
   { "display": { "externalUsagePath": "~/.claude/llmapi-usage-snapshot.json" } }
   ```
4. 重开 Claude Code，claude-hud 的用量条就会显示你在 llmapi.pro 的 5h/周用量。

快照文件格式（脚本自动生成，无需手改）：
```json
{
  "updated_at": "2026-06-08T...Z",
  "balance_label": "llmapi ultra",
  "five_hour": { "used_percentage": 9.7, "resets_at": "2026-06-08T...Z" },
  "seven_day": { "used_percentage": 0.2, "resets_at": "2026-06-09T...Z" }
}
```

---

## 直接查用量接口（给脚本/面板用）

```
curl https://api.llmapi.pro:99/v1/usage -H "x-api-key: sk-你的key"
```
返回：
```json
{ "plan": "max5x",
  "five_hour": { "used": 120, "limit": 1200, "remaining": 1080, "reset_at": "...Z" },
  "week":      { "used": 900, "limit": 6000, "remaining": 5100, "reset_at": "...Z" } }
```