ChatGPT 中转站使用教程

本文介绍如何安装 Codex，使用 CCSwitch 导入中转站配置，并通过网页版测试接口连通性。

一、安装 Codex

Codex 是运行在终端中的编程助手。请先安装 Node.js，然后执行：

bash

npm install -g @openai/codex

安装完成后运行：

bash

codex

官方项目地址：openai/codex

二、安装 CCSwitch

CCSwitch 是用于管理 Claude Code、Codex 等工具配置的桌面应用。

项目地址：CCSwitch

请在项目的 Releases 页面下载与你的操作系统匹配的安装包并完成安装。

新手推荐使用本站 API 页面提供的“一键导入 CCSwitch”，可以减少手动填写配置时的错误。

三、导入 MagicAI 配置

方式一：一键导入 CCSwitch

登录 MagicAI 控制台，创建或复制你的 API Key。
进入本站 API 页面，点击“一键导入 CCSwitch”。
浏览器弹出打开 CCSwitch 的确认提示时，选择“允许”。
导入成功后，关闭并重新打开 Codex，再开始使用。

方式二：手动配置

在 CCSwitch 中手动添加配置时，最容易填写错误的是 Base URL。

请使用下面的地址：

text

https://sky1818.com/

不要把地址误写成其他域名，也不要在没有明确要求时自行追加路径。

填写完成后保存配置，并在 CCSwitch 中导入或启用 MagicAI 配置。随后重新打开 Codex。

API Key 属于敏感凭据。不要把密钥发到群聊、工单或截图中；如果在公共网页测试过，建议测试完成后及时更换或删除该密钥。

四、网页版连通性测试

网页版测试用于确认 API 地址、API Key 和模型是否可以正常使用。

LIVE CHECK

API 连通性测试

填写 API Key，获取模型后发送一条 hi 进行真实请求。

https://sky1818.com/

API Key

API Key 只保存在当前页面内存中，不写入 URL 或浏览器存储。测试完成后建议更换临时密钥。

测试页面的固定配置如下：

API 地址：https://sky1818.com/
API Key：由用户填写
模型：点击“获取模型列表”后，从返回的模型中选择
测试消息：hi

使用步骤：

打开网页版测试工具。
在 API Key 输入框中填写你的密钥。
点击“获取模型列表”。
从模型列表中选择要测试的模型。
点击测试对话，页面发送消息 hi。
如果返回正常回复，说明 API 地址、密钥和模型配置基本可用。

网页版测试会把你填写的 API Key 发送到 https://sky1818.com/。请只在可信页面使用密钥，测试完成后不要保留或分享包含密钥的页面截图。

五、常见错误

错误	常见原因与处理方式
`401 / invalid key`	API Key 填错、复制时少了字符，或密钥已经被删除。请重新复制并确认密钥状态。
`余额不足`	账户没有可用余额，需要先充值或联系管理员处理。
`429 / limit`	上游账号达到并发或额度限制，请稍后重试。
`502 Bad Gateway`	上游网络或账号临时异常，一般重试即可；频繁出现时请联系客服。
`503 Unavailable`	当前模型没有可用渠道、模型名称填写错误，或者 API URL 填写错误。请依次检查模型名和 `Base URL`。
`Unsupported parameter`	移除报错中提到的参数，例如 `temperature` 或 `max_output_tokens`，然后重新请求。

排查顺序

遇到错误时，建议按下面的顺序检查：

确认 API URL 是 https://sky1818.com/。
重新复制 API Key，确认没有多余空格，也没有漏复制字符。
确认选择的模型名称来自“获取模型列表”的结果。
确认账户余额和上游额度状态。
关闭并重新打开 Codex 后再次测试。

六、聊天记录消失

如果出现聊天记录消失，可以使用 Codex-X 的会话同步功能处理。

GitHub 项目地址：

https://github.com/yynxxxxx/Codex-X

安装步骤：

打开上面的 GitHub 地址。
在仓库页面进入 Releases，下载与你的系统匹配的安装包。Codex-X 支持 Windows、macOS 和 Linux。
安装并打开 Codex-X。
在软件中点击“同步会话”。
等待同步完成后，再重新打开 Codex，检查聊天记录是否恢复。

如果仓库首页和 Releases 页面显示的版本不同，优先下载 Releases 页面中的最新稳定版本。

ChatGPT 中转站使用教程 ​

一、安装 Codex ​

二、安装 CCSwitch ​

三、导入 MagicAI 配置 ​

方式一：一键导入 CCSwitch ​

方式二：手动配置 ​

四、网页版连通性测试 ​