NextAI 产品文档

Appearance

在 Codex 中使用 NextAI API ​

学习如何配置 OpenAI Codex 使用 NextAI API 访问 GPT-5 和 GPT-5-Codex 以及 GPT-5.1-Codex 模型。

什么是 Codex？ ​

Codex 是 OpenAI 推出的官方命令行 AI 编程助手，运行在您的终端和 VSCode 中，帮助您更快地编写代码。

NextAI API 支持的 Codex 模型： ​

  • gpt-5 - 最新的 GPT-5 模型
  • gpt-5-codex - 专为代码优化的 GPT-5 Codex 模型
  • gpt-5.1-codex - 专为代码优化的 GPT-5.1 Codex 模型

已适配最新的 gpt-5.1-codex 模型，您只需要升级 Codex 并执行 codex -m gpt-5.1-codex 即可使用。

配置方式 ​

获取 API 密钥 ​

  1. 登录 NextAI API 控制台

访问 NextAI API 登录或注册账号。

  1. 创建令牌

在控制台中新建一个令牌，选择 Codex 分组：

  • 进入控制中心
  • 点击"新建令牌"
  • 选择 Codex 分组
  • 保存并复制以 sk- 开头的 API 密钥

Windows 配置 ​

前置环境要求 ​

在安装 Codex 之前，请确保您已具备以下环境：

  • Windows 10 或 Windows 11
  • Node.js 22+
  • npm 10+
  • 网络连接（可以正常访问 npm 源）

安装 Codex ​

打开命令提示符（CMD）或 PowerShell，运行：

js
npm install -g @openai/codex

验证安装 ​

运行以下命令验证安装：

js
codex --version

如果看到类似 codex-cli 0.31.0 的信息，说明安装成功。

配置 API ​

  1. 找到配置目录

进入当前用户的用户目录下的 .codex 文件夹：

js
C:\Users\YourUsername\.codex

如果看不到 .codex 文件夹，请在文件资源管理器中启用"显示隐藏的文件、文件夹和驱动器"选项。

  1. 创建配置文件

如果 .codex 文件夹不存在，需要手动创建该文件夹以及以下两个配置文件：

  • config.toml
  • auth.json
  1. 配置 config.toml

编辑 config.toml 文件，添加以下内容：

js
model_provider = "codex"
model = "gpt-5"  # 可更改为 "gpt-5-codex" 或 "gpt-5.1-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://api.nextaicore.com/v1"
wire_api = "responses"
requires_openai_auth = true

参数说明：

  • model: 可选 gpt-5 或 gpt-5-codex 或 gpt-5.1-codex
  • model_reasoning_effort: 推理级别，可选 low、medium、high
  • base_url: NextAI API 的 接口地址
  1. 配置 auth.json

编辑 auth.json 文件，添加您的 API 密钥：

js
{
  "OPENAI_API_KEY": "sk-your-api-key-here"
}

请将 sk-your-api-key-here 替换为您在 NextAI API 控制台获取的实际 API 密钥！

  1. 启动 Codex

配置完成后，重启终端，然后进入您的工程目录：

js
cd your-project
codex

如果成功启动，说明配置完成！

MacOS 配置 ​

前置环境要求 ​

  • Node.js 22+
  • npm 10+
  • 网络连接（可以正常访问 npm 源）

安装 Codex ​

打开终端，运行：

js
npm install -g @openai/codex

如果您使用 Homebrew，也可以运行：

js
brew install codex

验证安装 ​

运行以下命令验证安装：

js
codex --version

如果看到类似 codex-cli 0.31.0 的信息，说明安装成功。

配置 API ​

  1. 创建配置目录

打开终端，运行：

js
cd ~

检查是否存在 .codex 文件夹：

js
ls -la

如果不存在 .codex 文件夹，创建它并初始化配置文件：

js
mkdir .codex
cd .codex
touch config.toml auth.json

如果已存在，直接进入并用 VSCode 打开：

js
cd .codex && code .
  1. 配置 config.toml

编辑 config.toml 文件：

js
model_provider = "codex"
model = "gpt-5"  # 可更改为 "gpt-5-codex" 或 "gpt-5.1-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://api.nextaicore.com/v1"
wire_api = "responses"
requires_openai_auth = true
  1. 配置 auth.json

编辑 auth.json 文件：

js
{
  "OPENAI_API_KEY": "sk-your-api-key-here"
}

请将 sk-your-api-key-here 替换为您的实际 API 密钥！

  1. 启动 Codex

配置完成后，重启终端，然后进入您的工程目录：

js
cd your-project
codex

VSCode Codex 插件配置 ​

  1. 安装官方插件

在 VSCode 扩展市场中搜索并安装 OpenAI Codex 官方插件（带 OpenAI 认证标识）。

  1. 配置插件（旧版）

注意：新版 Codex 插件（0.36.0+）只读取 config.toml 文件，不需要在 settings.json 中配置。以下配置仅适用于旧版插件。

如果使用旧版插件，打开 VSCode 设置，搜索 @ext:openai.chatgpt，点击"在 settings.json 中编辑"，添加：

js
"chatgpt.apiBase": "https://api.nextaicore.com/v1",
"chatgpt.config": {
  "preferred_auth_method": "apikey",
  "model": "gpt-5",
  "model_reasoning_effort": "high",
  "wire_api": "responses"
}

保存后重启 VSCode 即可使用。

常见命令参考 ​

Codex 提供了多个内置斜杠命令：

命令说明
/mode切换审批模式（Suggest/Auto Edit/Full Auto）
/model切换 AI 模型和推理级别
/approvals切换批准模式（Read Only/Auto/Full Access）
/init创建 AGENTS.md 文件，为 Codex 提供项目指令
/status显示当前会话配置和令牌使用情况
/diff显示 Git 差异（包括未跟踪文件）
/clear清除会话历史
/prompts显示示例提示
/help显示帮助信息

更多详细信息请参考 Codex 官方教程。