Codex

推荐使用 Codex 桌面客户端，或在 Cursor / VS Code 中安装 OpenAI 官方 Codex 扩展。
本教程介绍如何通过本地配置，将 Codex 的模型请求接入智创聚合 API。

📌

联系客服免费提供远程配置服务

一、选择使用方式

使用方式	适用场景	安装入口
Codex 桌面客户端	日常开发、代码审查、多任务处理	官方下载页面（Win可以在应用商店下载）
Cursor / VS Code 扩展	在编辑器中结合项目代码使用 Codex	在扩展市场搜索 Codex，确认发布者为 OpenAI
Codex CLI	在终端中处理开发任务	参考下方 CLI 安装步骤

同一用户、同一运行环境下，Codex 桌面客户端、CLI 和编辑器扩展通常读取同一套用户配置。使用 WSL、SSH 远程开发或容器时，应确认 Codex 实际运行在哪个环境中。

开始前，请准备：

智创聚合 API Key。

当前 Key 所属分组支持的模型名称和推理等级。

支持 Codex 所需 Responses API 的接口地址。

二、安装 Codex

1. 桌面客户端或编辑器扩展

使用桌面客户端时，从官方下载页面下载安装适用于当前系统的版本。

使用 Cursor / VS Code 时，在扩展市场安装 OpenAI 官方 Codex 扩展。

建议使用最新稳定版。当前官方模型目录为 gpt-6.1-sol 标注的最低客户端版本为 0.153.0。

安装后，继续完成第三节的 API 配置。

2. Codex CLI

以下安装方式任选一种即可。

方式一：官方安装脚本

macOS / Linux：

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

使用官方安装脚本无需预先安装 Node.js。

方式二：npm 安装

先安装仍在维护的 Node.js LTS 版本，安装包通常包含 npm：

Node.js 官方下载页面

检查安装结果：

安装最新版 Codex CLI：

如果遇到全局安装权限错误，建议使用 Node.js 版本管理器或调整 npm 全局安装目录，避免直接使用 sudo 安装。

验证 CLI 安装

显示版本号即表示安装成功。如果提示找不到命令，请重新打开终端，并检查安装目录是否已加入 PATH。

通过 npm 安装的用户，后续也可以使用以下命令更新：

三、找到配置目录

Codex 默认使用用户主目录下的 .codex 文件夹。

运行环境	默认配置目录
Windows 原生	`C:\Users\你的用户名\.codex`
macOS	`/Users/你的用户名/.codex`
Linux	`/home/你的用户名/.codex`
WSL	`/home/你的Linux用户名/.codex`

如果设置了 CODEX_HOME 环境变量，应以该变量指定的目录为准。

Windows 原生环境

在文件资源管理器地址栏输入：

%USERPROFILE%\.codex

macOS / Linux 环境

配置目录通常为：

~/.codex

点号开头的目录通常为隐藏目录，可以通过文件管理器的“前往文件夹”功能或终端访问。

WSL 环境

如果 Codex 在 WSL 中运行，应编辑 WSL 内的 .codex。

可以在 Windows 文件资源管理器中通过以下路径访问：

\\wsl$\Ubuntu\home\你的Linux用户名\.codex

将 Ubuntu 替换为实际的 WSL 发行版名称。

创建配置文件

如果配置目录不存在，可以手动创建。然后在该目录中创建或编辑：

.codex/
├── auth.json
└── config.toml

如果已有配置，建议先备份，再合并下面的内容。Windows 中请确认文件没有被保存为 auth.json.txt 或 config.toml.txt。

四、配置 API Key 和模型

1. 配置 auth.json

在 auth.json 中填写智创聚合 API Key：

{
  "OPENAI_API_KEY": "sk-xxx"
}

填写说明：

将 sk-xxx 替换为智创聚合后台生成的 API Key。

使用英文双引号，JSON 中不能添加注释。

不要将 API Key 发给他人或提交到项目仓库。

已有登录信息时，先备份原文件；替换此文件会改变当前使用的认证信息。

2. 配置 config.toml

当前 OpenAI Codex 官方模型目录将 GPT-6.1-Sol 列为最新的编程与日常工作主力模型，模型名称为 gpt-6.1-sol。

以下配置使用该模型及其最高推理等级 ultra：

cli_auth_credentials_store = "file"

model = "gpt-6.1-sol"
model_provider = "custom"
model_reasoning_effort = "ultra"

[model_providers.custom]
name = "智创聚合 API"
base_url = "https://n.lconai.com/v1"
wire_api = "responses"
requires_openai_auth = true

模型和推理等级需当前分组支持。
官方模型目录已列出 gpt-6.1-sol 和 ultra。

3. 配置项说明

配置项	作用
`cli_auth_credentials_store`	设置为 `file`，使用本地文件保存认证信息
`model`	指定调用的模型名称，本教程使用 `gpt-6.1-sol`
`model_provider`	指定服务商配置，必须与下方 `custom` 对应
`model_reasoning_effort`	指定推理强度，本教程使用最高档 `ultra`
`name`	服务商显示名称
`base_url`	API 基础地址，保留末尾的 `/v1`
`wire_api`	使用 Responses API 协议
`requires_openai_auth`	使用 Codex 的 API Key / 登录认证机制；本教程配合 `auth.json` 中的 Key 使用

4. 合并已有配置

编辑已有 config.toml 时，请注意：

同一配置项不要重复定义。

顶层配置项应放在 [model_providers.custom] 之前。

如果已有 [model_providers.custom]，请编辑原有区块，不要再添加同名区块。

如果存在项目级配置或配置 profile，请检查它们是否覆盖了用户配置。

本教程采用接入所需的基础配置，不添加 disable_response_storage。该项不在当前官方配置参考中，也不能用于保证服务端不保存请求。

5. 重启应用

保存两个文件后，完全退出并重新打开 Codex 桌面客户端、Cursor / VS Code 或 Codex CLI。

编辑器中请新建一个 Codex 会话进行验证。通过本教程接入时，模型调用使用智创聚合 API Key。

五、推理等级说明

model_reasoning_effort 用于设置推理强度。

当前官方模型目录中，gpt-6.1-sol 支持以下档位：

推理等级	说明	建议用途
`low`	较轻量推理，响应更快	简单问答、轻量代码修改
`medium`	平衡速度与推理深度	日常开发、一般问题分析
`high`	更深入的推理	复杂 Bug 修复、代码审查
`xhigh`	更高强度推理	架构分析、复杂开发任务
`max`	面向高难度问题的最大推理深度	高难度排错、深入分析
`ultra`	最大推理强度，并支持自动任务委派	复杂项目任务、需要任务拆分与协作的工作

ultra 的自动任务委派能力还取决于 Codex 客户端版本、功能设置及服务商兼容情况。提高推理强度可能增加响应时间和用量。

最高推理等级

本教程默认使用：

model_reasoning_effort = "ultra"

日常开发

需要平衡速度和用量时，可以改为：

model_reasoning_effort = "medium"

复杂开发任务

复杂 Bug 修复或架构分析可以使用：

model_reasoning_effort = "xhigh"

每次只保留一行 model_reasoning_effort。

minimal 未列入当前 gpt-6.1-sol 的支持档位，请勿将其用于该模型的配置示例。

六、启动并验证接入

1. 桌面客户端或编辑器扩展

打开项目，进入 Codex，新建会话并输入：

请给出一个 Node.js 的 Hello World 示例，并解释如何运行。

2. Codex CLI

先进入项目目录。

macOS / Linux / WSL：

Windows PowerShell：

Set-Location "D:\你的项目路径"
codex

启动后输入同样的测试提示词。

3. 检查接入结果

配置成功的判断依据：

Codex 能正常返回结果。

智创聚合后台能看到对应的模型调用记录。

CLI 中使用 /status，确认当前模型和推理等级符合配置。

如果 /model 菜单中没有所需模型，可修改 config.toml 中的 model，重启后新建会话。自定义服务商的模型不一定全部出现在菜单中。

七、Codex CLI 常用命令

以下为 CLI 内的斜杠命令。不同版本及桌面客户端、编辑器扩展的可用命令可能不同，以当前界面提示为准。

命令	作用
`/status`	查看当前会话配置及 Token 使用情况
`/model`	选择模型和推理强度
`/permissions`	调整 Codex 可执行的操作权限
`/init`	创建 `AGENTS.md` 项目指令文件
`/diff`	查看 Git 改动，包括未跟踪文件
`/review`	审查当前代码改动
`/compact`	总结并压缩当前对话上下文
`/new`	开启新对话
`/clear`	清理终端显示并开启新对话
`/resume`	恢复已保存的对话
`/mcp`	查看 MCP 工具及连接状态
`/quit`	退出 Codex CLI

八、常见问题

1. 找不到 .codex 文件夹

可以手动创建，也可以先启动一次 Codex。

Windows 中可直接在文件资源管理器地址栏输入：

%USERPROFILE%\.codex

macOS / Linux 中，点号开头的目录通常为隐藏目录。

2. 修改配置后没有生效

依次检查：

是否编辑了 Codex 实际运行环境中的配置目录。

是否设置了 CODEX_HOME。

文件扩展名是否正确。

是否已完全重启应用并新建会话。

是否存在项目级 .codex/config.toml、配置 profile 或启动参数覆盖用户配置。

Windows 原生、WSL、远程主机和容器中的配置目录通常不同。

3. 提示模型不存在或没有权限

检查模型名称是否正确：

model = "gpt-6.1-sol"

同时确认当前 API Key 所属分组已支持该模型。如果后台使用其他模型名称，请填写后台提供的准确名称。

客户端支持某个模型，不代表本站当前分组已经开放该模型。

4. 提示不支持 ultra 推理等级

先确认 Codex 已更新，并检查当前模型和分组支持的推理档位。

如果当前通道不支持 ultra，可改用已明确支持的档位，例如：

model_reasoning_effort = "xhigh"

如果仍提示不支持，请继续按当前模型的支持情况调整，或暂时删除该配置项，使用默认设置验证接入。

5. 提示认证失败或 401

检查：

auth.json 是否为有效 JSON。

API Key 是否正确，有无多余空格。

Key 是否已失效或被禁用。

当前环境中的 OPENAI_API_KEY 是否指向其他 Key。

是否仍在使用旧的认证配置。

6. 提示请求失败、连接失败或 404

确认 API 基础地址为：

base_url = "https://n.lconai.com/v1"

不要将 base_url 填写为完整的 /v1/responses 地址。

同时确认网络、代理设置正常，且当前接口及分组支持 Responses API。

7. 提示未知配置项或 TOML 解析错误

检查配置项名称、英文引号、重复字段和区块位置。

优先使用本教程中的基础配置；其他选项请对照当前 Codex 版本的官方配置参考。

8. 返回 429 或额度不足

检查智创聚合后台的余额、分组限额及并发限制，减少并行请求后重试。

9. 模型菜单中找不到 GPT-6.1-Sol

先更新客户端。

如果使用自定义服务商后，模型仍未显示在菜单中，可直接在 config.toml 中填写：

model = "gpt-6.1-sol"

保存后重启并新建会话，再通过 /status 和后台调用记录确认实际使用的模型。

九、参考文档

一、选择使用方式#

二、安装 Codex#

1. 桌面客户端或编辑器扩展#

2. Codex CLI#

方式一：官方安装脚本#

方式二：npm 安装#

验证 CLI 安装#

三、找到配置目录#

Windows 原生环境#

macOS / Linux 环境#

WSL 环境#

创建配置文件#

四、配置 API Key 和模型#

1. 配置 auth.json#

2. 配置 config.toml#

3. 配置项说明#

4. 合并已有配置#

5. 重启应用#

五、推理等级说明#

最高推理等级#

日常开发#

复杂开发任务#

六、启动并验证接入#

1. 桌面客户端或编辑器扩展#

2. Codex CLI#

3. 检查接入结果#

七、Codex CLI 常用命令#

八、常见问题#

1. 找不到 .codex 文件夹#

2. 修改配置后没有生效#

3. 提示模型不存在或没有权限#

4. 提示不支持 ultra 推理等级#

5. 提示认证失败或 401#

6. 提示请求失败、连接失败或 404#

7. 提示未知配置项或 TOML 解析错误#

8. 返回 429 或额度不足#

9. 模型菜单中找不到 GPT-6.1-Sol#

九、参考文档#

一、选择使用方式

二、安装 Codex

1. 桌面客户端或编辑器扩展

2. Codex CLI

方式一：官方安装脚本

方式二：npm 安装

验证 CLI 安装

三、找到配置目录

Windows 原生环境

macOS / Linux 环境

WSL 环境

创建配置文件

四、配置 API Key 和模型

1. 配置 auth.json

2. 配置 config.toml

3. 配置项说明

4. 合并已有配置

5. 重启应用

五、推理等级说明

最高推理等级

日常开发

复杂开发任务

六、启动并验证接入

1. 桌面客户端或编辑器扩展

2. Codex CLI

3. 检查接入结果

七、Codex CLI 常用命令

八、常见问题

1. 找不到 .codex 文件夹

2. 修改配置后没有生效

3. 提示模型不存在或没有权限

4. 提示不支持 ultra 推理等级

5. 提示认证失败或 401

6. 提示请求失败、连接失败或 404

7. 提示未知配置项或 TOML 解析错误

8. 返回 429 或额度不足

9. 模型菜单中找不到 GPT-6.1-Sol

九、参考文档