Codex 配置教程

本教程适用于 Windows、macOS 和 Linux，涵盖以下三种使用方式：

终端版

桌面版

VS Code 插件版

先创建 API 令牌并安装需要的客户端，再完成一次公共配置即可。

一、创建 API 令牌

1. 选择模型和分组

打开模型广场，选择需要使用的模型，并确认该模型支持的分组。

不同分组对应不同渠道和计费倍率。通常，倍率较高的分组拥有更高的并发能力和稳定性，请根据实际需求选择。

2. 创建令牌

进入 控制台 → 令牌管理 → 添加令牌，选择支持目标模型的分组。

如需提高可用性，可以开启跨分组重试并配置多个分组。当前分组的渠道请求失败时，系统会按顺序尝试后续分组。

保存后复制生成的 API Key，后续配置时需要使用。

请妥善保管 API Key，不要发送给他人，也不要在截图中展示完整内容。

二、安装 Codex

以下三种方式可以任选一种，也可以同时安装。

方式 A：终端版

终端版适合习惯使用命令行的用户，支持 Windows、macOS 和 Linux。

1. 安装 Node.js

终端版需要 Node.js 22 或更高版本。先打开终端检查版本：

如果尚未安装或版本过低，请前往 Node.js 官网下载当前版本。

Windows：下载安装程序并按提示完成安装，然后重新打开终端。

macOS：根据 Mac 芯片类型下载安装包，完成安装后重新打开“终端”。

Linux：选择对应发行版的安装方式。安装后确认 node -v 显示 22 或更高版本，避免使用系统仓库中的旧版本。

2. 安装终端版

在 PowerShell、终端或 Shell 中运行：

安装完成后检查版本：

出现版本号即表示安装成功。

macOS 或 Linux 如果出现权限错误，不建议直接使用 sudo npm install。请改用 Node.js 版本管理工具安装 Node.js，再重新执行上述命令。

方式 B：桌面版

桌面版适合希望使用图形界面和多工作区功能的用户。

前往 Codex 桌面版下载页，选择对应系统的版本。

Windows：下载安装程序，或通过 Microsoft Store 安装。

macOS：下载适用于当前 Mac 的版本，打开安装文件后按提示完成安装。

Linux：如果下载页没有提供对应发行版，请使用终端版或 VS Code 插件版。

安装后先不必登录，继续完成第三部分的公共配置。配置完成后打开桌面版，选择本地项目文件夹即可使用。

方式 C：VS Code 插件版

VS Code 插件版适合希望直接在编辑器中使用 Codex 的用户，安装方式在 Windows、macOS 和 Linux 上基本一致。

打开 VS Code，进入扩展（Windows/Linux 快捷键 Ctrl+Shift+X，macOS 快捷键 Command+Shift+X）。

搜索 Codex，找到由 OpenAI 发布的 Codex - OpenAI's coding agent，点击安装。

安装完成后，继续进行第三部分的公共配置。

配置完成后，点击侧边栏中的 Codex 图标。如仍出现登录页面，请选择 使用 API Key 登录，填写第一步创建的 API Key。

Cursor、Windsurf 等兼容 VS Code 扩展的编辑器，也可以尝试安装同一插件。若安装后没有看到 Codex 图标，请重启编辑器，并信任文件。

三、配置 Codex（三版本通用）

三种 Codex 客户端共用同一套配置。配置文件所在目录如下：

系统	配置目录
Windows	`C:\Users\<你的用户名>\.codex`
macOS	`/Users/<你的用户名>/.codex`，也可写作 `~/.codex`
Linux	`/home/<你的用户名>/.codex`，也可写作 `~/.codex`

1. 打开配置目录

Windows

在文件资源管理器的地址栏输入 %USERPROFILE%\.codex，按回车进入。若目录不存在，请手动创建 .codex 文件夹。

macOS / Linux

打开终端，运行：

.codex 是隐藏目录。在 macOS 的访达中可以按 Command+Shift+. 显示隐藏文件；Linux 文件管理器通常可以按 Ctrl+H 显示隐藏文件。

2. 配置模型

在 .codex 目录中创建或打开 config.toml，写入以下内容并保存：

# 默认模型；如需使用其他模型，请填写模型广场中的对应名称
model_provider = "custom"
model = "gpt-5.6-sol"

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://www.northrouter.com/v1"

Windows 可以使用记事本编辑；macOS 可以使用文本编辑器；Linux 可以使用系统自带的文本编辑器。

3. 配置 API Key

在同一目录中创建或打开 auth.json，将 YOUR_API_KEY 替换为第一步创建的 API Key：

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

保存文件后，确认文件名分别为 config.toml 和 auth.json，没有额外的 .txt 后缀。

JSON 中的双引号和逗号必须保留，不要在 API Key 前后添加空格。

4. 重新启动客户端

保存配置后，关闭并重新打开 Codex、桌面应用或 VS Code，使新配置生效。

四、验证与排查

打开任意一种 Codex 客户端，发送一条测试消息。能够正常收到回复，即表示配置成功。

如果无法使用，请依次检查：

config.toml 和 auth.json 是否位于当前用户的 .codex 目录中。

文件名是否正确，尤其要确认 Windows 没有自动添加 .txt 后缀。

base_url 是否为 https://www.northrouter.com/v1。

API Key 是否完整，余额是否充足，所选分组是否支持当前模型。

model 是否与模型广场中的模型名称一致。

修改配置后，是否已经重新启动客户端。

Codex 配置教程

一、创建 API 令牌#

1. 选择模型和分组#

2. 创建令牌#

二、安装 Codex#

方式 A：终端版#

1. 安装 Node.js#

2. 安装终端版#

方式 B：桌面版#

方式 C：VS Code 插件版#

三、配置 Codex（三版本通用）#

1. 打开配置目录#

2. 配置模型#

3. 配置 API Key#

4. 重新启动客户端#

四、验证与排查#