Codex 安装与配置

OpenAI 代码助手，强大的 AI 编程工具。

请先完成「环境准备」章节，确保 Node.js 和 npm 已安装。

Linux / MacOS 配置

步骤 1: 安装 Codex

npm install -g @openai/codex@latest

步骤 2: 创建配置文件夹

在用户目录下创建 .codex 文件夹。

mkdir -p ~/.codex

步骤 3: 创建 config.toml

在 .codex 文件夹里创建 config.toml 文件，并填入下面的内容：

model_provider = "icodeeasy"
model = "gpt-5.3-codex"
disable_response_storage = true
suppress_unstable_features_warning = true
preferred_auth_method = "apikey"
personality = "pragmatic"

[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = true

如果 api.icodeeasy.cc 连接慢，可以把 base_url 换成 https://jp.icodeeasy.cc。

步骤 4: 配置环境变量

添加到 ~/.bashrc 或 ~/.zshrc：

export OPENAI_API_KEY="你的API Key"
export OPENAI_BASE_URL="https://api.icodeeasy.cc"

如果 api.icodeeasy.cc 连接慢，可以把 OPENAI_BASE_URL 换成 https://jp.icodeeasy.cc。

保存后运行 source ~/.bashrc 或 source ~/.zshrc 使配置生效。

步骤 5: 启动 Codex

cd your-project-folder
codex

Windows 配置

步骤 1: 安装 Codex

npm install -g @openai/codex@latest

步骤 2: 创建配置文件夹

查看用户目录：

echo $env:USERPROFILE

在用户目录下创建 .codex 文件夹：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

步骤 3: 创建 config.toml

在 .codex 文件夹里创建 config.toml 文件，并填入下面的内容：

model_provider = "icodeeasy"
model = "gpt-5.3-codex"
disable_response_storage = true
suppress_unstable_features_warning = true
preferred_auth_method = "apikey"
personality = "pragmatic"

[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = true

[features]
elevated_windows_sandbox = true

如果 api.icodeeasy.cc 连接慢，可以把 base_url 换成 https://jp.icodeeasy.cc。

步骤 4: 配置环境变量（PowerShell）

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的API Key", "User")

设置后需要重新打开 PowerShell 才能生效。

步骤 5: 启动 Codex

新开一个 PowerShell，进入工程目录并启动：

cd your-project-folder
codex

VSCode 配置

请先按上面的步骤配置好 Codex CLI，并确认命令行里可以正常启动和使用 Codex。VSCode 扩展依赖同一份用户目录下的 ~/.codex/config.toml 配置文件和系统环境变量。

步骤 1: 安装 Codex 扩展

在 VSCode 扩展市场搜索并安装 Codex。

步骤 2: 打开配置文件

Codex VSCode 扩展会复用用户目录下的 .codex/config.toml 配置。请按上面的 Linux / MacOS 或 Windows 步骤创建 .codex 文件夹和 config.toml 文件。

步骤 3: 配置 API Key

如果 VSCode 扩展提示需要输入 API Key，请到 密钥设置 页面复制密钥并填入。