安装 Codex CLI

Codex CLI 是 OpenAI 推出的代码生成命令行工具,专为编程任务优化。本教程将带你从零开始安装 Codex CLI。

前置要求

验证 Node.js 是否已安装:

node -v

node

如果看到 v22.x.x 或更高版本号,即可继续。

安装步骤

macOS / Linux
Windows

第 1 步:使用 npm 全局安装

打开终端,运行以下命令:

npm install -g @openai/codex

npm

等待安装完成。

如果提示权限不足

在命令前加上 sudo

sudo npm install -g @openai/codex

第 2 步:验证安装

codex --version

version

第 3 步:首次启动

codex

run

配置 Du's API

安装完成后,需要配置 Du's API 才能使用。Codex CLI 使用两个配置文件来管理设置。

已有配置文件?

如果你之前已经配置过 Codex CLI(比如用过官方 API),只需要修改以下字段:

  1. 打开 ~/.codex/config.toml,找到 [model_providers.OpenAI] 部分,修改 base_url
[model_providers.OpenAI]
base_url = "https://api.dusapi.com"
  1. 打开 ~/.codex/auth.json,修改 API Key:
{
  "OPENAI_API_KEY": "你的 Du's API Key"
}

修改后保存,重新启动 Codex CLI 即可生效。

第 1 步:创建配置目录

macOS / Linux
Windows
mkdir -p ~/.codex

第 2 步:创建 config.toml

  • macOS/Linux 路径:~/.codex/config.toml
  • Windows 路径:%USERPROFILE%\.codex\config.toml

配置内容

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.dusapi.com"
wire_api = "responses"
requires_openai_auth = true
配置说明
  • model:默认使用的模型,可以改为其他 GPT 或 Codex 模型
  • base_url:Du's API 的基础 URL(系统会自动添加 /v1
  • model_context_window:模型的上下文窗口大小

第 3 步:创建 auth.json

  • macOS/Linux 路径:~/.codex/auth.json
  • Windows 路径:%USERPROFILE%\.codex\auth.json

配置内容

{
  "OPENAI_API_KEY": "your-api-key-here"
}
重要提示

请将 your-api-key-here 替换为你在 Du's API 控制台 创建的实际 API Key。

第 4 步:验证配置

codex "Write a hello world function in Python"

如果看到生成的代码输出,说明配置成功。

更新 Codex CLI

npm update -g @openai/codex

卸载 Codex CLI

npm uninstall -g @openai/codex

下一步