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

—— 别看了 · 2026