星链AI · ChatGPT 安装与 API 中转接入指南

ChatGPT 安装与 Codex API 中转配置教程

需要桌面应用时，可先在 macOS 或 Windows 安装 ChatGPT；随后把 Codex、Codex CLI 或 Claude Code 接入星链AI。可任选 一键脚本 自动写入本地配置（推荐），CC Switch 可视化管理多份 API 中转配置。Codex 支持应用增强模式：接入第三方 API 的同时，保留官方插件、手机远程操作等 Codex APP 能力。

1

登录 星链 AI Hub

访问 https://aixlau.me 注册并登录即可。后续脚本会打开浏览器完成一次性授权，系统会自动创建 API Key 并写入本机配置，不需要你手动创建或复制密钥。

提示：如果浏览器里还没登录，授权页会先引导你登录。
2

打开终端

在 macOS 上按 ⌘ + 空格 调出 Spotlight，输入 Terminal 回车即可打开终端。Ubuntu 用户也可以按 Ctrl + Alt + T；其他 Linux 用户从应用菜单中搜索「Terminal」或「终端」。

3

安装 ChatGPT（仅 macOS）

如果已经安装 ChatGPT，可以跳过这一步。macOS 用户运行下面的独立安装命令，脚本会下载 OpenAI 官方最新 DMG、校验安装包并自动打开：

curl -fsSL https://aixlau.me/install/install-chatgpt.sh | bash
  1. 等待下载和校验完成，安装包会自动打开；
  2. 按照 macOS 安装窗口提示，将 ChatGPT 拖入「Applications / 应用程序」文件夹；
  3. 从「应用程序」中打开 ChatGPT。
Linux 用户：OpenAI 当前没有提供 Linux 桌面安装包，请跳过这一步，继续配置 Codex CLI 或 Claude Code。也可以使用 ChatGPT 网页版。
4

粘贴并运行下面的命令

先点击命令右上角的「复制」按钮，再回到终端窗口粘贴：macOS 按 ⌘ + V，Linux 通常按 Ctrl + Shift + V。看到命令出现在终端后按回车。该命令会下载最新配置脚本，然后打开浏览器完成授权；授权完成后会自动创建 API Key 并写入本机配置。

curl -fsSL https://aixlau.me/install/bootstrap.sh | bash
提示：如果浏览器没有自动打开，终端里会显示一个链接和验证码。复制链接到浏览器打开，使用刚才登录的同一个账号完成授权；授权过程中不要关闭终端。
5

选择客户端并等待自动授权

按下面两步操作。终端会显示客户端列表，其中一行会有高亮背景：

  1. 用 ↑ ↓ 移动高亮，选中要配置的客户端（默认已选中 Codex），按 回车 确认；
  2. 浏览器打开授权页后，使用刚才登录的同一个账号完成授权；如果出现「允许」「授权」或「继续」，按页面提示点击。不要关闭终端，页面会自动创建 API Key 并把结果交回终端。
macOS 终端中选择客户端并自动获取 API Key
用上下键选中 Codex，回车后浏览器会自动完成授权并创建 API Key。

回车后脚本会自动备份原配置并写入新配置，看到写入成功的提示就完成了。整个过程只配置你选中的那一个客户端，不会动其他客户端。

会写入哪些文件：选 Codex 写入 ~/.codex/ 下的相关文件；选 Claude Code 写入 ~/.claude/settings.json。如果文件已存在会先自动备份，可放心运行。
6

重启客户端开始使用

关闭并重新打开你刚配置的那个客户端，让它读取新配置即可：

  • Codex APP（桌面客户端）：直接退出后重新打开应用即可；
  • Codex CLI：终端里重新执行 codex 启动；
  • Claude Code：终端里重新执行 claude 启动，会自动走 星链 AI Hub 网关。
Codex APP 增强：选择 Codex 时，脚本会保留 Codex 应用增强能力；使用星链 AI Hub 第三方 API 的同时，仍可继续使用官方插件、手机远程操作等功能。
!

运行脚本后，Codex 仍显示「登录 ChatGPT」怎么办？

Codex 桌面端显示登录 ChatGPT，并提供使用其他方式登录按钮
看到这个页面时，不要点「继续登录」，请点「使用其他方式登录」。
  1. 点击 「使用其他方式登录」，选择使用 API Key 登录；
  2. 回到 星链 AI Hub 的「API 密钥」页面，找到脚本自动创建的 codex 密钥；
  3. 点击下图黑色箭头指向的复制图标，复制这条密钥；
  4. 返回 Codex，把密钥粘贴到 API Key 输入框，再点「继续」；
  5. 进入 Codex 后即可使用。后续正常退出、重新打开，不需要重复输入。
星链 AI Hub API 密钥页面中黑色箭头指向 codex 密钥复制按钮
黑色箭头指向的就是复制按钮，点击后再返回 Codex 粘贴密钥。
注意：API Key 相当于账号密码，只粘贴到 Codex 登录框，不要发给其他人。如果页面里没有 codex 密钥，请重新运行一键脚本并完成浏览器授权。
OpenAI 官方也说明桌面端可在退出登录页面选择其他登录方式并输入 API Key。详见 Codex 身份验证说明。
?

常见问题

Q：Codex API 中转站怎么配置？

登录星链AI 后，在 macOS、Linux 或 Windows 上运行本页的一键脚本，选择 Codex 并完成浏览器授权。脚本会自动创建 API Key、备份旧配置并写入 API 中转配置；也可以切换到 CC Switch 教程手动添加供应商。

Q：Claude Code 如何接入 API 中转服务？

运行一键脚本时选择 Claude Code，完成浏览器授权后，脚本会备份并更新 Claude Code 配置。重新执行 claude 启动即可使用。

Q：跑脚本前我需要装什么？

macOS 自带 curl 和 bash，Windows 10/11 自带 PowerShell。ChatGPT 桌面端可直接使用本页第 3 步安装；Codex CLI 和 Claude Code 命令行客户端仍需按各自官方说明安装。

Q：ChatGPT 桌面端怎么安装？

macOS 在终端运行本页安装命令，脚本会下载、校验并打开 OpenAI 官方 DMG；Windows 在 PowerShell 运行安装命令，脚本会打开微软商店的 ChatGPT 页面。Linux 当前没有官方桌面安装包。

Q：脚本会把我原来的配置覆盖掉吗？

不会丢。每个被改动的文件都会先备份成 xxx.bak.YYYYMMDD-HHMMSS 留在原目录，需要回退直接把 .bak.* 改回原名即可。

Q：我还需要自己创建 API Key 吗？

不需要。普通一键脚本流程只要求你注册并登录 星链 AI Hub，脚本会自动创建一个专用 API Key 并写入本机配置。

Q：脚本完成后打开 Codex，为什么还是「登录 ChatGPT」页面？

这是桌面端的首次登录确认，不是脚本失败。点「使用其他方式登录」→ 使用 API Key，再到 星链 AI Hub 的「API 密钥」页面复制脚本自动创建的 codex 密钥并粘贴即可。

Q：想恢复成官方 Codex/Claude？

把对应的备份文件 .bak.* 改回原文件名，或直接删掉脚本生成的配置块（config.toml 里有 # BEGIN SUB2API MANAGED BLOCK 标记区段）。