Codex 报错 "invalid transport in mcp_servers.codex_app":每个对话都失败的原因与解决办法
返回博客
文章codextroubleshootingwindowsmcpopenai

Codex 报错 "invalid transport in mcp_servers.codex_app":每个对话都失败的原因与解决办法

Mafra2026年11月15日阅读约 5 分钟

你在 Windows 上打开 Codex Desktop,选好项目,发出第一条消息。对话根本起不来。终端或界面返回:

failed to load configuration: invalid transport
in `mcp_servers.codex_app`

你去 config.toml 里找这个服务器。根本没有。你从来没配过任何叫 codex_app 的东西。大多数人就是在这里开始乱改:重装应用、清空 .codex、丢掉一下午。

这条消息说的不是你的配置。它说的是应用自己的一个内部组件,在后端运行的那个环境里已经失效了。原因有一个占绝对多数,修法只有一行。

流程图:所有对话都因 invalid transport 失败,在日志中确认,检查后端是否运行在 WSL 内,关闭 WSL,若仍失败则完全退出并重开应用
报错路径:内部服务器的传输方式在 WSL 内并不存在,而这个失败会拖垮整个配置加载。

这条报错到底在说什么?

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 服务器都由你自己声明,传输方式明确,每个服务器的状态单独可见。连不上的服务器只是一行失败,而不是一个打不开的应用。想看它在实践中怎么运作,从这里开始。

喜欢这篇文章吗?
把知识分享给你的朋友。
// 继续阅读

相关文章