NextAI 产品文档

Appearance

在 Codex Cli 中使用 NextAI API ​

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

什么是 Codex？ ​

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

配置方式 ​

获取 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 的版本信息，说明安装成功。

配置 API ​

  1. 找到配置目录

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

js
C:\Users\YourUsername\.codex

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

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

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

  1. 配置 config.toml

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

js
model_provider = "NextAIAPI"
model = "gpt-6.1-sol"
model_reasoning_effort = "medium"
model_verbosity = "high"
web_search = "live"

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

参数说明：

  • model: Codex 默认使用的模型名称，可自行修改
  • model_reasoning_effort: 推理级别，可自行修改
  • 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 的版本信息，说明安装成功。

配置 API ​

  1. 创建配置目录

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

js
~/.codex

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

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

  1. 配置 config.toml

编辑 config.toml 文件：

js
model_provider = "NextAIAPI"
model = "gpt-6.1-sol"
model_reasoning_effort = "medium"
model_verbosity = "high"
web_search = "live"

[model_providers.NextAIAPI]
name = "NextAIAPI"
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 插件配置 ​

安装官方插件 ​

在 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 官方教程。