CodeX CLI 保姆级安装与配置指南

1. 安装 Node.js

CodeX 和 npm 都依赖 Node.js 环境。

下载安装：到 Node.js 官网 下载 LTS（长期支持）版本的 Windows Installer(.msi)，运行安装程序按默认设置装完即可——安装程序会自动把 Node.js 加进系统 PATH。

验证安装：打开命令提示符或 PowerShell，确认 Node 和 npm 都装好了：

node --version
npm --version

2. 安装 CodeX CLI

用 npm 全局安装。请以管理员身份打开命令提示符或 PowerShell，执行：

npm install -g @openai/codex@latest

装完验证：

codex --version

如果安装过程中遇到权限问题，确认你是以管理员身份运行的终端。

3. 配置 CodeX API

3.1 获取专用 API Token

访问 CodeX 控制台，注册或登录后进入"API 密钥"页面，点"创建新密钥"并选择 CodeX 专用分组，复制生成的 API Key。注意：这个 token 和你在 Claude Code 里用的不是同一个。

3.2 创建配置目录

打开命令提示符或 PowerShell，创建 CodeX 的配置目录：

# 创建 CodeX 配置目录
mkdir %USERPROFILE%\.codex

# 进入配置目录
cd %USERPROFILE%\.codex

创建 config.toml：在 %USERPROFILE%\.codex 目录下，用文本编辑器新建 config.toml，粘贴以下内容：

model_provider = "duckcoding"
model = "gpt-5-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true

[model_providers.duckcoding]
name = "duckcoding"
base_url = "https://blog.biekanle.com"
wire_api = "responses"
requires_openai_auth = true

创建 auth.json：在同一目录下新建 auth.json，把你的 CodeX 专用令牌粘进去：

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

4. 初始化项目并使用

配置完成后，新建一个项目目录进去：

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

然后启动 CodeX 命令行工具：

codex