Codex 的几个客户端都靠后台的 app-server 干活。Windows 上的 Codex 桌面应用(2026 年 7 月 9 日起并入 ChatGPT 桌面应用,所以弹窗里写的是 "ChatGPT failed to start")和 ChatGPT 浏览器扩展,靠的是后台进程 codex.exe ... app-server;终端里的 Codex CLI 从 0.157.0 起,也会自动启动一个多个会话共用的本地后台服务器(background server)。报错里出现 app-server 或 background server,说明这一层没找到文件、没在期限内完成初始化、一启动就崩了、根本没连上,或者和当前会话的设置对不上。每条报错坏在不同环节,修法不能混用:先在下表找到你的原文,再跳到对应小节。
| 报错原文 | 常见出现位置 | 坏在哪 | 先做什么 | 怎样算修好 |
|---|---|---|---|---|
failed to start codex app-server: The system cannot find the path specified. (os error 3) | Browser Use、内置浏览器、Chrome 插件打开网页时 | 自动更新删掉了旧版本的文件夹,config.toml 或 CODEX_CLI_PATH 还指着它 | 把旧路径改成现存路径,或删掉失效的变量 | 新对话里打开网页、截图正常 |
Codex app-server manifest entry is missing required path nodePath(或 resourcesPath) | 浏览器扩展侧栏,标题是 "Unable to start ChatGPT" | chrome-native-hosts-v2.json 记录的运行时路径已经不存在 | 先打开桌面应用等 30–60 秒;不行再改这个 JSON | 侧栏正常加载 |
Codex app-server is not available(前一行是"恢复对话失败""Error submitting message"等) | 桌面应用里发消息、恢复或停止对话时 | 界面没得到 app-server 的回应:本机进程崩了,或者 Dot、云端、SSH 的远程连接没连上 | 先看本机的普通对话还能不能用 | 对话能恢复、消息能发出 |
Background server has incompatible feature settings(或 Cannot use the shared background server: ...) | 终端里运行 codex,Windows、macOS、Linux、WSL 都有 | CLI 和正在运行的共享后台服务器功能开关对不上,多由版本不一致或旧的保存值引起 | 把 CLI 升级到 0.162.1 或更高;急用先选 Run without daemon this time | 直接运行 codex 不再弹框 |
Codex app-server initialize handshake timed out | 启动弹窗,只有 Check for Updates 和 Quit | 后台进程 30 秒内没完成初始化 | 彻底退出后移走 logs_2.sqlite* | 应用正常进入主界面 |
code=3221225501,即 0xC000001D | 启动弹窗,或提示 Codex app-server process is not available | codex.exe 执行到非法指令后崩溃 | 用事件查看器看出错模块,是 ASProxy64.dll 就卸掉 Astrill 的 LSP | tasklist /m ASProxy64.dll 查不到任何进程 |
桌面应用这边,两条规则先说在前面。关窗口不等于退出:应用会常驻系统托盘,后台进程继续占着数据库,所以动任何文件之前都要从托盘退出。%USERPROFILE%\.codex 里存着本地对话记录、登录状态和配置,重装应用不会碰它,删掉它也修不好上面任何一条。终端里报 background server 的,不需要做下一节的准备,直接看 CLI 那一节。
截至 2026 年 10 月 14 日,只有 CLI 后台服务器那一条有官方修复:CLI 0.162.1 起,普通启动不会再因为默认设置不同而弹框。桌面应用的几条报错,OpenAI 都还没有公布根因或修复版本,更新日志里也没有提到这几句原文。下面的修法除特别注明外,都是用户在 GitHub issue 里报告的变通办法,每条都标出有几人验证过。
动手前:确认装的是哪个应用,彻底退出,再备份 .codex
先确认版本和包名。官方文档现在把它叫做 ChatGPT desktop app for Windows,但 Windows 里的包名仍然是 OpenAI.Codex,商店 ID 是 9PLM9XGG6VKS。另有一个叫 ChatGPT Classic 的旧应用(包名 OpenAI.ChatGPT-Desktop),里面没有 Codex 的 app-server;有用户通过普通的 ChatGPT 下载链接重装,结果装成了它。
Get-AppxPackage -Name "OpenAI.*" | Select-Object Name, Version输出里应该有 OpenAI.Codex。版本号记下来,后面判断分支和提交问题都要用。
然后彻底退出:在任务栏右下角的托盘图标上选择退出,VS Code 等编辑器里的 Codex 扩展也一并关掉。确认后台进程已经没了:
Get-Process ChatGPT, codex, node_repl -ErrorAction SilentlyContinue没有输出才算退干净。还有残留时,用 Stop-Process -Name ChatGPT, codex, node_repl -Force 结束。
最后备份 .codex。先看看对话记录有多大,有用户的 sessions 文件夹累积到 22.24 GB,这时最好备份到另一个磁盘:
Get-ChildItem "$env:USERPROFILE\.codex\sessions" -Recurse -File -ErrorAction SilentlyContinue |
Measure-Object Length -Sum | Select-Object Count, @{N='GB'; E={[math]::Round($_.Sum/1GB, 2)}}
$stamp = Get-Date -Format yyyyMMdd-HHmm
Copy-Item "$env:USERPROFILE\.codex" "$env:USERPROFILE\Desktop\codex-backup-$stamp" -Recurse.codex 里几个关键文件:state_5.sqlite 是对话列表的索引,sessions\ 是本地对话记录,config.toml 是配置,auth.json 是登录凭据,另外还有记忆和插件状态。下文要你"移走"的文件,都是挪到旁边的文件夹,随时可以搬回来。

failed to start codex app-server(os error 3):改掉更新后失效的路径
这条报错通常在 Browser Use、内置浏览器或 Chrome 插件干活时出现:标签页能列出来,但 tab.goto()、DOM 快照和截图全部失败,有时显示的是 os error 2。os error 3 是 Windows 的"找不到路径"。报错来自 node_repl.exe,它要启动 codex app-server --listen stdio://,却找不到该启动的那个 codex.exe。
原因已经被多名用户还原出来:应用会把辅助程序从 C:\Program Files\WindowsApps\ 复制到 %LOCALAPPDATA%\OpenAI\Codex\bin\<hash>\ 和 %LOCALAPPDATA%\OpenAI\Codex\runtimes\cua_node\<hash>\bin\,每个版本的 hash 都不一样。自动更新删掉旧文件夹后,下面几处还记着旧路径:
%USERPROFILE%\.codex\config.toml里的[mcp_servers.node_repl]一节(command、CODEX_CLI_PATH、NODE_REPL_NODE_PATH等)- 用户环境变量
CODEX_CLI_PATH chrome-native-hosts-v2.json(浏览器扩展用的那份记录,下一节细说)

最早的报告 #19187 从 2026 年 4 月 23 日开到现在,OpenAI 员工把后来的同类报告标成它的重复;#20206 等同类 issue 里,"还在发生"的留言一直持续到 2026 年 9 月 22 日。
第一步:找出哪些路径已经失效
彻底退出应用后,在 PowerShell 里列出 config.toml 里记录的所有 .exe 路径,False 就是已经不存在的:
$cfg = "$env:USERPROFILE\.codex\config.toml"
Select-String -Path $cfg -Pattern "[A-Za-z]:\\[^'`"\r\n]+?\.exe" -AllMatches |
ForEach-Object { $_.Matches.Value } | Sort-Object -Unique |
ForEach-Object { "{0} {1}" -f (Test-Path $_), $_ }
[Environment]::GetEnvironmentVariable("CODEX_CLI_PATH", "User")再看现在实际存在的文件在哪个 hash 文件夹里:
Get-ChildItem "$env:LOCALAPPDATA\OpenAI\Codex" -Recurse -Include codex.exe, node_repl.exe, node.exe -ErrorAction SilentlyContinue |
Select-Object FullName, LastWriteTime第二步:把旧路径改成现存路径
先复制一份 config.toml,再把失效的路径换成上一步找到的现存路径。#26011 里的报告者改成了这样(<user> 和 <hash> 换成你的实际值):
[mcp_servers.node_repl]
command = 'C:\Users\<user>\AppData\Local\OpenAI\Codex\bin\<hash>\node_repl.exe'
[mcp_servers.node_repl.env]
CODEX_CLI_PATH = 'C:\Users\<user>\AppData\Local\OpenAI\Codex\bin\<hash>\codex.exe'Windows 路径要用单引号,或者把反斜杠换成正斜杠。写在双引号里时 \ 会被当成转义符,有用户因此卡在启动界面,日志里是 missing escaped value。config.toml 其他字段怎么写,可以看 Codex 沙箱与 config.toml:权限、批准和网络怎么配。
用户环境变量 CODEX_CLI_PATH 如果指向不存在的文件,直接删掉比改成另一个 hash 更稳:
[Environment]::SetEnvironmentVariable("CODEX_CLI_PATH", $null, "User")有用户把它指向旧版本的 codex.exe 后,应用能启动了,跑的却是旧版 CLI,之后对话又出错。改完后彻底退出、重新打开,在新对话里让它打开一个网页并截图,能截图就说明修好了。这个办法有多名用户验证。其中一位遇到的路径失效还被误报成"企业网络策略拦截",所以看到这类提示也可以先查路径。
2026 年 4–5 月的版本:bin 文件夹整个不存在
在 26.422、26.429 这批版本上,%LOCALAPPDATA%\OpenAI\Codex\bin 有时根本没有被创建,辅助程序只留在 %LOCALAPPDATA%\Packages\OpenAI.Codex_2p2nqsd0c76g0\LocalCache\Local\OpenAI\Codex\bin。先把应用更新到最新版:有用户报告 26.506 已经能正常创建这个文件夹。更新后仍然没有时,多名用户的做法是建一个目录联接:
New-Item -ItemType Junction -Path "$env:LOCALAPPDATA\OpenAI\Codex\bin" `
-Target "$env:LOCALAPPDATA\Packages\OpenAI.Codex_2p2nqsd0c76g0\LocalCache\Local\OpenAI\Codex\bin"有一位用户在干净的虚拟机上这样做之后,报错变成了沙箱错误 CreateProcessAsUserW failed: 5,只有在完全访问模式下 Browser Use 才能用。
据多名报告者反馈,对这条报错没用的做法有:应用设置里的修复和重置、单纯重装、重启电脑、以管理员身份运行、另装一份 npm 版 Codex CLI。
missing required path nodePath / resourcesPath:让浏览器扩展找到新路径
这条报错出现在 Chrome、Edge、Brave 的 ChatGPT 扩展侧栏里,标题是 "Unable to start ChatGPT",下面写着 Codex app-server manifest entry is missing required path nodePath,也可能是 resourcesPath 或 codexCliPath。
扩展本身不运行 Codex,它的调用链是这样的:浏览器通过原生消息主机 com.openai.codexextension 启动 .codex\plugins\cache\openai-bundled\chrome\latest\ 下面的 extension-host.exe,后者读取 chrome-native-hosts-v2.json,再按里面记录的 nodePath、resourcesPath 等路径启动 app-server。所谓 "missing",多名用户确认是这个路径已经不存在,而不是字段缺失:桌面应用更新时删掉了旧的 cua_node\<hash> 运行时和旧安装目录,这份记录却没有跟着更新。2026 年 10 月 3 日和 10 月 8 日的更新之后,又有用户在 #32706 和 #40357 里报告复发。
从最轻的做法开始:
- 先打开桌面应用,等 30–60 秒再用扩展。 扩展只在桌面应用运行时才能工作,有一两位用户这样就恢复了。
- 走一遍官方的连接检查(浏览器扩展文档里的排查步骤,没有点名这条报错):更新桌面应用;装了不止一个 ChatGPT 或 Codex 桌面应用时,每个都更新,不用的删掉;重启浏览器;在桌面应用的 Settings → Computer Use 里确认浏览器显示 Manage 而不是 Install;使用装了扩展的那个浏览器配置文件;新开一个对话再试;重启桌面应用;仍不行就从 Settings → Computer Use 重新安装扩展。
- 在桌面应用里让 Codex "connect to Chrome",有一位用户这样让状态重新生成了。
OpenAI 支持人员在论坛回复里建议,不要反复重试安装插件、卸载插件或清缓存。上面几步都不行时,再手动修那份记录:
# 当前最新的 Node 运行时文件夹
Get-ChildItem "$env:LOCALAPPDATA\OpenAI\Codex\runtimes\cua_node" -Directory |
Sort-Object LastWriteTime -Descending | Select-Object -First 1 FullName
# 当前安装目录下的 resources
(Get-AppxPackage -Name OpenAI.Codex).InstallLocation + "\app\resources"关掉桌面应用和浏览器,先复制一份 %LOCALAPPDATA%\OpenAI\Codex\chrome-native-hosts-v2.json,再把里面的 nodePath 改成 <运行时文件夹>\bin\node.exe,nodeModuleDirs 改成同一位置的 node_modules,resourcesPath 改成上面输出的 resources 路径。JSON 里的反斜杠要写成 \\。保存后先启动桌面应用,再打开浏览器。这个做法有多名用户验证。#35705 里还有用户贴出了自动完成这几步的 PowerShell 脚本 Repair-CodexChromeManifest.ps1,它会先备份,并支持用 -WhatIf 预览改动,另有一人确认有效。脚本不是 OpenAI 提供的,运行前先读一遍。
如果连 chrome\latest 联接也指向了被删掉的版本,就需要从安装目录恢复插件缓存、重建联接和两份 v2 记录。这一步比较复杂,#42520 里有多名用户在 26.930.2377.0 上做成功的完整步骤。
修好的标志是侧栏正常加载,可以在桌面应用里用 @Chrome 之类的提及调用浏览器。
恢复对话失败 / Codex app-server is not available:分本地和远程
这条提示出现在桌面应用里,Windows 和 macOS 都有。它的意思是界面向 app-server 发了请求(发消息、恢复对话、停止任务),却没有得到回应。它只说明结果,不说明原因:没回应的可能是你电脑上的 codex.exe,也可能是 Dot 对话、Codex Cloud 环境或 SSH 连接背后的远程那一端。所以第一步只做一个判断:本机的普通对话还能不能用。
提示的第二行都是 Codex app-server is not available,较早或其他版本写作 Codex app-server process is not available。第一行随操作而变:
- 恢复对话时:中文界面是
恢复对话失败或无法恢复对话,英文界面是Failed to restore conversation或Failed to resume chat - 发消息时:
Error submitting message;新建对话时:创建聊天时出错 - 停止任务时:
Failed to stop chat
| 你看到的情况 | 多半是哪一端 | 先做什么 |
|---|---|---|
| 只有 Dot 对话、Codex Cloud 环境或 SSH 连接报错,本机对话正常 | 远程:桌面应用连不上远程那一端 | 在 chatgpt.com 网页版或手机上打开同一个任务;本地删文件、重装都碰不到这一层 |
| 所有对话都报错,连新建的空白对话也一样 | 本地:codex.exe 没起来,或起来后马上退出 | 彻底退出后重开,看退出代码;公司电脑查机器级策略文件 |
| 先出现 "ChatGPT hit a snag",之后恢复、停止对话都失败 | 本地:后台进程崩溃或被系统结束 | 在日志里找退出代码或 SIGKILL,按下面的本地分支处理 |
远程分支:Dot、Codex Cloud、SSH 连不上
Dot 对话的报告最多:macOS 和 Windows 上都有人反复看到"恢复对话失败 / Codex app-server is not available",同时本机任务照常运行(#49520、#53359,后者 2026 年 10 月 12 日提交)。Codex Cloud 环境配置完成后开新会话报 Error submitting message 也是这一类,有人在 SSH 连接上遇到同样的情况(#49868)。日志里的特征是 hostKind=durable、failureReason=open_timeout,WebSocket 以 1006 关闭,连接的是 codex-cloud-backend.chatgpt.com。
用代理上网的读者要留意 #49829(未关闭)。多名用户检查安装文件后发现:桌面应用的其他请求都走 Chromium 的网络栈,会用系统代理;唯独这条 durable WebSocket 是用 Node 的 ws 包直接连的,系统代理和应用的代理设置都管不到它。所以在直连超时、只能走代理的网络里,它一直 open_timeout,而同一个任务在 chatgpt.com 网页版能打开,在 Android 上也能继续对话。这个原因是用户分析出来的,OpenAI 没有确认,也没有给出修复。
能做的事情不多:
- 先用网页版或手机继续工作。 同一账号在网页版能打开同一个任务,说明账号和任务都还在,坏的只是桌面应用到远程的这条连接。
- 用 Clash 一类代理工具的,可以试 TUN 模式,但别指望一定有效。 一位 macOS 用户开 TUN 后,不用重启应用就恢复了;另一位在两台 Mac 上开 TUN 都没用,只开 TUN 时还一度断了本机对话,改回原设置才恢复。还有 Linux 用户给桌面应用单独配了代理环境变量和
--proxy-server,本机对话好了,云端连接照样超时。 - 别对这条分支做本地清理。 删
.codex、重置、重装处理的都是你电脑上的文件,远程那一端的连接不会因此变好,本地对话记录反而可能丢掉。
在 Cloud 对话里调用 Windows Computer Use 时报 program not found 的,见后面对照表的第一行。应用能打开、只是用着用着反复断线重连的,是另一类问题,见 Codex 一直 Reconnecting:先保住任务,再定位是哪一层断了。
本地分支:每个对话都失败,或用着用着崩掉
本机对话也全部失败时,问题在你电脑上的 app-server。按代价从小到大:
-
从托盘彻底退出再打开。 做法见上文"动手前"一节,这一步不动任何数据。
-
看进程是怎么退出的。 弹窗或日志里有退出代码时对照:
code=3221225501(0xC000001D)见下文 0xC000001D 一节;0xc0000409有报告与内存耗尽有关;0xC0000017有一例是用户 PATH 超过 32 KB,见对照表。macOS 上有用户的 app-server 被反复SIGKILL,当时 16 GB 内存的机器只剩约 447 MB 空闲,界面先报 "ChatGPT hit a snag",再报Failed to stop chat(#41473,单人报告)。遇到这种情况可以先关掉其他占内存的程序再试,这一步没有人专门验证过。 -
公司配的电脑,查机器级策略文件。 Windows 26.820.80927 上有人所有 Work 对话都报这条错(#41252,未关闭)。一位评论者发现,机器上的
C:\ProgramData\OpenAI\Codex\requirements.toml强制了自定义权限配置和一个托管 hook,去掉这份策略后就恢复了(单人报告)。这是整台电脑生效的策略,公司电脑上多半是管理员下发的,查到有这个文件先问 IT,不要自己删:powershellTest-Path "C:\ProgramData\OpenAI\Codex\requirements.toml"
同一个 issue 里,Windows 设置里的"重置"没有用;完全卸载重装后好了大约两天,之后恢复对话时又报"恢复对话失败"。所以重装最多算临时办法,而且一定先备份 .codex,原因见后面"删 .codex、重置"一节。
Background server has incompatible feature settings:升级到 0.162.1
这个框是终端里的 Codex CLI 弹的,和桌面应用无关,Windows、macOS、Linux、WSL 上都有人遇到。CLI 从 0.157.0(2026 年 9 月 25 日发布)起,运行 codex 时会自动启动一个共享的本地后台服务器(background server,命令里叫 app-server daemon),多个会话共用它。后台服务器启动时带着一组功能开关,当前会话要求的开关和它不一致时,就弹出这个框。
解决办法是把 CLI 升级到 0.162.1 或更高。 0.162.1(2026 年 10 月 9 日发布)把兼容检查限定在命令行上显式写出的功能开关,普通启动不会再因为 CLI 和后台服务器的默认值不同而弹框;OpenAI 员工在 #51758 里确认,CLI 比后台服务器新的情况也包括在内。截至 2026 年 10 月 14 日,npm 的 latest 和 Homebrew 的 codex cask 都是 0.162.1:
npm install -g @openai/codex@latest # 用 npm 安装的
brew upgrade --cask codex # 用 Homebrew 安装的
codex --version # 应显示 0.162.1 或更高MacPorts 截至 10 月 13 日还没有跟上 0.162.1。升级后正常启动仍然弹框的,OpenAI 员工请大家在 #51758 里报告 CLI 和后台服务器各自的版本号。
弹框里的三个选项分别会怎样
完整的弹框是这样的:
Background server has incompatible feature settings
This session requires api_key_model_discovery to be enabled
Restart will use these shared feature settings:
api_key_model_discovery = true
auth_elicitation = true
code_mode_host = true
mcp_oauth_refresh_coordination = false
These settings persist and can disable functionality for other clients. Restart may interrupt active or queued work.
1. Run without daemon this time
2. Restart with these settings
3. Cancel第二行是本次会话要求的值,也可能写成 to be disabled。api_key_model_discovery 在源码里的说明是"为 OpenAI API key 登录发现模型目录",它只是一个功能开关,不代表你需要 API key:用 ChatGPT 账号登录、没配任何 key 的用户同样遇到了这个框(#51891)。
| 选项 | 做了什么 | 会不会留下改动 | 对其他会话的影响 |
|---|---|---|---|
Run without daemon this time(这次不用后台服务器) | 本次会话单独运行,不连共享后台服务器 | 不会 | 没有影响 |
Restart with these settings(按这组设置重启) | 用上面列出的值重启后台服务器,选中后还要再确认一次 | 会:这组值被保存下来,以后每次启动都沿用 | 正在运行或排队的工作可能被打断 |
Cancel(默认选中) | 退出,什么都不改 | 不会 | 没有影响 |
没有弹出选择框、直接退出的,看到的是同一个问题的另一种写法:
Error: Cannot use the shared background server: This session requires api_key_model_discovery to be enabled.
To work without the background server, rerun the same command with --no-daemon (including resume or fork and its arguments).第二项是灰的、旁边写着 This server is not managed by Codex. 时,意思是 CLI 的后台服务器管理功能认不出正在运行的这个服务器,所以不能替你重启它;这不一定说明它是你手动另开的。这时只剩第一项和取消,或者用下面不需要重启的做法。
暂时没法升级 CLI:按影响从小到大选
-
只想先把手上的事做完:选第一项,或者启动时直接加
--no-daemon。恢复会话也一样:codex resume --no-daemon、codex resume <会话 ID> --no-daemon。它只对这一次有效,不会改任何设置。按 CLI 参考,--no-daemon不能和--remote或codex agents一起用。 -
想继续用共享后台服务器,又不想重启它:第二行写的是
to be enabled时,启动时加一次--disable api_key_model_discovery,或者在~/.codex/config.toml里写上下面两行。多名用户确认,这样能直接接入正在运行的后台服务器,不会重启它,也不会打断别的会话(#51891、#52642)。toml[features] api_key_model_discovery = false用 API key 或第三方 provider 的人要注意:按源码说明,这个开关管的是模型目录发现,关掉后模型列表可能受影响,这一点还没有人实际测试过。自定义 provider 的写法见 Codex 接第三方模型 API:先确认 Responses 兼容,再写 provider,
config.toml的其他配置见 Codex 沙箱与 config.toml:权限、批准和网络怎么配。 -
第二行写的是
to be disabled:多半是 CLI 比后台服务器旧,比如 CLI 停在 0.160.1,后台服务器已经自己更新到了 0.161.0。把 CLI 升级就行,#51758 的报告者升级后弹框就消失了。 -
确认没有别的会话在跑,才选第二项。它能解决问题,但会把这组值保存下来,并重启所有会话共用的那个服务器。
升级到 0.162.1 之后,把为了绕过弹框加的 --disable api_key_model_discovery 去掉,包括写进别名或脚本里的。按 0.162.1 的修复说明,命令行上显式写的开关仍然会被检查,留着它还可能再弹框。config.toml 里那两行不会再触发检查,但会让这个功能一直关着,没有必要再留。
CLI 和后台服务器为什么对不上:三种已报告的情况
- CLI 和后台服务器版本不一致。 后台服务器会自己更新:有人的 CLI 停在 0.160.1(Homebrew 或 npm 安装),后台服务器已经自动更新到 0.161.0;也有人反过来,Homebrew 的 CLI 是 0.162.0,后台服务器还是 0.160.1。0.161.0 把
api_key_model_discovery的默认值从关闭改成了开启,两边一新一旧就对不上。用下面的命令对比输出里的cliVersion和appServerVersion:
codex app-server daemon version- 版本一样,但后台服务器存着旧的覆盖值。 后台服务器把功能开关保存在
~/.codex/app-server-daemon/settings.json的featureOverrides里。以前选过一次Restart with these settings,api_key_model_discovery = false就被存了下来;默认值改成开启之后,每次新开会话都弹框(#51891 里一位用户读代码后的分析,和 0.162.1 的修复说明一致)。 - 后台服务器不归 Codex 管理,也就是第二项变灰的那种情况。
codex doctor 会列出后台服务器的状态、版本和设置文件位置,提交问题时用得上。在 CLI 里输入 /daemon 可以打开后台服务器的控制项;按斜杠命令文档,确认更新会退出 Codex,也可能打断正在进行的工作。
还有一个前兆:后台服务器自动更新时,可能先把正在运行的会话断掉,报 turn/steer failed: Server is draining; retry after reconnecting,之后再恢复会话就弹出这个框(#51763,未关闭)。
这些做法没用或代价大:0.161.0 上 codex app-server daemon restart --enable api_key_model_discovery 显示重启成功,保存的值却没变(#51787);降级到 0.160.0 只会让提示反过来,变成 to be disabled(#51806);一位 Windows 用户删掉 ~/.codex/app-server-daemon 也没有解决。#51787 的报告者在隔离环境里测试,先 codex app-server daemon stop 再 codex app-server daemon start 能清掉保存的覆盖值,但这会停掉共享后台服务器,连着它的会话都会中断。
同样提示加 --no-daemon 的其他后台服务器报错
下面几条也是 CLI 后台服务器的问题,后面都跟着 To work without the background server, rerun the same command with --no-daemon (including resume or fork and its arguments).,意思是:不用后台服务器的话,把同一条命令加上 --no-daemon 再运行一次,恢复或分叉会话时连原来的参数一起带上。
| 报错原文 | 出现情况 | 可以先试(证据强弱) |
|---|---|---|
Error: failed to open daemon process: Access is denied. (os error 5),旧版写作 Error: Access is denied. (os error 5) | Windows 11 的 PowerShell,0.160.1 到 0.162.1 都有报告;和桌面应用的 os error 3 不是一回事 | 一位用户把 .codex 下的 app-server-control、app-server-daemon 两个文件夹改名备份后恢复(#51283,未关闭,没有官方修复);报错提示可以加 --no-daemon,但报告里没有人实际试过 |
Error: start the Windows daemon from a non-elevated terminal; shared clients must not inherit administrator privileges | 0.157.0 在管理员终端里启动 | 换一个普通(非管理员)终端;有用户报告加 --no-daemon 能用,只是变慢了(#48043) |
Error: app server is running but is not managed by codex app-server daemon | npm 更新后,旧版 app-server 还在运行 | 确认没有会话在用,结束那个旧的 app-server 进程,再运行 codex app-server daemon start(#46468,未关闭) |
os error 5 那位用户的改名脚本如下。先关掉所有 Codex 会话再运行;这两个文件夹存的是后台服务器的控制和设置状态,改名而不是删除,出问题可以改回来:
$stamp = Get-Date -Format "yyyyMMdd-HHmmss"
foreach ($name in @("app-server-control", "app-server-daemon")) {
$path = Join-Path $HOME ".codex\$name"
if (Test-Path $path) { Rename-Item -LiteralPath $path -NewName "$name.backup-$stamp" }
}0.162.1 以管理员身份运行 CLI 时,会提示 Running as administrator: shared background server disabled.,这次会话不用共享后台服务器;想用它,就换回普通终端重新打开。
initialize handshake timed out:app-server 没在 30 秒内完成握手
按官方说明,客户端连上 app-server 后要先发一个 initialize 请求,这一步就是"握手"(handshake)。桌面应用只给它 30 秒,#39015 的日志里能看到 durationMs=30012、cause=initialize_handshake_timeout。30 秒这个期限是从日志里看到的,文档里没有写。
它和 15 秒的云端配置包超时不是一回事。如果你的报错是 timed out waiting for cloud config bundle after 15s,请看 Codex 启动超时:先查云端配置包,再处理连接、MCP 和进程。
按代价从小到大试:
1. 移走日志数据库 logs_2.sqlite。 这是证据最多的原因:日志库太大或已经损坏,app-server 启动时打开它就超时。有用户的日志库有 6.7 GB;另一位的 2.27 GB 日志库损坏,移走后握手时间降到 1.7 秒。按 #39015 的说明,这个库里没有对话和设置。从托盘彻底退出后,三个文件一起移走:
$codex = "$env:USERPROFILE\.codex"
Get-ChildItem "$codex\logs_2.sqlite*" | Select-Object Name, @{N='MB'; E={[math]::Round($_.Length/1MB)}}
$hold = "$codex\hold-logs-$(Get-Date -Format yyyyMMdd-HHmm)"
New-Item -ItemType Directory $hold | Out-Null
Move-Item "$codex\logs_2.sqlite*" $hold重新打开应用,它会建一个新的日志库。OpenAI 员工在 #23917 里说,新版本会检测并报告数据库损坏,自动修复还在开发中,没有给出版本号。
2. 清掉占着数据库的残留进程。 有一位用户遇到过十几次:上次没退干净的进程锁住了状态数据库。结束 Get-Process *codex*, *chatgpt*, *node_repl* 列出的进程后重新打开(#32160,单人报告)。
3. 用 WSL 跑 Codex 的,先关掉 WSL 模式。 在 WSL 模式下,启动时要通过 /mnt/c 回填状态,有人超过了 30 秒。在 config.toml 里加上下面的设置,或者等回填跑完(约 40 秒)再重新打开(#38345,单人报告):
[desktop]
runCodexInWindowsSubsystemForLinux = false代价是关掉之后,在 WSL 下建的对话暂时打不开(#39169)。
4. 对话记录特别大时,临时移走 sessions。 一位 Reddit 用户在 sessions 有 22.24 GB 时,只移日志库没用;完整备份后,把 sessions、archived_sessions 和 state_5.sqlite* 移到另一个盘,应用才打开(原帖)。这样做之后对话列表会暂时变空,文件搬回来之前看不到旧对话,所以放在最后,而且一定是移走,不是删除。同一帖里另有两人说,他们真正的原因是 WSL 模式。
还有一位用户切换了 Clash 代理节点就好了(#29040),只有这一例。
0xC000001D(code=3221225501):先查是谁注入了 codex.exe
完整报错一般是:
ChatGPT failed to start. (code=3221225501, signal=null). Most recent error: Codex app-server websocket closed (code=3221225501)3221225501 换成十六进制就是 0xC000001D,含义是 STATUS_ILLEGAL_INSTRUCTION:codex.exe 执行到一条 CPU 无法执行的指令,进程直接崩溃。有时界面上只显示 Codex app-server process is not available,这条提示怎样区分本地和远程,见上文 not available 一节。
先看是哪个模块崩的:打开事件查看器,进入 Windows 日志 → 应用程序,找来源为 Application Error、应用名是 codex.exe 的错误,看"错误模块名称"(Faulting module name)。
错误模块是 ASProxy64.dll:卸掉 Astrill 的 LSP
ASProxy64.dll 是 Astrill VPN 装进 Winsock 的 LSP 组件,它会被注入到 codex.exe 里。这是桌面版 0xC000001D 证据最多的原因,#30884 和 #24408 里的报告者用的都是 Zen 5、Core Ultra、i7-14700KF 这类新 CPU,所以问题不在 CPU 太老。多名用户验证过的做法,任选一种:
- 在 Astrill 里按住 Ctrl 打开菜单,Help → LSP Uninstall,然后重启电脑。
- 用管理员终端检查并重置 Winsock 目录,然后重启。注意
netsh winsock reset会重置所有 LSP,不只 Astrill 的:
netsh winsock show catalog | findstr ASProxy
netsh winsock reset- 直接卸载 Astrill。
重启后运行 tasklist /m ASProxy64.dll,显示没有任务在运行,就说明 DLL 已经不再注入,这时再打开应用。想继续用 Astrill 的用户报告,OpenWeb 和 WireGuard 协议不会装这个 LSP,去掉 LSP 后 StealthVPN 也照常可用。如果错误模块是别的第三方 DLL,情况可能类似,但目前只有 Astrill 有成批的验证报告。
错误模块是 codex.exe 本身:本地多半修不了
这时更可能是某些版本的 codex.exe 用到了你的 CPU 不支持的指令。目前有两个相关案例,都不是桌面版:npm 版 CLI 0.135.0 在 Haswell 至强上崩溃,OpenAI 员工回复"下个版本修复",临时办法是退回 0.134.0(#25367);VS Code 扩展里的 codex.exe 在 Zen 3 和 Raptor Lake 上报 HW capability requested: 0x200000,报告者说 WSL2 里的 Linux 版能用(#17410,仍未关闭)。桌面版的 0xC000001D 没有任何 OpenAI 员工回复,当前版本具体要求哪些 CPU 指令也没有公开说明。
对这一分支,多名用户报告重装、重新注册应用包、装 VC++ 运行库、删 SQLite 数据库、清空 .codex 都没有效果。能做的是按文末的清单收集信息、提交报告;需要临时继续工作的话,可以参照 #17410 的报告者,改在 WSL2 里用 CLI。
其他 app-server 报错和启动卡住:对照表
不是上面几条时,按原文在这里找:
| 报错或现象 | 多半是什么 | 可以先试(证据强弱) |
|---|---|---|
failed to launch codex app-server: program not found | 在 Cloud 对话里调用 Windows Computer Use 时出现,同样的测试在 "On my computer" 对话里正常 | 改用本机对话;原因不明(#51867,2026 年 10 月 7 日单人报告) |
Codex app-server process is not available、"ChatGPT hit a snag" | 后台 codex.exe 已经崩了,界面没有重启它;只在 Dot 或云端对话里出现的,见上文 not available 一节的远程分支 | 看退出代码:0xC000001D 见上一节;0xc0000409 有报告与内存耗尽有关;0xC0000017 有一例是用户 PATH 超过 32 KB(先备份 HKCU\Environment 再精简,#46374) |
code=3221225506,即 0xC0000022 | 26.820.7780.0–26.825.6671.0 上,SafeDllSearchMode 被设成 0 时加载 dbghelp.dll 被拒 | 用管理员权限把 HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\SafeDllSearchMode 改回 Windows 默认值 1(多人验证,#40913) |
Unable to locate the Codex CLI binary. Set CODEX_CLI_PATH or ensure the Electron resources include bin/codex. | 8–9 月部分版本从安装包里复制 CLI 失败 | 更新到新版本或改装 ChatGPT (Beta);应用装在非 C 盘时,在"设置 → 应用 → 已安装的应用"里把它移到 C 盘(多人,#40700) |
| 没有报错,一直卡在 logo 或转圈(26.924–26.928) | 界面在等后台进程 | 只结束命令行里带 app-server 的那个 codex.exe,应用会重新拉起它(多人,#48333);多人报告 26.930.x 已恢复 |
| 登录后 10–35 秒自己关闭(26.1002.7124.0,10 月 7 日起) | 后台运行时包 OpenAI.CodexPrimaryRuntime 安装时崩溃 | 有用户手动安装已下载的运行时包后恢复,步骤和签名检查见 #52029 与论坛帖(非官方) |
code=3221225781,即 0xC0000135 | 缺少 vcruntime140_1.dll | 安装最新的 Microsoft Visual C++ 运行库 x64 和 x86(单人,论坛) |
卡在 logo 时只结束 app-server 进程,可以用这条命令(来自 Qiita 上的记录)。结束 exec-server 没用,结束全部 codex.exe 会打断其他会话:
Get-CimInstance Win32_Process |
Where-Object { $_.Name -eq "codex.exe" -and $_.CommandLine -like "* app-server *" } |
ForEach-Object { Stop-Process -Id $_.ProcessId -Force }应用已经正常打开、只是用着用着断线重连,那是另一类问题,见 Codex 一直 Reconnecting:先保住任务,再定位是哪一层断了。
删 .codex、重置、以管理员运行:这些做法修不好还有代价
- 删除
.codex文件夹。 有用户排查时这样做,丢了全部对话记录;在 #30884 和 #30339 里,删掉它也没有修好 0xC000001D。OpenAI 支持人员在论坛回复里也说,没备份就不要删%USERPROFILE%\.codex。启动卡住时,他们建议的是把%APPDATA%\Codex改名为Codex.backup,这是另一个文件夹。"结束残留进程、删掉 .codex"对 not available 同样不对症:远程分支根本不在本机,本地分支里连重置和重装都只管用一阵子。 - Windows 设置里的"重置"。 有用户重置后本地任务被删掉了,还要重新登录;"修复"相对安全一些。日志和崩溃转储存在应用包的
LocalCache里,卸载时很可能一起被删,要卸载的话先把下文提到的日志复制出来。 - 以管理员身份运行。 它解决不了 os error 3,而且按官方文档,这样启动后 Codex 执行的每条命令都会带着管理员权限。最多临时用来排查一次。终端里的 CLI 以管理员身份运行时,会关掉共享后台服务器,0.157.0 上则直接报错,同样不是修法。
- 关闭 Windows 安全防护。 OpenAI 支持人员明确不建议把它当成变通办法。
- 来路不明的补丁和"修复工具"。 相关 issue 里有新注册账号贴出的补丁压缩包,被其他用户指认为勒索病毒;有一段修改
browser-client.mjs的补丁,会绕过网站许可检查;还有一款在多个帖子里推广的修复工具,同样不是 OpenAI 的。都不要下载运行。
本地修不好时:在 /feedback 或 GitHub issue 里附上这些
整理好以下信息再报告,对方才能判断是哪条分支:
- 应用版本(
Get-AppxPackage -Name OpenAI.Codex输出里的 Version)和 Windows 版本号(运行winver查看) - 完整的报错原文和退出代码,比如
code=3221225501 - 事件查看器里 Application Error 的错误模块名称
- 桌面端日志:
%LOCALAPPDATA%\Packages\OpenAI.Codex_2p2nqsd0c76g0\LocalCache\Local\Codex\Logs\<年>\<月>\<日>\codex-desktop-*.log,崩溃转储在同一LocalCache下的Roaming\Codex\web\Codex\Crashpad\reports(较早版本的日志在%LOCALAPPDATA%\Codex\Logs) - not available:本机对话能不能用,出错的是不是 Dot、Cloud 或 SSH 对话,网页版能不能打开同一个任务,用的什么代理工具和模式,日志里有没有
hostKind=durable - CLI 后台服务器:
codex --version和codex app-server daemon version的输出(cliVersion、appServerVersion),以及codex doctor里 Background Server 那一段 - 你已经试过的步骤和各自的结果
在应用里可以运行 /feedback,联系支持时附上对话 ID,这是浏览器扩展文档给出的最后一步。也可以把信息补充到已有的 issue 里,而不是另开新帖:os error 3 对应 #19187,nodePath 对应 #35705,握手超时对应 #39015,0xC000001D 对应 #24408,Dot 和代理环境下的 not available 对应 #49829,本机所有对话都报 not available 对应 #41252,后台服务器升级后仍弹框对应 #51758,os error 5 对应 #51283。贴日志之前,把里面的用户名和项目路径换掉。
Codex 打不开的几个相关问题
Codex 更新后打不开,是上面这几条报错吗?
有弹窗、有原文的,按开头的表对照即可。nodePath 这条在 2026 年 10 月 3 日和 8 日的更新后都有人复发,os error 3 也多发生在自动更新之后。没有任何报错、一直卡在 logo 的,多数是 26.924–26.928 那一批版本,见对照表里的"卡在 logo"一行;10 月 7 日以后在 26.1002.7124.0 上登录完自动关闭的,是运行时包安装崩溃那一行。终端里的 CLI 在 0.161.0 前后开始弹 Background server has incompatible feature settings 的,升级到 0.162.1 就能解决。
重装 Codex 能修好 app-server 启动失败吗?
多数情况不能。.codex 在应用包之外,重装不会动它,所以凡是由 config.toml、日志库、对话记录引起的问题,重装后还在;os error 3、握手超时和 0xC000001D 都有用户报告重装无效,not available 有人重装后只好了两天。例外是 Unable to locate the Codex CLI binary:有用户换到更新的版本后恢复了,但不是每个人都有效。要重装的话,用商店 ID 9PLM9XGG6VKS 安装(winget install --id 9PLM9XGG6VKS -s msstore),不要装成 ChatGPT Classic。
Codex CLI 能用、桌面应用打不开,说明什么?
说明账号和网络大概率没问题,坏的是桌面应用自己复制出来的那套程序、它记录的路径,或者注入进它进程的 DLL。#20048 和 #30884 都是 CLI 正常、桌面端报错。另装一份 npm 版 CLI 修不好 os error 3,但等官方修复期间,可以先用 CLI 继续工作;CLI 自己也弹后台服务器的框时,先加 --no-daemon。
Codex 提示 api_key_model_discovery,是要我配 API key 吗?
不是。api_key_model_discovery 是 CLI 的一个功能开关,管的是用 API key 登录时去发现可用的模型目录;用 ChatGPT 账号登录的人也会在 Background server has incompatible feature settings 里看到它。它出现在提示里,只是因为 CLI 和后台服务器对这个开关的取值不一样。升级到 0.162.1 即可;暂时不能升级的,做法见上文 CLI 那一节。
ChatGPT 桌面应用和 Codex App 是同一个应用吗?
是同一个。更新日志写明,2026 年 7 月 9 日起 Codex 成为 ChatGPT 桌面应用的一部分,原有项目和设置会保留。Windows 里的包名仍是 OpenAI.Codex,所以弹窗写的是 ChatGPT,报错里写的是 Codex app-server。ChatGPT Classic 是另一个应用,里面没有 Codex。有的电脑上还同时装着 ChatGPT (Beta),包名是 OpenAI.CodexBeta;浏览器扩展连不上时,官方建议每个都更新,或者删掉不用的那个。



