Codex 安装与配置教程

本文基于你提供的内容整理为网页版本，覆盖 Windows、macOS、Linux 三个平台的安装、配置、启动与常见问题，并已统一替换为 High Chat 接入地址。

文档首页产品使用说明 API 基础教程插件/软件教程总览

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

3. 验证安装

打开命令提示符（CMD）或 PowerShell，运行：

codex --version

Windows 配置 API

1. 获取 Auth Token

访问 High Chat 站点页面进行以下操作：

点击 控制台 → API令牌 页面。
点击 添加令牌。
令牌名称随意。
额度建议：设置为 无限额度。
其他选项保持默认。

Windows 获取 API 令牌示意图

2. 配置文件

重要提示：请将下方的 sk-xxx 替换为您在 High Chat 生成的实际 API 密钥。

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

Windows .codex 目录示意图

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

Windows 创建配置文件示意图

填写配置（需要将 sk-xxx 替换成您自己创建的真实 SK）。

auth.json 中的配置：

{"OPENAI_API_KEY": "sk-xxx"}

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

model_provider = "HighAPI" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.HighAPI] name = "HighAPI" base_url = "https://www.high-chat.top/v1" wire_api = "responses"

Windows 启动 codex

重启终端！重启终端！重启终端！

然后进入到您的工程目录：

cd your-project-folder

运行以下命令启动：

codex

Windows 启动 codex 示意图

VSCode 插件 codex

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

Windows VSCode 插件安装示意图

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

Windows VSCode 插件侧边栏示意图

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)" # 安装 Node.js brew install node

2. 安装 codex

打开终端（Terminal），运行（可能需要加 sudo）：

npm install -g @openai/codex

3. 验证安装

打开终端（Terminal），运行：

codex --version

配置 API

1. 获取 Auth Token

访问 High Chat 站点页面进行以下操作：

点击 控制台 → API令牌 页面。
点击 添加令牌。
令牌名称随意。
额度建议：设置为 无限额度。
其他选项保持默认。

Mac 获取 API 令牌示意图

2. 配置文件

重要提示：请将下方的 sk-xxx 替换为您在 High Chat 生成的实际 API 密钥。

创建目录和文件：

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

编辑 auth.json 文件：

vi ~/.codex/auth.json

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

{"OPENAI_API_KEY": "sk-xxx"}

编辑 config.toml 文件：

vi ~/.codex/config.toml

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

model_provider = "HighAPI" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.HighAPI] name = "HighAPI" base_url = "https://www.high-chat.top/v1" wire_api = "responses"

启动 codex

重启终端！重启终端！重启终端！

然后进入到您的工程目录：

cd your-project-folder

运行以下命令启动：

codex

Mac 启动 codex 示意图

VSCode 插件 codex

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

Mac VSCode 插件安装示意图

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

Mac VSCode 插件侧边栏示意图

Linux 版本教程

系统要求

主流 Linux 发行版（Ubuntu 20.04+、Debian 10+、CentOS 7+ 等）。
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

CentOS/RHEL/Fedora：

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

Arch Linux：

sudo pacman -S nodejs npm

2. 安装 codex

打开终端（Terminal），运行：

sudo npm install -g @openai/codex

3. 验证安装

打开终端（Terminal），运行：

codex --version

配置 API

1. 获取 Auth Token

访问 High Chat 站点页面进行以下操作：

点击 控制台 → API令牌 页面。
点击 添加令牌。
令牌名称随意。
额度建议：设置为 无限额度。
其他选项保持默认。

Linux 获取 API 令牌示意图

2. 配置文件

重要提示：请将下方的 sk-xxx 替换为您在 High Chat 生成的实际 API 密钥。

创建目录和文件：

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

编辑 auth.json 文件：

vi ~/.codex/auth.json

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

{"OPENAI_API_KEY": "sk-xxx"}

编辑 config.toml 文件：

vi ~/.codex/config.toml

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

model_provider = "HighAPI" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.HighAPI] name = "HighAPI" base_url = "https://www.high-chat.top/v1" wire_api = "responses"

启动 codex

重启终端！重启终端！重启终端！

然后进入到您的工程目录：

cd your-project-folder

运行以下命令启动：

codex

Linux 启动 codex 示意图

VSCode 插件 codex

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

Linux VSCode 插件安装示意图

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

Linux VSCode 插件侧边栏示意图

常见问题

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

确认 API Key 创建是否正确：额度选择 无限额度，不要限制模型，分组选择对应平台要求的分组。

更多 codex 配置及使用详情请参考 codex 官方教程。配置API令牌请访问High Chat：https://www.high-chat.top。