Claude Code Router 怎么读取供应商账户余额与套餐额度并测试用量字段映射

Claude Code Router 怎么读取供应商账户余额与套餐额度并测试用量字段映射

【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router

在 Claude Code Router（CCR）中接入上游供应商之后，如果你想在供应商列表、托盘或账号面板里看到账户余额、套餐额度和账号状态，需要给这个供应商开启"获取用量"，并把供应商用量接口返回的 JSON 字段映射到 CCR 的余额、订阅等指标上。供应商返回的字段结构各不相同，直接保存前很容易把路径写错。下面的流程是：在供应商表单里开启用量读取 → 选择用量模式 → 填写字段映射 → 用"测试用量请求"验证映射 → 在概览仪表盘确认余额组件有数据。

前提：供应商已经添加完成，API 地址和 API 密钥可用；"浏览器请求"模式仅在 CCR Desktop 可用。用量读取只影响账号用量展示，不会影响模型是否能请求，关闭后 CCR 不请求用量接口。

开启用量读取并选择用量模式

在供应商配置表单中打开"获取用量"开关，然后从以下四种用量模式中选择（来源：供应商配置）：

如果供应商按 CCR 标准格式提供账号接口（或使用内置预设），选"标准用量端点"即可，不需要再填字段路径。本文主路径以"HTTP JSON 请求"为例，因为它覆盖"供应商返回自定义 JSON"这一最常见情况。

"刷新间隔（毫秒）"控制用量刷新间隔。未填写时使用默认刷新间隔，最小有效间隔为 30000ms。

填写 HTTP JSON 请求与字段映射

"HTTP JSON 请求"模式下，请求会附带供应商 API Key，除非在 raw connector 中改成其他认证方式。需要填写的核心字段：

字段路径使用 CCR 的轻量 JSONPath 语法，支持以下写法：

如果站点把 access token 存在localStorage、用量接口依赖浏览器登录态，则改用"浏览器请求"模式（底层是webcontent-jsonconnector）。该模式不携带供应商 API Key，请求从"浏览器存储 Origin"在 CCR 内置浏览器中执行fetch，并通过${localStorage.key}这类请求头模板注入 token。文档给出的 raw connector 示例（字段值仅为文档示例，需按你的供应商替换 endpoint、loginUrl 和映射路径）：

{ "type": "webcontent-json", "endpoint": "https://api.vendor.example.com/account", "browser": { "credentials": "omit", "loginUrl": "https://vendor.example.com/login", "partition": "built-in-browser", "requestOrigin": "https://vendor.example.com", "headerTemplates": { "authorization": "Bearer ${localStorage.accessToken}" } }, "mapping": { "meters": [ { "id": "balance", "kind": "balance", "label": "Balance", "remaining": "$.balance.remaining", "unit": "USD" } ] } }

其中credentials的取值规则：认证通过 token 请求头发送且 API 返回Access-Control-Allow-Origin: *时用omit；只有接口需要 Cookie 且服务端返回精确网站 origin 时才用include。若browser.credentials未配置，CCR 在配置了browser.headerTemplates时默认使用omit，否则保持面向 Cookie 场景的旧默认值include。

用"测试用量请求"验证字段映射

保存前，先验证映射是否写对：

1. 点击"测试用量请求"。CCR 会立即请求一次用量接口并解析映射结果，这是文档指定的在保存前验证字段路径的方式。
2. 测试成功后，界面会列出"响应字段"，即响应 JSON 中可选的字段路径。点击余额剩余、余额总额、余额已用、订阅剩余、订阅上限、重置时间可以把对应路径快速填入相应字段，避免手写路径出错。
3. 映射无误后再保存供应商。

走"原始连接器 JSON"模式时，点击插入示例会填入一个包含standard、http-json、webcontent-json、plugin和local-estimate五种类型的示例 connector 数组，可以基于示例改写。各 connector 类型的能力：

导入本机 Agent 登录态（Claude Code、Codex、ZCode）的供应商会自动带上对应的账号用量读取：Claude Code 导入使用 Anthropic OAuth 用量接口，Codex 导入会读取 Codex 额度、余额和 token 统计接口，ZCode 导入在 API 地址命中内置预设时复用对应预设的用量配置，无需再手动映射。

在概览仪表盘验证余额展示

用量读取生效后，到概览仪表盘查看结果（来源：概览仪表盘）：

1. 编辑布局时添加"账户组件"，数据选择所有账户或指定账户（内部配置值格式通常是provider或provider::credentialId）。
2. 账户组件读取供应商配置里的账户 / 用量连接器，展示的是连接器最近一次获取到的快照，不按顶部"按时间查看用量"的时间窗口重算。
3. 要让它显示余额或剩余额度，前提是供应商已启用并测试过"获取用量"。

如果账户组件为空，按文档给出的顺序检查：

1. 供应商是否配置了账户 / 用量连接器；
2. 获取用量测试是否成功；
3. API Key 或账户接口是否仍有效；
4. 当前选择的指定账户是否已经被删除或重命名。

托盘是另一个验证点：把托盘小精灵设为"余额进度条"，选择供应商账户和余额 / 套餐 / 额度数据作为进度来源（来源：托盘配置）。如果页面提示"暂无可用账户数据，请先为供应商启用账户监控"，说明还没有供应商开启"获取用量"，或用量读取尚未成功。

限制说明

• "获取用量"只影响账号用量展示，不影响模型请求能力；关闭后不再请求用量接口。
• "浏览器请求"模式只在 CCR Desktop 可用，且用量接口响应仍须是 JSON，字段映射继续使用轻量 JSONPath；用量请求 URL 可以是另一个 origin，前提是目标 API 允许该网站 origin 跨域访问。
• 用量读取的刷新间隔最小有效值为 30000ms，低于该值的填写不生效。
• 凭据池中的"启用"开关控制单条凭据是否参与请求转发和用量读取，关闭后保留配置但不会被选中；凭据"名称"会出现在账号用量、日志和内部诊断里，建议写成可识别的用途或额度来源。
• 供应商通过ccr://provider深度链接导入时，usage_url、fetch_usage、usage_method、balance、subscription等参数可以随导入直接带上用量接口与字段路径（来源：一键导入供应商），导入后仍建议在表单里用"测试用量请求"复核一次映射。

【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router