HRouter 常见问题：Key 安全、计费、用量与账号

这一页汇总使用 HRouter 时最常被问到的问题，每个问题都链接到更详细的说明。如果你的问题是某个具体的报错码，直接看对应的报错排查文章。

快速找到你的问题

开始使用

第一次用，应该从哪里开始？ 按 从充值到第一次调用 的顺序：充值、创建 Key、选择分组、接入工具、查看用量。

怎么最快接入 Claude Code 或 Codex？ 用 HRouter Desktop，输入 Key 即可自动写入配置。想自己维护配置文件，看 Claude Code 或 Codex。

Base URL 到底填什么？ OpenAI 系带 /v1，Claude 和 Gemini 用站点根地址，见 API 地址对照表。

怎么知道自己的 Key 能用哪些模型？ 请求 /v1/models，见 查询可用模型。

Key 与安全

Key 泄露了怎么办？ 立刻在 API 密钥 页面停用旧 Key，再新建一个，并更新所有工具里的配置。不要等发现异常消耗之后再处理。

怎样安全地保管 Key？ 放在环境变量或密钥管理器里，不要提交到 GitHub、前端代码、截图或聊天记录。给不同工具和项目创建不同的 Key，泄露时可以单独停用。

可以限制一个 Key 的用量吗？ 可以，创建或编辑 Key 时设置额度限制，也可以设置 IP 限制、速率限制和有效期，见 创建 API Key。

HRouter Desktop 会上传我的 Key 吗？ Key 只保存在本机配置中，用于读取模型列表。隐私和安全说明见 HRouter Desktop 开源仓库。

充值与计费

怎么充值，多久到账？ 见 充值与到账。充值后在“我的订单”里核对订单状态和余额，已付款未到账时保留订单编号联系平台，不要重复付款。

余额、订阅和兑换码有什么区别？ 余额是账户可用金额；订阅按分组提供周期额度；兑换码按其实际权益兑换。三者概念不同，余额不会自动让 Key 获得所有分组的权限，见 如何选择 Key 分组。

怎么知道每次调用扣了多少钱？ 在 使用记录 按 Key、模型和时间筛选，逐条核对输入、输出和费用，见 查看用量与刷新。

价格在哪里看？ 在 模型页面 按供应商和分组查看。实际费用受输入、输出、缓存和分组倍率影响，以使用记录为准。

分组与模型

分组是什么，为什么要选？ 分组决定 Key 能用哪些模型，也关联价格和使用限制。先确定要用的工具和模型，再选分组，见 如何选择 Key 分组。

为什么模型列表里没有我想要的模型？ 当前 Key 的分组没有它，换分组后重新查询，见 model_not_found。

编程该选哪个模型？ 见 编程场景怎么选模型。

使用中的问题

Claude Code 提示版本不对？ 见 Claude Code 常见问题。

Codex 显示 exceeded retry limit？ 见 Codex 常见问题。

能不能在编辑器里使用？ 可以：Claude Code VSCode、Claude Code JetBrains、Codex VSCode、Codex JetBrains、Cline、Cherry Studio。

自己写代码怎么调用？ 见 OpenAI SDK 和 Anthropic SDK。

还是没解决

记录下发生的时间、使用的工具、返回的错误码和错误信息，去掉完整的 Key 后联系平台。提供这些信息能让排查快很多。