新手完整教程 · 2026-10-02 更新

从注册账号到用上 Codex，一页走完全流程

按顺序完成邮箱注册、充值或领取试用、选择分组、创建 API 密钥、安装 CC Switch、一键导入，再下载安装 Codex。第一次使用也能照着完成。

从第 1 步开始 已有密钥，直接导入 下载安装包

开始前准备

一个可收信邮箱目前注册支持 QQ 邮箱（qq.com）和 Gmail（gmail.com）。
Windows 或 macOS 电脑确认系统架构；绝大多数 Windows 电脑选 x64。
本站账号与余额新用户可按页面活动领取试用，后续可充值或兑换卡密。
不要公开 API 密钥密钥等同于余额使用权限，只放在自己的设备上。

1. 注册网站账号并验证邮箱

1
打开注册页

点击 注册账号。首次进入会显示服务条款与隐私政策，阅读后选择是否同意继续。

2
填写用户名和邮箱

用户名不能与现有账号重复；邮箱使用 QQ 邮箱或 Gmail。密码至少 8 位，并再次确认。

3
完成人机检测并发送验证码

人机检测通过后点击「发送验证码」，到邮箱收取验证码。收件箱没有时检查垃圾邮件。

4
创建账号并登录

填入邮箱验证码后提交注册，再前往 登录页。不要把邮箱验证码或密码发给任何人。

注册页提示的赠送额度、支持邮箱和活动规则，以页面实时显示为准。

2. 充值、兑换并选择分组

  1. 登录后进入「充值/订阅」或钱包页面。
  2. 已有兑换码：选择兑换码充值，完整粘贴卡密并兑换；在线充值则按页面提示完成。
  3. 确认余额已经到账，再查看账户当前可用分组。
  4. 按需求选择分组。常见有福利、混池、Team/Plus 和 Pro 等档位；先查看分组说明、可用模型和倍率，具体价格与权限以控制台实时显示为准。
不要只看分组名称猜价格。创建密钥前，以控制台显示的倍率、模型范围和套餐权限为准。

3. 创建 API 密钥

1
进入控制台的「令牌」页面

打开 控制台，在左侧找到「令牌」，点击「创建令牌」。

2
填写名称并选择分组

名称建议写成设备用途，例如 codex-home-pc。选择你已开通、准备给 Codex 使用的分组。

3
设置额度和模型范围

新手可以先设一个可控额度；如页面允许限制模型，确保包含你准备在 Codex 中使用的模型。

4
复制并保管密钥

创建后复制 sk- 开头的密钥。不要截图发群，也不要写入公开代码仓库。

密钥泄露时，立即回到「令牌」页面删除旧密钥并重新创建；仅修改密码不能让已泄露密钥失效。

4. 下载 Codex 与 CC Switch 推荐镜像

本站镜像用于改善国内下载稳定性。Codex 自动同步自 Wangnov/codex-app-mirror，CC Switch 同步自 官方 Releases；下载链接由本站提供，软件本身不做二次打包。

Codex 稳定推荐版：26.917.71314 CC Switch 当前镜像：v3.20.4

Codex 桌面版

Windows x64绝大多数 Intel / AMD 电脑，MSIX 安装包。下载 Windows x64 Windows ARM64骁龙 X、部分 ARM Windows 设备。下载 Windows ARM64 macOS Apple SiliconApple M1 / M2 / M3 / M4 / 后续 M 系列。下载 Apple 芯片版 macOS Intel「关于本机」中显示 Intel 处理器的旧款 Mac。下载 Intel 版

CC Switch

Windows x64 MSI推荐普通 Windows 电脑使用。下载 MSI Windows x64 便携版MSI 无法打开时，下载 ZIP 解压使用。下载便携版 Windows ARM64适用于 ARM 架构 Windows 电脑。下载 ARM64 MSI CC Switch macOS下载 DMG 后拖入应用程序。下载 macOS 版
Codex 当前固定为经验证的稳定推荐版；只有四个平台文件全部下载并通过大小与 SHA-256 校验后，才会一次性切换。待新版完成兼容性验证后再解除固定。

5. 安装 CC Switch 与 Codex

Windows

  1. 先安装 CC Switch。MSI 双击无反应时使用便携版 ZIP，解压后运行。
  2. 再打开 Codex 的 .Msix 文件，按系统提示安装。
  3. 如果 Windows 询问是否允许打开 ccswitch:// 链接，选择允许。

macOS

  1. 分别打开两个 DMG，把 CC Switch 和 Codex 拖入 Applications / 应用程序。
  2. 第一次打开若被系统拦截，到「系统设置 → 隐私与安全性」确认来源后再打开。
先启动一次 CC Switch，让系统注册一键导入协议；然后再执行下一步。安装包请只从本站按钮或上方列出的发布仓库获取。

6. 一键导入 CC Switch

在下面粘贴你刚创建的本站 API 密钥，点击一次即可唤起 CC Switch，并把翎航API配置为 Codex 当前供应商。

请确认 CC Switch 已安装并至少启动过一次。
密钥不会上传：本页只在你的浏览器内临时拼出 ccswitch:// 本机协议链接并交给 CC Switch；不会把密钥写入本站请求、统计、Cookie 或本地存储。唤起后输入框会立即清空。

手动配置备用方案

一键导入没有唤起应用时，在 CC Switch 中手动新增 Codex / OpenAI Compatible 供应商：

名称：翎航API
API Base URL：https://api.tianjinlinghang.com/v1
API Key：你在本站创建的 sk- 密钥
Wire API：responses
Default Model：以当前分组支持的模型为准

保存后点击切换/启用，确认当前供应商显示为「翎航API」。

6.1 自动审批跟随当前主对话模型

使用「Approve for me / 自动审批」时，审批也需要调用模型。完成下面的一次配置后，当前主对话用 gpt-6-astra，审批就用 Astra；主对话用 gpt-5.6-sol，审批就用 5.6 Sol。切换到目录内的其他模型后，审批也随之切换。

保留你在 CC Switch 中的主模型、API 密钥和分组。审批请求使用同一供应商，按实际请求模型和原密钥分组计费；审批会产生独立的模型用量。此工具只配置模型目录，不会开启全权限、修改审批策略或自动批准所有操作。

Windows：下载后运行一次

下载 Windows 配置工具

先在 CC Switch 中完成导入并启用。打开 PowerShell，输入 powershell.exe -NoProfile -ExecutionPolicy Bypass -File ，把刚下载的 .ps1 文件拖入窗口补齐路径，再回车。该命令只对本次脚本运行设置执行策略，无需管理员权限。

macOS：下载后在终端运行一次

下载 macOS 配置工具

打开「终端」，输入 sh ，把下载的 .sh 文件拖入终端补齐路径，再回车。

  1. 看到「配置完成」或「Configured」后，完全退出 Codex（包括托盘或菜单栏进程），然后重新打开。
  2. 继续使用原来的主对话模型与密钥。需要自动审批时，选择「Approve for me / 自动审批」。
  3. 在本站「使用日志」核对实际模型。主对话不是 Luna 时，审批不应再额外请求 Luna。
配置工具从本站下载并校验公开模型目录；不会提取或上传 API 密钥，也不需要填写密钥。原配置仅在本机保留，修改前会备份 config.toml 和同名目录文件。工具会将模型目录指向本站兼容目录；如果你维护其他供应商的自定义模型目录，先保留原配置，必要时用备份恢复。

当前覆盖本站现有 GPT 文本模型名称（包括 Astra、Sol、Terra、Luna、Fast 和 Compact 变体）。目录显示模型不代表密钥拥有调用权限；以原分组实际支持范围为准。以后新增模型、更新客户端或使用单独配置文件后，如果审批仍调用旧模型，请重新运行最新版工具。现有镜像安装包未被二次修改。

7. 启动或重新打开 Codex

  1. 确认 CC Switch 中「翎航API」已经启用。
  2. 如果 Codex 已经打开，先完全退出（包括托盘/菜单栏），再重新启动，以读取新配置。
  3. 打开一个你有权限的本地项目文件夹。第一次使用建议选测试目录，不要直接在重要项目中尝试删除或批量修改操作。
  4. 在 Codex 新建任务并发送一个简单问题。
这套方式使用本站 API 密钥和余额，不需要把个人 ChatGPT 账号密钥写进 CC Switch。

8. 发起测试并检查使用日志

在 Codex 输入：

请用三句话说明当前目录里有哪些主要文件；不要修改任何文件。

成功标准：

  • Codex 正常返回文字，没有 401、402、429、502 或 503。
  • 本站控制台「使用日志」出现对应的模型、分组和消耗记录。
  • 如果日志出现但 Codex 没显示完整回答，记录准确时间、模型名和错误截图后联系客服。

其他 OpenAI 兼容客户端

Cherry Studio、Chatbox、NextChat、Open WebUI 等客户端通常填写：

API Base URL：https://api.tianjinlinghang.com/v1
API Key：你的本站 sk- 密钥

常用接口为 POST /v1/responses 和 POST /v1/chat/completions。客户端会自动拼接路径时，不要重复填成 /v1/v1。

AI 生图 API 教程查看生图专用密钥、模型和调用示例。 渠道状态遇到上游错误时先查看公开状态与维护信息。

故障排查

现象处理方法
点击一键导入没有反应先安装并启动 CC Switch 一次，再刷新本页重试；浏览器询问是否打开外部应用时选择允许。仍不行就用手动配置。
导入后地址是 localhost:3000在 CC Switch 中改为 https://api.tianjinlinghang.com/v1，保存并重新启用。
401 / authentication failed密钥错误、被删除或复制时带了空格。重新创建密钥并导入。
402 / quota insufficient余额或令牌额度不足；充值、兑换或提高令牌额度后重试。
429 / 请求过多并发或频率超过限制，降低并发并稍后重试。
502 unknown provider for model当前分组不支持填写的模型；在控制台确认模型范围，换成支持的模型再导入。
503 / upstream failed上游繁忙或临时不可用。先查看状态页，稍后重试；持续发生时提供准确时间和模型名。
请求一直转圈完全退出并重开 Codex；在 CC Switch 确认当前供应商，然后查看本站使用日志判断请求是否到站。
主对话可用，但自动审批请求 Luna 报 503运行上方「自动审批跟随主模型」配置工具，完全退出并重启 Codex。无需换密钥分组。若客户端不支持该配置，先使用「Ask for approval / 请求批准」手动审批，并提供客户端版本供排查。
MSIX 无法安装确认下载完整且架构正确；普通 Intel/AMD 电脑选 x64，骁龙 Windows 选 ARM64。
如何判断 Windows 是 x64 还是 ARM64？

打开「设置 → 系统 → 系统信息」，查看“系统类型”。写着 x64-based processor 选 x64；写着 ARM-based processor 选 ARM64。

如何判断 Mac 是 Apple Silicon 还是 Intel？

点左上角苹果图标 →「关于本机」。看到 Apple M 系列芯片选 Apple Silicon；看到 Intel 处理器选 Intel。

API 密钥泄露了怎么办？

立即到控制台「令牌」页面删除旧密钥，重新创建并导入。不要只修改账号密码。

需要人工协助时提供什么？

提供操作系统、准确时间、模型名、Codex 错误截图和本站使用日志截图；CC Switch 截图必须遮住 API 密钥。

翎航API 使用文档 · 安装包版本由镜像元数据动态显示 · 如需人工协助，请从站内「联系我们」入口联系。