ChatGPT/Codex APP 桌面版

本教程适用于 Windows 和 macOS，主要介绍如何安装 Codex/ChatGPT 桌面版，并通过 API Key 接入 GPT 模型。

整个配置过程主要分为以下几步：

安装 Codex/ChatGPT 桌面版

找到 Codex 配置目录

修改 config.toml

创建 DeepRouter API Key

使用 API Key 登录 Codex

配置完成后，后续正常打开 Codex 即可直接使用。

第一步：安装 Codex/ChatGPT 桌面版

首先下载并安装自己系统对应版本的 ChatGPT/Codex 桌面版。

官网下载地址：

https://chatgpt.com/zh-Hans-CN/download

国内网盘下载：

https://share.weiyun.com/TN4bIAwH

下载完成后，根据安装程序提示正常完成安装。

安装完成后建议先不要登录，我们先完成 Codex 的 API 配置。

第二步：找到 Codex 配置目录

Codex 的配置文件保存在当前用户目录下的 .codex 文件夹中。

Windows

Windows 的 Codex 配置目录一般位于：

C:\Users\你的用户名\.codex

例如 Windows 用户名为 testuser：

C:\Users\testuser\.codex

如果看不到 .codex 文件夹，可以打开 Windows 文件资源管理器：

查看 → 显示 → 隐藏的项目

开启隐藏文件显示后，再查看当前用户目录。

如果确实没有 .codex 文件夹，也可以手动创建。

macOS

macOS 的 Codex 配置目录为：

~/.codex

最快的打开方式：

打开 访达 Finder

按下 Command + Shift + G

输入：

~/.codex

按下回车

即可直接打开 Codex 配置目录。

如果提示目录不存在，也可以手动创建 .codex 文件夹。

第三步：修改 config.toml

进入 .codex 文件夹后，找到：

config.toml

使用文本编辑器打开。

如果没有 config.toml，可以手动创建一个同名文件。

将下面的配置完整复制进去：

model_provider = "wolf"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.wolf]
name = "wolfai"
base_url = "https://wolfai.top/v1"
wire_api = "responses"
requires_openai_auth = true

修改完成后保存文件。

Windows 用户特别注意

Windows 默认可能会隐藏文件扩展名。

因此手动创建配置文件时，需要确认真正的文件名是：

config.toml

而不是：

config.toml.txt

如果文件被保存成 .txt，Codex 将无法正常读取配置。

配置参数说明

下面简单介绍几个主要参数。

默认模型：

model = "gpt-5.5"

表示默认使用 gpt-5.5 模型。

如果后续需要使用其他模型，可以根据 DeepRouter 实际提供的模型 ID 进行修改。

推理强度：

model_reasoning_effort = "high"

常用值包括：

high：高推理强度

medium：中等推理强度

low：低推理强度

一般直接使用：

model_reasoning_effort = "high"

即可。

第四步：创建 API Key

配置文件修改完成后，接下来需要创建 Codex 登录使用的 API Key。

打开 WolfAI：https://wolfai.top

注册并登录后进入控制台，找到：

API 密钥

然后点击创建新的 API Key 密钥。

建议设置：

名称： 随意填写，例如 Codex

分组： 选择 Codex

其他设置： 保持默认

确认无误后创建 API Key。

创建成功后会得到类似下面的密钥：

sk-xxxxxxxxxxxxxxxx

复制并保存这个 API Key，下一步登录 Codex 时需要使用。

重要：API Key 相当于账号密码。
不要将完整 API Key 发送给其他人，也不要在截图、录屏、直播或视频教程中完整展示。
如果 API Key 不慎泄露，请立即在 DeepRouter 后台删除旧 Key，并重新创建。

第五步：使用 API Key 登录 Codex

完成前面的配置后，打开之前安装好的 ChatGPT/Codex 桌面版。

进入 Codex 登录界面后，选择：

使用其他方式登录

将刚刚在 WolfAI 创建的 API Key：

sk-xxxxxxxxxxxxxxxx

粘贴进去，然后点击继续。

如果 API Key 和 config.toml 配置正确，验证通过后即可进入 Codex。

常见问题

1. 找不到 `.codex` 文件夹

Windows：

打开：

文件资源管理器 → 查看 → 显示 → 隐藏的项目

然后进入：

C:\Users\你的用户名\

检查是否存在：

.codex

如果没有，可以手动创建。

macOS：

打开访达，按下：

Command + Shift + G

输入：

~/.codex

回车即可打开。

如果目录不存在，可以手动创建。

2. 找不到 config.toml

如果 .codex 文件夹存在，但是里面没有：

config.toml

可以直接手动创建。

然后将下面的完整配置复制进去：

model_provider = "wolf"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.wolf]
name = "wolfai"
base_url = "https://wolfai.top/v1"
wire_api = "responses"
requires_openai_auth = true

Windows 用户需要特别确认文件不是：

config.toml.txt

3. 出现 401 Unauthorized / Invalid token

如果出现：

401 Unauthorized

或者：

Invalid token

通常代表 API Key 存在问题。

重点检查：

API Key 是否完整复制

API Key 是否已经失效

创建 API Key 时是否选择了正确的 Codex 分组

DeepRouter 后台的 API Key 是否仍然有效

是否使用了之前已经删除或失效的旧 Key

如果无法确定，可以直接：

删除旧 API Key → 创建新的 API Key → 重新登录 Codex

4. 出现 model not found

如果出现：

model not found

检查 config.toml 中的：

model = "gpt-5.6"

模型 ID 必须与 DeepRouter 当前实际支持的模型名称保持一致。

如果 DeepRouter 后续调整模型名称，需要同步修改这里的模型 ID。

5. 修改 config.toml 后没有生效

首先确认配置文件路径是否正确。

Windows：

C:\Users\你的用户名\.codex\config.toml

macOS：

~/.codex/config.toml

确认无误后：

保存 config.toml

完全退出 Codex

重新打开 Codex

再次测试

Windows 用户还需要检查配置文件是否被保存成：

config.toml.txt

6. API Key 登录失败

如果输入 API Key 后无法登录，首先确认：

WolfAI API Key 是否有效

API Key 是否完整复制

API Key 是否选择了正确的 Codex 分组

config.toml 是否已经正确配置

base_url 是否为正确地址

如果仍然无法登录，可以重新创建一个 API Key 后再次尝试。

7. 如何更换 API Key

如果后续需要更换 DeepRouter API Key，可以先退出当前 Codex 登录状态，然后重新使用新的 API Key 登录。

如果旧 API Key 已经泄露，建议先在 DeepRouter 后台删除旧 Key，再创建新的 API Key。

配置总结

整个配置过程主要就是三个核心步骤：

第一步：安装 Codex/ChatGPT 桌面版

下载并正常安装对应系统版本。

第二步：修改 .codex/config.toml

配置内容：

model_provider = "wolf"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.wolf]
name = "wolfai"
base_url = "https://wolfai.top/v1"
wire_api = "responses"
requires_openai_auth = true

第三步：创建API Key 并登录 Codex

进入 WolfAI 创建 Codex 分组的 API Key，然后在 Codex 中选择 使用其他方式登录 → API Key，输入创建好的 Key。

验证成功后，即可通过 WolfAI 在 Codex 中使用 GPT 模型。

第一步：安装 Codex/ChatGPT 桌面版#

第二步：找到 Codex 配置目录#

Windows#

macOS#

第三步：修改 config.toml#

Windows 用户特别注意#

配置参数说明#

第四步：创建 API Key#

第五步：使用 API Key 登录 Codex#

常见问题#

1. 找不到 .codex 文件夹#

2. 找不到 config.toml#

3. 出现 401 Unauthorized / Invalid token#

4. 出现 model not found#

5. 修改 config.toml 后没有生效#

6. API Key 登录失败#

7. 如何更换 API Key#

配置总结#