CodeX CLI 配置使用教程

编程插件Tokens消耗量很大，请注意Tokens消耗

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 用户

# 安装 Node.js LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# 验证安装
node --version

MacOS 用户

# 安装 Xcode 命令行工具
sudo xcode-select --install

# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 通过 Homebrew 安装 Node.js
brew install node

# 验证安装
node --version

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

三、环境配置

获取必要的配置信息
您需要准备两个重要的配置项：

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

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

启动 CodeX CLI 前的环境准备

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

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

# 进入项目目录
cd your-project-folder

# 设置环境变量
export OPENAI_API_KEY="sk-..."  # 替换为您的实际令牌
export OPENAI_BASE_URL="https://api.coolyeah.net/v1"

# 启动 CodeX CLI
codex

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

自动配置脚本

# 替换下方的 sk-... 为您的实际令牌
AUTH_TOKEN="sk-..."
BASE_URL="https://api.coolyeah.net/v1"

# 写入配置到各个 shell 配置文件
echo -e "export OPENAI_API_KEY=$AUTH_TOKEN" >> ~/.bash_profile
echo -e "export OPENAI_BASE_URL=$BASE_URL" >> ~/.bash_profile

echo -e "export OPENAI_API_KEY=$AUTH_TOKEN" >> ~/.bashrc
echo -e "export OPENAI_BASE_URL=$BASE_URL" >> ~/.bashrc

echo -e "export OPENAI_API_KEY=$AUTH_TOKEN" >> ~/.zshrc
echo -e "export OPENAI_BASE_URL=$BASE_URL" >> ~/.zshrc

使配置生效
重启终端后，就可以直接使用了

四、运行

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

启动 Codex CLI
进入项目目录后，直接输入命令运行：

cd your-project-folder
codex --model gpt-5-2025-08-07

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

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

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

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

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

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

CodeX CLI 配置使用教程

系统要求#

安装 Node.js#

Ubuntu / Debian 用户#

MacOS 用户#

CodeX CLI#

一、下载#

二、安装#

三、环境配置#

四、运行#

系统要求

安装 Node.js

Ubuntu / Debian 用户

MacOS 用户

CodeX CLI

一、下载

二、安装

三、环境配置

四、运行