Codex 三层故障详细排查与修复步骤
结合视频内容和技术资料,以下是针对Codex环境故障的逐层排查+修复的详细操作指南,覆盖路由、沙箱、工具链三个核心层级:
一、第一层:路由配置故障排查
核心问题:配置文件中的模型版本、端口与实际运行服务不匹配,导致服务无法正常通信。
排查步骤:
- 定位Codex配置文件:
- Windows系统:路径通常为 C:\Users\你的用户名.codex\config.json 或 C:\Program Files\OpenAI Codex\config.json
- 用记事本或VS Code打开配置文件,检查以下字段:
- config.model :应与实际运行的模型版本一致(如视频中的 gpt-6.1-sol )
- ImageModel :需与图片服务器的模型版本匹配(视频中此处为 gpt-6.1-sol )
- Listener53567 :需确认端口是否被占用,若显示 1 表示端口监听失败
2. 检查实际运行的服务: - 打开任务管理器(Ctrl+Shift+Esc),查看Codex相关进程的命令行参数,确认实际运行的模型版本
- 用PowerShell执行 netstat -ano | findstr "53567" ,检查该端口是否被其他进程占用
修复方法: - 统一模型版本:将 config.model 和 ImageModel 改为相同版本(如视频中的 gpt-6.1-sol )
- 清理旧端口:在配置文件中删除 Listener53567 字段,或更换为未被占用的端口
- 重启Codex服务:在任务管理器中结束所有Codex进程,重新启动应用
二、第二层:Windows沙箱故障排查
核心问题:沙箱权限不足、配置错误,导致Codex无法进入工作空间执行任务。
排查步骤:
- 检查沙箱基础状态:
- 打开「控制面板→程序→启用或关闭Windows功能」,确认「Windows沙箱」已勾选
- 若未勾选,勾选后重启电脑;若已勾选,取消勾选重启后重新勾选
2. 检查沙箱权限: - 打开Codex设置,进入「沙箱配置」,确认「工作区写入」「网络访问」权限已开启
- 用管理员PowerShell执行以下命令,检查沙箱标记文件权限:
powershell
m a r k e r = " marker = " marker="env:USERPROFILE.codex.sandbox\setup_marker.json"
Test-Path $marker # 确认文件存在
icacls $marker # 查看文件权限,需确保当前用户有读取权限
- 检查项目文件所有权:
- 打开出问题的项目文件夹,用管理员PowerShell执行:
powershell
takeown /F ".git" /R /D Y # 递归修改.git文件夹所有权为当前用户
修复方法:
- 修复Codex应用:进入「设置→应用→已安装的应用→Codex→高级选项→修复」
- 切换沙箱模式:在配置文件中添加 windows sandbox = "unelevated" 临时降低权限,测试后改回 elevated
- 重置沙箱:关闭Codex后,删除 C:\Users\你的用户名.codex.sandbox 文件夹,重启Codex自动重建沙箱
三、第三层:工具链故障排查
核心问题:Python、npm、npx等工具未正确安装,或环境变量配置错误,导致Codex无法调用工具。
排查步骤:
- 检查Python安装:
- 打开PowerShell,执行 python --version 和 where python
- 若显示「Windows商店占位程序」,说明Python未正确安装,或系统默认调用了商店版本
2. 检查npm和npx安装: - 执行 npm --version 和 npx --version ,若提示「不存在」,说明Node.js未正确安装
3. 检查其他依赖工具: - 执行 git --version 和 ffmpeg -version ,确认Git和FFmpeg已安装并配置环境变量
修复方法: - 安装正确的Python版本:
- 打开PowerShell,执行 winget install Python.Python.3.14 (安装稳定版Python)
- 重启PowerShell,执行 python --version 确认版本正确
- 安装Node.js和npm:
- 从Node.js官网下载LTS版本安装包(https://nodejs.org/)
- 安装时勾选「Add to PATH」选项,重启PowerShell后执行 npm --version 验证
- 配置环境变量:
- 右键「此电脑→属性→高级系统设置→环境变量」
- 在「系统变量→Path」中添加Python安装路径(如 C:\Python314 )和npm路径(如 C:\Users\你的用户名\AppData\Roaming\npm )
- 验证工具链:
执行以下命令确认所有工具正常:
powershell
python --version
node --version
npm --version
npx --version
git --version
ffmpeg -version
四、最终验证与总结
完成以上三层修复后,执行以下操作验证环境:
-
重启Codex,让所有配置生效
-
让Codex执行一次简单任务(如生成一个文本文件),检查是否能正常完成
-
查看Codex日志,确认返回 CODEX_RECHECK_OK 且所有工具链检查通过
关键总结:Codex出现故障时,不要急于更换模型,应优先按「路由→沙箱→工具链」的顺序排查,90%的问题都能通过修复环境配置解决。后续可将这些检查步骤做成一键脚本,提升排查效率。
看完了。结论是:目前最可能的瓶颈不是端口、沙箱或工具链,而是"高推理强度 + 标准速度档 + 过长的旧会话"。
本机检查结果:
- 当前实际模型:
gpt-5.6-sol - 推理强度:
high - 服务档位:
default,未启用 Fast mode - Codex/ChatGPT 应用:已是最新版
- 使用额度:5 小时窗口约 2%,周窗口约 35%,没有触发限流
- 旧会话:98 个回合,日志约 128 MB,累计处理约 1.18 亿 token;继续在这种长会话里工作,很容易因上下文整理、缓存和压缩而越来越慢
- 当前会话:模型推理步骤最长约 8 秒,没有发现异常卡死
- 沙箱:正在正常执行本次诊断;配置为
elevated - 53567 端口:没有监听,但它不是当前 Codex 的固定必需端口
- 工具启动:Node、Git、FFmpeg 均在约 18--41 ms 内启动,不慢
- Python、npm、npx:当前 PATH 中不存在;这会影响需要这些工具的任务,但不会导致模型生成文字变慢
- 内存:ChatGPT/Codex 相关进程约占 2.36 GB,系统尚有约 5 GB 可用,不像内存耗尽
你贴的教程有几处需要纠正:
-
当前配置文件是
C:\Users\Administrator\.codex\config.toml,不是config.json。Codex 还可能加载项目里的.codex/config.toml,并按优先级覆盖用户配置。官方配置说明 -
ImageModel、Listener53567和CODEX_RECHECK_OK不是当前官方配置与健康检查中的标准项目。图片模型也不需要与文本模型强制保持相同名称。 -
不需要在 Windows 功能中启用微软的"Windows 沙箱"。Codex 使用自己的
mxc、elevated或unelevated实现。官方 Windows 沙箱说明 -
不建议为了速度执行
takeown /F .git /R、删除整个.codex\.sandbox,或切换到安全性较弱的unelevated。这些操作只适合明确出现权限或沙箱启动错误时。 -
你的系统版本为 build
26200.6584,低于官方列出的 Windows 25H2 MXC 起始版本26200.9278,所以继续使用elevated比强行开启 MXC 更稳妥。
建议优先这样处理:
- 新建一个聊天继续工作,避免沿用那个 98 回合的超长会话。
- 将推理强度从
high调到medium;通常这是最直接的提速方式。 - 如果界面支持,开启 Fast mode。官方说明它可提高速度,但会以更高倍率消耗额度。官方速度说明
- 暂时不要重置沙箱、修改端口或安装 Python/Node;除非具体任务确实报工具不存在。
- 你的用户配置里还有
sandbox_mode = "danger-full-access"和approval_policy = "never"。当前聊天被应用的workspace-write权限覆盖,所以没有直接暴露为全盘访问,但这两个默认值安全性偏低,和速度也无关。
我没有改动任何配置。就这次检查而言,最值得改的是 model_reasoning_effort = "high",以及避免继续使用超长旧会话。