Win/Mac
Windows / Mac 安装
根据自己的电脑系统选择对应版本。
- 1打开 OpenAI 官方下载页
点击下方的“打开官网下载”。
- 2选择电脑系统并安装
Windows 选择 Windows 版；Mac 选择 macOS 版。下载完成后按页面提示安装。
- 3打开 ChatGPT
Windows 从开始菜单打开，Mac 从“应用程序”打开，然后进入 Codex。
STEP 1
下载并安装 Codex
不用打开终端。进入 OpenAI 官方下载页，选择 Windows 或 macOS 版本，按页面提示安装即可。
下载后看到“ChatGPT”是正常的
OpenAI 已把 Codex 整合进新版 ChatGPT 桌面应用。安装完成后打开 ChatGPT，再进入 Codex 即可。
进阶用户：安装 Codex CLI
CLI 需要使用 PowerShell 或终端。普通用户可以跳过，不影响按照本页主线安装桌面应用。
Windows
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"macOS
curl -fsSL https://chatgpt.com/codex/install.sh | shSTEP 2
准备账号与 API Key
首次接入前完成下面四项。已创建 Key 的用户可以直接进入下一步。
STEP 3
使用 CC Switch 连接羊TOKEN
CC Switch 会自动完成 Codex 配置，不需要手动创建文件或输入配置命令。
Base URL
https://sub2.yangtoken.com/v1配置工具CC Switch
接口类型Responses
1
下载安装 CC Switch
打开官方发布页，下载与你电脑系统对应的安装包。
2
添加羊TOKEN
打开 CC Switch，在顶部选择“Codex”，点击右上角的加号，然后选择“自定义”。
选择 Codex
打开 CC Switch 后，点击顶部的 Codex 标签。
添加自定义供应商
点击右上角“+”，选择“自定义”或“Custom”。
填写羊TOKEN信息
按照下方内容填写，API Key 使用你在羊TOKEN控制台创建的 Key。
名称羊TOKEN
API 地址
https://sub2.yangtoken.com/v1API Key填写你的羊TOKEN Key
模型填写渠道状态页面显示的可用模型
不需要开启本地路由
羊TOKEN支持 Codex 使用的 Responses 接口，保存自定义供应商即可。
3
保存并切换
保存配置后，把“羊TOKEN”设为当前 Codex 供应商，再重新打开 Codex。
确认 API 地址、Key 和模型填写正确。
在 Codex 供应商列表中点击“羊TOKEN”。
完全退出 Codex 后重新打开，让新配置生效。
STEP 4
第一次使用 Codex
打开桌面应用，选择需要处理的文件夹，然后发送一个简单任务进行测试。
打开桌面应用
打开 ChatGPT，并进入 Codex。
选择项目文件夹
点击打开文件夹，选择希望 Codex 读取的代码目录。
发送一个小任务
先让 Codex 解释项目并运行现有测试，确认连接和工具权限正常。
核对使用日志
在羊TOKEN使用日志中确认模型、API Key、Tokens 和费用。
第一次建议这样问
首次任务示例
打开使用记录
请先阅读这个项目，告诉我如何启动和运行测试。不要修改文件。
能正常回复CC Switch、Key 与模型配置基本正确
日志出现消耗记录请求已经通过羊TOKEN完成路由
没有提交 Key检查项目内没有密钥或用户级配置文件
MAINTENANCE
更新与卸载
桌面应用与普通软件一样管理；只有进阶 CLI 用户需要使用命令。
更新桌面应用打开应用后按更新提示操作保持使用 OpenAI 官方版本
Windows 卸载设置 → 应用 → 已安装的应用找到 ChatGPT 后选择卸载
Mac 卸载打开“应用程序”文件夹把 ChatGPT 移到废纸篓
Codex CLI
codex update仅适用于安装了 CLI 的进阶用户TROUBLESHOOTING
常见问题
先按错误码定位层级，再决定是修改本机配置、模型名称，还是等待上游恢复。
安装后找不到 CodexAPP
新版 Codex 在 ChatGPT 桌面应用中。先从开始菜单或“应用程序”打开 ChatGPT，再进入 Codex；无需在电脑里寻找单独名为 Codex 的应用。
401 / unauthorized / invalid keyKEY
回到 CC Switch 的 Codex 页面，编辑“羊TOKEN”，确认 API Key 复制完整且没有多余空格。保存后重新切换到羊TOKEN，并重启 Codex。
404 / model_not_foundMODEL
配置中的模型名不在当前账号分组，或上游渠道暂时没有该模型。到渠道状态页面核对准确模型名后修改 model。
429 / too_many_requestsLIMIT
上游账号池当前达到 RPM、TPM 或并发限制。稍后重试；羊TOKEN会在请求尚未输出内容时按路由规则尝试其他可用渠道。
502 / 503 / upstream unavailableUPSTREAM
上游服务暂时不可用，不是本机安装错误。等待自动重试和备用渠道切换；持续失败时带上时间、模型和 request id 联系客服。
配置修改后没有生效CONFIG
确认 CC Switch 的 Codex 当前供应商显示为“羊TOKEN”。重新保存并切换一次，然后完全退出 Codex 再重新打开。
Base URL 应该填哪个？URL
Codex Provider 使用 https://sub2.yangtoken.com/v1，末尾的 /v1 必须保留。
如何保护 API Key？SECURITY
每台设备使用独立 Key；不要写进项目配置、代码、截图或公开仓库。发现泄露后立即在控制台禁用旧 Key 并创建新 Key。
SUPPORT
仍然无法完成配置？
联系客服时请提供操作系统、Codex 版本、错误全文、发生时间和模型名。不要发送完整 API Key。
进入控制台客服 QQ：3266368669