# 在 Claude Code 和 CC Switch 里实时看余额

> 不用打开控制台也能看 WanAPIs 余额:Claude Code 装一个开源状态栏插件就会自动显示,CC Switch 粘贴一段脚本即可,只需要你已经配好的 sk- Key。也可以直接调用 OpenAI 兼容的余额接口。

网页版:https://wanapis.com/docs/balance

WanAPIs 支持 new-api / one-api 通用的 OpenAI 兼容余额接口(/v1/dashboard/billing/subscription),只用 sk- 开头的 API Key 就能查,不需要另外生成访问令牌。很多 Claude Code / Codex 周边工具都认这个接口,配好后余额会一直显示在你干活的地方。查询不调用模型、不扣费,数字与控制台「钱包」页一致。

## 接入步骤

### 1. 先用一条命令确认能查到

把 sk-xxx 换成你的 Key,在终端执行。返回里的 balance 是剩余额度,hard_limit_usd 是累计总额度(已用 + 剩余)。

**终端**

```
curl https://api.wanapis.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer sk-xxx"

# 返回示例
{"object":"billing_subscription","has_payment_method":true,"soft_limit_usd":125.5,"hard_limit_usd":125.5,"system_hard_limit_usd":125.5,"access_until":0,"balance":23.8}
```

### 2. Claude Code:装状态栏插件,余额自动出现

开源插件 claude-statusbar(GitHub: leeguooooo/claude-code-usage-bar,MIT 协议)会用 Claude Code 里已经配好的 ANTHROPIC_BASE_URL 和 Key 自动找到余额接口,在底部状态栏显示剩余额度,每 5 分钟刷新一次,不用做任何额外配置。装完重启 Claude Code 即可。

**安装(需要 Python;也可以用 uv tool install 或 pipx install)**

```
pip install claude-statusbar
cs --setup
```

### 3. CC Switch:在「用量查询」里粘贴脚本

Claude Code 和 Codex 的供应商都适用。鼠标悬停在 WanAPIs 供应商卡片上,点「用量查询」(📊 图标)→ 打开「启用用量查询」→ 模板选「自定义」→ 把下面整段粘进去 → 点「测试脚本」,能看到余额就保存。脚本里的 {{apiKey}} 会自动换成这个供应商配置的 Key,不用手填。「自动查询间隔」建议设 5 分钟。

**CC Switch → 用量查询 → 自定义**

```
({
  request: {
    url: "https://api.wanapis.com/v1/dashboard/billing/subscription",
    method: "GET",
    headers: {
      "Authorization": "Bearer {{apiKey}}",
      "User-Agent": "cc-switch/1.0"
    }
  },
  extractor: function (response) {
    if (response.error) {
      return { isValid: false, invalidMessage: response.error.message };
    }
    return {
      remaining: response.balance,
      used: response.hard_limit_usd - response.balance,
      total: response.hard_limit_usd,
      unit: "CNY"
    };
  }
})
```

## 常见问题

### 查到的是账户余额,还是这把 Key 的额度?

默认创建的 Key 不限额度,查到的就是账户余额。如果你在控制台给这把 Key 设了额度上限,查到的是这把 Key 自己还剩多少,这样把 Key 分给别人时不会暴露整个账户的余额。

### 为什么控制台显示 $,这里显示 ¥?

WanAPIs 的额度按人民币计:充值 ¥1 = 1 额度。控制台里的 $ 只是符号,数字与这里完全相同。

### 查余额会扣费吗?

不会。余额接口不调用任何模型,不产生费用。

### 我用的工具不在上面,能接吗?

只要工具支持 new-api / one-api 的余额接口(/v1/dashboard/billing/subscription 和 /v1/dashboard/billing/usage)就能用,余额 = hard_limit_usd - total_usage / 100,或者直接读 balance。自己写脚本时请带上 User-Agent 请求头,Python urllib 的默认 User-Agent 会被拦截(403)。

### 想看每次调用花了多少?

余额接口只给总数。按模型、按时间的明细在控制台「使用日志」页,可以按 Key 和模型筛选。

---

本文由 WanAPIs 官网生成,和网页版内容同步。全部教程的 Markdown 目录:https://wanapis.com/docs/index.md
