跳到主要内容

CodeX 安装指南

🚀 CodeX 快速开始​

企业级 AI 编程助手，GPT-5 驱动

1️⃣ 环境准备 → 2️⃣ 安装配置 → 3️⃣ 开始编程

系统要求​

  • Windows: Windows 10 或 Windows 11, Node.js 18+
  • macOS: macOS 10.15+, Node.js 18+
  • Linux: Ubuntu 18.04+, CentOS 7+, Debian 9+, Node.js 18+
  • 网络连接

Windows 完整安装教程​

1. 安装 Node.js​

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

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

方法二：使用包管理器

使用 Winget：

winget install OpenJS.NodeJS.LTS

使用 Chocolatey：

choco install nodejs-lts

使用 Scoop：

scoop install nodejs-lts

验证安装：

node --version
npm --version

2. 安装 CodeX CLI​

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

npm install -g @openai/codex@latest

验证安装：

codex --version

3. 配置 API​

3.1 获取 CodeX 专用 API Token​

• 访问控制台 • 注册账户或登录现有账户 • 进入 "API 密钥" 页面 • 点击 "创建新密钥"，选择 CodeX 专用分组 • 复制生成的 API Key

重要：CodeX 需要使用专门的分组令牌，与 Claude Code 的令牌不同！

3.2 创建配置文件夹​

mkdir %USERPROFILE%\.codex
cd %USERPROFILE%\.codex

3.3 创建配置文件​

  1. 创建 config.toml 文件：
model_provider = "xcode"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true

[model_providers.xcode]
name = "xcode"
base_url = "https://router.052.io/v1"
wire_api = "responses"
requires_openai_auth = true
  1. 创建 auth.json 文件：
{
  "OPENAI_API_KEY": "粘贴为CodeX专用分组令牌key"
}

4. 启动 CodeX​

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

mkdir my-codex-project
cd my-codex-project

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

codex

首次运行配置：

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

macOS 安装教程​

1. 安装 Node.js​

brew install node

2. 安装 CodeX​

npm install -g @openai/codex@latest

3. 配置​

创建 ~/.codex/ 目录和配置文件：

config.toml：

model_provider = "xcode"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true

[model_providers.xcode]
name = "xcode"
base_url = "https://router.052.io/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json：

{
  "OPENAI_API_KEY": "your-codex-token"
}

4. 启动​

codex

Linux 安装教程​

1. 安装 Node.js​

Ubuntu/Debian：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 安装 CodeX​

npm install -g @openai/codex@latest

3. 配置​

创建 ~/.codex/ 目录和配置文件（同 macOS）。

4. 启动​

codex

VSCode 配置教程​

配置步骤​

  1. 打开 VSCode 的 settings.json 文件
  2. 添加以下配置：
{
  "chatgpt.apiBase": "https://router.052.io/v1",
  "chatgpt.config": {
    "preferred_auth_method": "apikey"
  }
}

快捷键说明​

  • Windows: Ctrl+Shift+P → "Preferences: Open Settings (JSON)"
  • macOS: Cmd+Shift+P → "Preferences: Open Settings (JSON)"
  • Linux: Ctrl+Shift+P → "Preferences: Open Settings (JSON)"

配置说明

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