如果你已经装好了 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 |
- 验证安装
|
1 |
codex --version |
配置 API（核心）
获取 Token173 API Key
访问： → 控制台 → API令牌 → 添加令牌
- 令牌分组：codex专属（必须选这个分组）
- 令牌名称：随意
- 额度：建议设为无限额度
- 其他默认 → 新建
配置文件位置
|
1 |
C:\Users\你的用户名\.codex |
没有 .codex 就手动创建，里面放两个文件：
- auth.json
- config.toml
- 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
重启终端！重启终端！重启终端！
|
1 2 |
cd 你的项目目录 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 |
vi ~/.codex/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" |
启动
|
1 |
codex |
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）。
启动
|
1 |
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
- 不要加代理/镜像到这个地址
