跳转到内容
CC Switch WikiUnofficial Community Wiki

cc-switch 用量查询不显示 / 查询失败

Quick fix

升级到最新版；官方额度需手动开启，供应商脚本检查接口地址与 HTTPS，余额显示问题自 v4.0 起修复。

Symptom

Section titled “Symptom”
报错原文
测试失败: Network error: error sending request for url (https://api.novita.ai/v3/user/balance)

Cause

Section titled “Cause”

cc-switch 3.x 的用量查询与统计功能在多个版本间反复出现回归：供应商查询脚本接口错误（如 Novita 官方预设指向不可用的 /v3/user/balance）、base_url 被强制要求 HTTPS（非 localhost 时直接拒绝）、官方账号额度默认改为手动开启、单套餐不显示 extra 字段、余额类不在小面板显示、每日汇总表为空等。维护者表示 3.x 用量统计 bug 较多，已在 v4.0 整体重做。

Fix

Section titled “Fix”

  1. 升级到最新版（v4.0 及以上），该版本重做了用量统计、额度展示和授权中心，修复了旧版大部分查询失败/不显示问题。

  2. 如果是官方 Claude 账号的额度不显示，在「用量查询」按钮里手动开启用量统计功能（3.16.3 之后默认关闭）。

  3. 如果是第三方供应商查询失败，检查用量查询脚本：确认接口地址可用（如 Novita 需改为 https://api.novita.ai/openapi/v1/billing/balance/detail），且 URL 必须使用 HTTPS（localhost 除外）。

  4. 如果用量面板为 0，尝试勾选「启用 Tool Search」；若使用 Windows MSI 离线升级后数据丢失，切换时间范围到 7d 或 30d 查看。

  5. 如果脚本配置后 extra 字段不显示，这是单套餐视图下的已知 bug，已在 v3.12.0 修复，请升级。

Affected Versions

Section titled “Affected Versions”
ToolClaude Code
Version3.14.1 - 3.20.3（v4.0 起修复）
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

本页汇总自 22 个真实 issue

FAQ

Section titled “FAQ”
为什么更新到 3.16.3 后额度统计不显示了？
官方账号的用量统计从 3.16.3 起改为手动开启，请在「用量查询」按钮里启用。
为什么测试和配置用量查询按钮灰掉了？
通常是供应商被误判为官方供应商，尝试重新添加该供应商。
为什么 HTTP 的 base_url 无法做用量查询？
旧版本强制要求 HTTPS（localhost 除外），这是安全限制，v4.0 已调整。
余额类供应商为什么在小面板上不显示用量？
v4.0 起已支持，托盘会显示“余额 8.99 CNY”这样的文字。
离线升级 Windows MSI 安装包后用量统计清空了怎么办？
尝试切换时间范围到 7d 或 30d，若仍为空可能是 bug，需反馈。

相关问题

Section titled “相关问题”
模型列表为空，Codex 无法选择 DeepSeek 模型升级到 CC Switch 4.0 后重新应用 DeepSeek 预设；Codex 桌面端的模型列表显示也受其自身版本支持情况影响。5 issues merged无法解析apiKey和baseUrl变量在自定义用量查询模板中使用 `{{ apiKey }}` 或 `{{baseUrl}}`，并测试 `isValid: false` 是否被正确判为失败。2 issues mergedDeepSeek 接入 cc-switch：Codex 深度集成功能请求这是 DeepSeek 深度接入 Codex 的功能请求；原帖尚未提供可验证的解法，关闭状态不能证明已实现。1 issues merged

这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。