打开项目

快速开始

作者
VORTEX Team
发布时间
2026/8/10
阅读时间
大约 12 分钟
从注册账号到配置 CLI 工具的完整接入路径。

让我们从这里开始吧!从 0 开始的 VORTEX API 使用之旅,一步步来,准没问题!

第一步:注册账号

注册账号

打开注册入口后,点击页面右上角的“注册”。如果你已在登录页,也可以点击底部的“没有账户?注册”进入注册流程。

方式一(推荐):使用 Google 账号注册

  1. 点击“使用 Google 继续”。
  2. 在弹窗中选择要绑定的 Google 账号并完成授权。
  3. 注册成功后,使用该账户进入 VORTEX API 控制台。

使用 Google 注册无需额外设置密码,后续登录时继续选择同一个 Google 账号即可。

方式二:使用邮箱注册

  1. 点击“使用用户名注册”。
  2. 填写邮箱、用户名和密码。
  3. 按页面提示提交,完成注册。
VORTEX API 注册页面
注册账户或使用 Google 继续。

第二步:登录账号

已注册用户进入登录页后,可以选择 Google 账号或邮箱、用户名登录。浏览器会保持登录状态;在新设备上需重复登录流程。

登录账号

使用 Google 账号登录

  1. 点击“使用 Google 继续”。
  2. 选择注册时绑定的 Google 账号。
  3. 授权成功后即可自动登录。

使用邮箱或用户名登录

  1. 输入邮箱地址或用户名。
  2. 输入账号密码。
  3. 点击“继续”完成登录。
VORTEX API 登录页面
使用用户名、电子邮件或 Google 账号登录。

第三步:购买额度

登录控制台后,进入左侧“钱包管理”。你可以使用支付宝在线充值,也可以购买兑换码后兑换到账户余额。

方式一:支付宝在线充值

  1. 切换到“在线充值”标签,在“充值金额”中选择固定金额,或填写“自定义金额”。
  2. 在“付款方式”中选择“支付宝”,核对右侧“支付明细”中的到账额度和应付金额。
  3. 点击“前往支付”,按支付页面提示完成付款。
  4. 支付完成后返回钱包页面,确认可用余额;需要核对订单时,可点击“订单历史”。
VORTEX API 钱包管理中的支付宝在线充值页面
选择充值金额和支付宝,确认支付明细后前往支付。

方式二:购买并使用兑换码

  1. 切换到“兑换码”标签,选择所需额度,点击“获取兑换码”并按页面提示完成购买。
  2. 获得兑换码后,回到钱包管理页面,在下方“我已有兑换码”中粘贴完整兑换码。
  3. 点击“立即兑换”,兑换成功后额度将立即到账,再检查上方可用余额。
VORTEX API 钱包管理中的兑换码购买与兑换入口
购买兑换码后,在下方“我已有兑换码”中粘贴并立即兑换;已有兑换码可直接使用。

第四步:创建 API 令牌

进入 API 密钥管理

  1. 在控制台左侧“常规”区域点击“API 密钥”。
  2. 在列表右上角点击“创建 API 密钥”。
VORTEX API 密钥管理页面
查看现有密钥并创建新的 API 密钥。

创建新 API 密钥

  1. 填写便于识别的名称,例如 Codex、Claude Code 或项目名称。
  2. “分组”默认为“智能路由”,也可以选择目标模型对应的指定分组;按需要设置过期时间、数量与额度。
  3. 不熟悉访问限制时,建议先保持默认设置。
  4. 确认后保存更改,并安全保存生成的完整密钥。
VORTEX API 创建 API 密钥弹窗
设置名称、分组、过期时间、额度与访问限制。

查看分组可用模型

打开顶部“模型广场”,按分组、供应商、模型标签、定价类型和端点类型筛选。创建 API 密钥前,请确认目标模型与所选分组匹配。

VORTEX API 模型广场页面
按分组和能力筛选当前可用模型。

第五步:环境检查

在配置 Claude Code、Codex 或其他 CLI 工具之前,请先确认本机已经正确安装 Node.js。在 Windows、macOS 或 Linux 终端中执行:

npm list -g --depth-0

如果命令可以正常执行,说明 Node.js 与 npm 已经可用。即使输出中没有安装任何全局包,也不影响后续配置。若提示“命令未找到”或类似错误,请先完成 Node.js 安装,再重新执行上面的命令确认。

第六步:配置 CLI 工具

基础条件

  1. 完成环境检查,确认 Node.js 与 npm 可以正常使用。
  2. 安装要使用的 Claude Code、Codex 或其他 CLI 工具。
  3. 创建与目标模型分组匹配的 API 密钥,并安全保存完整密钥。

API 端点说明

登录控制台后,可以在概览页“API 信息”区域查看当前可用的 API Endpoint。使用 OpenAI 兼容格式的客户端或工具时,请在 API 地址后添加 /v1。

https://api.vxhop.com/v1
Authorization: Bearer <你的 API 密钥>

使用 Claude Code 等专用配置时,请以对应教程中的示例为准。

为了让配置过程更轻便简单,推荐使用 GitHub 开源项目 CC-Switch 来管理本地 CLI 配置。

CC-Switch 项目地址

如果你不使用该工具,也可以继续阅读下方的 CLI 手动配置教程。无论使用哪个 CLI,请先完成上述基础条件,确保 Node.js、npm 和对应 CLI 都能正常使用。