你在 Windows 上打开 Codex Desktop,选好项目,发出第一条消息。对话根本起不来。终端或界面返回:
failed to load configuration: invalid transport
in `mcp_servers.codex_app`
你去 config.toml 里找这个服务器。根本没有。你从来没配过任何叫 codex_app 的东西。大多数人就是在这里开始乱改:重装应用、清空 .codex、丢掉一下午。
这条消息说的不是你的配置。它说的是应用自己的一个内部组件,在后端运行的那个环境里已经失效了。原因有一个占绝对多数,修法只有一行。
这条报错到底在说什么?
Codex Desktop 内置了一个插件 codex-app-tools@openai-bundled,它注册了一个名为 codex_app 的 MCP 服务器。这个服务器不是你的集成。它支撑的是线程与子代理的调度,提供 create_thread、fork_thread、send_message_to_thread 这类工具。
它的传输方式声明在 %USERPROFILE%\.codex\plugins\cache\openai-bundled\codex-app-tools\0.1.3\desktop-mcp.json 里,长这样:
{
"mcpServers": {
"codex_app": {
"command": "cmd.exe",
"args": ["/d", "/s", "/c", "call", "./scripts/launch_codex_app_tools_mcp.cmd", "./server.mjs"],
"cwd": ".",
"enabled": true
}
}
}
看 command 那一行:cmd.exe。这是一个只存在于 Windows 的传输方式。当应用后端跑在 WSL 里时,去拉起这个进程的是一个 Linux 二进制,它无法解析 cmd.exe。配置加载器以 invalid transport 拒绝这个服务器,而这次拒绝是致命的,所以每个 thread/start 都返回 -32600。不是一个对话坏了,是全部都坏。
怎么在两分钟内确认?
去应用日志里找两样东西:报错字符串,以及显示后端运行在哪个环境的那一行。
# Windows(PowerShell),Microsoft Store 安装包的日志
cd "$env:LOCALAPPDATA\Packages\[OI].Codex_2p2nqsd0c76g0\LocalCache\Local\Codex\Logs"
Select-String -Path *.log -Pattern "invalid transport","Spawning process inside WSL"
如果两条同时出现,诊断就闭合了。在官方仓库的 issue #40910 里,A/B 测试就是这么做的:同一个应用、同一个 config.toml、同一台机器,只翻转 WSL 那个开关。WSL 开着时,多个会话里出现 125 次报错;WSL 关掉后,一次都没有,消息正常发出并处理。
怎么解决?
打开 config.toml(位于 %USERPROFILE%\.codex\config.toml),关掉在 WSL 内执行:
runCodexInWindowsSubsystemForLinux = false
如果这个键已经存在,只改值就行。完全退出应用,而不只是关窗口,然后重新打开。修复立即生效且稳定,issue 里记录的就是这条总能奏效的办法。
有一个容易踩的细节:在应用里,这个设置以开关形式出现在偏好设置中,标签是 "Run Codex in WSL"。用开关改和改文件效果一样,但应用必须重启才会重新读取。如果你改了却没反应,多半只是关了窗口。
为什么禁用插件没用?
这是独自排查时最耗时间的一步。看到报错里的插件名,第一反应就是把它关掉:
[plugins."codex-app-tools@openai-bundled"]
enabled = false
没有用。服务器照样被加载、照样失败,因为它不走普通的插件开关。issue #40910 明确记录了这一点。如果你正好走到这一步,可以停下来了。
如果你必须用 WSL 呢?
这里诚实的答案是:到目前为止没有官方支持的修法。关掉 WSL 能解决报错,但改变了执行环境:/mnt/... 路径、只存在于 Linux 的 MCP 服务器、原生工具链都用不了了。如果你的流程依赖这些,关掉它不是绕开问题,而是换一个问题。
今天真正可走的路:
- 在 WSL 里跑 CLI,而不是跑桌面应用。 bug 在桌面应用的代码路径里,不在 CLI 里。WSL 内的 CLI 不经过这个传输方式。
- 桌面应用留在原生 Windows,需要时用命令调用 WSL。 不够顺滑,但偶尔需要 Linux 环境时能保住。
- 别指望降级。 应用通过 Microsoft Store 更新,不提供旧版本,仓库的 release 也只发 CLI 二进制。issue #26914 要的正是这个能力,至今没有维护者回复。
完全没有 WSL 也会出现这个报错吗?
还有第二类原因,更少见也更烦人:WSL 已经关掉,报错依然存在。它通常来自渲染层在应用初始化完成之前发出的一个旧键。这种情况下症状是间歇性的:某些启动正常,某些启动失败,完全退出再重开就能清掉会话。
还有一种 socket 权限变体,记录在 #56677 里,出现在有多个用户账号的 Mac 上。/private/tmp/codex-app-tools 目录的属主变成了另一个账号,应用无法创建 socket。日志显示 EACCES 和 listen EACCES: permission denied。恢复办法是把目录权限还回来并重开应用,但这个目录之后可能又回到错误状态。
| 症状 | 原因 | 解决办法 |
|---|---|---|
| Windows 上每次对话都失败 | 后端在 WSL 内,cmd.exe 传输无效 | runCodexInWindowsSubsystemForLinux = false |
| 间歇性失败,重开就消失 | 渲染层在初始化前发出的旧键 | 完全退出并重开 |
| 只对某个 Mac 用户失败 | /private/tmp/codex-app-tools 属主是另一个账号 | 还回目录权限并重开 |
禁用 codex-app-tools 插件 | 不走普通插件开关 | 没用,这条路不存在 |
把配置块镜像进 config.toml | 能用,但路径与版本绑定 | 下次应用更新就坏 |
这个报错值得学到什么?
这个故障有一个在任何一个工具里都值得认出来的特征:一个内部组件注册了只存在于某个操作系统的传输方式,而它的失败对整个会话是致命的。应用不会降级,它就是打不开任何对话。
一个坏掉的 MCP 服务器不该拖垮配置加载,issue 自己给出的第三个修复方向正是这个:让那个服务器的失败变成非致命,只关掉依赖它的功能。在它落地之前,办法就是从日志诊断,从根上切掉原因。
在 Verboo Code 里,每个 MCP 服务器都由你自己声明,传输方式明确,每个服务器的状态单独可见。连不上的服务器只是一行失败,而不是一个打不开的应用。想看它在实践中怎么运作,从这里开始。



