出错了怎么办

按症状对号入座，大多数问题两三步能自己解决。先给颗定心丸：这一页里的操作都弄不坏电脑，最坏也不过是重装一遍。

第一招 · 让它自己体检

随便开一个黑色窗口（cmd 或 Git Bash 都行），敲这一行回车：

codex doctor

它会检查四件事：装没装好、配置文件读不读得到、密钥能不能用、现在能不能正常跑。哪一项标红或者写着 fail，就带着那句话去下面对应的小节。

要是连这条命令都敲不出来，问题就出在安装本身，直接看下一节。

装不上

每条都先说这个报错到底是什么意思，再给"先试这个"。

提示"不是内部或外部命令"

报错长这样：'node' 不是内部或外部命令，换成 npm 或 codex 也是同一类。意思是这个窗口不知道程序装在哪儿 —— 通常不是没装成，而是窗口比程序开得早。

1. 关掉所有黑色窗口，重新开一个

   包括缩在任务栏里那些。八成到这步就好了。

2. 还不行就重启电脑

   重启会让系统重新认一遍新装好的程序。

3. 再不行就重装 Node.js

   去 nodejs.org 下 LTS 版（页面上标着 LTS 的按钮），一路 Next 装完，再重开窗口试。

npm 卡住不动 / network timeout

网络问题，不是你敲错了。最快的验证办法：手机开热点，电脑连上去再跑一遍安装命令。热点能装成，就说明是公司网络挡的，请 IT 帮忙给 npm 配一下代理，之后回公司网也能用。

npm install -g @openai/codex

EACCES 或 permission denied

权限不够 —— 往全局目录里装东西需要管理员身份。关掉当前窗口（装了一半也没关系），在开始菜单搜 cmd，在结果上右键 → 以管理员身份运行，再敲一遍上面那条安装命令。

PowerShell 说"禁止运行脚本"

完整报错是无法加载文件 npm.ps1，因为在此系统上禁止运行脚本。这是 Windows 自己的安全设置在拦，跟 Codex 无关。

最省事的解法是换个窗口：cmd 和 Git Bash 都不会被拦，本文档的命令在这两个里都能跑。

非要用 PowerShell，就以管理员身份打开它，执行下面这行再输入 Y 确认（微软官方推荐值，只放开本地脚本）：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

敲 codex --version 没有任何输出，或者桌面版一闪就没了

1. 拿到安装包

   文件名是 vc_redist.x64.exe，微软官方组件。直接找管理员要，别在搜索引擎里随手下 —— 这名字被仿冒得多。

2. 双击安装，一路 Next

   约一分钟装完，中间不需要做任何选择。

3. 重启电脑（这步不能省）

   不重启系统还在用旧组件，装了等于没装。很多人卡在这里，以为"装了还是不行"。

4. 新开窗口验证

   敲 codex --version，看到版本号就成了，命令行和桌面版会一起恢复。

配置文件不对

找不到 .codex 文件夹

要么还没建，在 cmd 里敲这行就有了：

mkdir %USERPROFILE%\.codex

要么建了但看不见 —— 点开头的文件夹在 Windows 里默认隐藏。资源管理器里点查看 → 显示 → 隐藏的项目打勾就出来。

改完名字还是 config.toml.txt

系统默认不显示扩展名，你看到的"config.toml"后面其实还跟着隐形的 .txt，改名时只改了前半截。先点查看 → 显示 → 文件扩展名打勾，再右键重命名、把末尾的 .txt 删掉。

报错 config parse error 或 invalid TOML

配置文件里有字符打错了，九成九是引号问题：中文输入法打出的 “” 和英文的 "" 长得很像，但程序只认后者。用记事本打开 config.toml，和配置那一页逐字符比一遍。拿不准就整段删掉重新复制一次，比一个个找快。

报错 401 / unauthorized / invalid api key

密钥没读到或者不对。检查存密钥的那个文件：文件名必须正好是 auth.json（不能是 auth.json.txt）；位置必须在 %USERPROFILE%\.codex 里，不是桌面也不是下载文件夹；内容就下面三行，密钥完整复制、前后别多空格、引号用英文引号。

{
  "OPENAI_API_KEY": "sk-xxxxxxxx（找管理员要）"
}

用起来有问题

右键菜单里没有 Open Git Bash here

Windows 11 把右键菜单折叠了，不是没装上。右键后点最下面那行显示更多选项，或者按住 Shift 再右键，一步到位。展开后仍然没有，才是 Git 没装好，回安装那一页重装。

中文显示成乱码

Git Bash 默认字符集不是中文常用的那套。在它的标题栏上右键 → Options → Text → Character set，改成 UTF-8，关掉窗口重开即可，改一次长期有效。

回答到一半断了 / 提示超时

通常是网络抖了一下或服务当时忙，不是配置坏了。先连按两次 Ctrl + C 退出，再敲 codex 进去重问一遍。

反复出错就让它"想得浅一点"来提速：在 Codex 里输入 /model，把思考强度从 xhigh 往下调到 high 或 medium；想固定下来就改配置文件里 model_reasoning_effort 那一行。日常问答用 medium 就够。

让它改 Word、Excel，它说不会

或者只回了一段文字、文件根本没动。两种可能：

• 技能没装到位置上 —— 回文档处理技能那一页，把验证步骤再走一遍。
• 启动时不在文件所在的文件夹，这个最常见。Codex 只看得见自己"所在的那个文件夹"，所以必须在文件所在文件夹的空白处右键 → Open Git Bash here 再启动它。

找不到生成的结果文件

它一般把结果生成在原文件旁边、名字后面带个后缀（比如 报表_updated.xlsx），有时直接覆盖原文件。打开当前文件夹按"修改日期"排序，最上面的新文件就是。还找不到就直接问它"刚才把结果存到哪了"，它会给出完整路径。

复制 pptx 文件夹卡很久

正常现象，不是死机。那个文件夹里有上万个碎小文件，硬盘处理就是慢。耐心等 30 秒到 2 分钟，别中途取消 —— 取消会留下半截目录，得删掉重来。

实在不行，彻底重来

折腾到记不清自己改过什么的时候，推倒重装比继续查快。这不影响你的文档和其它软件：

1. 卸载 Codex

   npm uninstall -g @openai/codex

2. 删掉配置文件夹

   把 %USERPROFILE%\.codex 整个删掉。里面只有配置和密钥，照文档重填即可。

3. 卸载 Node.js 和 Git

   在系统的"应用"或"程序和功能"里把这两个都卸掉。

4. 回安装那一页从头做一遍

   这次全程用同一个窗口、命令整行复制。

怎么求助能最快得到答复

找同事帮忙时把下面三样一次性发过去，能省一半来回：