Codex 配置教程

环境准备

安装 Node.js

下载 Node.js

访问 Node.js 官网：https://nodejs.org/en/download

重要提示：

• 请选择正确的芯片架构（x64 或 ARM64）
• 确保 Node.js 版本为 18.0 以上

验证安装

下载后点击安装包进行安装。安装完成后，打开终端验证：

node --version
npm --version

如果显示版本号，则安装成功。

---

安装 Codex 客户端

打开终端，执行以下命令：

npm install -g @openai/codex --registry=https://registry.npmmirror.com

---

配置 API 密钥

Mac & Linux 配置

使用一条命令即可完成配置：

# 创建配置目录并写入配置文件
mkdir -p ~/.codex && tee ~/.codex/config.toml >/dev/null <<'EOF'
model_provider = "amz123"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.amz123]
name = "amz123"
base_url = "系统下发的API地址"
wire_api = "responses"
requires_openai_auth = true
EOF

# 配置密钥（请将 "你的sk-key" 替换为实际密钥）
tee ~/.codex/auth.json >/dev/null <<EOF
{
  "OPENAI_API_KEY": "你的sk-key"
}
EOF

手动配置方式：

如果一键命令失败，可以手动创建文件：

1. 创建 ~/.codex/config.toml 文件：

model_provider = "amz123"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.amz123]
name = "amz123"
base_url = "系统下发的API地址"
wire_api = "responses"
requires_openai_auth = true

2. 创建 ~/.codex/auth.json 文件：

{
  "OPENAI_API_KEY": "你的密钥"
}

---

Windows 配置

Windows 用户需要手动创建配置文件。

1. 创建配置目录

按 Win + R，输入 %USERPROFILE%，打开用户目录。

在该目录下创建 .codex 文件夹（如果不存在）。

2. 创建 config.toml 文件

在 .codex 文件夹中创建 config.toml 文件，内容如下：

model_provider = "amz123"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.amz123]
name = "amz123"
base_url = "系统下发的API地址"
wire_api = "responses"
requires_openai_auth = true

3. 创建 auth.json 文件

在 .codex 文件夹中创建 auth.json 文件，内容如下：

{
  "OPENAI_API_KEY": "你的密钥"
}

---

常见问题解决

Q1: 401 报错

原因：配置文件格式有问题或密钥错误。

解决方法：

1. 检查 config.toml 和 auth.json 文件格式是否正确
2. 建议使用文本编辑器打开文件，检查是否有多余空格或特殊字符
3. 确认密钥已正确复制（无多余空格）

标准配置参考：

config.toml:

model_provider = "amz123"
model = "gpt-5.2-codex"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.amz123]
name = "amz123"
base_url = "系统下发的API地址"
wire_api = "responses"
requires_openai_auth = true

auth.json:

{
  "OPENAI_API_KEY": "你的密钥"
}

Q2: 如何验证配置是否成功？

在终端中运行：

codex --version

如果显示版本号，说明安装成功。

总结

核心步骤回顾

1. ✅ 安装 Node.js：确保版本 18.0+
2. ✅ 安装 Codex 客户端：使用 npm 全局安装
3. ✅ 配置 API 密钥：
   • Mac/Linux：一键脚本或手动创建配置文件
   • Windows：手动创建 .codex 目录和配置文件
4. ✅ 验证配置：运行 codex --version 检查