Codex GUI/CLI 安装与配置

GUI 安装

下载并安装包含 Codex 的桌面应用。

Windows
Linux
macOS

Windows 提供官方安装程序，也支持使用 winget 从 Microsoft Store 安装。任选一种方式即可。

使用 winget 安装

打开 PowerShell，运行下面的官方安装命令：

PowerShell
winget install --id 9PLM9XGG6VKS -s msstore

安装完成后，从开始菜单打开 ChatGPT 并登录。

Linux 桌面应用目前为官方预览版，支持 Ubuntu、Debian、Fedora 和 Arch Linux，并提供 x64 与 ARM64 版本。

先确认处理器架构：

Terminal
uname -m

x86_64 对应 x64；aarch64 或 arm64 对应 ARM64。

Ubuntu / Debian：下载 .deb 并安装

下载 x64 .deb ↗ · 下载 ARM64 .deb ↗

下载完成后，在终端进入下载目录并安装对应文件：

x64
cd ~/Downloads
sudo apt install ./chatgpt_amd64.deb

ARM64
cd ~/Downloads
sudo apt install ./chatgpt_arm64.deb

Fedora：下载 .rpm 并安装

下载 x64 .rpm ↗ · 下载 ARM64 .rpm ↗

下载完成后，在终端进入下载目录并安装对应文件：

x64
cd ~/Downloads
sudo dnf install ./chatgpt.x86_64.rpm

ARM64
cd ~/Downloads
sudo dnf install ./chatgpt.aarch64.rpm

Arch Linux：使用官方安装脚本

官方脚本会检测处理器架构、配置已签名的软件包仓库并安装 ChatGPT。

Terminal
curl --proto '=https' --tlsv1.2 -fL -o install-arch.sh \
  https://persistent.oaistatic.com/codex-app-prod/linux/install-arch.sh
sudo bash install-arch.sh

安装完成后，从应用程序菜单打开 ChatGPT；也可以在终端运行 chatgpt。查看 Linux 官方说明 ↗

CLI 安装

在终端使用 Codex 时，按系统选择安装方式。

Windows
Linux
macOS

在 PowerShell 中选择一种方式安装 Codex CLI。

curl
npm

使用 curl 下载并运行官方 Windows 安装脚本，无需 Node.js。

PowerShell
$codexInstaller = curl.exe -fsSL https://chatgpt.com/codex/install.ps1
if ($LASTEXITCODE -eq 0) {
  Invoke-Expression ($codexInstaller -join [Environment]::NewLine)
}

没有 curl？安装 curl

Windows 10 新版本和 Windows 11 通常已自带 curl，可以先检查：

curl.exe --version

如果找不到命令，从官网下载适合系统架构的压缩包，解压后将其中的 bin 目录添加到用户 Path 环境变量，再重新打开 PowerShell。

下载 curl for Windows ↗

使用 Chocolatey 安装

已安装 Chocolatey 时，以管理员身份打开 PowerShell，运行：

PowerShell
choco install curl -y

没有 Chocolatey？查看官方安装教程 ↗

安装完成后，重新打开 PowerShell。选择一种安装方式即可。

已有 Node.js 和 npm 时，直接运行：

PowerShell
npm.cmd install -g @openai/codex

没有 npm？安装 Node.js 与 npm

从 Node.js 官网选择 LTS 版本，下载 Windows 安装程序（.msi），按默认选项完成安装；npm 会一并安装。

安装 Node.js ↗

使用 Chocolatey 安装

已安装 Chocolatey 时，以管理员身份打开 PowerShell，运行：

PowerShell
choco install nodejs-lts -y

没有 Chocolatey？查看官方安装教程 ↗

安装完成后，重新打开 PowerShell。选择一种安装方式即可。

重新打开 PowerShell，检查安装结果：

node --version
npm.cmd --version

安装完成后，重新打开 PowerShell，检查 Codex 版本：

cmd /c codex --version

在 WSL 内运行时，请使用 Linux 标签页，并在 WSL 内安装、配置和启动 Codex。

显示版本号表示安装完成。升级时使用原来的安装方式，避免多个版本混用。

先安装适合当前发行版的 Node.js LTS，再在终端中安装 Codex。

Node.js 官方下载 ↗

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

显示版本号表示安装完成。升级时使用原来的安装方式，避免多个版本混用。

在终端中使用 Homebrew 安装；如果尚未安装 Homebrew，也可使用下方 npm 方式。

Terminal
brew install --cask codex
codex --version

已有 Node.js？使用 npm 安装

没有 Node.js？安装 Node.js ↗

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

显示版本号表示安装完成。升级时使用原来的安装方式，避免多个版本混用。

接入 Supakook

GUI 与 CLI 使用同一套配置，填写一次即可。先准备自己的 Supakook API 密钥。

Windows
Linux
macOS

在用户主目录中找到 .codex 文件夹，编辑 config.toml；没有该文件夹时可用下方 PowerShell 命令创建。

用户配置文件： .codex\config.toml

PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

用户配置文件： ~/.codex/config.toml

使用 nano
使用 Vim

打开配置文件
mkdir -p ~/.codex
nano ~/.codex/config.toml

粘贴配置后，按 Ctrl+O，再按回车保存；按 Ctrl+X 退出。

没有 nano？安装 nano

按你的 Linux 发行版执行对应命令，安装后再运行上方的编辑命令。

Ubuntu / Debian
sudo apt update
sudo apt install nano

Fedora
sudo dnf install nano

Arch Linux
sudo pacman -Syu nano

打开配置文件
mkdir -p ~/.codex
vim ~/.codex/config.toml

按 i 进入编辑模式，粘贴配置；按 Esc，输入 :wq，再按回车保存并退出。

没有 Vim？安装 Vim

按你的 Linux 发行版执行对应命令，安装后再运行上方的编辑命令。

Ubuntu / Debian
sudo apt update
sudo apt install vim

Fedora
sudo dnf install vim

Arch Linux
sudo pacman -Syu vim

用户配置文件： ~/.codex/config.toml

打开配置文件
mkdir -p ~/.codex
touch ~/.codex/config.toml
open -e ~/.codex/config.toml

将以下配置填写到 config.toml 中并保存。

config.toml
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.supakook.com/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

在同一个 .codex 文件夹中创建 auth.json，填入自己的 API 密钥并保存。

Windows
Linux
macOS

.codex\auth.json

PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\auth.json"

~/.codex/auth.json

使用 nano
使用 Vim

打开配置文件
mkdir -p ~/.codex
nano ~/.codex/auth.json

粘贴配置后，按 Ctrl+O，再按回车保存；按 Ctrl+X 退出。

没有 nano？安装 nano

按你的 Linux 发行版执行对应命令，安装后再运行上方的编辑命令。

Ubuntu / Debian
sudo apt update
sudo apt install nano

Fedora
sudo dnf install nano

Arch Linux
sudo pacman -Syu nano

打开配置文件
mkdir -p ~/.codex
vim ~/.codex/auth.json

按 i 进入编辑模式，粘贴配置；按 Esc，输入 :wq，再按回车保存并退出。

没有 Vim？安装 Vim

按你的 Linux 发行版执行对应命令，安装后再运行上方的编辑命令。

Ubuntu / Debian
sudo apt update
sudo apt install vim

Fedora
sudo dnf install vim

Arch Linux
sudo pacman -Syu vim

~/.codex/auth.json

打开配置文件
mkdir -p ~/.codex
touch ~/.codex/auth.json
open -e ~/.codex/auth.json

auth.json
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

也可以使用 CC Switch 配置。如果设置过 CODEX_HOME，请使用它对应的目录；WSL 的 Linux 配置目录与 Windows 用户目录不同。

重启并验证

GUI

如果应用目前是打开的，请完全退出后重新启动。进入 Codex 并打开项目，发送“你好”，收到正常回复即可确认基本连接可用。

CLI

如果 Codex CLI 正在运行，先退出，再在项目文件夹中启动：

启动 Codex CLI
codex

Windows PowerShell 也可以运行：

cmd /c codex

发送“你好”验证连接。当前配置的 provider 为 OpenAI，模型为 gpt-5.5。

常见问题

现象	检查方向
找不到 codex 命令	重新打开终端，检查安装位置与 PATH；Windows 可使用 `cmd /c codex`
提示缺少密钥	检查 `.codex/auth.json` 中的 `OPENAI_API_KEY` 是否填写正确
401 / 403	检查密钥、额度与模型权限
404 / 模型不可用	核对 Base URL、Responses 接口与模型名称
配置没有生效	检查 `CODEX_HOME`、项目配置和启动参数是否覆盖用户配置

参考来源

官方桌面端指南 · 官方 CLI 指南 · 认证说明 · Sub2API 配置源码

GUI 安装​

CLI 安装​

接入 Supakook​

重启并验证​

GUI​

CLI​

常见问题​

参考来源​

GUI 安装

CLI 安装

接入 Supakook

重启并验证

GUI

CLI

常见问题

参考来源