OpenAI Codex 全平台详细安装与配置教程（Windows/Mac/Linux）

前言

本文为完整版 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，执行全局安装命令：

python 复制代码

npm install -g @openai/codex

4. 验证是否安装成功

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

python 复制代码

codex --version

5. API 详细配置

5.1 获取 Auth Token

访问站点：startapi.top，登录个人控制台；
左侧菜单栏进入【API令牌】页面；
点击【添加令牌】，参数配置规则：

令牌分组：必须选择 codex专属（选错将无法正常使用）
令牌名称：自定义填写
额度设置：建议设置为无限额度
其余配置：保持系统默认即可

5.2 编写配置文件

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

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

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

填入对应配置内容, (需要将 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 推荐）：

python 复制代码

# 如果尚未安装 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：

python 复制代码

npm install -g @openai/codex

4. 验证安装

python 复制代码

codex --version

5. API 详细配置

5.1 获取 Auth Token

访问站点：startapi，进入控制台 - API令牌；
新建令牌，分组选择：codex特供；
自定义令牌名称，额度设置为无限额度，其余默认。

5.2 配置文件创建与编辑

python 复制代码

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

编辑 auth.json 文件：

python 复制代码

vi ~/.codex/auth.json

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

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

python 复制代码

{"OPENAI_API_KEY": "sk-xxx"}

编辑 config.toml 文件：

python 复制代码

vi ~/.codex/config.toml

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

python 复制代码

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

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

python 复制代码

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

访问站点：startapi.top，进入控制台 - API令牌；
新建令牌，分组选择：codex渠道-gpt；
自定义名称，额度无限，其余参数默认。

5.2 配置文件编写

创建目录及文件：

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

vi ~/.codex/auth.json

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

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

复制代码

{"OPENAI_API_KEY": "sk-xxx"}

配置 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 启动报错、无法调用接口，请按以下顺序逐一排查：

核对 API Key 是否正确，密钥状态是否正常；
确认令牌分组与当前系统教程要求一致；
额度设置为无限额度，不要限制模型调用权限；
修改配置文件后，必须重启终端再重新启动 Codex；
更多疑难问题，可查阅 Codex 官方教程。

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