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 RouterCCR中接入上游供应商之后如果你想在供应商列表、托盘或账号面板里看到账户余额、套餐额度和账号状态需要给这个供应商开启获取用量并把供应商用量接口返回的 JSON 字段映射到 CCR 的余额、订阅等指标上。供应商返回的字段结构各不相同直接保存前很容易把路径写错。下面的流程是在供应商表单里开启用量读取 → 选择用量模式 → 填写字段映射 → 用测试用量请求验证映射 → 在概览仪表盘确认余额组件有数据。前提供应商已经添加完成API 地址和 API 密钥可用浏览器请求模式仅在 CCR Desktop 可用。用量读取只影响账号用量展示不会影响模型是否能请求关闭后 CCR 不请求用量接口。开启用量读取并选择用量模式在供应商配置表单中打开获取用量开关然后从以下四种用量模式中选择来源供应商配置模式适用情况标准用量端点供应商已适配 CCR 标准账号端点例如/.well-known/ccr/account和/v1/account/limits或使用内置预设供应商HTTP JSON 请求供应商已有自己的余额或额度接口且返回自定义 JSON浏览器请求用量接口依赖网页登录态、Cookie 或 localStorage仅在 CCR Desktop 可用原始连接器 JSON直接编辑account.connectors数组适合更复杂的能力如果供应商按 CCR 标准格式提供账号接口或使用内置预设选标准用量端点即可不需要再填字段路径。本文主路径以HTTP JSON 请求为例因为它覆盖供应商返回自定义 JSON这一最常见情况。刷新间隔毫秒控制用量刷新间隔。未填写时使用默认刷新间隔最小有效间隔为 30000ms。填写 HTTP JSON 请求与字段映射HTTP JSON 请求模式下请求会附带供应商 API Key除非在 raw connector 中改成其他认证方式。需要填写的核心字段字段含义方法用量请求方法GET或POST用量请求 URL用量接口地址可以是完整 URL请求头用量接口需要的额外请求头。文档明确提醒不要在这里写固定的敏感认证头优先使用供应商 API Key 认证请求体POST请求体必须是合法 JSON余额剩余字段 / 余额总额字段 / 余额已用字段余额三个值在响应 JSON 中的路径余额单位例如USD、CNY或%订阅剩余字段 / 订阅上限字段 / 订阅重置字段套餐、订阅、tokens 或配额的剩余量、总量和重置时间路径。重置时间可返回 ISO 时间也可返回秒级或毫秒级时间戳订阅单位例如tokens、requests、hours状态字段账号状态路径支持ok、warning、critical、error、unsupported消息字段账号提示信息路径适合展示供应商返回的错误、套餐说明或风控提示字段路径使用 CCR 的轻量 JSONPath 语法支持以下写法写法说明$整个响应对象$.balance.remaining读取对象字段$.items[0].value读取数组下标$[weird-key]读取包含特殊字符的字段名$.limits[?(.typeTOKENS)].remaining在数组中查找第一个满足简单等值条件的对象100 - $.data.percentage数值字段支持简单减法表达式常用于把已用百分比转换成剩余百分比如果站点把 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。用测试用量请求验证字段映射保存前先验证映射是否写对点击测试用量请求。CCR 会立即请求一次用量接口并解析映射结果这是文档指定的在保存前验证字段路径的方式。测试成功后界面会列出响应字段即响应 JSON 中可选的字段路径。点击余额剩余、余额总额、余额已用、订阅剩余、订阅上限、重置时间可以把对应路径快速填入相应字段避免手写路径出错。映射无误后再保存供应商。走原始连接器 JSON模式时点击插入示例会填入一个包含standard、http-json、webcontent-json、plugin和local-estimate五种类型的示例 connector 数组可以基于示例改写。各 connector 类型的能力连接器类型能力standard使用 CCR 标准账号端点http-json请求一个 JSON 接口并用 mapping 字段映射余额、套餐、状态和消息webcontent-json使用 CCR Desktop 内置浏览器登录态执行浏览器侧请求并映射 JSON 响应plugin调用已安装插件注册的账号用量 connectorlocal-estimate不请求远程接口基于本地窗口配置展示估算额度导入本机 Agent 登录态Claude Code、Codex、ZCode的供应商会自动带上对应的账号用量读取Claude Code 导入使用 Anthropic OAuth 用量接口Codex 导入会读取 Codex 额度、余额和 token 统计接口ZCode 导入在 API 地址命中内置预设时复用对应预设的用量配置无需再手动映射。在概览仪表盘验证余额展示用量读取生效后到概览仪表盘查看结果来源概览仪表盘编辑布局时添加账户组件数据选择所有账户或指定账户内部配置值格式通常是provider或provider::credentialId。账户组件读取供应商配置里的账户 / 用量连接器展示的是连接器最近一次获取到的快照不按顶部按时间查看用量的时间窗口重算。要让它显示余额或剩余额度前提是供应商已启用并测试过获取用量。如果账户组件为空按文档给出的顺序检查供应商是否配置了账户 / 用量连接器获取用量测试是否成功API Key 或账户接口是否仍有效当前选择的指定账户是否已经被删除或重命名。托盘是另一个验证点把托盘小精灵设为余额进度条选择供应商账户和余额 / 套餐 / 额度数据作为进度来源来源托盘配置。如果页面提示暂无可用账户数据请先为供应商启用账户监控说明还没有供应商开启获取用量或用量读取尚未成功。限制说明获取用量只影响账号用量展示不影响模型请求能力关闭后不再请求用量接口。浏览器请求模式只在 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考