1. Windows 更新 Codex 后 PowerShell 找不到 codex.exe 的现场还原
Windows 上更新 Codex 之后，PowerShell 里敲codex直接报找不到codex.exe，这个问题的本质不是 Codex 装坏了，而是你终端里那条命令入口还指着旧版本目录。Codex 在 Windows 上的安装路径通常带版本号或哈希目录，比如%LOCALAPPDATA%\OpenAI\Codex\bin\<某串标识>\codex.exe，每次更新后这串标识会变，旧路径自然失效。PowerShell 的Set-Alias或$PROFILE里写死的路径就成了“过期地图”，命令当然找不到目标。
这个场景适合三类人：一是刚在 Windows 上更新完 Codex、准备继续用命令行跑任务的开发者；二是把 Codex 接进 TaoToken 做模型调用、需要终端稳定识别codex命令的人；三是习惯用 PowerShell 而不是 CMD、又不想每次手动敲全路径的普通用户。核心检索词就是 Windows、PowerShell、codex.exe、Codex、Set-Alias，这几个词贯穿全文。
先说清楚 Codex 是什么、能做什么。Codex 是 OpenAI 推出的命令行编码代理工具，可以在终端里读代码、改文件、跑命令，适合把重复的编码任务交给它。它本身是一个 CLI 程序，Windows 上以codex.exe形式存在。你更新它之后，安装器会把新版本放到新的目录，但不会自动帮你改 PowerShell 里的别名或 PATH。于是出现一个很典型的现象：where.exe codex可能什么都找不到，或者找到的是旧路径；codex --version报The term 'codex' is not recognized。
我先把排查顺序理清楚，这样你不用瞎试。第一步，确认新版codex.exe到底在哪；第二步，看当前 PowerShell 的 PATH 和别名指向哪；第三步，用Set-Alias或函数把入口改到新路径；第四步，写进$PROFILE固化；第五步，验证codex --version和实际调用。整个过程不需要重装 Codex，也不需要改系统环境变量，改的是 PowerShell 这一层的命令解析。
这里有个容易踩的坑：很多人第一反应是去“系统属性 → 环境变量”里改 PATH，但 Codex 更新后的目录名带随机串，你手动加一次，下次更新又失效。更稳的做法是用 PowerShell 函数动态查找最新目录，而不是写死路径。这也是后面Set-Alias方案要解决的核心问题。
另外要区分两个概念：Set-Alias只能把别名指向一个已存在的命令或可执行文件路径，它不能执行“查找最新目录”这种逻辑；而function可以。所以真正能扛住 Codex 频繁更新的写法，是用函数包一层Get-ChildItem排序取最新，再用&调用。excerpt 里给的正是这个思路，我会把它拆得更细，并补上 PATH 检查、报错对照和 TaoToken 接入的配置。
如果你同时用 TaoToken 来统一管理模型调用，那终端里codex命令能不能稳定跑起来就更关键了，因为 Codex 的配置里要填 Base URL、API Key 和 Model ID，命令入口不稳定，后面接什么都白搭。所以这篇先把“命令找得到”这件事彻底解决，再谈接入。
2. TaoToken 前置准备：Base URL、API Key 与 Model ID 三件套
在动手改 PowerShell 之前，先把 TaoToken 这边的三件套准备好，因为后面验证codex命令时，你要让它真正能调用模型，而不是只打印个版本号。TaoToken 的官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api ，注意 API 这个地址不加 UTM 参数，配置里填的就是它。
三件套具体是：Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api；API Key 去控制台生成，入口在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，生成后复制保存，它只显示一次；Model ID 根据你要用的模型填，比如 Claude 系列或 GPT 系列的对应标识，具体以文档为准，文档入口 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。API Keys 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，方便你后续轮换。
为什么要在 Codex 场景里提 TaoToken？因为 Codex 作为编码代理，底层要调模型。如果你用 TaoToken 做统一入口，Codex 的配置里就要写清楚 Base URL、Key、Model ID 这三项。而 Codex 读取配置的方式，在 Windows 上常见的是auth.json或环境变量。这里要提醒：Codex 的auth.json路径通常在用户目录下的.codex文件夹里，比如%USERPROFILE%\.codex\auth.json。如果你用的是 Codex 的 OAuth 登录方式，那它走的是另一套鉴权，和 API Key 模式不同，别混用。
我建议的顺序是：先在 TaoToken 控制台把 Key 生成好，Model ID 确认好，再回到 PowerShell 修codex命令入口。这样等你codex --version通过之后，直接就能跑一次真实请求验证。如果你还没决定用哪个模型，可以先到模型对话页 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 试一下，确认模型可用再写进配置。
对于长期在 Windows 上做编码、跑 Agent 任务的人，可以考虑 Coding Plan，入口 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它更适合持续性的编码调用场景。但这一步不急，先把命令入口修好。
需要强调一点：TaoToken 在这里的角色是模型调用的统一入口，不是让你绕过什么，也不是替代你的编辑器。你该用 VS Code 还是用 VS Code，该用 Codex 还是用 Codex，TaoToken 只是把 Base URL 和 Key 管理集中起来。配置时把 Base URL 写成https://taotoken.net/api，不要多加斜杠或路径，否则容易出现 404 或 401。
如果你之前配过 Claude Code 或 Codex 的 Anthropic 兼容模式，注意 Base URL 的写法要和文档一致。Claude Code 相关入口在 https://taotoken.net/claudecode?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite ，里面有针对 Anthropic 协议的说明。Codex 这边如果走 OpenAI 兼容协议，Base URL 同样是https://taotoken.net/api，Model ID 按文档填。
准备好这三件套之后，我们进入 PowerShell 的实际操作。记住：先修命令入口，再填配置，最后验证请求。顺序反了的话，你会分不清是命令找不到还是 Key 填错了。
3. 可复制配置：PATH 检查、Set-Alias 与 $PROFILE 固化
这一节是全文的核心，给你可以直接复制的命令和配置片段。先做 PATH 检查，确认当前 PowerShell 能不能找到codex。打开 PowerShell，执行：
where.exe codex如果返回空，或者返回一个旧路径，说明命令入口有问题。接着看当前会话里有没有别名：
Get-Alias codex如果报Cannot find alias，说明别名没定义。再看$PROFILE里写了什么：
notepad $PROFILE如果提示文件不存在，说明你还没建过配置文件，这很正常。可以用下面命令创建：
if (-not (Test-Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }然后定位新版codex.exe的真实路径。Codex 更新后一般放在%LOCALAPPDATA%\OpenAI\Codex\bin\下面，带一层随机目录。用这条命令列出所有候选并按时间排序：
Get-ChildItem "$env:LOCALAPPDATA\OpenAI\Codex\bin\*\codex.exe" -File | Sort-Object LastWriteTime -Descending | Select-Object -First 5 FullName, LastWriteTime你会看到最新的那个codex.exe路径。确认它能跑：
& "这里替换成上面输出的完整路径\codex.exe" --version能打印版本号，说明新版可执行文件没问题，问题只在命令入口。接下来把入口改成动态查找。打开$PROFILE：
notepad $PROFILE删掉里面旧的Set-Alias codex ...那一行，替换成下面这个函数：
function codex { $exe = Get-ChildItem "$env:LOCALAPPDATA\OpenAI\Codex\bin\*\codex.exe" -File | Sort-Object LastWriteTime -Descending | Select-Object -First 1 if (-not $exe) { Write-Error "未找到 codex.exe，请确认 Codex 已安装" return } & $exe.FullName @args }保存后重新加载配置：
. $PROFILE再验证：
codex --version这次应该能正常输出版本号。这个函数的好处是：Codex 下次更新换了目录，它自动取最新的那个codex.exe，你不用再改路径。如果你更喜欢用Set-Alias，也可以写成先解析路径再设别名，但Set-Alias本身不支持动态查找，所以更推荐函数写法。
如果你确实想保留Set-Alias的语义，可以这样组合：
$codexExe = (Get-ChildItem "$env:LOCALAPPDATA\OpenAI\Codex\bin\*\codex.exe" -File | Sort-Object LastWriteTime -Descending | Select-Object -First 1).FullName Set-Alias -Name codex -Value $codexExe但注意，这种写法在每次 Codex 更新后都要重新执行，除非你把它也放进$PROFILE并在里面动态计算。所以本质上还是函数更省心。
接下来是 Codex 的模型配置。如果你用 TaoToken，Codex 的auth.json或环境变量里要填三件套。auth.json路径一般是：
%USERPROFILE%\.codex\auth.json一个可参考的配置结构如下（字段名以 Codex 实际版本为准，这里给出对照关系）：
{ "base_url": "https://taotoken.net/api", "api_key": "你的 TaoToken API Key", "model": "你的 Model ID" }如果你用的是环境变量方式，可以在$PROFILE里加：
$env:OPENAI_BASE_URL = "https://taotoken.net/api" $env:OPENAI_API_KEY = "你的 TaoToken API Key"注意：环境变量方式和你已有的 OAuth 登录可能冲突，二选一。如果你之前用 OAuth 登录过 Codex，先确认当前用的是哪种鉴权模式，别同时开两套。
配置写完后，重新加载$PROFILE，再跑一次codex --version和一次真实请求。真实请求可以用一个简单任务，比如让它读一个文件或回答一个问题，确认模型调用链路通了。
这里再补一个 PATH 层面的检查。如果你希望codex在 CMD 或其它终端也能用，那需要把新版目录加进系统 PATH，但目录名带随机串，手动加不现实。更稳的做法还是用 PowerShell 函数，或者写一个codex.cmd包装脚本放到一个固定目录，再把固定目录加进 PATH。包装脚本内容：
@echo off for /f "delims=" %%i in ('powershell -NoProfile -Command "Get-ChildItem \"%LOCALAPPDATA%\OpenAI\Codex\bin\*\codex.exe\" -File | Sort-Object LastWriteTime -Descending | Select-Object -First 1 -ExpandProperty FullName"') do set CODEX_EXE=%%i "%CODEX_EXE%" %*把这个codex.cmd放到C:\Tools\之类固定目录，再把该目录加进 PATH，CMD 里也能用。不过对大多数只用 PowerShell 的人来说，函数方案已经够了。
4. 验证请求与成功结果：从 codex --version 到真实模型调用
配置改完，必须验证，不然你不知道是命令入口通了还是模型调用也通了。验证分两层：第一层是命令层，第二层是请求层。
命令层验证：
codex --version成功输出类似codex 0.x.x的版本号。如果这一步就报The term 'codex' is not recognized，说明$PROFILE没加载或函数没写对，回到上一节检查。如果报的是路径相关错误，比如Cannot find path，说明函数里查找逻辑没匹配到文件，用Get-ChildItem手动确认路径。
再验证别名或函数是否生效：
Get-Command codex应该显示Function codex或Alias codex。如果是Application codex.exe，说明系统 PATH 里也有一个，可能和你的函数冲突，需要确认优先级。
请求层验证：跑一个简单任务，比如让 Codex 回答一个问题或读一个文件。具体命令取决于你的 Codex 版本，常见的是：
codex "用一句话说明这个项目是做什么的"如果配置了 TaoToken 的 Base URL 和 Key，请求会走https://taotoken.net/api。成功的话你会看到模型返回内容。如果报 401，说明 Key 不对或没带上；如果报local proxy failed，说明本地网络或代理配置有问题，检查你的环境变量里有没有残留的代理设置；如果报reading choices相关错误，通常是响应格式和 Codex 预期不一致，检查 Base URL 是否写成了带多余路径的形式。
我实测下来，最容易出问题的是 Base URL 多写了/v1或结尾斜杠。TaoToken 的 API 地址就是https://taotoken.net/api，不要自己加/v1，除非文档明确要求。Model ID 也要和文档一致，大小写和连字符都不能错。
如果你用的是 Codex 的 OAuth 模式，那它不走 API Key，验证方式不同。OAuth 模式下codex命令会引导你登录，登录成功后请求走官方通道。但如果你要接 TaoToken，就得切到 API Key 模式，把auth.json或环境变量配好。两种模式不要混，混了容易出现鉴权冲突。
再给一个验证请求是否真的到了 TaoToken 的方法：在 TaoToken 控制台的用量或日志页面看有没有对应请求记录。入口在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，登录后能看到调用情况。如果命令返回了内容但控制台没记录，说明请求没走 TaoToken，可能还在用旧配置或 OAuth。
成功的结果应该是：codex --version有版本号，codex "任务"有模型返回，控制台有调用记录。三者都对上，才算真正修好。
如果你还想验证模型本身是否可用，可以到模型对话页 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 手动发一条消息，确认模型和 Key 没问题，再回到终端验证 Codex。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth 冲突
这一节把真实会遇到的报错列出来，对照排查。第一个是 401 Unauthorized。原因通常是 API Key 没填、填错、或者填了但没生效。检查auth.json里的api_key字段，或者环境变量OPENAI_API_KEY是否在当前会话里。PowerShell 里可以用：
$env:OPENAI_API_KEY确认值是不是你复制的那个。如果为空，说明$PROFILE没加载或变量名写错。注意 Key 只显示一次，丢了就重新生成，入口 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。
第二个是local proxy failed。这个报错通常和本地网络配置有关，比如系统里设了代理但代理不可用，或者环境变量里有HTTP_PROXY、HTTPS_PROXY指向了一个失效地址。检查：
Get-ChildItem Env: | Where-Object { $_.Name -match "PROXY" }如果有输出，确认这些代理是否还需要。不需要就清掉：
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue然后重开 PowerShell 再试。注意，这里说的是清理本地失效代理配置，不是让你去搭什么通道，别理解偏。
第三个是reading choices相关错误。这通常出现在响应解析阶段，Codex 期望的响应结构和实际返回不一致。常见原因是 Base URL 写错，比如写成了https://taotoken.net/api/v1或结尾多了斜杠。改成https://taotoken.net/api再试。另一个原因是 Model ID 不对，模型不存在时返回结构也会异常。对照文档确认 Model ID，入口 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。
第四个是 OAuth 冲突。如果你之前用 OAuth 登录过 Codex，auth.json里可能有 OAuth 相关字段，同时你又填了 API Key，Codex 可能优先走 OAuth，导致你的 TaoToken 配置不生效。解决办法是确认当前鉴权模式，要么清掉 OAuth 字段只用 API Key，要么反过来。别两套并存。
第五个是$PROFILE没加载。PowerShell 默认可能不允许执行脚本，检查执行策略：
Get-ExecutionPolicy如果是Restricted，改成：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned然后再. $PROFILE。这一步很多人漏掉，导致改了配置文件但没生效。
第六个是函数里Get-ChildItem找不到文件。确认 Codex 安装目录是不是%LOCALAPPDATA%\OpenAI\Codex\bin\。有些版本可能装在别的地方，用：
Get-ChildItem "$env:LOCALAPPDATA\OpenAI" -Recurse -Filter codex.exe -ErrorAction SilentlyContinue全盘找一下。找到后把函数里的路径改成实际路径。
第七个是 CMD 里能用但 PowerShell 里不能用，或者反过来。这是 PATH 和$PROFILE作用域不同导致的。PowerShell 的函数只在 PowerShell 会话里生效，CMD 读的是系统 PATH。如果你两个都要用，就用前面说的codex.cmd包装脚本方案。
排查时建议按顺序：先codex --version确认命令层，再codex "任务"确认请求层，再看控制台记录确认走没走 TaoToken。一层一层来，别跳。
6. 语义一致 CTA：把命令入口和模型入口都固定下来
命令入口修好之后，建议把$PROFILE备份一份，比如复制到 OneDrive 或 Git 仓库，换机器时直接拉下来用。函数里的查找逻辑不依赖具体版本号，所以 Codex 再更新也不用改。这是这套方案最大的价值：一次配置，长期稳定。
模型入口这边，TaoToken 的三件套建议也固定下来。Base URL 固定写https://taotoken.net/api，API Key 放在auth.json或环境变量里，Model ID 按文档填。需要生成或轮换 Key 就去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，需要查文档就去 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。如果你还在选模型，可以到模型对话页 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 先试。长期做编码和 Agent 任务的话，Coding Plan 入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。
最后给一个实用技巧：在$PROFILE里加一个codex-path函数，专门用来打印当前解析到的codex.exe路径，方便你排查：
function codex-path { Get-ChildItem "$env:LOCALAPPDATA\OpenAI\Codex\bin\*\codex.exe" -File | Sort-Object LastWriteTime -Descending | Select-Object -First 1 -ExpandProperty FullName }以后codex出问题，先跑codex-path看路径对不对，再跑codex --version看命令通不通，两步就能定位。这套组合我在多台 Windows 机器上用过，Codex 更新后基本不用再手动改路径。
