ChatGPT 配置
本页介绍如何在 ChatGPT 桌面端中接入 APINebula。ChatGPT 与 Codex 共用同一份本地配置，因此需要配置 config.toml 和 auth.json，但不需要安装 Node.js 或 Codex CLI。请选择正在使用的系统查看教程。
官方下载地址：ChatGPT 官方下载页面
开始前请先确认：
- 已安装并可以正常打开 ChatGPT 桌面端
- 已注册并登录 APINebula
- 已创建
CODEX分组的 API Key
ChatGPT、Codex CLI 和 VS Code 中的 Codex 插件会读取同一个 .codex 配置目录。如果此前已经按照 Codex 配置教程完成配置，可以直接打开 ChatGPT 测试，无需重复修改文件。
- Windows
- macOS
- Linux
Windows 教程
第一步：配置 config.toml
按下 Win+R，输入 powershell，然后按回车。在 PowerShell 中执行：
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
notepad "$HOME\.codex\config.toml"
如果文件已存在，记事本会直接打开；如果不存在，保存时会创建它。删除原有内容，将以下内容完整粘贴并保存：
model = "gpt-6-astra"
model_provider = "codex"
model_reasoning_effort = "medium"
[model_providers.codex]
name = "codex"
base_url = "https://apinebula.ai/v1"
wire_api = "responses"
requires_openai_auth = true
上方的 gpt-6-astra 是配置示例。请前往 模型广场确认 CODEX 分组当前可用的模型名称。base_url 必须保留 /v1。
第二步：配置 auth.json
在 PowerShell 中执行：
notepad "$HOME\.codex\auth.json"
如果文件已存在，记事本会直接打开；如果不存在，保存时会创建它。删除文件中的原有内容，仅保留以下内容并保存：
{
"OPENAI_API_KEY": "你的API_KEY"
}
前往 令牌管理，创建 CODEX 分组令牌。提交后回到令牌列表，在目标令牌的密钥栏直接复制完整 API Key；只替换配置中的 你的API_KEY 占位文字，并保留原有引号。
创建令牌时，建议将 模型可用列表 留空。填写后，如果列表中不包含当前模型，请求可能返回 403。
第三步：启动测试
在 ChatGPT 菜单栏中选择 文件 → Quit ChatGPT，或按下 Ctrl+Q 完全退出，然后重新启动应用。新建一个对话并发送：
你好
如果可以正常返回内容，就说明配置已经生效。
macOS 教程
第一步：配置 config.toml
按下 Command+Space，输入“终端”或 Terminal，然后按回车。在终端中执行：
mkdir -p ~/.codex
touch ~/.codex/config.toml
open -e ~/.codex/config.toml
删除原有内容，将以下内容完整粘贴并保存：
model = "gpt-6-astra"
model_provider = "codex"
model_reasoning_effort = "medium"
[model_providers.codex]
name = "codex"
base_url = "https://apinebula.ai/v1"
wire_api = "responses"
requires_openai_auth = true
上方的 gpt-6-astra 是配置示例。请前往 模型广场确认 CODEX 分组当前可用的模型名称。base_url 必须保留 /v1。
第二步：配置 auth.json
在终端中执行：
touch ~/.codex/auth.json
open -e ~/.codex/auth.json
删除文件中的原有内容，仅保留以下内容并保存：
{
"OPENAI_API_KEY": "你的API_KEY"
}
前往 令牌管理，复制 CODEX 分组生成的完整 API Key：在目标令牌的密钥栏直接复制即可。只替换配置中的 你的API_KEY 占位文字，并保留原有引号。
创建令牌时，建议将 模型可用列表 留空。填写后，如果列表中不包含当前模型，请求可能返回 403。
第三步：启动测试
完全退出并重新打开 ChatGPT，新建一个对话并发送：
你好
如果可以正常返回内容，就说明配置已经生效。
Linux 说明
ChatGPT 目前没有官方 Linux 桌面版，因此本页没有可供 Linux 安装的桌面客户端配置步骤。
如果需要在 Linux 中使用同一套 CODEX 分组令牌，请改用 Codex CLI 配置教程。
