在 Claude Code 和 CC Switch 里实时看余额
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
一个 API Key 调用 GPT、Claude、Gemini、DeepSeek、Kimi、GLM 等模型,国内直连、按 token 实付。