OpenAI Codex 安装配置教程：Easy Claude Code 中转服务使用指南

本文档由 Easy Claude Code 出品，辅助用户简单高效优惠地使用 OpenAI Codex。购买 Claude Code 直接送 Codex，国内用户无需 VPN。

目录

安装 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 密钥

获取密钥

没有密钥的用户请点击此处购买：https://easyclaude.com/store

激活流程：

  1. 购买密钥后访问控制台
  2. 登录即可自动激活使用（激活后开始计时）
  3. 如不想立即使用，可稍后再激活

Mac & Linux 配置

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

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

[model_providers.ecc]
name = "ecc"
base_url = "https://api.easyclaude.com/v1"
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 = "ecc"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.ecc]
name = "ecc"
base_url = "https://api.easyclaude.com/v1"
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 = "ecc"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.ecc]
name = "ecc"
base_url = "https://api.easyclaude.com/v1"
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 = "ecc"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.ecc]
name = "ecc"
base_url = "https://api.easyclaude.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json:

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

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

在终端中运行：

codex --version

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

Q3: 密钥在哪里查看？

登录 ECC 控制台：https://easyclaude.com/app

在控制台中可以查看：

  • API Key
  • 已使用配额
  • 剩余配额
  • 有效期

总结

核心步骤回顾

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

推荐配置流程

Mac/Linux 用户：

# 1. 安装 Codex
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 2. 一键配置
mkdir -p ~/.codex && tee ~/.codex/config.toml >/dev/null <<'EOF'
model_provider = "ecc"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.ecc]
name = "ecc"
base_url = "https://api.easyclaude.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

# 3. 配置密钥
tee ~/.codex/auth.json >/dev/null <<EOF
{
  "OPENAI_API_KEY": "你的sk-key"
}
EOF

Windows 用户：

  1. 安装 Codex
  2. 手动创建 %USERPROFILE%\.codex 目录
  3. 创建 config.toml 和 auth.json 文件
  4. 填入配置内容和密钥

相关资源