2026最新Codex 对接 GPT API完整教程｜基于 token173 配置，零基础也能上手

赛博三大爷
231 阅读6分钟

如果你已经装好了 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 下载对应您电脑系统的版本，之后一直点击“下一步”即可完成安装。

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

2. 安装 codex 打开命令提示符 (CMD) 或 PowerShell，运行：

npm install -g @openai/codex

AI写代码

3. 验证安装 打开命令提示符 (CMD) 或 PowerShell，运行：

codex --version

AI写代码

配置 API

1. 获取 Auth Token 访问 token173.com 站点页面进行以下操作：

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

image.png

2. 配置文件

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

  1. 进入当前用户的用户目录下的 .codex 文件夹中，例如：C:\\Users\\testuser\\.codex。 （注意：如果看不到该目录，说明您没有打开 Windows 的“显示隐藏的项目”，请先在文件资源管理器中开启。）

image.png

  1. 如果没有 .codex 文件夹，请手动创建该文件夹，然后在其中创建 config.toml 以及 auth.json 两个文件。

image.png

填写配置

(需要将

sk-xxx

AI写代码

替换成您自己创建的真实 SK)。

a. `auth.json` 中的配置：
 
```json
{"OPENAI_API_KEY": "sk-xxx"}
AI写代码

b. config.toml 中的配置（直接粘贴下面的内容即可）： model_reasoning_effort 可选值为 high, medium, low，分别代表模型思考的努力程度（高、中、低）。

model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
 
[model_providers.api111]
name = "api111"
base_url = "<https://token173.com/v1>"
wire_api = "responses"
AI写代码

 
### 启动 codex
 
**重启终端！重启终端！重启终端！**
然后进入到您的工程目录：
 
```bash
cd your-project-folder
AI写代码

运行以下命令启动：

codex

AI写代码

image.png

VSCode 插件 codex

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

image.png

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

image.png

Mac 版本教程

系统要求

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

安装步骤

1. 安装 Node.js

  • 方式一：直接访问 Node.js 官网 下载并安装最新 LTS 版本。

  • 方式二：使用 Homebrew（推荐）

    # 如果尚未安装 Homebrew，请先运行此命令
/bin/bash -c "$(curl -fsSL [<https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh>](<https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh>))"
 
# 安装 Node.js
brew install node
AI写代码

2. 安装 codex 打开终端 (Terminal)，运行（可能需要加 sudo）：

npm install -g @openai/codex

AI写代码

3. 验证安装 打开终端 (Terminal)，运行：

codex --version

AI写代码

配置 API

1. 获取 Auth Token 访问 token173 站点页面进行以下操作：

  • 点击 控制台 → API令牌 页面

  • 点击 添加令牌

  • 令牌分组请选择：codex特供（务必选择此分组，否则无法使用）

  • 令牌名称随意

  • 额度建议：设置为 无限额度

  • 其他选项保持默认

    image.png

2. 配置文件

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

  1. 创建目录和文件：

    mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
AI写代码

  2. 编辑 auth.json 文件：

    vi ~/.codex/auth.json

AI写代码

    按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。

    {"OPENAI_API_KEY": "sk-xxx"}

AI写代码

  3. 编辑 config.toml 文件：

    vi ~/.codex/config.toml

AI写代码

    按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。

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

启动 codex

重启终端！重启终端！重启终端！ 然后进入到您的工程目录：

cd your-project-folder

AI写代码

运行以下命令启动：

codex

AI写代码

[图片]

VSCode 插件 codex

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

安装完成后会出现在侧边栏。 [图片]

Linux 版本教程

系统要求

  • 主流 Linux 发行版 (Ubuntu 20.04+, Debian 10+, CentOS 7+, etc.)
  • Node.js 22+
  • npm 10+
  • 网络连接

安装步骤

1. 安装 Node.js

  • Ubuntu/Debian

    sudo apt update
curl -fsSL <https://deb.nodesource.com/setup_lts.x>  |
sudo -E bash -
sudo apt-get install -y nodejs
AI写代码

  • CentOS/RHEL/Fedora

    # 使用 dnf (Fedora) 或 yum (CentOS/RHEL)
sudo dnf install nodejs npm
# 或
sudo yum install nodejs npm
AI写代码

  • Arch Linux

    sudo pacman -S nodejs npm

AI写代码

2. 安装 codex 打开终端 (Terminal)，运行：

sudo npm install -g @openai/codex

AI写代码

3. 验证安装 打开终端 (Terminal)，运行：

codex --version

AI写代码

配置 API

1. 获取 Auth Token 访问 token173站点页面进行以下操作：

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

2. 配置文件

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

  1. 创建目录和文件：

    mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml
AI写代码

  2. 编辑 auth.json 文件： 按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。

    vi ~/.codex/auth.json

AI写代码

    {"OPENAI_API_KEY": "sk-xxx"}

AI写代码

  3. 编辑 config.toml 文件： 按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。

    vi ~/.codex/config.toml

AI写代码

    model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
 
[model_providers.api111]
name = "api111"
base_url = "<https://token173.com/v1>"
wire_api = "responses"
AI写代码

启动 codex

重启终端！重启终端！重启终端！ 然后进入到您的工程目录：

cd your-project-folder

AI写代码

运行以下命令启动：

codex

AI写代码

image.png

VSCode 插件 codex

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

image.png

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

image.png

常见问题

出现错误请按照如下步骤排查：

确认 API Key 创建是否正确：额度选择无限额度，不要限制模型，分组选择 codex渠道。

更多 codex 配置及使用详情请参考 codex 官方教程。

avatar
文章
阅读
粉丝