跳转到内容

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

Quick fix

先开启用量统计开关并检查供应商脚本与协议限制;官方统计需启用 Tool Search。

报错原文
测试失败: base_url 必须使用 HTTPS 协议(localhost 除外)

该 cluster 里用户反馈集中在 cc-switch 的“用量查询/使用统计”功能:升级后统计不显示、测试脚本失败、额度字段异常或统计为空。原因并不完全相同:部分版本中官方用量统计默认改为手动开启,或需要启用 Tool Search 才会显示;自定义供应商的用量查询依赖用户配置的请求 URL、extractor 返回字段、HTTPS/私有 IP 限制,以及供应商接口是否可用;另有统计范围、模型映射、会话目录识别等问题。维护者说明 cc-switch 的用量统计功能存在较多 bug,供应商侧数据应作为最终依据。

  1. 如果升级后导航菜单看不到使用统计,先打开“用量查询”按钮内的开关,确认官方用量统计已手动开启。

  2. 如果“设置 - 关于 - 用量信息”为 0,勾选启用 Tool Search 后重新查看用量信息。

  3. 如果“测试”和“配置用量查询”按钮灰掉不可点击,删除当前供应商并重新添加,避免被错误识别为官方供应商。

  4. 如果测试脚本提示 base_url 必须使用 HTTPS 协议,将 base_url 改为 HTTPS;localhost 场景除外,非 localhost 的 HTTP 地址会被限制。

  5. 如果是 Novita AI 用量查询失败,不要使用默认的 https://api.novita.ai/v3/user/balance,改用可用的 balance detail 接口。

    cc-switch 供应商用量查询脚本(Novita AI)
    ({
    request: {
    url: "https://api.novita.ai/openapi/v1/billing/balance/detail",
    method: "GET",
    headers: {
    Authorization: "Bearer {{apiKey}}",
    "Content-Type": "application/json",
    Accept: "application/json",
    "User-Agent": "cc-switch/1.0"
    }
    },
    extractor: function (response) {
    var raw = response.availableBalance;
    var units = Number(raw);
    if (raw === undefined || raw === null || !isFinite(units)) {
    return {
    isValid: false,
    invalidMessage: response.message || "Novita 返回缺少 availableBalance"
    };
    }
    return {
    isValid: true,
    planName: "Novita AI",
    remaining: units / 10000,
    unit: "USD"
    };
    }
    })
  6. 如果用量统计仍异常,切换到 7d 或 30d 范围查看,并以供应商后台的实际计费数据为准。

ToolClaude Code
Version3.14.1 - 3.19.1
PlatformsWindowsmacOS
为什么更新到新版后使用统计不显示了?
部分版本中官方用量统计改为手动开启,请在“用量查询”按钮里面开启;如果用量信息为 0,尝试勾选启用 Tool Search。
为什么“测试”和“配置用量查询”被禁用、灰掉?
可能是供应商被错误识别为官方供应商,重新添加该供应商通常可以恢复。
为什么 HTTP 形式的 base_url 无法进行用量统计?
用量查询曾限制私有 IP 和 HTTPS,非 localhost 的 base_url 需要使用 HTTPS;维护者表示过度防护会在后续版本移除。
cc-switch 里的模型统计和供应商计费不一致怎么办?
维护者说明 cc-switch 的用量统计目前 bug 较多,请以供应商那边的数据为准。
Claude 桌面版 Cowork 的会话会被统计吗?
已有 issue 指出当前统计主要扫描 ~/.claude/projects/,Cowork 会话不在该目录中,因此可能不会进入统计;该问题属于功能缺口/待支持项。

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