快速开始

第一次使用 Windows 版 Codex App 时，按下面步骤配置。配置完成后，Codex 会通过 UseGoodAI 使用 AI 模型。

开始前确认：

• 已安装 ChatGPT / Codex App；还没安装先看 Codex 接入。
• 已打开 UseGoodAI 管理后台，方便下一步创建 API 密钥。
• 账号有余额。

1. 创建本中转站的 API 密钥

进入管理后台 API 密钥，点击 创建密钥。名称写用途，分组选择当前要用的模型档位，创建后复制 API Key。

API Key 用来让 Codex 识别你的账户并记录用量，后面脚本会要求你粘贴这个 Key。

查看创建和复制截图

2. 打开 PowerShell 运行脚本

Windows 按 Win + X，点击 终端 或 Windows PowerShell。

在打开的窗口里粘贴运行：

irm https://docs.usegoodai.com/install/codex.ps1 | iex

看到输入 API Key 的提示时，粘贴第 1 步复制的 Key，然后按回车。

Mac 用户看这里

打开终端运行：

curl -fsSL https://docs.usegoodai.com/install/codex.sh | bash

看到输入 API Key 的提示时，粘贴第 1 步复制的 Key，然后按回车。

3. 关闭并重新打开 Codex

脚本完成后，彻底退出 Codex App，再重新打开并新建任务。

发送 测试。

能正常回复，就接入完成。还是不能回复，先看下面的脚本排查。

4. 查看模型价格

接入完成后，看 模型价格 了解价格和分组。实际扣费以后台使用记录为准。

运行脚本时遇到问题

遇到的问题	先做这个	还是不行
PowerShell 提示无法下载脚本	检查网络后重新运行第 2 步命令	仍然失败时，改用下面的 CC Switch 接入
脚本提示未检测到 Codex App	先安装 Codex App，再回到本页重新运行脚本	看 Codex 接入
Codex 提示 INSUFFICIENT_BALANCE 或 Insufficient account balance	登录后台充值，充值后重新测试	仍然提示余额不足时，确认 Codex 使用的是当前账号的 API Key
脚本完成后 Codex 还是不能回复	彻底退出 Codex；Windows 用任务管理器结束所有 ChatGPT 进程，再重新打开	看 报错与踩坑

脚本已经完成，但 Codex 返回具体错误时，直接看 报错与踩坑。

脚本安全吗？

脚本开源，源码会放在公开仓库：

https://github.com/usegoodai/usegoodai-codex-installer

这个脚本只是帮不会手动改配置的用户写入 Codex 配置，不会修改系统设置。不放心就用下面的 CC Switch 或手动配置。

文件	作用
C:\Users\你的用户名\.codex\config.toml	写入 UseGoodAI 接口地址、模型和 Responses 配置
C:\Users\你的用户名\.codex\auth.json	写入 UseGoodAI API Key

写入前会自动备份旧文件。

Mac 用户对应路径是 ~/.codex/config.toml 和 ~/.codex/auth.json。

移除中转配置，恢复官方账号登录

Windows 打开 PowerShell，运行：

irm https://docs.usegoodai.com/install/codex-restore.ps1 | iex

macOS / Linux 打开终端，运行：

curl -fsSL https://docs.usegoodai.com/install/codex-restore.sh | bash

脚本会清空登录凭据，并删除 config.toml 中的模型端点配置；MCP 和其它配置保持不变。完成后彻底退出 Codex，重新打开并使用官方账号登录。

不用脚本的方式

顺序	方式	入口
第二种	CC Switch 接入	Codex CC Switch 接入
第三种	手动配置	Codex 手动接入

安装生图工具

Codex 已经可以正常对话后，再为图片模型额外创建一个 专门画图分组 的 API Key。按照安装生图工具运行一键安装命令，之后可以直接在 Codex 对话中生成、修改并显示图片。