快速开始

⚠️

IMPORTANT给阅读者的忠告！

01

📖

请你在部署使用前一定去看看 模型分组介绍 与 常见问题 板块，如果有时间最好阅读全文

02

💡

我们一直提倡 "授人以鱼，不如授人以渔"

03

✅

这两个板块不仅能提升你的使用体验，也能解答你今后会在群里提问的 90% 的问题

请务必认真阅读以上内容

让我们从这里开始吧！

从 0 开始的 HuiLiu API 使用之旅~

一步步来，准没问题！

第一步：注册账号

• 注册入口：https://www.huiliuapi.com/register

• 打开注册入口后，按表单填写信息即可。
• 如果你在登录页，也可以点击底部“没有账户？注册”进入注册流程。

注册步骤

1. 填写用户名、密码、确认密码。
2. 填写邮箱，点击“获取验证码”，到邮箱中查收验证码并填入。
3. 勾选“我已阅读并同意用户协议和隐私政策”。
4. 点击“注册”完成。

注意

邮箱会用于接收验证码与通知；密码建议使用字母、数字和特殊字符组合。请妥善保管登录凭证，避免账号被盗用。

第二步：登录账号

• 登录入口：https://www.huiliuapi.com/login

登录步骤

1. 输入用户名或邮箱。
2. 输入账号密码。
3. 勾选用户协议后，点击“继续”完成登录。

设备登录说明

浏览器会保持登录状态；在新设备需重复登录流程。

如果登录后页面异常，可以先清空浏览器缓存后重试：

• Windows / Linux Chrome：按 Ctrl + Shift + Delete 打开清除浏览数据页面。
• macOS Chrome：按 Command + Shift + Delete 打开清除浏览数据页面。

忘记密码时，点击登录页的“忘记密码？”，按页面提示通过邮箱重置即可。

第三步：购买额度

登录控制台后，进入左侧“钱包管理”页面购买额度。

1. 在“选择充值额度”中选择固定额度，或在“自定义额度”中输入要充值的金额。
2. 确认页面下方的“实付金额”后，点击“立即支付”。

支付说明

目前充值比例为 1:1，即 1 元人民币等同于 1 美元额度。如果使用支付宝或微信支付时没有弹出支付页面，请先关闭代理后重试。

第四步：创建 API 令牌

登录后进入控制台面板，左侧选择“令牌管理”。

进入令牌管理

1. 在左侧菜单点击“令牌管理”。
2. 点击页面上方的“添加令牌”。

创建新令牌

在弹窗中填写令牌信息：

• 令牌名称：用于区分不同用途，例如 Claude Code、Codex、Gemini。
• 令牌分组：必须选择，分组决定这个令牌可以使用哪些模型。
• 过期时间：默认“永不过期”，也可以按需要设置有效期。
• 新建数量：一般保持 1 即可。
• 额度设置：开启“无限额度”时，令牌实际可用额度仍受账户余额限制。
• 访问限制：不熟悉时建议先保持默认，不要开启模型限制或 IP 白名单。

令牌分组一定要选对

令牌分组会直接影响可用模型。比如 Claude Code、Codex、Gemini CLI 需要选择对应分组；如果分组选错，后续配置 CLI 时很容易出现“模型不存在”或无法调用的问题。

如果你不确定每个分组适合什么场景，请先阅读 模型分组介绍。

填写完成后，点击右下角“提交”完成创建。

查看分组可用模型

你可以在“模型广场”查看每个令牌分组下支持哪些模型。

1. 点击页面右上角“模型广场”。
2. 在左侧筛选区选择供应商或令牌分组。
3. 模型卡片会显示该分组可用的模型、价格和折扣倍率。

如果你想了解折扣含义，可以点击模型广场右上方的“折扣说明”。

第五步：环境检查

在配置 Claude Code、Codex 或 Gemini CLI 之前，请先确认本机已经正确安装 Node.js。

在 Windows、macOS 或 Linux 终端中执行：

npm list -g --depth=0

如果命令可以正常执行，说明 Node.js 与 npm 已经可用。即使输出中没有安装任何全局包，也不影响后续配置。

如果提示“命令未找到”或类似错误，说明当前环境还没有安装 Node.js，或安装后没有正确加入系统环境变量。请先完成 Node.js 安装，再重新执行上面的命令确认。

必须先完成环境检查

CLI 工具依赖 Node.js 和 npm。环境没有准备好时，后续安装 Claude Code、Codex、Gemini CLI 都可能失败。

第六步：配置 CLI 工具

HuiLiu API 支持在命令行中使用 Claude Code、Codex、Gemini CLI。

基础条件

开始配置 CLI 前，请先完成以下步骤：

1. 完成上方 环境检查，确保 Node.js 和 npm 可以正常使用。
2. 完成 安装 CLI，安装 Claude Code、Codex、Gemini CLI。

API 端点说明

登录控制台后，可以在“数据看板”右侧的“API 信息”查看当前可用的 API Endpoint。

• 主站 Endpoint：https://www.huiliuapi.com，稳定可靠，适合生产环境。

OpenAI 兼容端点需要添加 /v1

如果你使用的是 OpenAI 兼容格式的客户端或工具，例如 Codex、OpenAI SDK、Cherry Studio 的 OpenAI 兼容配置，请在 API 地址后添加 /v1：

https://www.huiliuapi.com/v1

如果使用的是 Claude Code、Gemini CLI 等专用配置，请以对应教程中的示例为准。

CLI 手动配置教程传送门

注意：不管你是使用哪个 CLI，请一定先完成上方基础条件，确保 Node.js、npm 和对应 CLI 都可以正常使用。

• Claude Code 配置教程
• Codex 配置教程
• Gemini 配置教程