如果你已经装好了 Codex,却卡在
401、invalid_api_key、model not found,
大概率不是你不会用,而是配置细节踩坑了。
这篇教程目标很简单:不讲空话,只保留能直接跑通的步骤。
按文档操作,10 分钟内你就能在终端里正常启动 Codex,并在 VSCode 中使用它。

这篇教程能帮你解决什么
- 跨平台安装:Windows / macOS / Linux 全覆盖
- 一次性讲清 auth.json 与 config.toml 的正确写法
- 给出可直接复制的命令与配置模板
- 附常见报错排查清单,出错时可快速定位
Windows 版本教程
系统要求
- Windows 10 或 Windows 11
- Node.js 22+
- npm 10+
- 网络连接正常
安装步骤
前置步骤!!!
安装 Git Bash:访问 Git - Downloads 下载对应系统版本,一路“下一步”即可。
安装 Node.js
访问 Node.js 官网,下载并安装最新 LTS 版本。
安装 codex
打开 CMD 或 PowerShell:
|
1
|
npm install -g @openai/codex
|
- 验证安装
配置 API(核心)
获取 Token173 API Key
访问: → 控制台 → API令牌 → 添加令牌
- 令牌分组:codex专属(必须选这个分组)
- 令牌名称:随意
- 额度:建议设为无限额度
- 其他默认 → 新建
配置文件位置
没有 .codex 就手动创建,里面放两个文件:
- auth.json(直接复制)
|
1
|
{"OPENAI_API_KEY": "sk-xxx"}
|
把 sk-xxx 替换成你在 token173.com 生成的 Key。
- config.toml(直接复制)
|
1
2
3
4
5
6
7
8
9
|
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
重启终端!重启终端!重启终端!
VSCode 插件
扩展商店搜索 codex → 安装即可。
macOS 版本教程
系统要求
- macOS 12+
- Node.js 22+
- npm 10+
安装 Node.js(推荐 Homebrew)
|
1
2
|
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
|
安装 codex
|
1
2
|
npm install -g @openai/codex
codex --version
|
配置 API
获取 Token173 Key
访问: → 控制台 → API令牌 → 添加令牌
分组选:codex专属
创建配置文件
|
1
2
3
|
mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
|
- auth.json
写入:
|
1
|
{"OPENAI_API_KEY": "sk-xxx"}
|
- config.toml
|
1
|
vi ~/.codex/config.toml
|
写入:
|
1
2
3
4
5
6
7
8
9
|
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"
|
启动
Linux 版本教程
系统要求
- Ubuntu 20.04+ / Debian 10+ / CentOS 7+
- Node.js 22+
安装 Node.js
Ubuntu/Debian
|
1
2
3
|
sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
|
CentOS/RHEL/Fedora
|
1
|
sudo dnf install nodejs npm
|
安装 codex
|
1
2
|
sudo npm install -g @openai/codex
codex --version
|
配置
同 macOS:
|
1
2
|
mkdir -p ~/.codex
touch ~/.codex/auth.json ~/.codex/config.toml
|
填入和上面完全一样的 auth.json、config.toml(token173 的 base_url)。
启动
常见报错排查
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
- 不要加代理/镜像到这个地址
|