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

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

接入步骤

  1. 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. 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. 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

一个 API Key 调用 GPT、Claude、Gemini、DeepSeek、Kimi、GLM 等模型,国内直连、按 token 实付。