用量查询

不打开控制台也能看可用余额、今日 / 本周消费和调用次数。三种方式选一种：

浏览器插件：装进 Chrome，点工具栏图标查看
Agent 技能：在 Claude Code / Codex 对话里问「还剩多少余额」
CC-Switch 用量查询：已经用 CC-Switch 管理配置的，在供应商卡片上直接显示

三种方式查的都是当前 API Key 的用量，不是整个账户。最准确的明细（每次调用的模型、Token、扣费）以控制台使用统计为准。

浏览器插件

插件与 CodexZH 共用同一个，设置 API Key 时选择站点「CcodeZH」即可。工具栏图标角标显示可用余额，点开面板查看今日、本周、近 7 天的消费、调用次数与 Token，每分钟自动刷新。

CcodeZH 浏览器插件面板

安装只有 3 步

下载插件 → 解压文件 → 在 Chrome 加载解压后的文件夹

不要直接加载 .zip 压缩包，必须先解压。

第 1 步：下载并解压

下载浏览器插件

Windows：右键压缩包 → 全部解压缩，解压到不会随便删除的位置（如文档文件夹）
macOS：双击压缩包，自动解压出 codexzh 文件夹

打开 codexzh 文件夹，确认能直接看到 manifest.json。

第 2 步：加载到 Chrome

浏览器插件安装流程

地址栏输入 chrome://extensions/ 并回车
打开右上角「开发者模式」开关
点「加载已解压的扩展程序」，选择第 1 步解压出的 codexzh 文件夹
点 Chrome 右上角拼图图标，把插件旁边的图钉点上，固定到工具栏

第 3 步：选择站点并填写 API Key

点工具栏插件图标，再点面板右上角的钥匙按钮
站点选 CcodeZH
粘贴控制台里 sk- 开头的 API Key，点「保存」

面板显示「余额充足」和可用余额，说明已正常读取。图标颜色按余额分档：低于 $5 橙色，低于 $1 或用完红色。

注意站点

CodexZH 和 CcodeZH 的 Key 不通用。站点选错会提示「API Key 无效」。

常见问题

提示找不到 manifest.json：选错了文件夹，要选能直接看到 manifest.json 的那层。

提示「API Key 无效」：检查站点是否选了 CcodeZH、Key 前后是否多了空格、Key 是否已在控制台轮换或禁用。

Chrome 提示「开发者模式扩展」：手动安装的插件都会出现这个提示，可以继续使用。

更新插件：下载新版解压后覆盖原文件夹，在 chrome://extensions/ 点插件的刷新按钮。

隐私：API Key 存在浏览器本地，不会同步到 Google 账号。插件只请求 ccodezh.com 和 codexzh.com 的用量接口，不发起模型调用。

Agent 技能

装好后在 Claude Code 或 Codex 里直接问「还剩多少余额」「今天用了多少」「这周哪个模型最费钱」，Agent 会调用技能查询并回答。零依赖，只需 Node.js 20+。

让 AI 自己装

启动 Claude Code，把下面这段提示词完整粘贴进去：

帮我安装 CcodeZH 的用量查询技能，教程在 https://docs.codexzh.com/claude-code/usage

技能包下载地址：https://ccodezh.com/downloads/ccodezh-usage.zip

请你：
1. 判断我现在用的客户端。Claude Code 的技能目录是 ~/.claude/skills/，Codex 的是 ~/.agents/skills/。目录不存在就创建。
2. 下载压缩包并解压到技能目录，确认结构是 <技能目录>/ccodezh-usage/SKILL.md，不要多套一层文件夹。
3. 检查 ~/.claude/settings.json 的 env.ANTHROPIC_BASE_URL 是否指向 ccodezh。是的话会自动复用里面的 Key，跳过这步；否则创建 ~/.ccodezh/config.json，内容是 {"apiKey": "sk-在这里填你的密钥"}，权限设成 600。
4. 装完列出技能目录确认文件到位，告诉我去哪里替换真实密钥，以及需要重启客户端才生效。

注意：不要编造 API Key，一律用占位符。

手动安装

下载技能包

解压到技能目录：

bash

# Claude Code
mkdir -p ~/.claude/skills && unzip ccodezh-usage.zip -d ~/.claude/skills/
# Codex
mkdir -p ~/.agents/skills && unzip ccodezh-usage.zip -d ~/.agents/skills/

配置 API Key。按手动配置把 CcodeZH 写进 ~/.claude/settings.json 的，技能会自动复用，跳过这步。否则任选一种：

bash

# 方式一：环境变量
export CCODEZH_API_KEY=sk-xxx

# 方式二：配置文件
mkdir -p ~/.ccodezh && echo '{"apiKey": "sk-xxx"}' > ~/.ccodezh/config.json && chmod 600 ~/.ccodezh/config.json

重启 Claude Code / Codex

验证

在终端直接运行：

bash

node ~/.claude/skills/ccodezh-usage/scripts/usage.mjs stats

输出类似：

可用余额    $42.18
今日        $3.27   58 次调用   4,812,330 tokens
本周        $12.90   231 次调用   18,004,117 tokens
近 7 天      $15.42   276 次调用   21,550,902 tokens
累计消费    $186.35
Key 到期    永不过期

CC-Switch 用量查询

在 CC-Switch 里给 CcodeZH 供应商配置用量查询后，卡片底部会显示可用余额和今日消费。还没装 CC-Switch 的见 CC Switch 一键导入。

预设模板必须选「自定义」

CC-Switch 的「通用模板」「NewAPI」等预设模板要求查询地址和供应商的 base_url 同域名，会报错：

请求域名 ccodezh.com 与 base_url 域名 api.ccodezh.com 不匹配（必须是同源请求）

用量接口在 ccodezh.com，模型接口在 api.ccodezh.com，两者域名不同。选「自定义」模板就没有这个限制。

步骤 1：打开用量查询设置

鼠标悬停在 CcodeZH 供应商卡片上，点右侧的用量查询按钮（或「更多」→「配置用量查询」），打开「启用用量查询」开关。

打开用量查询设置

步骤 2：预设模板选「自定义」

预设模板选择自定义

步骤 3：填写提取器代码

把下方代码完整粘贴到提取器输入框。会被 CC-Switch 自动替换成这个供应商配置的 Key，不用改。点底部「测试脚本」，没问题再保存。

javascript

({
  request: {
    url: "https://ccodezh.com/api/v1/usage/stats?key={{apiKey}}",
    method: "GET",
    headers: {
      "Content-Type": "application/json",
    },
  },
  extractor: function (response) {
    const data = response?.success ? response.data : null;

    if (!data) {
      return {
        isValid: false,
        invalidMessage: response?.message || response?.error || "查询失败",
      };
    }

    const toNumber = (value) => {
      const n = Number(value);
      return Number.isFinite(n) ? n : 0;
    };
    const usd = (value) => `$${toNumber(value).toFixed(2)}`;
    const count = (value) => String(Math.round(toNumber(value))).replace(/\B(?=(\d{3})+(?!\d))/g, ",");

    const today = data.today || {};
    const week = data.week || {};
    const recent = data.recent || {};
    const unlimited = data.remainQuota === null || data.remainQuota === undefined;
    // 换算成北京时间 YYYY-MM-DD HH:mm（不依赖 Intl 时区支持）
    const expires = data.expiresAt
      ? new Date(Date.parse(data.expiresAt) + 8 * 3600000).toISOString().slice(0, 16).replace("T", " ")
      : "永不过期";

    return {
      isValid: !data.expired,
      invalidMessage: data.expired ? "API Key 已过期" : undefined,
      planName: "CcodeZH",
      unit: "USD",
      used: toNumber(today.used),
      remaining: unlimited ? undefined : toNumber(data.remainQuota),
      extra: [
        `可用余额：${unlimited ? "不限" : usd(data.remainQuota)}`,
        `今日消费：${usd(today.used)}`,
        `今日调用：${count(today.calls)}`,
        `本周消费：${usd(week.used)}`,
        `本周调用：${count(week.calls)}`,
        `近 7 天消费：${usd(recent.used)}`,
        `累计消费：${usd(data.totalUsed)}`,
        `Key 到期：${expires}`,
      ].join("\n"),
    };
  },
});

步骤 4：保存配置

点右下角「保存」，卡片底部会显示：

已使用（今日消费）和剩余（可用余额）
今日 / 本周 / 近 7 天消费与调用次数
累计消费、Key 到期时间

「自动查询间隔」建议 5 分钟以上。接口每个 Key 每分钟限 20 次，查询太频繁会提示「查询过于频繁」。

常见问题

提示「同源请求」不匹配：预设模板没选「自定义」，回到步骤 2。

提示「API Key 无效」：供应商里配的 Key 已在控制台轮换或禁用，更新供应商的 Key 后重新测试。

提示 404 或 Invalid URL：查询地址写成了 api.ccodezh.com，应为 https://ccodezh.com/api/v1/usage/stats。

用量查询 ​

浏览器插件 ​

第 1 步：下载并解压 ​

第 2 步：加载到 Chrome ​

第 3 步：选择站点并填写 API Key ​

常见问题 ​

Agent 技能 ​

让 AI 自己装 ​

手动安装 ​

验证 ​

CC-Switch 用量查询 ​

步骤 1：打开用量查询设置 ​

步骤 2：预设模板选「自定义」 ​

步骤 3：填写提取器代码 ​

步骤 4：保存配置 ​

常见问题 ​

用量查询

浏览器插件

第 1 步：下载并解压

第 2 步：加载到 Chrome

第 3 步：选择站点并填写 API Key

常见问题

Agent 技能

让 AI 自己装

手动安装

验证

CC-Switch 用量查询

步骤 1：打开用量查询设置

步骤 2：预设模板选「自定义」

步骤 3：填写提取器代码

步骤 4：保存配置

常见问题