Appearance
浏览器插件用量查询
CodexZH 提供了一个 Chrome 浏览器插件。安装后，点击工具栏图标即可查看 API Key 的剩余额度、今日消费、本周额度和订阅到期时间，无需每次打开控制台。
安装只有 3 步
下载插件 → 解压文件 → 在 Chrome 加载解压后的文件夹
不要直接加载 .zip 压缩包，必须先解压。
第 1 步：下载插件
下载完成后，你会得到 codexzh-browser-extension.zip。
第 2 步：解压插件压缩包
Chrome 不能直接加载 .zip 文件，需要先解压。
- Windows：右键点击压缩包 → 选择全部解压缩 → 解压到不会随便删除的位置（如桌面或文档文件夹）。
- macOS：双击压缩包，系统会自动解压出一个文件夹。
解压后打开文件夹，确认里面包含以下文件：
text
manifest.json
popup.html
popup.js
background.js
usage.js选文件夹时要注意
加载插件时，要选择能直接看到 manifest.json 的那层文件夹，不是 .zip 压缩包，也不是外层目录。
第 3 步：打开 Chrome 扩展管理页面
先看一下完整安装流程：
在地址栏输入以下地址并按回车：
text
chrome://extensions/第 4 步：开启开发者模式
在扩展程序页面右上角找到"开发者模式"开关，打开它。
开启后，页面上方会出现"加载已解压的扩展程序"按钮。
第 5 步：加载插件文件夹
点击"加载已解压的扩展程序"，在弹出的文件选择窗口中，选择第 2 步解压出来的、包含 manifest.json 的文件夹。
加载成功后，扩展列表里会出现 CodexZH 插件。
第 6 步：固定到工具栏
- 点击 Chrome 右上角的拼图图标。
- 找到 CodexZH 插件，点击旁边的图钉按钮。
固定后，插件图标会常驻在工具栏。
第 7 步：填写 API Key
点击工具栏中的 CodexZH 插件图标，在弹出的面板中填写你的 API Key（以 sk- 开头），然后点击"保存并刷新"。
保管好 API Key
API Key 是你的使用凭证，不要截图发给别人，也不要粘贴到公开群聊或论坛里。
第 8 步：确认安装成功
配置成功后，插件面板中会显示：
- 实时可用额度 / 本周已用额度 / 周限额度
- 今日消费 / 今日调用量 / 总使用额度
- 订阅开始和到期时间
插件图标上出现绿色数字，说明已正常读取额度。
常见问题
提示找不到 manifest.json
选错文件夹了。重新点击"加载已解压的扩展程序"，选择打开后能直接看到 manifest.json 的那层文件夹。
点了插件但没有数据
通常是 API Key 有误或订阅已到期，请检查：
- API Key 是否以
sk-开头 - 前后是否多复制了空格
- 订阅是否仍然有效
Chrome 提示"开发者模式扩展"
正常现象。插件是手动安装的，不是从 Chrome 网上应用店安装的，会出现这个提示。来源是本文的下载链接，可以继续使用。
如何更新插件？
- 下载并解压新版插件压缩包。
- 打开
chrome://extensions/，找到 CodexZH 插件。 - 点击刷新按钮（如果是覆盖原文件夹）；或删除旧版后重新加载新版文件夹。
隐私说明
- API Key 存储在浏览器本地，不会同步到 Google 账号，也不会上传到服务器。
- 插件只请求 CodexZH 的用量查询接口，不会替你发起任何模型调用。