CodeX CLI 配置使用教程

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

系统要求

Node.js 版本 ≥ 18.0

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

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

安装 Node.js

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

Ubuntu / Debian 用户

MacOS 用户

CodeX CLI

一、下载

CodeX CLI 官方下载地址：

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

Github 地址：

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

二、安装

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

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

使用 npm 安装

npm install -g @openai/codex

使用 Homebrew 安装

brew install codex

三、环境配置

1. 获取必要的配置信息

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

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

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

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

📌

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

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

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

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

自动配置脚本

使配置生效

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

四、运行

1. 确定使用的模型

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

2. 启动 Codex CLI

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

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

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

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

3. 成功启动

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

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

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

CodeX CLI 配置使用教程

系统要求#

安装 Node.js#

Ubuntu / Debian 用户#

MacOS 用户#

CodeX CLI#

一、下载#

二、安装#

三、环境配置#

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

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

四、运行#

1. 确定使用的模型#

2. 启动 Codex CLI#

3. 成功启动#

系统要求

安装 Node.js

Ubuntu / Debian 用户

MacOS 用户

CodeX CLI

一、下载

二、安装

三、环境配置

1. 获取必要的配置信息

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

四、运行

1. 确定使用的模型

2. 启动 Codex CLI

3. 成功启动