OpenAI Codex本地完整配置教程｜（Windows/Mac/Linux全平台，修复鉴权报错）

薛定猫AI2026-08-26 18:04

标签：#codex #AI编程 #vscode插件 #大模型 #开发工具

简介：一份完整可落地的Codex安装配置教程，修复鉴权异常，对接API，覆盖Windows、Mac、Linux系统，同时包含config.toml关键参数修改。

0. 配置修改说明

⚠️这一步是解决鉴权报错的核心，必须操作

  1. 删除下面两行配置
toml 复制代码 
preferred_auth_method = "apikey"
personality = "pragmatic"
  1. 在 [model_providers.api111] 节点内新增一行
toml 复制代码 
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，运行：

bash 复制代码 
npm install -g @openai/codex

3. 验证安装

打开命令提示符 (CMD) 或 PowerShell，运行：

bash 复制代码 
codex --version

配置 API

1. 获取 Auth Token

访问 yunzhicode.com 站点页面进行以下操作：

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

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

  1. 进入当前用户的用户目录下的 .codex 文件夹中，例如：C:\Users\testuser\.codex。 注意：如果看不到该目录，请开启 Windows 的「显示隐藏的项目」。
  2. 如果没有 .codex 文件夹，请手动创建该文件夹，然后在其中创建 config.toml 以及 auth.json 两个文件。
auth.json 配置
json 复制代码 
{"OPENAI_API_KEY": "sk-xxx"}
config.toml 完整配置（已按截图修改，直接复制）

model_reasoning_effort 可选值为 xhigh/high/medium/low，代表模型思考努力程度。

toml 复制代码 
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

🚨重启终端！重启终端！重启终端！

进入到您的工程目录：

bash 复制代码 
cd your-project-folder

运行以下命令启动：

bash 复制代码 
codex

VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。

安装完成后会出现在侧边栏。

Mac 版本教程

系统要求

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

安装步骤

1. 安装 Node.js

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

# 安装 Node.js
brew install node

2. 安装 codex

打开终端 (Terminal)，运行（可能需要加 sudo）：

bash 复制代码 
sudo npm install -g @openai/codex

3. 验证安装

bash 复制代码 
codex --version

配置 API

1. 获取 Auth Token

访问 yunzhicode.com 站点页面进行以下操作：

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

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

  1. 创建目录和文件：
bash 复制代码 
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  1. 编辑 auth.json 文件：
bash 复制代码 
vi ~/.codex/auth.json

按 i 进入插入模式，粘贴下面内容，将 sk-xxx 替换为你的密钥。

json 复制代码 
{"OPENAI_API_KEY": "sk-xxx"}

按 ESC 键，输入 :wq 并回车保存退出。

  1. 编辑 config.toml 文件：
bash 复制代码 
vi ~/.codex/config.toml

按 i 进入插入模式，粘贴完整配置：

toml 复制代码 
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

🚨重启终端！重启终端！重启终端！

bash 复制代码 
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
bash 复制代码 
sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
  • CentOS/RHEL/Fedora
bash 复制代码 
# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)
sudo dnf install nodejs npm
# 或
sudo yum install nodejs npm
  • Arch Linux
bash 复制代码 
sudo pacman -S nodejs npm

2. 安装 codex

打开终端 (Terminal)，运行：

bash 复制代码 
sudo npm install -g @openai/codex

3. 验证安装

bash 复制代码 
codex --version

配置 API

1. 获取 Auth Token

访问 yunzhicode.com 站点页面进行以下操作：

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

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

  1. 创建目录和文件：
bash 复制代码 
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
  1. 编辑 auth.json 文件：
bash 复制代码 
vi ~/.codex/auth.json

按 i 进入插入模式，粘贴下面内容，将 sk-xxx 替换为你的密钥。

json 复制代码 
{"OPENAI_API_KEY": "sk-xxx"}

按 ESC 键，输入 :wq 并回车保存退出。

  1. 编辑 config.toml 文件：
bash 复制代码 
vi ~/.codex/config.toml

按 i 进入插入模式，粘贴完整配置：

toml 复制代码 
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

🚨重启终端！重启终端！重启终端！

bash 复制代码 
cd your-project-folder
codex

VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。

安装完成后会出现在侧边栏。

📌 常见问题排查

调用报错请依次检查：

  1. API令牌分组必须选对应codex分组，分组错误直接无法使用；
  2. 令牌额度设置为无限额度，不要做模型限制；
  3. config.toml必须删除 preferred_auth_method = "apikey"，并且provider块内必须存在 requires_openai_auth = true；
  4. 修改配置文件之后，一定要完全关闭重启终端；
  5. base_url确认填写为 https://yunzhicode.com/v1，末尾带上 /v1；
  6. auth.json里面密钥sk-xxx替换为yunzhicode.com生成真实密钥，不要保留示例文本。

更多 Codex 使用细节，可以查阅官方文档。

相关推荐
w01_02_032 小时前
deepseek, harness , windows , 安装。
windows
辻弋2012 小时前
手动关服务会自动重启、组策略家庭版用不了——Windows Update Blocker用“禁用+锁定”双保险，让Win10/11自动更新彻底闭嘴
服务器·人工智能·windows·电脑·开源软件
躺不平的理查德2 小时前
OpenSSL 的异步 TLS 1.3 加密
linux·运维·服务器
tedcloud1232 小时前
Awesome DSH Plugin 怎么用？给 DeepSeek Harness 搭建自己的插件生态
大数据·linux·服务器·人工智能·音视频
qinwsq3 小时前
Gmssl windows下编译
windows·gmssl
钓鱼的小小猫3 小时前
从零拿捏Linux（一） ---- 命令（视频秒解）
linux·linux命令
懋学的前端攻城狮3 小时前
把 SwiftUI List 换成 NSTableView：一次目录树卡顿的排查记录
macos·swiftui·swift
明王明王3 小时前
Ubuntu 26.04 使用 Windows Spotlight：给 Bing Wallpaper 加上 Spotlight 支持
linux·windows·ubuntu
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02GitHub 镜像站点032026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？04微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新05Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费06历年考研数学一、数学二、数学三真题试卷及答案PDF07AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路08VSCode+CodeX扩展，无法启动092026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片10如何新建文件夹？ 电脑新建文件夹的4种方法