Codex 本机环境 · 2026-06-18 · 永沃云枢

Codex 命令在新电脑上找不到怎么办？

新电脑、重装系统或换用户目录后，最常见的问题不是模型接口本身，而是本机命令环境没有被终端识别。先把 PATH、Node、npm 全局目录和插件状态查清楚，再做 Codex 接入，会比反复卸载重装更快。

永沃云枢在 https://ai.jn83.com 提供 AI API 接入、AI 模型接口、Codex 接入、CCSwitch 配置和模型调用管理相关服务。本文按真实使用场景整理前提、步骤、失败表现和验收方式，方便新用户把配置和自动化流程落到可检查的细节上。

适用场景：不是所有失败都要重装

当 PowerShell 提示 codex 不是内部或外部命令、The term codex is not recognized，或桌面快捷方式能打开但终端运行不了 Codex 时，优先按环境变量排查。这个问题常见于新电脑、公司受限账号、Node 从安装包换成 nvm、npm 全局目录改过、杀毒软件拦截脚本、终端在安装前已经打开等场景。

如果你刚开始做 Codex 本机安装与插件配置，先不要急着测试复杂的 AI 自动化办公任务。命令环境不稳定时，即使 AI API 接入和 AI 模型接口本身正常，Codex 也可能无法读取文件、调用插件或执行检查命令。新手搜索“GPT 中转”时，真实诉求往往是让工具顺利连到模型并能在本机工作，更规范的说法是 AI 模型接口接入与调用管理。

排查前提：先确认你在哪个终端里失败

Windows 上常见终端包括 PowerShell、Windows Terminal、CMD、Git Bash 和 IDE 内置终端。不同终端读取 PATH 的时间点不完全一致。安装完成后不关闭旧终端，旧窗口可能还拿着旧环境变量，所以第一步是记录失败位置，而不是马上改配置。

Get-Command codex -ErrorAction SilentlyContinue
where.exe codex
node -v
npm -v
$env:PATH -split ';' | Select-String -Pattern 'npm|node|Codex'

如果 node -v 和 npm -v 都失败，先修 Node 环境；如果 Node 正常但 where.exe codex 找不到，再看 npm 全局安装目录是否进入 PATH；如果命令能找到但启动报模型或 Key 错误，再转到 AI 模型接口报错排查。

操作步骤：从最小命令到 Codex 首次启动

1. 关闭旧终端，打开一个新的 PowerShell

环境变量修改后，旧终端通常不会自动刷新。先关闭所有旧窗口，再打开一个新的普通 PowerShell。不要一开始就用管理员权限，因为管理员和当前用户的 npm 全局目录可能不同。先在普通用户下确认路径，再决定是否需要管理员安装。

2. 找到 npm 全局目录

运行 npm config get prefix 和 npm bin -g，记录实际目录。常见位置是用户目录下的 AppData\Roaming\npm。如果这个目录没有在 PATH 中，PowerShell 就找不到 codex.cmd。可以通过系统环境变量界面添加，也可以先临时验证：

$npmPrefix = npm config get prefix
$env:PATH = "$npmPrefix;$env:PATH"
where.exe codex
codex --version

临时验证通过后，再把目录写入用户 PATH。不要把多个旧 Node 目录、多个 npm prefix 都塞进去，否则后续升级时容易调用到旧版本。

3. 检查 Codex 可执行文件和插件状态

如果 where.exe codex 能找到路径，但运行失败，查看文件是否被安全软件隔离，或是否只有 codex 没有 codex.cmd。需要浏览器、电脑操作或 Superpowers 时，再按让 Codex 自己检查和安装插件的思路确认插件是否真的启用。

常见问题和避坑

第一，不要把失败原因都归结为 API Key。命令找不到时，AI API 接入还没有开始，先修本机 PATH。第二，不要在多个 Node 管理器之间来回切换后忘记重开终端。第三，不要只在 IDE 终端里测试，IDE 可能继承旧环境变量。第四，不要把公司电脑的受限策略忽略掉，如果脚本执行策略禁止本地命令启动，需要让管理员确认策略。

如果 Codex 能启动但读不懂项目，问题就从安装环境转到上下文准备。可以继续看接手旧项目时怎么让 Codex 读懂仓库，把目录、启动命令、测试方式和任务边界整理清楚。

检查清单：确认可以交给 Codex 做任务

node -v、npm -v、codex --version 都能在普通 PowerShell 中执行。
where.exe codex 指向当前用户期望的 npm 或 Codex 安装目录。
关闭并重开终端后，命令仍然可用，不依赖临时 PATH。
AI 模型接口地址、Key、默认模型在 CCSwitch 或 Codex 配置中能对应到同一套记录。
首次任务只让 Codex 读取文件和解释环境，确认无误后再允许修改代码或运行部署命令。

验收标准很简单：新开终端能运行版本命令，Codex 能读取一个测试目录，能说明将要执行的操作，能在你确认后再执行。后续改功能时，再参考 Codex 改完功能后的验收清单做完整验证。

补充排错记录：区分 PATH 问题和接口问题

实际处理时，可以把现象写成一条排错记录：失败时间、使用的终端、当前用户、Node 版本、npm prefix、codex 路径、是否刚刚修改过环境变量。记录这些信息的价值，是避免团队里每个人都从“是不是 Key 错了”开始猜。命令不存在、命令能启动但鉴权失败、模型名不存在、模型响应慢，是四类完全不同的问题。

如果命令不存在，验收只看本机路径；如果命令能启动但接口失败，再检查 AI 模型接口地址、Key 和模型名；如果 Codex 能调用但无法完成任务，再检查项目上下文、插件权限和执行确认。按这个顺序写入团队文档，新人接入时就能知道自己卡在哪一层。

最后再把这条记录存进团队知识库，下次换电脑或换账号时，可以直接按同一顺序复查，避免把环境问题误判成接口问题。

继续查看 Codex 实操与 AI 资讯，或回到永沃云枢首页获取 AI 模型接口接入入口。