Codex非系统盘安装故障修复指南

先给出几个确定性结论：Codex安装在D盘或E盘等非系统盘后，启动报错或命令无响应，根本原因往往是Windows环境变量PATH未正确指向安装目录。系统无法定位codex.exe或对应的CLI入口，自然会抛出错误。问题本身不复杂，但排查路上可能踩不少坑——除了环境变量配置，还得排查快捷方式残留、注册表关联冲突，甚至防病毒软件暗中拦截。

按下面步骤逐一排查，效率最高。

核实Codex真实安装路径

打开文件资源管理器，导航到当初选定的非系统盘安装目录——比如D:Codex或E:Program FilesCodex。检查目录下是否存在codex.exe或codex.cmd。如果里面只有.config、.sqlite这类子目录，说明主程序并未正确部署到该路径。这种情况建议重新运行安装程序，在自定义安装界面勾选“将可执行文件放入安装目录根路径”，或手动将bin子目录设为安装目标。

手动将非系统盘路径追加至PATH环境变量

按下Win + R，输入sysdm.cpl回车 → 切换到「高级」选项卡 → 点击「环境变量」→ 在「系统变量」区域找到并双击Path → 点「新建」→ 粘贴实际的Codex可执行路径（例如D:Codex或E:Program FilesCodexbin）→ 点「确定」保存所有窗口。

⚠️ 注意：路径末尾禁止加反斜杠，否则PATH解析会失败；若安装目录包含空格（如Program Files），无需额外加引号——Windows PATH原生支持含空格的路径。

验证并强制刷新终端上下文

关闭所有已打开的CMD、PowerShell、Git Bash窗口；随后以管理员身份重新启动PowerShell；执行：
codex --version

若仍提示“不是内部或外部命令”，说明环境变量尚未生效。此时不必急于修改PATH——可在当前PowerShell中临时注入路径：
$env:Path += ";D:Codex"（将D:Codex替换为实际路径）→ 再次运行 codex --version。若能正常返回版本号，证明路径正确，只是系统级PATH未被新终端读取——此时必须重启电脑，确保所有进程（包括Explorer、IDE、后台服务）加载更新后的PATH。

修复快捷方式残留导致的路径紊乱

方法一：右键点击桌面或开始菜单中的Codex快捷方式 → 选“属性” → 检查“目标”字段。若指向类似"C:WindowsSystem32cmd.exe" /c "C:UsersXXXAppDataLocalProgramsCodexcodex.exe"这类硬编码在系统盘的路径，说明此快捷方式为旧版本遗留。直接删除它，然后前往真实的非系统盘安装目录，右键codex.exe → “发送到” → “桌面快捷方式”重建一个即可。

方法二：如果通过开始菜单启动失败，但在非系统盘下直接双击codex.exe却能正常运行，问题出在Windows注册表关联。此时无需手动篡改注册表——以管理员身份运行PowerShell，执行：
cd D:Codex; .codex.exe --register-shell-integration（路径按实际替换）。该命令会主动重写Shell集成项，直接覆盖旧系统盘路径引用。

排查防病毒软件拦截行为

部分国产安全软件（如火绒、360、腾讯电脑管家）会将非系统盘中运行的.exe默认标记为“高风险行为”，尤其当Codex首次从D盘启动时，可能静默阻止其创建子进程或访问网络。打开杀毒软件主界面 → 找到“防护日志”或“拦截记录” → 筛选今日时间段 → 查看是否有codex.exe被拦截的记录。若有，点击“添加信任”，勾选“永久信任此文件”和“信任该路径下所有程序”。【这是非系统盘安装后最易被忽略的隐蔽杀手】

来源：互联网