NextAI 产品文档

Appearance

在 Codex 中使用 NextAI API ​

学习如何使用 NextAI API 完成 OpenAI Codex 的配置。

什么是 Codex？ ​

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

NextAI API 支持的 Codex 模型： ​

  • gpt-5.4 - 最新的 GPT-5.4 模型
  • gpt-5.3-codex - 专为代码优化的 GPT-5.3 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.121.0 的信息，说明安装成功。

配置 API ​

  1. 找到配置目录

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

js
C:\Users\YourUsername\.codex

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

  1. 创建配置文件

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

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

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

js
model_provider = "nextaicore"
model = "gpt-5.4"  # 可更改为 "gpt-5.3-codex"
model_reasoning_effort = "medium"
model_verbosity = "high"
disable_response_storage = true

[features]
web_search_request = true

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

参数说明：

  • model: 可选 gpt-5.4 或 gpt-5.3-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.121.0 的信息，说明安装成功。

配置 API ​

  1. 创建配置目录

在访达界面按下 “Command+Shift+G”，输入以下路径并回车，打开 Codex 配置目录：

js
~/.codex

新建config.toml、auth.json以及AGENTS.md（可略）文件：

js
config.toml：Codex 的核心配置文件，中转服务与 MCP 等都在此文件配置

auth.json：存放中转站获取的 API Key 密钥

AGENTS.md：Codex 全局工作的提示词
  1. 配置 config.toml

编辑 config.toml 文件：

js
model_provider = "nextaicore"
model = "gpt-5.4"  # 可更改为 "gpt-5.3-codex"
model_reasoning_effort = "medium"
model_verbosity = "high"
disable_response_storage = true

[features]
web_search_request = true

[model_providers.nextaicore]
name = "nextaicore"
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. 配置 AGENTS.md（可略）

编辑 AGENTS.md 文件：

js
# Codex全局工作指南

## 回答风格:
 - 回答必须使用中文
 - 对总结、Plan、Task、以及长内容的输出，优先进行逻辑整理后使用美观的Table格式整齐输出；普通内容正常输出
  1. 启动 Codex

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

js
cd your-project
codex

VSCode Codex 插件配置 ​

安装官方插件 ​

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

常见命令参考 ​

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

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

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