根本原因是windows环境变量path未正确指向非系统盘中的codex可执行文件路径,需手动将实际安装路径(如d:\codex)添加到系统path,并重启电脑使所有进程生效;同时排查快捷方式残留、注册表关联错误及杀毒软件拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex安装在D盘、E盘等非系统盘后启动报错或命令无法识别,根本原因是Windows环境变量PATH未正确指向非系统盘中的可执行文件路径,导致系统找不到codex.exe或对应CLI入口。
确认Codex实际安装位置
打开资源管理器,导航到你选择的非系统盘安装目录(例如 D:\Codex\ 或 E:\Program Files\Codex\),检查是否存在 codex.exe 或 codex.cmd 文件。若目录为空或只有.config、.sqlite等子文件夹,说明安装过程未将主程序释放到目标路径——此时需重新运行安装程序,并在自定义安装界面勾选“将可执行文件放入安装目录根路径”或手动指定bin子目录为安装目标。
手动添加非系统盘路径到PATH环境变量
按下 Win + R,输入 sysdm.cpl 回车 → 切换到「高级」选项卡 → 点击「环境变量」→ 在「系统变量」区域找到并双击 Path → 点击「新建」→ 粘贴你实际的Codex可执行路径(如 D:\Codex\ 或 E:\Program Files\Codex\bin)→ 点击「确定」保存所有窗口。
⚠️ 注意:路径末尾不能加反斜杠 \ ,否则会导致PATH解析失败;若安装目录含空格(如 Program Files),无需加引号,Windows PATH本身支持含空格路径。
验证并强制刷新终端环境
关闭所有已打开的CMD、PowerShell、Git Bash窗口;重新以管理员身份启动PowerShell;执行:
codex --version
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
如果仍提示“不是内部或外部命令”,说明环境变量未生效。此时不要重复编辑PATH,而是直接在当前PowerShell中临时注入:
$env:Path += ";D:\Codex"(把D:\Codex换成你的实际路径)→ 再次运行 codex --version。若此时能返回版本号,证明路径本身正确,只是系统级PATH未被新终端读取——必须重启电脑才能让所有进程(包括Explorer、IDE、后台服务)完整加载更新后的PATH。
修复因快捷方式残留导致的路径错乱
方法一:右键桌面或开始菜单中的Codex快捷方式 → 选择“属性” → 查看“目标”栏内容。如果显示类似 "C:\Windows\System32\cmd.exe" /c "C:\Users\XXX\AppData\Local\Programs\Codex\codex.exe" 这种硬编码系统盘路径,说明快捷方式是旧版安装残留。直接删除该快捷方式,然后去你真正的非系统盘安装目录中,找到codex.exe → 右键 → “发送到” → “桌面快捷方式”重建。
方法二:若通过Start Menu启动失败,但直接双击非系统盘下的codex.exe可正常运行,说明问题出在Windows应用注册表关联。此时无需改注册表,只需用管理员PowerShell执行:
cd D:\Codex; .\codex.exe --register-shell-integration(路径按实替换)。这会主动重写Shell集成项,覆盖掉旧的系统盘路径引用。
检查防病毒软件拦截行为
部分国产安全软件(如火绒、360、腾讯电脑管家)会将非系统盘运行的.exe默认标记为“高风险行为”,尤其当Codex首次从D盘启动时,可能静默阻止其创建子进程或访问网络。打开你的杀毒软件主界面 → 找到“防护日志”或“拦截记录” → 筛选今日时间 → 查看是否有codex.exe被拦截条目。若有,点击“添加信任”并勾选“永久信任此文件”和“信任该路径下所有程序”。【这是非系统盘安装后最常被忽略的真凶】










