AI跃云 API 使用教程

本文整理自《AI跃云 API 使用教程》，主要讲怎么把 AI跃云 API 配置到 Codex、Claude Code 等工具里使用。

AI跃云 API 使用教程封面

新手先看这里

如果你是新手，优先看本页教程。还不懂也可以看视频教程：

必读：我们是售卖 API，不是售卖 Codex 或 Claude Code。所以我们只确保我们的 API 能正常调用 GPT 模型和 Claude 模型。下面的教程可以把 API 配置到 Codex 和 Claude Code 里使用。我们不提供免费远程服务，如果是小白一定要远程服务，需要另外收费。

一、先安装好 Codex 或 Claude Code

如果你还没有安装 Codex、Claude Code，或想使用 cc-switch 图形化配置工具，可以继续看下面的截图指引。

Codex 详细教程：https://halo.yunshudong.com/archives/codex-app-cc-switch-zero-install-guide-20260430

Claude Code 详细教程：https://halo.yunshudong.com/archives/claude-code-domestic-cc-switch-guide

Codex 安装资源

如果还没有安装 Codex，可以先下载网盘里的 codex 资源。

codexWindows / macOS提取码AIHG

二、下载 cc-switch 配置 API 的工具

cc-switch 是一个图形化配置工具，适合不想手动填写 API 地址和 Key 的用户。

安装后可以一键导入 Codex、Claude Code、OpenCode、小龙虾等工具的配置，减少出错概率。

下载方式	地址	说明
GitHub	https://github.com/farion1231/cc-switch/releases	网络能访问 GitHub 时优先使用。
国内下载	见下面下载卡片	注意区分 Windows 和 macOS 版本。

cc-switch 国内下载

国内下载方式，注意区分 Windows 和 macOS 版本。

switchWindows / macOS提取码AIHG

三、注册账号、兑换充值并导入 API 配置

先打开 AI跃云网站注册账号：

https://yue-yun.com/

注册后，可以使用购买到的密钥进行兑换充值，然后导入 API 配置。

AI跃云注册和登录页面

四、有兑换码的用户进行兑换充值

有兑换码的用户，请在下面页面进行兑换充值。没有兑换码的用户，可以自行在“充值”菜单页面自助充值。

AI跃云兑换充值入口

AI跃云兑换充值页面

AI跃云充值操作截图

AI跃云导入 API 配置截图

AI跃云 Key 配置截图

AI跃云配置完成截图

五、自动导入失败时，使用 cc-switch 手动配置

cc-switch 手动配置入口

cc-switch 选择工具类型

cc-switch 填写 API 信息

cc-switch 保存配置

cc-switch 配置完成

注意：如果 API 请求主站点 https://api.yue-yun.com 连接失败，就使用备用香港节点：

https://api-hk.aihge.com

六、常用站点与充值提醒

项目	地址	说明
API 请求地址	主站点：https://api.yue-yun.com 备用香港节点：https://api-hk.aihge.com	填写到工具配置里的 API 调用地址。
用户管理页面	https://api.yue-yun.com/key-portal	用于查看 Key、余额、用量、到期时间和充值情况。