Claude Code Router 怎么配置凭据池多上游 Key 轮换、优先级权重与本地限额【免费下载链接】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当你的团队或高频调用场景只有一个上游供应商但手里握着多条 API Key不同账户、不同额度来源时单 Key 的API 密钥字段不够用了。Claude Code RouterCCR在供应商配置里提供了“凭据池”把多条上游 Key 配在同一个供应商下CCR 会把启用的凭据展开成多个内部上游目标按你设置的优先级、权重在 Key 之间轮换并按本地限额规则自动跳过已触顶的 Key。本文基于 CCR 文档讲清从添加供应商到配好凭据池、再到验证轮换生效的完整操作路径。准备条件CCR 已启动能打开管理界面。CCR 支持桌面应用、Node.js 22 的 npm CLI 和 Docker 三种发行方式桌面端管理地址为应用内窗口npm CLI 默认为http://127.0.0.1:3458模型网关在http://127.0.0.1:3456安装方式详见 快速开始。你手头有同一供应商签发的多条 API Key。注意只填写由当前 API 地址对应供应商签发的 Key。如果你希望请求日志里看到凭据分布需要先在设置 → 日志与观测打开请求日志日志与可观测性。第一步添加供应商凭据池挂在供应商下面所以先建供应商接入供应商进入供应商页面点击添加供应商。在选择 预设供应商中选择内置预设预设会自动填入常见的 API 地址、协议和图标如果服务不在预设里选择其他 / 自定义 API 地址并填写名称和API 地址。在添加凭据步骤可以先填一条API 密钥。填写 API 地址和密钥后CCR 会自动探测该端点支持的协议与可用模型。注意主表单的API 密钥只是“默认供应商凭据”没有配置凭据池时模型请求用这条 Key协议探测、模型探测、连通性检测和默认用量读取也会用它一旦配置了凭据池CCR 会优先使用凭据池中的 Key这条主表单 Key 退居为单 Key 配置。第二步展开凭据池并添加 Key在供应商表单的高级设置中展开凭据池guides 里也描述为“在凭据步骤切换到凭据池”。凭据池的核心字段如下完整说明见 供应商配置字段用途添加 Key新增一条上游 API Key启用控制单条凭据是否参与请求转发和用量读取。关闭后配置保留但该 Key 不会被选中名称凭据显示名会出现在账号用量、日志和内部诊断里建议写成可识别的用途或额度来源方便之后在请求日志里辨认API 密钥该凭据实际发送给上游的 KeyKey 高级选项展开单条凭据的调度和限额字段优先级、权重、限制 JSON导入 JSON从 JSON 文件批量导入凭据支持顶层数组或对象中的credentials、keys、apiKeys数组移除删除当前凭据行逐条点添加 Key是主路径如果 Key 数量多用导入 JSON批量导入更省事导入结构示例{ credentials: [ { name: team-a, apiKey: sk-... }, { name: team-b, apiKey: sk-... } ] }顶层直接写数组、或用keys/apiKeys作为数组字段名同样是文档支持的写法sk-...需替换为真实 Keyname是凭据名称。给每条凭据起一个能区分用途的名称值得花一分钟后面在请求日志里按凭据筛选时靠的就是这个名字。第三步设置优先级与权重展开某条凭据的Key 高级选项可以设置两个调度字段优先级数字越小越优先。未填写时按凭据行顺序作为优先级。权重同优先级、相近使用率下的排序权重数字越大越优先。未填写时为1。一个典型排法把额度最充足、最稳定的 Key 放在最前或显式给更小的优先级数字把备用 Key 排在后面这样日常流量集中在主 Key 上主 Key 触顶或被跳过时再轮到后面的 Key。第四步为单条 Key 配置本地限额同一批 Key 里如果有的有速率限制、有的有每日额度用限制 JSON给每条 Key 单独设本地限额。CCR 会按请求、tokens 或图片数量统计窗口使用量达到上限后自动跳过该 Key尝试同供应商的其他可用 Key。限制 JSON支持的常用字段字段含义rpm/rph/rpd每分钟 / 每小时 / 每天最多请求数tpm/tph/tpd每分钟 / 每小时 / 每天最多 tokensipm/iph/ipd每分钟 / 每小时 / 每天最多图片数maxRequestswindowMs自定义时间窗口内最多请求数maxTokensquotaWindowMs自定义时间窗口内最多 tokens文档给出的示例{ rpm: 60, tpm: 100000 }表示该 Key 每分钟最多 60 次请求、每分钟最多 100000 tokens。限额是 CCR 本地统计的窗口规则达到上限后这条 Key 被跳过不影响同供应商其他可用 Key 继续转发。验证轮换与限额是否生效两个验证手段都来自文档检测连通性。填好凭据和模型后点击检测连通性CCR 会用当前 API 地址、密钥、协议和所选模型发送一次真实请求确认整条链路可用。检测请求会限制输出长度但仍可能产生额外 token 消耗或计入供应商侧请求次数建议只在弹窗中勾选需要确认的模型不要一次性检查全部模型。检测结果只用于诊断连通性不会自动修改模型列表。请求日志按凭据筛选。保存供应商后发起若干请求到请求日志里按凭据筛选确认轮换符合预期。请求日志记录每条模型请求最终命中的供应商、模型、凭据、状态码、耗时、token 等字段日志页支持按状态、供应商、模型、凭据、请求 ID、模型名、请求体或响应体筛选日志与可观测性。多 Key 场景下重点看每条请求命中的凭据分布是否与你的优先级/权重设置一致给某条 Key 配了限额后也可以在日志里观察该凭据在窗口触顶后是否不再被命中。边界与注意事项凭据池 ≠ 客户端 API Key。凭据池是“上游 Key 池”控制 CCR 调用供应商时用哪条 Key“API 密钥”页面里的 CCR 客户端访问 Key 控制的是客户端访问 CCR 时用哪个 Key两者相互独立。管理 Token、CCR 客户端 API Key 和上游供应商凭据彼此独立客户端访问网关时不要直接暴露上游凭据。关闭即不轮换。某条凭据的启用关闭后它的配置保留但不会再被选中想临时摘除一条出问题的 Key 时关闭比删除更稳妥。用量读取不受凭据池配置影响请求能力。表单里的获取用量只影响供应商列表、托盘或账号面板中的余额/额度展示不会影响模型是否能请求。配合凭据池查看账户状态时可以按provider或provider::credentialId这类内部配置值指定某个供应商或某个凭据的账户快照概览。完成以上步骤后这个供应商就会以“多条上游 Key 调度规则 本地限额”的形态参与路由。后续如果要调整某条 Key 的优先级或限额直接回到供应商页面对应供应商的高级设置里修改即可无需重建供应商。【免费下载链接】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），仅供参考
Claude Code Router 怎么配置凭据池：多上游 Key 轮换、优先级权重与本地限额
Claude Code Router 怎么配置凭据池多上游 Key 轮换、优先级权重与本地限额【免费下载链接】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当你的团队或高频调用场景只有一个上游供应商但手里握着多条 API Key不同账户、不同额度来源时单 Key 的API 密钥字段不够用了。Claude Code RouterCCR在供应商配置里提供了“凭据池”把多条上游 Key 配在同一个供应商下CCR 会把启用的凭据展开成多个内部上游目标按你设置的优先级、权重在 Key 之间轮换并按本地限额规则自动跳过已触顶的 Key。本文基于 CCR 文档讲清从添加供应商到配好凭据池、再到验证轮换生效的完整操作路径。准备条件CCR 已启动能打开管理界面。CCR 支持桌面应用、Node.js 22 的 npm CLI 和 Docker 三种发行方式桌面端管理地址为应用内窗口npm CLI 默认为http://127.0.0.1:3458模型网关在http://127.0.0.1:3456安装方式详见 快速开始。你手头有同一供应商签发的多条 API Key。注意只填写由当前 API 地址对应供应商签发的 Key。如果你希望请求日志里看到凭据分布需要先在设置 → 日志与观测打开请求日志日志与可观测性。第一步添加供应商凭据池挂在供应商下面所以先建供应商接入供应商进入供应商页面点击添加供应商。在选择 预设供应商中选择内置预设预设会自动填入常见的 API 地址、协议和图标如果服务不在预设里选择其他 / 自定义 API 地址并填写名称和API 地址。在添加凭据步骤可以先填一条API 密钥。填写 API 地址和密钥后CCR 会自动探测该端点支持的协议与可用模型。注意主表单的API 密钥只是“默认供应商凭据”没有配置凭据池时模型请求用这条 Key协议探测、模型探测、连通性检测和默认用量读取也会用它一旦配置了凭据池CCR 会优先使用凭据池中的 Key这条主表单 Key 退居为单 Key 配置。第二步展开凭据池并添加 Key在供应商表单的高级设置中展开凭据池guides 里也描述为“在凭据步骤切换到凭据池”。凭据池的核心字段如下完整说明见 供应商配置字段用途添加 Key新增一条上游 API Key启用控制单条凭据是否参与请求转发和用量读取。关闭后配置保留但该 Key 不会被选中名称凭据显示名会出现在账号用量、日志和内部诊断里建议写成可识别的用途或额度来源方便之后在请求日志里辨认API 密钥该凭据实际发送给上游的 KeyKey 高级选项展开单条凭据的调度和限额字段优先级、权重、限制 JSON导入 JSON从 JSON 文件批量导入凭据支持顶层数组或对象中的credentials、keys、apiKeys数组移除删除当前凭据行逐条点添加 Key是主路径如果 Key 数量多用导入 JSON批量导入更省事导入结构示例{ credentials: [ { name: team-a, apiKey: sk-... }, { name: team-b, apiKey: sk-... } ] }顶层直接写数组、或用keys/apiKeys作为数组字段名同样是文档支持的写法sk-...需替换为真实 Keyname是凭据名称。给每条凭据起一个能区分用途的名称值得花一分钟后面在请求日志里按凭据筛选时靠的就是这个名字。第三步设置优先级与权重展开某条凭据的Key 高级选项可以设置两个调度字段优先级数字越小越优先。未填写时按凭据行顺序作为优先级。权重同优先级、相近使用率下的排序权重数字越大越优先。未填写时为1。一个典型排法把额度最充足、最稳定的 Key 放在最前或显式给更小的优先级数字把备用 Key 排在后面这样日常流量集中在主 Key 上主 Key 触顶或被跳过时再轮到后面的 Key。第四步为单条 Key 配置本地限额同一批 Key 里如果有的有速率限制、有的有每日额度用限制 JSON给每条 Key 单独设本地限额。CCR 会按请求、tokens 或图片数量统计窗口使用量达到上限后自动跳过该 Key尝试同供应商的其他可用 Key。限制 JSON支持的常用字段字段含义rpm/rph/rpd每分钟 / 每小时 / 每天最多请求数tpm/tph/tpd每分钟 / 每小时 / 每天最多 tokensipm/iph/ipd每分钟 / 每小时 / 每天最多图片数maxRequestswindowMs自定义时间窗口内最多请求数maxTokensquotaWindowMs自定义时间窗口内最多 tokens文档给出的示例{ rpm: 60, tpm: 100000 }表示该 Key 每分钟最多 60 次请求、每分钟最多 100000 tokens。限额是 CCR 本地统计的窗口规则达到上限后这条 Key 被跳过不影响同供应商其他可用 Key 继续转发。验证轮换与限额是否生效两个验证手段都来自文档检测连通性。填好凭据和模型后点击检测连通性CCR 会用当前 API 地址、密钥、协议和所选模型发送一次真实请求确认整条链路可用。检测请求会限制输出长度但仍可能产生额外 token 消耗或计入供应商侧请求次数建议只在弹窗中勾选需要确认的模型不要一次性检查全部模型。检测结果只用于诊断连通性不会自动修改模型列表。请求日志按凭据筛选。保存供应商后发起若干请求到请求日志里按凭据筛选确认轮换符合预期。请求日志记录每条模型请求最终命中的供应商、模型、凭据、状态码、耗时、token 等字段日志页支持按状态、供应商、模型、凭据、请求 ID、模型名、请求体或响应体筛选日志与可观测性。多 Key 场景下重点看每条请求命中的凭据分布是否与你的优先级/权重设置一致给某条 Key 配了限额后也可以在日志里观察该凭据在窗口触顶后是否不再被命中。边界与注意事项凭据池 ≠ 客户端 API Key。凭据池是“上游 Key 池”控制 CCR 调用供应商时用哪条 Key“API 密钥”页面里的 CCR 客户端访问 Key 控制的是客户端访问 CCR 时用哪个 Key两者相互独立。管理 Token、CCR 客户端 API Key 和上游供应商凭据彼此独立客户端访问网关时不要直接暴露上游凭据。关闭即不轮换。某条凭据的启用关闭后它的配置保留但不会再被选中想临时摘除一条出问题的 Key 时关闭比删除更稳妥。用量读取不受凭据池配置影响请求能力。表单里的获取用量只影响供应商列表、托盘或账号面板中的余额/额度展示不会影响模型是否能请求。配合凭据池查看账户状态时可以按provider或provider::credentialId这类内部配置值指定某个供应商或某个凭据的账户快照概览。完成以上步骤后这个供应商就会以“多条上游 Key 调度规则 本地限额”的形态参与路由。后续如果要调整某条 Key 的优先级或限额直接回到供应商页面对应供应商的高级设置里修改即可无需重建供应商。【免费下载链接】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），仅供参考