Codex 安装与配置教程

​

Windows 版本教程

​

系统要求

• Windows 10 或 Windows 11
• Node.js 22+
• npm 10+
• 网络连接

​

安装步骤

npm install -g @openai/codex

codex --version

​

配置 API

• 点击 控制台 → API令牌 页面
• 点击 添加令牌
• 令牌分组请选择：codex专属（务必选择此分组，否则无法使用）
• 令牌名称随意
• 额度建议：设置为 无限额度
• 其他选项保持默认

重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！

1. 进入当前用户的用户目录下的 .codex 文件夹中，例如：C:\Users\testuser\.codex。 （注意：如果看不到该目录，说明您没有打开 Windows 的“显示隐藏的项目”，请先在文件资源管理器中开启。）

2. 如果没有 .codex 文件夹，请手动创建该文件夹，然后在其中创建 config.toml 以及 auth.json 两个文件。

3. 填写配置 (需要将 sk-xxx 替换成您自己创建的真实 SK)。

{"OPENAI_API_KEY": "sk-xxx"}

model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://onetoken.one/v1"
wire_api = "responses"

​

启动 codex

cd your-project-folder

codex

​

VSCode 插件 codex

​

​

Mac 版本教程

​

系统要求

• macOS 12 或更高版本
• Node.js 22+
• npm 10+
• 网络连接

​

安装步骤

• 方式一：直接访问 Node.js 官网 下载并安装最新 LTS 版本。
• 方式二：使用 Homebrew（推荐）
  # 如果尚未安装 Homebrew，请先运行此命令
  /bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"
  
  # 安装 Node.js
  brew install node
  

npm install -g @openai/codex

codex --version

​

配置 API

• 点击 控制台 → API令牌 页面
• 点击 添加令牌
• 令牌分组请选择：codex特供（务必选择此分组，否则无法使用）
• 令牌名称随意
• 额度建议：设置为 无限额度
• 其他选项保持默认

重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！

1. 创建目录和文件：
   mkdir -p ~/.codex
   touch ~/.codex/auth.json
   touch ~/.codex/config.toml
   
2. 编辑 auth.json 文件：
   vi ~/.codex/auth.json
   
   按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。
   { "OPENAI_API_KEY": "sk-xxx" }
   
3. 编辑 config.toml 文件：
   vi ~/.codex/config.toml
   
   按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。
   model_provider = "api111"
   model = "gpt-5-codex"
   model_reasoning_effort = "high"
   disable_response_storage = true
   preferred_auth_method = "apikey"
   
   [model_providers.api111]
   name = "api111"
   base_url = "https://onetoken.one/v1"
   wire_api = "responses"
   

​

启动 codex

cd your-project-folder

codex

​

VSCode 插件 codex

​

Linux 版本教程

​

系统要求

• 主流 Linux 发行版 (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)
• Node.js 22+
• npm 10+
• 网络连接

​

安装步骤

• Ubuntu/Debian
  sudo apt update
  curl -fsSL [https://deb.nodesource.com/setup_lts.x](https://deb.nodesource.com/setup_lts.x) | sudo -E bash -
  sudo apt-get install -y nodejs
  
• CentOS/RHEL/Fedora
  # 使用 dnf (Fedora) 或 yum (CentOS/RHEL)
  sudo dnf install nodejs npm
  # 或
  sudo yum install nodejs npm
  
• Arch Linux
  sudo pacman -S nodejs npm
  

sudo npm install -g @openai/codex

codex --version

​

配置 API

• 点击 控制台 → API令牌 页面
• 点击 添加令牌
• 令牌分组请选择：codex渠道-gpt（务必选择此分组，否则无法使用）
• 令牌名称随意
• 额度建议：设置为 无限额度
• 其他选项保持默认 [图片]

重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！ 重要提示：请将下方的 sk-xxx 替换为您在 onetoken.one 生成的实际 API 密钥！

1. 创建目录和文件：
   mkdir -p ~/.codex
   touch ~/.codex/auth.json
   touch ~/.codex/config.toml
   
2. 编辑 auth.json 文件：
   vi ~/.codex/auth.json
   
   按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。
   { "OPENAI_API_KEY": "sk-xxx" }
   
3. 编辑 config.toml 文件：
   vi ~/.codex/config.toml
   
   按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。
   model_provider = "api111"
   model = "gpt-5-codex"
   model_reasoning_effort = "high"
   disable_response_storage = true
   preferred_auth_method = "apikey"
   
   [model_providers.api111]
   name = "api111"
   base_url = "https://onetoken.one/v1"
   wire_api = "responses"
   

​

启动 codex

cd your-project-folder

codex

​

VSCode 插件 codex

​

​

常见问题

1. 确认 API Key 创建是否正确：额度选择无限额度，不要限制模型，分组选择 codex渠道-gpt。