标签：#codex #AI编程 #vscode插件 #大模型 #开发工具 简介：一份完整可落地的Codex安装配置教程，修复鉴权异常，对接API，覆盖Windows、Mac、Linux系统，同时包含config.toml关键参数修改。
0. 配置修改说明
⚠️这一步是解决鉴权报错的核心，必须操作
preferred_auth_method = "apikey"
personality = "pragmatic"
requires_openai_auth = true
下文给出的完整 config.toml 已经完成修改，直接复制使用即可。
Windows 版本教程
系统要求
- Windows 10 或 Windows 11
- Node.js 22+
- npm 10+
- 网络连接
安装步骤
前置步骤！！！ 安装 Git Bash，请访问 Git – Downloads 下载对应您电脑系统的版本，之后一直点击“下一步”即可完成安装。
1. 安装 Node.js 访问 Node.js 官网 下载并安装最新 LTS 版本。
2. 安装 codex 打开命令提示符 (CMD) 或 PowerShell，运行：
npm install -g @openai/codex
3. 验证安装 打开命令提示符 (CMD) 或 PowerShell，运行：
codex –version
配置 API
1. 获取 Auth Token 访问 yunzhicode.com 站点页面进行以下操作：
- 点击 控制台 → API令牌 页面
- 点击 添加令牌
- 令牌分组请选择：codex专属（务必选择此分组，否则无法使用）
- 令牌名称随意
- 额度建议：设置为 无限额度
- 其他选项保持默认
重要提示：请将下方的 sk-xxx 替换为您在 yunzhicode.com 生成的实际 API 密钥！
注意：如果看不到该目录，请开启 Windows 的「显示隐藏的项目」。
auth.json 配置
{"OPENAI_API_KEY": "sk-xxx"}
config.toml 完整配置（已按截图修改，直接复制）
model_reasoning_effort 可选值为 xhigh/high/medium/low，代表模型思考努力程度。
model_provider = "api111"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
[model_providers.api111]
name = "api111"
base_url = "https://yunzhicode.com/v1"
wire_api = "responses"
requires_openai_auth = true
启动 codex
🚨重启终端！重启终端！重启终端！
进入到您的工程目录：
cd your-project-folder
运行以下命令启动：
codex
VSCode 插件 codex
以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。 安装完成后会出现在侧边栏。
Mac 版本教程
系统要求
- macOS 12 或更高版本
- Node.js 22+
- npm 10+
- 网络连接
安装步骤
1. 安装 Node.js
- 方式一：直接访问 Node.js 官网 下载并安装最新 LTS 版本。
- 方式二：使用 Homebrew（推荐）
# 如果尚未安装 Homebrew，请先运行此命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js
brew install node
2. 安装 codex 打开终端 (Terminal)，运行（可能需要加 sudo）：
sudo npm install -g @openai/codex
3. 验证安装
codex –version
配置 API
1. 获取 Auth Token 访问 yunzhicode.com 站点页面进行以下操作：
- 点击 控制台 → API令牌 页面
- 点击 添加令牌
- 令牌分组请选择：codex特供（务必选择此分组，否则无法使用）
- 令牌名称随意
- 额度建议：设置为 无限额度
- 其他选项保持默认
重要提示：请将下方的 sk-xxx 替换为您在 yunzhicode.com 生成的实际 API 密钥！
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
vi ~/.codex/auth.json
按 i 进入插入模式，粘贴下面内容，将 sk-xxx 替换为你的密钥。
{"OPENAI_API_KEY": "sk-xxx"}
按 ESC 键，输入 :wq 并回车保存退出。
vi ~/.codex/config.toml
按 i 进入插入模式，粘贴完整配置：
model_provider = "api111"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
[model_providers.api111]
name = "api111"
base_url = "https://yunzhicode.com/v1"
wire_api = "responses"
requires_openai_auth = true
按 ESC 键，输入 :wq 并回车保存退出。
启动 codex
🚨重启终端！重启终端！重启终端！
cd your-project-folder
codex
VSCode 插件 codex
以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。 安装完成后会出现在侧边栏。
Linux 版本教程
系统要求
- 主流 Linux 发行版 (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)
- Node.js 22+
- npm 10+
- 网络连接
安装步骤
1. 安装 Node.js
- Ubuntu/Debian
sudo apt update
curl -fsSL 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
2. 安装 codex 打开终端 (Terminal)，运行：
sudo npm install -g @openai/codex
3. 验证安装
codex –version
配置 API
1. 获取 Auth Token 访问 yunzhicode.com 站点页面进行以下操作：
- 点击 控制台 → API令牌 页面
- 点击 添加令牌
- 令牌分组请选择：codex渠道-gpt（务必选择此分组，否则无法使用）
- 令牌名称随意
- 额度建议：设置为 无限额度
- 其他选项保持默认
重要提示：请将下方的 sk-xxx 替换为您在 yunzhicode.com 生成的实际 API 密钥！
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
vi ~/.codex/auth.json
按 i 进入插入模式，粘贴下面内容，将 sk-xxx 替换为你的密钥。
{"OPENAI_API_KEY": "sk-xxx"}
按 ESC 键，输入 :wq 并回车保存退出。
vi ~/.codex/config.toml
按 i 进入插入模式，粘贴完整配置：
model_provider = "api111"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
[model_providers.api111]
name = "api111"
base_url = "https://yunzhicode.com/v1"
wire_api = "responses"
requires_openai_auth = true
按 ESC 键，输入 :wq 并回车保存退出。
启动 codex
🚨重启终端！重启终端！重启终端！
cd your-project-folder
codex
VSCode 插件 codex
以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。 安装完成后会出现在侧边栏。
📌 常见问题排查
调用报错请依次检查：
更多 Codex 使用细节，可以查阅官方文档。
