1. Windows11 下 ChatGPT 启动报错到底卡在哪
你在 Windows11 上双击 ChatGPT 桌面端，界面还没出来就弹出一行红字：Unable to locate the Codex CLI binary，后面跟着一句提示，让你设置 CODEX_CLI_PATH 或者确认 Electron 资源里带了 bin/codex。这个报错的意思是：ChatGPT 这个壳程序在启动时，会去调用一个叫 Codex CLI 的命令行工具，但它按默认路径找了一圈没找到，于是直接拒绝启动。
Codex CLI 你可以理解成 ChatGPT 桌面端背后的“手和脚”。聊天窗口负责显示和交互，真正去读写文件、执行命令、跑代码补全的那部分能力，是靠这个独立的可执行文件完成的。Windows11 和 macOS、Linux 不一样的地方在于，它的可执行文件后缀是 .exe，而且安装位置经常被放在用户目录下的隐藏文件夹里，路径里还带用户名，所以一旦环境变量没配好，或者配置文件里写的是别的平台的路径，启动就会失败。
这篇面向的是在 Windows11 上用 ChatGPT 桌面端、并且已经通过 TaoToken 这类兼容接口来驱动模型的人。核心要解决三件事：第一，确认 Codex CLI 到底装在哪；第二，把 CODEX_CLI_PATH 这个环境变量配对；第三，检查 config.toml 和 settings.json 里的路径与接口地址是否一致。整套流程不需要重装系统，也不需要卸载 ChatGPT，跟着做基本能恢复启动。
我先把结论放前面：九成以上的“找不到 Codex CLI”都不是文件真的丢了，而是路径没进环境变量，或者配置文件里写了一个带引号、带空格、带反斜杠转义的错误路径。下面按排查顺序一步步来。
2. 先确认 Codex CLI 的真实安装位置
在动手改任何配置之前，先找到文件。Windows11 上 Codex CLI 的常见落点有这么几个，你可以按顺序去文件资源管理器里看：
第一个位置是用户目录下的隐藏文件夹。在地址栏直接粘贴下面这行，把“你的用户名”换成你实际的登录名：
C:\Users\你的用户名\.codex\packages\standalone\current\bin如果这个目录存在，里面应该能看到 codex.exe 或者 codex.cmd。注意 .codex 是带点的隐藏目录，默认不显示，直接在地址栏输入路径比一层层点进去更快。
第二个位置是 npm 全局安装目录。如果你之前用 npm 装过，可以打开 PowerShell 执行：
npm config get prefix它会返回一个类似C:\Users\你的用户名\AppData\Roaming\npm的路径，Codex CLI 的可执行文件通常就在这个目录下。
第三个位置是手动解压的目录，比如你下载了 standalone 包解压到 D 盘某个文件夹。这种情况路径不固定，需要你自己回忆或者用搜索找。
找到之后，把完整路径复制下来。这里有个关键点：环境变量里填的应该是包含可执行文件的目录，而不是可执行文件本身。也就是说填...\current\bin，不要填...\current\bin\codex.exe。很多人就是多写了文件名，导致程序还是找不到。
验证文件确实可用，可以在 PowerShell 里 cd 到那个目录，然后执行：
.\codex.exe --version能打印出版本号，说明文件本身没问题，接下来就是让 ChatGPT 知道它在哪。
3. TaoToken 前置：把接口地址和 Key 准备好
ChatGPT 桌面端要正常跑起来，除了 Codex CLI 这个本地可执行文件，还需要一个能响应请求的模型接口。这里用 TaoToken 来做接入，它的 API 地址是https://taotoken.net/api，兼容常见的 OpenAI 风格调用方式，配置起来比较直接。
你需要先去控制台拿一个 API Key。打开https://taotoken.net/console，登录后在 API Keys 页面创建一个新的 Key，复制出来先存到记事本里。这个 Key 后面要写进配置文件，注意不要泄露，也不要提交到 Git 仓库。
如果你还没决定用哪个模型，可以先去模型对话页面试一下https://taotoken.net/models，确认账号能正常调用、额度没问题，再回来配本地客户端。这样能避免“到底是 Key 错了还是路径错了”这种两头排查的麻烦。
对于长期在 Windows11 上做编码、跑 Agent 任务的人，可以考虑 Coding Plan，入口在https://taotoken.net/coding-plan。它的定位是给持续性的编码场景用的，比按次调用更适合天天开着 ChatGPT 桌面端干活的人。接入文档在https://taotoken.net/doc，里面有各客户端的配置示例，遇到字段不确定的时候可以对照。
把 Key 和接口地址准备好之后，就可以进入配置文件环节了。
4. 可复制配置：环境变量 + config.toml + settings.json
这一节是整篇的核心，三样东西要配：系统环境变量 CODEX_CLI_PATH、Codex 的 config.toml、以及 ChatGPT 桌面端的 settings.json。三者路径要一致，接口地址要指向 TaoToken。
4.1 设置 CODEX_CLI_PATH 环境变量
图形界面方式：右键“此电脑” → 属性 → 高级系统设置 → 环境变量。在“用户变量”区域点“新建”，变量名填CODEX_CLI_PATH，变量值填你第 2 步找到的 bin 目录，比如：
C:\Users\你的用户名\.codex\packages\standalone\current\bin如果你更喜欢命令行，用 PowerShell 设置用户级环境变量也可以，执行完需要重开终端：
[Environment]::SetEnvironmentVariable("CODEX_CLI_PATH", "C:\Users\你的用户名\.codex\packages\standalone\current\bin", "User")设置完立刻在当前窗口验证一下（新开的窗口才会读到）：
echo $env:CODEX_CLI_PATH能回显出路径就说明写进去了。这里有个坑：路径里如果带空格，比如用户名里有空格，环境变量值本身不用加引号，但写进 toml 或 json 时要按各自语法处理，后面会讲。
4.2 配置 config.toml
Codex CLI 的配置文件通常在C:\Users\你的用户名\.codex\config.toml。如果文件不存在就新建一个。下面是一个可用的骨架，把 api_key 换成你自己的：
# Codex CLI 配置骨架 model = "gpt-4o-mini" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" [shell] path = "C:\\Users\\你的用户名\\.codex\\packages\\standalone\\current\\bin"注意 toml 里反斜杠是转义字符，所以 Windows 路径要写成双反斜杠\\，或者改用正斜杠/。这一点和 json 一样，写错了会导致解析失败，表现出的症状有时也会是“找不到可执行文件”。
4.3 配置 settings.json
ChatGPT 桌面端的设置文件一般在C:\Users\你的用户名\AppData\Roaming\ChatGPT\settings.json，不同版本可能略有差异。用文本编辑器打开，加入或修改下面这些字段：
{ "codexCliPath": "C:\\Users\\你的用户名\\.codex\\packages\\standalone\\current\\bin", "apiBaseUrl": "https://taotoken.net/api", "apiKeyEnv": "TAOTOKEN_API_KEY", "model": "gpt-4o-mini" }同样，json 里反斜杠要双写。apiKeyEnv指向的是环境变量名，真正的 Key 值建议放在系统环境变量里，而不是明文写进 json。设置 Key 的命令：
[Environment]::SetEnvironmentVariable("TAOTOKEN_API_KEY", "你的Key", "User")三处路径保持一致，是避免“找不到 Codex CLI”的关键。任何一处写错，程序都可能回退到默认路径然后报错。
5. 验证请求与成功结果
配置改完，先别急着开 ChatGPT，按顺序验证，能快速定位是哪一层出问题。
第一步，重开一个 PowerShell 窗口，确认两个环境变量都在：
echo $env:CODEX_CLI_PATH echo $env:TAOTOKEN_API_KEY第二步，直接调用 Codex CLI，看它能不能读到配置并连上接口：
codex.exe --version codex.exe "用一句话说明当前配置的模型"如果第二条能返回模型输出，说明 CLI 本身、config.toml、接口地址三者都通了。这一步成功，基本就排除了路径和 Key 的问题。
第三步，启动 ChatGPT 桌面端。正常的话界面会直接打开，不再弹“无法找到 Codex CLI 可执行文件”。你可以在对话里发一条简单指令，比如让它列一下当前目录文件，观察是否能正常调用本地能力。
成功的结果有三个特征：启动无红字报错、对话能返回内容、涉及文件操作的指令能真正执行。如果只满足前两个，第三个失败，那多半是 shell 路径或权限问题，回到 config.toml 的[shell]段检查。
6. 本篇常见错排查
下面这些是我在 Windows11 上实际遇到过的坑，按出现频率排。
路径多写了文件名。CODEX_CLI_PATH 要填目录，不是 exe 文件。填成...\bin\codex.exe会继续报找不到。
反斜杠没转义。toml 和 json 里单反斜杠是转义符，C:\Users会被解析成奇怪的东西。统一用双反斜杠或正斜杠。
改了环境变量没重开程序。环境变量是进程启动时读取的，改完必须关掉 ChatGPT 和所有终端重新打开，否则读到的还是旧值。
用户名带空格或中文。路径里有空格时，某些客户端解析会截断。可以尝试把 Codex CLI 挪到一个纯英文无空格的目录，比如C:\tools\codex\bin，再更新三处配置。
settings.json 格式错误。多一个逗号、少一个引号都会让整个文件解析失败，程序可能静默回退默认值。改完用在线 json 校验工具过一遍。
接口地址写成了首页。apiBaseUrl 要填https://taotoken.net/api，不要填带 UTM 的推广链接或首页地址，否则请求会 404。
Key 没设或设错环境变量名。config.toml 里env_key写的是变量名，实际值要在系统环境变量里。名字对不上就会认证失败。
杀毒软件拦截。少数情况下安全软件会把 codex.exe 当可疑程序隔离，去隔离区看一眼，必要时加白名单。
排查顺序建议固定为：文件是否存在 → 环境变量是否生效 → 配置文件语法是否正确 → 接口是否连通。按这个顺序走，基本不会绕圈。
7. 后续接入与长期使用建议
路径修好、ChatGPT 能启动之后，如果你打算长期在 Windows11 上用它做编码或跑 Agent，建议把 Key 和接口配置固定下来，别每次手动改。API Key 管理在https://taotoken.net/api-keys，可以按用途建不同的 Key，方便轮换和排查。接入细节不确定时翻https://taotoken.net/doc，里面有配置字段说明。
需要快速验证某个模型是否可用，直接去https://taotoken.net/models对话测试，比在本地反复重启客户端快得多。而如果你像我一样每天开着桌面端写代码、跑长任务，Coding Plan 会更省心，入口在https://taotoken.net/coding-plan，适合把调用量稳定下来的场景。
最后提醒一句：每次升级 ChatGPT 桌面端或 Codex CLI 之后，安装路径有可能变化，尤其是 standalone 包更新后current这个软链接指向的目录会变。升级完如果又报找不到可执行文件，回到第 2 步重新确认路径，再核对三处配置是否还指向同一个 bin 目录，通常几分钟就能恢复。
