ChatGPT 提示 Unable to locate Codex CLI？TaoToken 这样改 Codex 的模型通道

Windows 上把 ChatGPT 桌面版更新到带 Codex 的版本后点开 Codex 面板经常直接弹Unable to locate the Codex CLI binary。这个报错分两层一层是桌面应用找不到本机的 codex 可执行文件另一层是 Codex CLI 自身没有可用的模型通道。下面按排障顺序走先在 PowerShell 里把路径修好再用 TaoTokenhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 Key把 Codex 的模型通道 Base URL 指向 https://taotoken.net/api 。1. 报错现场Unable to locate the Codex CLI binary 在找什么1.1 ChatGPT 桌面版与 codex CLI 的关系ChatGPT 桌面版里的 Codex 功能并不是把整套运行时塞进安装包里。它做的是调用本机已经存在的 codex 命令行程序再把用户输入交给这个程序去执行。换句话说桌面版是前端入口codex CLI 才是真正跑请求的进程。当 Windows 注册表、环境变量、PATH 里没有任何一处能让桌面版定位到 codex 的可执行文件时它就只能在界面上抛出Unable to locate the Codex CLI binary。这个提示的英文本身很直白找不到 Codex CLI 的二进制文件。问题可能出在三个位置根本没装openai/codex装了但 npm 全局目录不在 PATH装了、PATH 也对但 ChatGPT 桌面版没有读取到CODEX_CLI_PATH这个变量。排障时不要一上来就重装 ChatGPT先按顺序确认 codex 到底落在哪。1.2 路径问题和模型通道问题是两码事很多人把 codex CLI 装好、codex --version也能打印版本号就以为桌面版的 Codex 能直接用了。实际上这只解决了第一层问题。codex CLI 自己还需要知道向哪个 provider 发请求、用哪个 base_url、拿哪把 API Key、调哪个模型。这四项没有配置时CLI 能启动但请求发不出去或者在认证阶段就被拒绝。所以完整的修复链路是先让 ChatGPT 找到 codex.exe再让 codex CLI 找到一条可用的模型通道。第二步需要一组独立于官方额度的 Key这也是后面要把 Codex 的 provider 指向 TaoToken 的原因。Key 的创建入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 不要等到配置写完才去找。2. PowerShell 修复 Node/npm 与 CODEX_CLI_PATH2.1 确认 Node/npm 在 PATH 里openai/codex通过 npm 分发所以第一步不是折腾 ChatGPT而是确认 PowerShell 里 Node 和 npm 都能正常调用。打开一个新的 PowerShell 窗口逐条执行node -v npm -v where.exe node where.exe npm前两条返回版本号后两条返回实际路径才算环境正常。如果node或npm提示“不是内部或外部命令”说明 Node.js 没装或者安装时没有勾选 Add to PATH。去 Node.js 官网下载 LTS 版本重新安装安装完成后关闭所有 PowerShell 窗口再开新的。不要在当前窗口里继续试旧进程读不到新的 PATH。还有一种情况是装了多个 Node 版本where.exe node返回好几行第一行指向了一个已经被删掉的旧目录。这时要么调整 PATH 顺序要么用 nvm-windows 切到稳定版本。Node 环境不干净后面npm install -g装出来的 codex 也可能落到非预期目录。2.2 安装 openai/codex 并定位 codex.exeNode/npm 正常后执行全局安装npm install -g openai/codex安装完成后先确认命令可用codex --version where.exe codex npm config get prefixwhere.exe codex会列出系统能找到的 codex 入口。Windows 上常见的结果是.cmd包装文件而 ChatGPT 桌面版真正需要的是一个可执行的.exe。用npm config get prefix找到 npm 全局目录再进入该目录下的node_modules\openai\codex查看bin或平台相关子目录里的实际二进制。不同版本的目录组织可能略有差异以where.exe和npm root -g的实际输出为准不要照抄网上的固定路径。把找到的 codex.exe 完整路径复制下来可以先在 PowerShell 里直接运行一次 C:\Users\你的用户名\AppData\Roaming\npm\node_modules\openai\codex\bin\codex.exe --version能打印版本号说明这个文件就是对的报权限错误或者文件不存在就换where.exe结果里的另一条路径再试。2.3 写入 CODEX_CLI_PATH 并重启 ChatGPT拿到真实路径后用 PowerShell 写入用户级环境变量[Environment]::SetEnvironmentVariable( CODEX_CLI_PATH, C:\Users\你的用户名\AppData\Roaming\npm\node_modules\openai\codex\bin\codex.exe, User )第二行的路径要换成上一步实际验证过的路径并且把“你的用户名”替换成当前 Windows 账户名。写入完成后CODEX_CLI_PATH对新启动的进程才生效。ChatGPT 桌面版如果是开机自启的或者一直挂在托盘里它仍然读的是旧环境。正确做法是从托盘菜单彻底退出 ChatGPT确认任务管理器里没有残留进程再重新打开然后点开 Codex 面板。提示如果不想改用户级变量也可以只在当前会话临时设置$env:CODEX_CLI_PATH但这种方式对从开始菜单启动的 ChatGPT 无效。排障阶段建议直接用SetEnvironmentVariable的用户级写法。3. TaoToken 创建 Key把 Codex 的模型通道换过来3.1 打开官网创建 API Key路径修好后Codex CLI 能跑起来了但还需要一组可以真正发起对话的凭据。打开 TaoToken 注册并登录进入控制台创建 API Key。Key 通常只完整显示一次复制后先放在本地密码管理器或者临时文本里不要直接贴到公开仓库、聊天记录或截图里。创建 Key 这一步和路径修复没有先后依赖但建议在改config.toml之前完成。原因是配置文件里的env_key只是告诉 Codex 去读哪个环境变量真正让请求通过的是那把 Key。Key 没准备好后面冒烟测试一定会报认证错误容易把问题误判成 base_url 写错。3.2 Base URL 写 https://taotoken.net/apiCodex 的 provider 配置里有一个base_url字段填的是接口入口不是给人点开的网页。这里统一写https://taotoken.net/api末尾不要加/v1也不要加斜杠。官网落地页和接口地址是两套东西注册、创建 Key、看模型广场、查用量走带 UTM 的官网页面填进 Codex 配置文件的 base_url 用https://taotoken.net/api。把两者混在一起常见结果是请求打到网页路径上返回 404 或者 HTML 内容CLI 解析不了。注意Codex 会在 base_url 后面自行拼接具体的接口路径。手动补/v1属于多此一举反而容易让路径变成/api/v1/...或者/api/v1/v1/...。以配置文件里只保留到/api为准。3.3 模型 ID 以模型广场为准模型 ID 不要凭记忆写。不同通道、不同时间开放的可调用模型不一样网上抄来的gpt-5、带日期后缀的编号都不一定适用于当前账号。正确做法是打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 进入模型广场查看当时列表里标注为可用的模型 ID原样复制到config.toml的model字段。如果模型广场显示某个模型支持 chat completions而 Codex 默认走了另一套协议可能会在运行时报路径不匹配。这时按接入文档补wire_api字段不要自己猜。模型 ID、协议类型、Key 权限三者对不上报错通常出现在第一次请求而不是配置解析阶段。4. 写 ~/.codex/config.tomlmodel_provider 与 env_key4.1 配置文件最小可复制版本Windows 下 Codex CLI 的配置文件位于C:\Users\你的用户名\.codex\config.toml如果.codex目录不存在先手动创建。用记事本或 VS Code 打开config.toml写入下面这段最小配置model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEYmodel填模型广场复制的 IDmodel_provider是当前选中的 provider 名字必须和下面方括号里的taotoken完全一致base_url固定为https://taotoken.net/apienv_key告诉 Codex 去读名为TAOTOKEN_API_KEY的环境变量。四行各司其职少一行都跑不通。配置写完后可以用codex --help或重新启动一次 CLI 来确认没有 TOML 语法错误。如果启动时报解析失败优先检查引号是否成对、方括号是否写成了中文全角。4.2 设置 TAOTOKEN_API_KEY 环境变量回到 PowerShell把从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建的那把 Key 写入用户级环境变量[Environment]::SetEnvironmentVariable( TAOTOKEN_API_KEY, YOUR_API_KEY, User )把YOUR_API_KEY替换成实际 Key。写完后关闭当前 PowerShell重新开一个窗口验证echo $env:TAOTOKEN_API_KEY能回显内容说明变量已经进入新进程。不要在多人共用的机器上直接回显完整 Key验证时可以先看长度或者只确认变量存在。环境变量和config.toml都改完之后再新开一个 PowerShell 窗口跑 codex不要在旧窗口里测试。4.3 不要套 ANTHROPIC_*那是 Claude Code 的变量Codex 和 Claude Code 是两套不同的 CLI配置文件和变量命名也不一样。ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL是 Claude Code 侧的写法套到 Codex 上不会生效。Codex 读的是~/.codex/config.toml里的model_provider、base_url和env_key。把两边的变量混在一起最常见的结果是 Codex 仍然用默认 provider请求发到官方端点然后因为没有官方 Key 而失败。排障时可以打开两个终端分别测试一个专门跑codex exec一个留着以后配 Claude Code。不要在同一份配置文件里同时维护两套变量。通道边界清楚后面出问题才好定位是哪一层没生效。5. 验证 ChatGPT 内嵌 Codex 是否真的走通5.1 命令行 codex exec 冒烟在写回 ChatGPT 桌面版之前先用命令行做一次最小请求确认 Key、base_url、模型 ID 三个点已经对齐codex exec 只回复四个字通道已通如果返回类似“通道已通”的内容说明 Codex CLI 已经能通过https://taotoken.net/api正常发起请求环境变量和配置文件都读到了。如果报 401先检查TAOTOKEN_API_KEY是否在新终端里可见如果报模型不存在回模型广场核对model字段如果报路径错误检查base_url是否多带了/v1。命令行通过之后再回桌面版能减少排查变量。桌面版如果仍然报Unable to locate the Codex CLI binary那是第一层路径问题和 API Key 无关回到CODEX_CLI_PATH章节检查。5.2 桌面版重启后再点 Codex彻底退出 ChatGPT 桌面版包括托盘图标右键退出然后从开始菜单重新启动。打开 Codex 面板发一个简单问题比如让它解释一段本地代码或生成一个函数。观察两件事第一是否还弹找不到 CLI 的报错第二请求是否在合理时间内返回内容。如果桌面版能打开面板但请求失败把鼠标移到错误提示上看具体是“认证失败”“模型不可用”还是“连接超时”。认证类错误优先查 Key 和env_key模型类错误优先查模型 ID连接类错误则回到base_url和本机网络环境。桌面版和命令行走的是同一份 Codex 配置命令行通了、桌面版不通通常是桌面版进程没有读到新环境变量。5.3 控制台核对这次调用发完测试请求后打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 进入控制台查看调用记录或用量页面。如果能看到刚才那次请求的时间、模型和消耗说明 ChatGPT 内嵌的 Codex 确实通过 TaoToken 的通道完成了调用而不是走了别的默认 provider。这一步同时还能确认模型 ID 是否选对。记录里显示的模型名应该和config.toml里的model一致。不一致就说明配置文件被其他 provider 覆盖了或者model_provider的名字没有对上。6. 还没通按这四个点回查6.1 CODEX_CLI_PATH 指到了 .cmd 或旧版本Windows 上where.exe codex经常返回.cmd包装文件而 ChatGPT 桌面版需要的是实际可执行文件。如果你把CODEX_CLI_PATH指向了.cmd桌面版仍然可能报找不到。回到npm root -g输出目录找到openai/codex下面的真实二进制把它完整路径写进变量。另一种情况是曾经装过旧版本 codexPATH 第一顺位指向了残留目录。where.exe codex返回多行时逐条用--version验证选择能正常输出版本的那一个。6.2 环境变量没重启终端 / ChatGPTSetEnvironmentVariable写入的是用户级变量但已经打开的进程不会自动刷新。PowerShell 需要新开窗口ChatGPT 需要完全退出后重新启动。如果只是点了窗口右上角的关闭按钮进程可能仍在托盘里运行下一次打开只是唤回旧进程变量还是旧的。判断方法任务管理器里搜 ChatGPT确认没有残留进程再重新启动。改完环境变量后第一次测试务必新开终端和新开应用。6.3 Key 或模型 ID 不匹配认证失败和模型不存在的表现比较接近都是请求返回错误。区分方法是看错误文本里有没有提到model或unauthorized。Key 类问题重新生成一把确认写入的是TAOTOKEN_API_KEY而不是写成了别的变量名。模型类问题回模型广场重新复制 ID注意大小写和连字符。如果配置里同时保留了官方 providerCodex 可能优先选了默认 provider。检查model_provider是否等于taotoken以及[model_providers.taotoken]这段是否存在。6.4 provider 段名和 model_provider 不一致TOML 里model_provider taotoken和[model_providers.taotoken]必须完全一致。常见错误是上面写taotoken下面写成tao_token或者TaoToken。大小写和连字符不一致时Codex 找不到对应 provider就会回退到默认配置最终表现为请求发不出去或者认证失败。改完这段后重新跑一次codex exec确认返回内容再回桌面版。7. 下一步让 Codex 长期跑在自己的额度上7.1 需要稳定编码额度看 Coding Plan路径和通道都配通之后Codex 的每次请求都会走你创建的那把 Key。临时测试用模型对话页面就够了如果要长期在 ChatGPT 桌面版里让 Codex 跑代码任务可以打开 Coding Plan 看套餐是否覆盖日常用量。Key 的管理和重新生成在 控制台 API Keys 页面。先用 模型对话 发一条消息验证这把 Key 能正常返回再回桌面版继续用 Codex。顺序反过来也成立但先验证 Key 能省掉一轮桌面版重启。7.2 排障顺序记住这三步下次再遇到 Codex 相关报错先看报错原文属于哪一层出现Unable to locate the Codex CLI binary就是路径层检查CODEX_CLI_PATH和.exe路径能启动但请求失败就是通道层检查config.toml里的model_provider、base_url和env_key请求返回内容但用量不对就去控制台看调用记录和模型 ID。把这两层分开之后Windows 下 ChatGPT 的 Codex 面板就不再是一个黑盒。路径交给CODEX_CLI_PATH模型通道交给~/.codex/config.tomlKey 交给环境变量。三段都对齐报错自然消失。