如果你已經(jīng)裝好了 Codex，卻卡在
401、invalid_api_key、model not found，
大概率不是你不會(huì)用，而是配置細(xì)節(jié)踩坑了。

這篇教程目標(biāo)很簡(jiǎn)單：不講空話，只保留能直接跑通的步驟。
按文檔操作，10 分鐘內(nèi)你就能在終端里正常啟動(dòng) Codex，并在 VSCode 中使用它。

這篇教程能幫你解決什么

• 跨平臺(tái)安裝：Windows / macOS / Linux 全覆蓋
• 一次性講清 auth.json 與 config.toml 的正確寫法
• 給出可直接復(fù)制的命令與配置模板
• 附常見報(bào)錯(cuò)排查清單，出錯(cuò)時(shí)可快速定位

Windows 版本教程

系統(tǒng)要求

• Windows 10 或 Windows 11
• Node.js 22+
• npm 10+
• 網(wǎng)絡(luò)連接正常

安裝步驟

前置步驟?。?！
安裝 Git Bash：訪問 Git - Downloads 下載對(duì)應(yīng)系統(tǒng)版本，一路“下一步”即可。

安裝 Node.js
訪問 Node.js 官網(wǎng)，下載并安裝最新 LTS 版本。

安裝 codex
打開 CMD 或 PowerShell：

npm install -g @openai/codex

3. 驗(yàn)證安裝

codex --version

配置 API（核心）

獲取 Token173 API Key
訪問：token173.com → 控制臺(tái) → API令牌 → 添加令牌

• 令牌分組：codex專屬（必須選這個(gè)分組）
• 令牌名稱：隨意
• 額度：建議設(shè)為無限額度
• 其他默認(rèn) → 新建

配置文件位置

C:\Users\你的用戶名\.codex

沒有 .codex 就手動(dòng)創(chuàng)建，里面放兩個(gè)文件：

• auth.json
• config.toml

3. auth.json（直接復(fù)制）

{"OPENAI_API_KEY": "sk-xxx"}

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

4. config.toml（直接復(fù)制）

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"

啟動(dòng) codex

重啟終端！重啟終端！重啟終端！

cd 你的項(xiàng)目目錄
codex

VSCode 插件

擴(kuò)展商店搜索 codex → 安裝即可。

macOS 版本教程

系統(tǒng)要求

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

安裝 Node.js（推薦 Homebrew）

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

安裝 codex

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

配置 API

獲取 Token173 Key
訪問：token173.com → 控制臺(tái) → API令牌 → 添加令牌
分組選：codex專屬

創(chuàng)建配置文件

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"

啟動(dòng)

codex

Linux 版本教程

系統(tǒng)要求

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

安裝 Node.js

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

安裝 codex

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）。

啟動(dòng)

codex

常見報(bào)錯(cuò)排查

401 / invalid_api_key

• Key 復(fù)制是否有空格
• 令牌分組是否選了 codex專屬
• 是否在 token173.com 控制臺(tái)創(chuàng)建

model not found

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

連不上 / 超時(shí)

• 網(wǎng)絡(luò)能訪問 token173.com
• 不要加代理/鏡像到這個(gè)地址

以上就是Codex配置GPT的保姆級(jí)教程的詳細(xì)內(nèi)容，更多關(guān)于Codex配置GPT教程的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論