Codex CLI 与桌面端配置

Codex CLI 和 Codex 桌面 App 使用同一个 .codex 目录。你需要创建 config.toml 和 auth.json 两个文件，配置一次后两边都能通过 TokenFlash 使用 GPT 模型。

如果你不熟悉 PowerShell、终端、复制命令或配置文件，请先阅读 电脑基础操作。

你需要准备什么

1. 一台 Windows、macOS 或 Linux 电脑。
2. 一个可用的 TokenFlash API Key。
3. Node.js 22 或更高版本，本文推荐 Node.js 24。
4. Codex CLI，或 Windows/macOS 版 Codex App。

CLI 和 App 如何共用配置

Codex 默认从当前用户的 .codex 文件夹读取两个必备文件：

config.toml 保存模型、Base URL 和认证方式，auth.json 保存 API Key。

同一台电脑、同一个系统账户下，Codex CLI 和 Codex App 都会读取这两个文件。

第一步：安装 Node.js

如果你已经完成 OpenCode 教程中的 Node.js 24 安装，执行 node -v 和 npm -v 能显示版本号，可以直接跳到下一步。

node -v
npm -v

node -v
npm -v

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
sudo dnf install -y nodejs

需要使用 NVM 或其他架构安装包时，请参考 OpenCode 安装教程中的 Node.js 章节。

第二步：安装 Codex CLI

Windows、macOS 和 Linux 都使用同一条 npm 命令：

npm install -g @openai/codex

安装完成后验证：

codex --version

看到 Codex 版本号即表示安装成功。

第三步：安装 Codex 桌面 App

桌面端是可选项。只使用 CLI 的用户可以直接跳到“创建共用配置文件”。

建议访问 Codex App 官方页面 获取最新版本，也可以使用下方下载入口：

• macOS：打开 DMG，将 Codex 拖入 Applications 文件夹。
• Windows：打开安装程序，按照界面提示完成安装。
• Linux：目前优先使用 Codex CLI。

安装完成后先不要急着开始任务。继续创建共用配置文件，配置完成后再重新打开 App。

第四步：创建 config.toml

New-Item -ItemType Directory -Force "$HOME\.codex"
notepad "$HOME\.codex\config.toml"

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

第五步：写入 TokenFlash 接口配置

将下面内容完整粘贴到 config.toml：

在 TokenFlash 控制台选择模型和 Codex CLI 后，可以分别复制 config.toml 与 auth.json 内容。

model_provider = "tokenflash"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
cli_auth_credentials_store = "file"

[model_providers.tokenflash]
name = "TokenFlash"
base_url = "https://tokenflash.cn/v1"
wire_api = "responses"
requires_openai_auth = true

保存文件后，继续创建 auth.json。缺少 auth.json 时，Codex 无法获得 API Key。

每个配置项有什么作用

第六步：创建 auth.json

auth.json 与 config.toml 位于同一个 .codex 文件夹，用于保存 TokenFlash API Key。

notepad "$HOME\.codex\auth.json"

nano ~/.codex/auth.json

把 在这里填写你的APIKey 替换为你的 TokenFlash API Key：

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "在这里填写你的APIKey"
}

Windows 最终文件位置

两个文件创建并保存后，可以在 C:\Users\你的用户名\.codex 文件夹中看到它们：

地址栏应位于当前用户的 .codex 文件夹，文件类型应分别显示为 TOML 和 JSON。

两个文件缺一不可

第七步：启动并验证

验证 Codex CLI

先完全关闭之前打开的 Codex，再重新打开 PowerShell 或终端。进入你的项目目录：

cd /path/to/your-project
codex

进入 Codex 后，先输入一个不会修改文件的任务：

请告诉我你当前使用的模型，并分析这个项目的目录结构，不要修改任何文件。

能正常返回内容，说明 TokenFlash 配置已经生效。

验证 Codex App

1. 完全退出 Codex App。
2. 确认 config.toml 和 auth.json 都已保存。
3. 重新打开 Codex App。
4. 选择一个测试项目文件夹。
5. 输入“分析这个项目，不要修改文件”。

App 和 CLI 使用相同系统账户时，会共同读取这两个文件，不需要再次填写 Base URL 和 API Key。

如何切换模型

最简单的方法是修改 config.toml 第一行：

model = "其他模型ID"

模型 ID 必须与 TokenFlash 模型定价页面 中显示的 ID 完全一致。保存后，完全退出并重新打开 Codex CLI 或 App。

CLI 中也可以输入 /model 查看当前版本支持的模型切换功能。

常见问题

codex 命令不存在

关闭并重新打开 PowerShell 或终端，再执行：

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

App 没有读取新配置

1. 确认 App 和 CLI 使用的是同一个电脑账户。
2. 确认 config.toml 和 auth.json 都位于用户目录的 .codex 文件夹。
3. Windows 检查文件是否被保存成 config.toml.txt 或 auth.json.txt。
4. 确认 config.toml 包含 cli_auth_credentials_store = "file"。
5. 完全退出 App，而不是只关闭当前项目窗口，然后重新打开。

提示未授权或 API Key 无效

确认：

1. auth.json 中包含 "auth_mode": "apikey"。
2. OPENAI_API_KEY 的值没有前后空格。
3. API Key 仍然有效且账户有可用额度。
4. config.toml 中的 requires_openai_auth 是 true。
5. base_url 包含 /v1，wire_api 是 responses。

以前使用过切换工具或本地代理

本教程不需要任何本地代理。检查 base_url，不要使用 127.0.0.1 或 localhost 地址。配置应直接指向：

base_url = "https://tokenflash.cn/v1"

官方资源

• Codex 官方仓库
• Codex App 官方页面
• Codex 官方文档
• TokenFlash API Key