Codex配置GPT的保姆级教程

目录

• 这篇教程能帮你解决什么
• Windows 版本教程
• 系统要求
• 安装步骤
• 配置 API（核心）
• 启动 codex
• VSCode 插件
• macOS 版本教程
• 系统要求
• 安装 Node.js（推荐 Homebrew）
• 安装 codex
• 配置 API
• 启动
• Linux 版本教程
• 系统要求
• 安装 Node.js
• 安装 codex
• 配置
• 启动
• 常见报错排查

如果你已经装好了 Codex，却卡在
401、invalid_api_key、model not found，
大概率不是你不会用，而是配置细节踩坑了。

这篇教程目标很简单：不讲空话，只保留能直接跑通的步骤。
按文档操作，10 分钟内你就能在终端里正常启动 Codex，并在 VSCode 中使用它。

• 跨平台安装：Windows / macOS / Linux 全覆盖
• 一次性讲清 auth.json 与 config.toml 的正确写法
• 给出可直接复制的命令与配置模板
• 附常见报错排查清单，出错时可快速定位

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

前置步骤！！！
安装 Git Bash：访问 Git – Downloads 下载对应系统版本，一路“下一步”即可。

安装 Node.js
访问 Node.js 官网，下载并安装最新 LTS 版本。

安装 codex
打开 CMD 或 PowerShell：

npm install -g @openai/codex

3. 验证安装

codex --version

获取 Token173 API Key
访问：token173.com → 控制台 → API令牌 → 添加令牌

• 令牌分组：codex专属（必须选这个分组）
• 令牌名称：随意
• 额度：建议设为无限额度
• 其他默认 → 新建

配置文件位置

C:Users你的用户名.codex

没有 .codex 就手动创建，里面放两个文件：

• auth.json
• config.toml

3. auth.json（直接复制）

{"OPENAI_API_KEY": "sk-xxx"}

把 sk-xxx 替换成你在 token173.com 生成的 Key。

4. config.toml（直接复制）

model_provider = "token173"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.token173]
name = "token173"
base_url = "https://api.token173.com/v1"
wire_api = "responses"

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

cd 你的项目目录
codex

扩展商店搜索 codex → 安装即可。

• macOS 12+
• Node.js 22+
• npm 10+

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node

npm install -g @openai/codex
codex --version

获取 Token173 Key
访问：token173.com → 控制台 → API令牌 → 添加令牌
分组选：codex专属

创建配置文件

mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml

3. auth.json

vi ~/.codex/auth.json

写入：

{"OPENAI_API_KEY": "sk-xxx"}

4. config.toml

vi ~/.codex/config.toml

写入：

model_provider = "token173"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.token173]
name = "token173"
base_url = "https://api.token173.com/v1"
wire_api = "responses"

codex

• Ubuntu 20.04+ / Debian 10+ / CentOS 7+
• Node.js 22+

Ubuntu/Debian

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

CentOS/RHEL/Fedora

sudo dnf install nodejs npm

sudo npm install -g @openai/codex
codex --version

同 macOS：

mkdir -p ~/.codex
touch ~/.codex/auth.json ~/.codex/config.toml

填入和上面完全一样的 auth.json、config.toml（token173 的 base_url）。

codex

401 / invalid_api_key

• Key 复制是否有空格
• 令牌分组是否选了 codex专属
• 是否在 token173.com 控制台创建

model not found

• config.toml 里 model 写：gpt-5-codex
• base_url 必须是：https://api.token173.com/v1

连不上 / 超时

• 网络能访问 token173.com
• 不要加代理/镜像到这个地址

以上就是Codex配置GPT的保姆级教程的详细内容，更多关于Codex配置GPT教程的资料请关注风君子博客其它相关文章！