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

1. 安装 Node.js (推荐)

CodeX 和 npm (Node Package Manager) 都依赖 Node.js 环境。

• 下载与安装：
  • 访问 Node.js 官网：https://nodejs.org
  • 下载 LTS (长期支持) 版本的 Windows Installer (.msi)。
  • 运行安装程序，按默认设置完成安装即可。
  • 安装程序会自动将 Node.js 添加到系统的 PATH 环境变量中。
• 验证安装：
  • 打开 命令提示符 或 PowerShell。
  • 运行以下命令来确认 Node 和 npm 是否安装成功：
    node --version
    npm --version
    

2. 安装 CodeX CLI

使用 npm 全局安装 CodeX 命令行工具。

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

    npm install -g @openai/codex@latest
    

• 验证安装：
  • 安装完成后，运行以下命令：

    codex --version
    

  • 注意： 如果在安装过程中遇到权限问题，请务必确认您是以管理员身份运行的命令提示符。

3. 配置 CodeX API

CodeX 需要专门的 API 密钥和配置文件来连接服务。

步骤 3.1: 获取 CodeX 专用 API Token

1. 访问 CodeX 控制台。
2. 注册或登录您的账户。
3. 进入 "API 密钥" 页面。
4. 点击 "创建新密钥"，并选择 CodeX 专用分组。
5. 复制生成的 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 文件，并粘贴以下内容：

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