前言

本文为完整版 Codex 安装配置手册，覆盖 Windows、MacOS、Linux 三大操作系统，包含环境依赖安装、API密钥配置、配置文件编写、终端启动、VSCode插件使用等全套流程，适配所有开发者直接参考使用。

---

一、Windows 版本教程

1. 系统要求

• 操作系统：Windows 10 / Windows 11

• 运行环境：Node.js 22+、npm 10+

• 基础条件：正常网络连接

2. 前置依赖安装

第一步：安装 Git Bash

访问 Git 官方下载地址(https://git-scm.com/install/),下载适配本机系统的安装包，全程默认下一步即可完成安装

第二步：安装 Node.js

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

3. 安装 Codex

打开 CMD 命令提示符 或 PowerShell，执行全局安装命令：

npm install -g @openai/codex

4. 验证是否安装成功

打开 CMD 命令提示符 或 PowerShell,  输入以下命令，输出版本号即代表安装正常：

codex --version

---

5. API 详细配置

5.1 获取 Auth Token

1. 访问站点：startapi.top，登录个人控制台；

2. 左侧菜单栏进入【API令牌】页面；

3. 点击【添加令牌】，参数配置规则：

• 令牌分组：必须选择 codex专属（选错将无法正常使用）

• 令牌名称：自定义填写

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

• 其余配置：保持系统默认即可

5.2 编写配置文件

重要提示：所有 sk-xxx 均需要替换为你在 startapi.top 生成的真实 API 密钥！

1. 进入系统用户目录，找到 .codex 文件夹，示例路径：C:\Users\testuser\.codex；若找不到该文件夹，需在文件资源管理器中开启「显示隐藏的项目」；

2. 若无 .codex 目录，手动创建，并在目录内新建两个文件：auth.json、config.toml；

3. 填入对应配置内容, (需要将 sk-xxx 替换成您自己创建的真实 SK)。

a. auth.json 中的配置：

{"OPENAI_API_KEY": "sk-xxx"}

b. config.toml 中的配置

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://startapi.top/v1"
wire_api = "responses"

参数说明：model_reasoning_effort 支持 high、medium、low 三个值，分别对应模型高/中/低思考强度。

6. 启动 Codex

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

cd your-project-folder

运行以下命令启动：

codex

---

7. VSCode 插件安装

完成以上全部配置后，打开 VSCode，进入扩展商店，搜索关键词 codex 并安装官方插件，安装完成后插件会展示在编辑器侧边栏，直接使用即可。

---

二、Mac 版本教程

1. 系统要求

• 操作系统：macOS 12 及更高版本

• 运行环境：Node.js 22+、npm 10+

• 基础条件：正常网络连接

2. 安装 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

3. 安装 Codex

打开终端（Terminal），执行安装命令，权限不足可添加 sudo：

npm install -g @openai/codex

4. 验证安装

codex --version

---

5. API 详细配置

5.1 获取 Auth Token

1. 访问站点：startapi，进入控制台 - API令牌；

2. 新建令牌，分组选择：codex特供；

3. 自定义令牌名称，额度设置为无限额度，其余默认。

5.2 配置文件创建与编辑

1. 一键创建目录与配置文件：

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

2. 编辑 auth.json 文件：

vi ~/.codex/auth.json

按 i 进入编辑模式，粘贴下方内容并替换密钥，ESC 后输入 :wq 保存退出：

请将下方的 sk-xxx 替换为您在 startapi.top 生成的实际 API 密钥！

{"OPENAI_API_KEY": "sk-xxx"}

3. 编辑 config.toml 文件：

vi ~/.codex/config.toml

按 i 进入编辑模式，粘贴下方内容并替换密钥，ESC 后输入 :wq 保存退出：

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://startapi.top/v1"
wire_api = "responses"

6. 启动 Codex

重启终端，切换项目目录并启动：

cd your-project-folder

7. VSCode 插件安装

同 Windows 教程，在 VSCode 扩展市场搜索 codex，安装官方插件即可。

---

三、Linux 版本教程

1. 系统要求

• 操作系统：Ubuntu 20.04+、Debian 10+、CentOS 7+ 等主流发行版

• 运行环境：Node.js 22+、npm 10+

• 基础条件：正常网络连接

2. 安装 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

CentOS/RHEL/Fedora 系列：

# dnf 方式（Fedora） 
sudo dnf install nodejs npm
 # yum 方式（CentOS） 
sudo yum install nodejs npm

Arch Linux 系列：

sudo pacman -S nodejs npm

3. 安装 Codex

sudo npm install -g @openai/codex

4. 验证安装

codex --version

---

5. API 详细配置

5.1 获取 Auth Token

1. 访问站点：startapi.top，进入控制台 - API令牌；

2. 新建令牌，分组选择：codex渠道-gpt；

3. 自定义名称，额度无限，其余参数默认。

5.2 配置文件编写

1. 创建目录及文件：

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

2. 配置 auth.json：

vi ~/.codex/auth.json

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

请将下方的 sk-xxx 替换为您在 startapi.top 生成的实际 API 密钥！

{"OPENAI_API_KEY": "sk-xxx"}

3. 配置 config.toml：

vi ~/.codex/config.toml

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

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://startapi.top/v1"
wire_api = "responses"

6. 启动 Codex

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

cd your-project-folder codex

运行以下命令

codex

7. VSCode 插件安装

打开 VSCode 扩展商店，检索 codex 并安装官方插件即可。

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

---

四、常见问题排查

若 Codex 启动报错、无法调用接口，请按以下顺序逐一排查：

1. 核对 API Key 是否正确，密钥状态是否正常；

2. 确认令牌分组与当前系统教程要求一致；

3. 额度设置为无限额度，不要限制模型调用权限；

4. 修改配置文件后，必须重启终端再重新启动 Codex；

5. 更多疑难问题，可查阅 Codex 官方教程。

标签：Codex、AI编程、VSCode插件、大模型配置、开发工具