1. 安装 Node.js (推荐)
CodeX 和 npm (Node Package Manager) 都依赖 Node.js 环境。
- 下载与安装:
- 访问 Node.js 官网:
https://nodejs.org
- 下载 LTS (长期支持) 版本的 Windows Installer (.msi)。
- 运行安装程序,按默认设置完成安装即可。
- 安装程序会自动将 Node.js 添加到系统的 PATH 环境变量中。
- 访问 Node.js 官网:
- 验证安装:
- 打开 命令提示符 或 PowerShell。
- 运行以下命令来确认 Node 和 npm 是否安装成功:
Bash
node --version npm --version
2. 安装 CodeX CLI
使用 npm 全局安装 CodeX 命令行工具。
- 执行安装命令:
- 请以管理员身份打开 命令提示符 或 PowerShell。
- 执行全局安装命令:
Bash
npm install -g @openai/codex@latest
- 验证安装:
- 安装完成后,运行以下命令:
Bash
codex --version
- 注意: 如果在安装过程中遇到权限问题,请务必确认您是以管理员身份运行的命令提示符。
- 安装完成后,运行以下命令:
3. 配置 CodeX API
CodeX 需要专门的 API 密钥和配置文件来连接服务。
步骤 3.1: 获取 CodeX 专用 API Token
- 访问 CodeX 控制台。
- 注册或登录您的账户。
- 进入 "API 密钥" 页面。
- 点击 "创建新密钥",并选择 CodeX 专用分组。
- 复制生成的 API Key。
重要提示: 这个 CodeX 专用的 API 令牌与您在 Claude Code 中使用的令牌是不同的。
步骤 3.2: 创建配置文件夹和文件 (Windows 路径示例)
打开命令提示符或 PowerShell,创建 CodeX 的配置目录:
# 创建 CodeX 配置目录
mkdir %USERPROFILE%\.codex
# 进入配置目录
cd %USERPROFILE%\.codex
1. 创建 config.toml
文件:
在 %USERPROFILE%\.codex
目录下,使用文本编辑器创建 config.toml
文件,并粘贴以下内容:
Ini, 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
2. 创建 auth.json
文件:
在同一目录下创建 auth.json
文件,并将您的 CodeX 专用令牌粘贴进去:
{
"OPENAI_API_KEY": "粘贴为CodeX专用分组令牌key"
}
4. 初始化项目并开始使用
配置完成后,您就可以在一个新项目中使用 CodeX 了。
- 创建并进入项目目录:
mkdir my-codex-project cd my-codex-project
- 启动 CodeX 命令行工具:
codex