Codex CLI 基本介绍

CodeX CLI 是一个强大的 AI 编程助手，让您可以直接在终端与 AI 协作编程，本教程将指导您完成安装与配置。

请先检查令牌里的分组设置

确保令牌的分组里只选择/使用了【Codex 专属分组】，其他的分组不可以在 Codex 中使用，否则会报错，请注意！

CodeX CLI 安装要求

Node.js 版本 ≥ 18.0

支持的操作系统：macOS、Linux、Windows (WSL)

如果您使用 Windows 系统，请确保安装了 WSL 来使用以下代码及运行 CodeX CLI，请勿使用 Windows 自带的 cmd。

安装 Node.js

💡 提示：如果您已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。

Windows

MacOS

Ubuntu / Debian

CodeX CLI 下载与安装

一、CodeX CLI 下载

CodeX CLI 官方下载地址：

https://developers.openai.com/codex/cli

Github 地址：

https://github.com/openai/codex/releases

二、CodeX CLI 安装

官方教程的安装步骤已经比较详细了，这里直接引用方便大家查看，具体的安装请参考官方，本教程后续主要详细介绍怎样配置 API。

请注意安装过程不需要开梯子。

使用 npm 安装

npm install -g @openai/codex

使用 Homebrew 安装

brew install codex

三、CodeX CLI 配置第三方 API

1. 获取必要的配置信息

您需要准备两个重要的配置项：

配置项	说明	获取方式
OPENAI_API_KEY	API 认证令牌	注册后在 `API令牌` 页面点击 `添加令牌` 获得（以 `sk-` 开头）
OPENAI_BASE_URL	API 服务地址	使用 `https://api.n1n.ai/v1`

📝 创建令牌时的建议设置：
名称：随意命名
额度：设为无限额度
其他选项：保持默认设置 (至少添加 3 个分组如果有)

2. 启动 CodeX CLI 前的环境准备

📌

以下环境配置方式 2 选 1 即可，可以先使用方式 1 跑通环境，再使用方式 2 避免每次启动 CodeX CLI 都进行配置。

方式 1：临时配置 CodeX CLI 环境
请在您的项目目录下运行：

方式 2：永久配置 CodeX CLI 环境

为了避免每次都需要手动设置环境变量，建议将配置写入系统配置文件：

自动配置脚本

更改 config.toml 文件

找到 ~/.codex/config.toml文件（若不存在可创建此文件），打开文件并删除所有内容，复制以下代码到文件中，然后保存：

model = "gpt-5.4"
model_reasoning_effort = "medium"
openai_base_url="https://api.n1n.ai/v1"
personality = "pragmatic"
[projects."~/"]
trust_level = "trusted"

使配置生效

重启 CodeX CLI 终端后，就可以直接使用了

任何时候遇到以下问题，耐心等待就可以，不要做任何操作：

四、运行 CodeX CLI

1. 确定使用的模型

如果你想使用的模型是 gpt-5.4，在 n1n 平台上对应的模型名称为“gpt-5.4”，则启动时需要用上参数 --model gpt-5.4。

2. 启动 Codex CLI

进入项目目录后，直接输入命令运行：

启动后在界面中选择第 2 项：

请注意需要选择使用 API 运行 CodeX CLI。

第一次运行时需要选择第 1 项给予权限，如下图：

3. 成功启动

成功启动后，输入 “你好” 进行测试，得到成功返回：

🎉🎉 恭喜！ 现在您可以开始与您的 AI 编程搭档一起写代码了！

💡 提示：如遇到其他问题，请查看官方文档或联系技术支持。

CodeX CLI 配置使用 API 教程

Codex CLI 基本介绍#

CodeX CLI 安装要求#

安装 Node.js#

CodeX CLI 下载与安装#

一、CodeX CLI 下载#

二、CodeX CLI 安装#

三、CodeX CLI 配置第三方 API#

1. 获取必要的配置信息#

2. 启动 CodeX CLI 前的环境准备#

四、运行 CodeX CLI#

1. 确定使用的模型#

2. 启动 Codex CLI#

3. 成功启动#

Codex CLI 基本介绍

CodeX CLI 安装要求

安装 Node.js

CodeX CLI 下载与安装

一、CodeX CLI 下载

二、CodeX CLI 安装

三、CodeX CLI 配置第三方 API

1. 获取必要的配置信息

2. 启动 CodeX CLI 前的环境准备

四、运行 CodeX CLI

1. 确定使用的模型

2. 启动 Codex CLI

3. 成功启动