推荐使用 Codex 客户端，或在 Cursor / VS Code 中安装 Codex 扩展使用

Codex 接入智创聚合 API 教程

一、推荐使用方式

推荐优先使用以下方式：

Codex 桌面客户端：适合日常开发、代码审查、多任务处理。

Cursor / VS Code 安装 Codex 扩展：适合在编辑器中直接调用 Codex。

命令行 Codex CLI：适合在终端中使用。

Codex 客户端、CLI、Cursor / VS Code 扩展通常会共用同一套本地配置文件。

二、配置文件位置

Codex 的用户配置目录一般是 .codex。

不同系统路径如下：

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

如果你是在 Windows 的 WSL / Linux 环境中使用 Codex，注意要编辑 WSL 里的 .codex 文件夹，不是 Windows 原生的 C:\Users\你的用户名\.codex。

在 Windows 文件资源管理器中，可以通过类似下面的路径打开 WSL 文件：

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

如果 .codex 文件夹不存在，可以手动新建。

三、在 Cursor / VS Code / Codex 客户端中使用

在 Cursor 或 VS Code 中搜索并安装 Codex 扩展，或者下载安装 Codex 桌面客户端。

然后找到 .codex 文件夹，创建或编辑下面两个文件：

auth.json
config.toml

1. 配置 auth.json

打开 auth.json，填入你的智创聚合 API Key：

{
  "OPENAI_API_KEY": "sk-xxx"
}

说明：

sk-xxx 替换成你从智创聚合 API 购买的 Key。

JSON 文件不能写注释。

不要使用中文引号。

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

2. 配置 config.toml

打开 config.toml，写入以下内容：

cli_auth_credentials_store = "file"

disable_response_storage = true
model = "gpt-5.5"
model_provider = "custom"
model_reasoning_effort = "xhigh"
personality = "friendly"

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

保存后，重启 Codex 客户端、Cursor 或 VS Code，即可开始使用。

如果启动时提示 disable_response_storage 是未知配置项，可以删除这一行；它不影响模型接入。模型是否可用以智创聚合后台实际支持的模型名称为准。

四、推理等级说明

model_reasoning_effort 用来控制推理强度，可选值通常为：

model_reasoning_effort = "xhigh"
model_reasoning_effort = "high"
model_reasoning_effort = "medium"
model_reasoning_effort = "low"
model_reasoning_effort = "minimal"

建议：

日常开发：medium 或 high

复杂 Bug 修复、架构分析、长任务：xhigh

简单问答或轻量修改：low 或 minimal

注意：xhigh 是否生效取决于当前模型和服务商是否支持。

五、命令窗口安装使用

如果你想在终端中使用 Codex，可以安装 Codex CLI。

方式一：官方安装脚本

macOS / Linux：

Windows PowerShell：

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

方式二：npm 安装

如果使用 npm 安装，需要先安装 Node.js 和 npm。

建议环境：

Node.js 18+，推荐 Node.js 22 LTS

npm 10+

网络连接正常

安装 Codex：

如果 Linux 下遇到权限问题，可以使用：

验证安装：

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

六、安装 Node.js

Ubuntu / Debian：

CentOS / RHEL / Fedora：

Arch Linux：

验证版本：

七、启动 Codex

进入你的项目目录：

启动 Codex：

首次启动后，可以输入一句简单测试：

请帮我写一个 Node.js 的 hello world 示例

如果能够正常返回，并且智创聚合后台能看到调用记录，说明配置成功。

八、常见命令参考

命令	描述
`/model`	切换模型和推理级别
`/permissions`	调整 Codex 的权限模式
`/init`	生成 `AGENTS.md` 项目指令文件
`/status`	查看当前会话配置、模型、权限和上下文使用情况
`/diff`	查看当前项目改动
`/review`	让 Codex 审查当前改动
`/clear`	清空当前会话并开始新对话
`/new`	在当前 CLI 中开启新会话
`/compact`	压缩长对话上下文
`/mcp`	查看 MCP 工具状态
`/quit`	退出 Codex CLI

九、常见问题

找不到 .codex 文件夹
手动创建即可。Windows 中注意开启“显示隐藏的项目”。

配置后不生效
确认你编辑的是当前运行环境对应的 .codex。Windows 原生和 WSL 的配置目录不是同一个。

提示模型不存在
检查 model = "gpt-5.5" 是否为智创聚合后台支持的模型名称。

提示认证失败或 401
检查 auth.json 中的 API Key 是否正确，是否有多余空格，JSON 格式是否有效。

请求失败或连接失败
检查 base_url 是否正确：

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

更多官方文档参考：

在Codex中设置

Codex 接入智创聚合 API 教程#

一、推荐使用方式#

二、配置文件位置#

三、在 Cursor / VS Code / Codex 客户端中使用#

1. 配置 auth.json#

2. 配置 config.toml#

四、推理等级说明#

五、命令窗口安装使用#

方式一：官方安装脚本#

方式二：npm 安装#

六、安装 Node.js#

七、启动 Codex#

八、常见命令参考#

九、常见问题#