1. 安装 Node.js#

方法：使用官方安装包（推荐）

1. 访问 https://nodejs.org
2. 下载 LTS 版本的 Windows Installer (.msi)
3. 运行安装程序，按默认设置完成安装
4. 安装程序会自动添加到 PATH 环境变量

验证安装：

在CMD/PowerShell里面验证以下命令

1
node --version
2
npm --version

TIP

提示： 建议使用 LTS（长期支持）版本以获得最佳稳定性。安装完成后需重启命令行窗口。

2. 安装 CodeX CLI#

打开命令提示符（以管理员身份运行）或 PowerShell，执行以下命令：

1
npm install -g @openai/codex@latest

验证安装：

1
codex --version

NOTE

注意：如果遇到权限问题，请确保以管理员身份运行命令提示符。

3. 配置 Codex API Key#

1
mkdir %USERPROFILE%\.codex
2
cd %USERPROFILE%\.codex

1
model_provider = "providerTest"
2
model = "gpt-5.1-codex"
3
model_reasoning_effort = "high"
4
network_access = "enabled"
5
disable_response_storage = true
6

7
[model_providers.providerTest]
8
name = "providerTest"
9
base_url = "https://[中转站api].com/v1"
10
wire_api = "responses"
11
requires_openai_auth = true

1
{
2
  "OPENAI_API_KEY": "粘贴为CodeX专用分组令牌key"
3
}

4 启动 CodeX#

配置完成后，先进入到工程目录：

1
mkdir my-codex-project
2
cd my-codex-project

然后，运行以下命令启动：

1
codex

NOTE

首次运行配置：

• • 选择您的开发环境配置
• • 配置代码生成偏好
• • 设置 GPT-5 推理等级
• • 开始 AI 辅助编程！🚀

1. 安装 Node.js#

方法一：使用包管理器（推荐）

Ubuntu/Debian 系统：

1
# 更新软件包列表
2
sudo apt update
3

4
# 安装 Node.js 和 npm
5
sudo apt install -y nodejs npm
6

7
# 验证安装
8
node --version
9
npm --version

CentOS/RHEL/Fedora 系统：

1
# CentOS/RHEL
2
sudo yum update
3
sudo yum install -y nodejs npm
4

5
# Fedora
6
sudo dnf install -y nodejs npm
7

8
# 验证安装
9
node --version
10
npm --version

使用 NodeSource 仓库（推荐，获取最新版本）：

1
# 添加 NodeSource 仓库
2
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
3

4
# 安装 Node.js
5
sudo apt-get install -y nodejs
6

7
# 验证安装
8
node --version
9
npm --version

方法二：使用官方安装包

1. 访问 https://nodejs.org
2. 下载 LTS 版本的 Linux 安装包
3. 按照官方安装说明完成安装
4. 打开终端验证安装成功

1
node --version
2
npm --version

2. 安装 CodeX CLI#

在终端中执行以下命令：

1
# 全局安装 CodeX
2
sudo npm install -g @openai/codex@latest
3

4
# 验证安装
5
codex --version

NOTE

权限问题解决（未遇到过）：如果遇到权限错误，可以配置 npm 使用用户目录： mkdir ~/.npm-global && npm config set prefix '~/.npm-global' 然后将 export PATH=~/.npm-global/bin:$PATH 添加到 ~/.bashrc 中。

3. 配置 Codex API Key#

1
# 创建 CodeX 配置目录
2
mkdir -p ~/.codex
3
cd ~/.codex

1
# 创建配置文件
2
cat > config.toml << 'EOF'
3
model_provider = "providerTest"
4
model = "gpt-5.1-codex"
5
model_reasoning_effort = "high"
6
network_access = "enabled"
7
disable_response_storage = true
8

9
[model_providers.providerTest]
10
name = "providerTest"
11
base_url = "https://[中转站api].com/v1"
12
wire_api = "responses"
13
requires_openai_auth = true
14
EOF

1
# 创建认证文件
2
cat > auth.json << 'EOF'
3
{
4
  "OPENAI_API_KEY": "粘贴为CodeX专用分组令牌key"
5
}
6
EOF

初始化项目并开始使用#

1
# 创建新项目
2
mkdir my-codex-project
3
cd my-codex-project
4

5
# 启动 CodeX
6
codex

配置步骤#

打开 VSCode 的 settings.json 文件，添加以下配置：

1
"chatgpt.apiBase": "https://[中转站api].com/v1",
2
"chatgpt.config": {
3
  "preferred_auth_method": "apikey"
4
}

快捷键说明#

Windows : Ctrl+Shift+P → “Preferences: Open Settings (JSON)”

macOS : Cmd+Shift+P → “Preferences: Open Settings (JSON)”

Linux : Ctrl+Shift+P → “Preferences: Open Settings (JSON)”

NOTE

• 请确保您的 API Token 已经在扩展设置中正确配置
• 配置完成后重启 VSCode 以确保设置生效
• 使用 CodeX 专用 Token 以获得最佳体验