Codex GUI/CLI 安装与配置

接入 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

在 Ubuntu / Debian 中执行以下命令，安装后再运行上方的编辑命令。

Ubuntu / Debian
sudo apt update
sudo apt install nano

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

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

没有 Vim？安装 Vim

在 Ubuntu / Debian 中执行以下命令，安装后再运行上方的编辑命令。

Ubuntu / Debian
sudo apt update
sudo apt install vim

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

使用 nano
mkdir -p ~/.codex
nano ~/.codex/config.toml

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

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

config.toml
model_provider = "OpenAI"
model = "gpt-6-astra"
review_model = "gpt-6-astra"
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

在 Ubuntu / Debian 中执行以下命令，安装后再运行上方的编辑命令。

Ubuntu / Debian
sudo apt update
sudo apt install nano

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

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

没有 Vim？安装 Vim

在 Ubuntu / Debian 中执行以下命令，安装后再运行上方的编辑命令。

Ubuntu / Debian
sudo apt update
sudo apt install vim

~/.codex/auth.json

使用 nano
mkdir -p ~/.codex
nano ~/.codex/auth.json

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

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

推荐使用目前最流行的开源软件 CC Switch 配置本地密钥。

提示：CODEX_HOME 是用于自定义 Codex 配置与数据存放目录的环境变量。没设置过，按上面的默认路径操作即可；设置过，请在指定目录中编辑配置文件。WSL 是 Windows 中的 Linux 环境，使用独立的 Linux 用户目录。

重启并验证

如果 Codex 正在运行，请先关闭；桌面版重新打开 Codex 应用程序，CLI 在终端输入 codex 启动，然后发送消息，能正常回复即表示设置成功。

接入 Supakook​

重启并验证​

接入 Supakook

重启并验证