cc-switch 配置用量查询失败 / 用量查询一直显示失败 / undefined / base_url 不能为空
Quick fix
升级到 v3.16.2+；仍失败时按 NewAPI 格式填写 base_url 和访问令牌，或关闭自动刷新/用量查询。
Symptom
Section titled “Symptom”配置用量查询失败后，一直显示查询失败该集群包含多类问题：早期版本存在 UI 崩溃、自动更新间隔被重置为 0、多个供应商共享同一份用量配置导致配置串改、自定义模板保存后回退为 NewAPI 模板，以及自定义脚本提示 base_url 不能为空。v3.16.1 修复了主界面“刷新用量”路径与配置页凭证解析不一致的问题；若升级到 v3.16.2 后仍失败，通常是上游接口格式、访问令牌或 base_url 配置不符合 NewAPI 要求，或上游本身不支持用量查询。另有未解决问题：QuickJS 提取器时区固定为 UTC，模型统计 Tokens 未计入 cache_read_tokens / cache_creation_tokens。
升级 cc-switch 到 v3.16.2 或更新版本；维护者确认主界面刷新用量的凭证解析问题已在 v3.16.1 修复。
如果仍然查询失败，按 NewAPI 格式重新配置用量查询：填写 base_url、header/访问令牌，不要只把 URL 写在自定义脚本里。
如果暂时不需要自动查询，关闭用量查询/自动刷新，避免“查询失败”提示持续显示。
如果提取器里使用 Date 显示重置时间，QuickJS 当前按 UTC 运行；临时手动加时区偏移，例如 new Date(timestamp + 8 * 3600 * 1000)。
Affected Versions
Section titled “Affected Versions”Toolcc-switch
Version3.8.2 起持续报告；v3.16.1 修复主界面刷新的凭证解析，建议升级到 v3.16.2 及以上
PlatformsWindowsLinux
Source Issues
Section titled “Source Issues”本页汇总自 18 个真实 issue
- #227请问为何查询额度失败，显示undefined
- #397用量自动更新失效
- #4183.9.0-1 版本 用量查询无法切换到自定义
- #495配置用量查询页面频繁出现这个报错
- #558升级到3.9.0,用例查询有2个问题
- #607本地环境检查，检查WSL有问题，导致用量统计不出来
- #626用量查询配置串了
- #650两个使用过程遇到的问题
- #660配置用量 编辑显示的不对
- #676成本统计及实时刷新问题
- #686官方Codex，使用量查询失败
- #1271配置用量查询失败后，一直显示查询失败
- #1372配置了用量查询无法看到使用情况
- #14423.12.X是否使用量统计功能不work了？
- #1636用量查询bug
- #1716用量统计失效
- #1780用量查询bug
- #1941Bug: QuickJS runtime uses UTC timezone, ignoring system local timezone
- 升级到新版后还是查询失败怎么办？
- 重新打开 issue，并提供 cc-switch 版本、配置方式和复现步骤；同时确认上游是否支持 NewAPI 格式用量查询。
- 自定义模板为什么保存后又变回 NewAPI/通用模板？
- 这是早期版本 bug，后续版本已修复；升级到新版后重新保存配置。
- 官方 Codex 为什么使用量查询失败？
- 维护者回复该场景需要上游适配，官方接口当时不支持。
- 模型统计 Tokens 为什么偏少？
- 当前统计只计算 input_tokens + output_tokens，未包含 cache_read_tokens 和 cache_creation_tokens，相关 issue 仍开放。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。