codex报错需分层定位：先运行codex status查最后成功步骤，无输出则用codex read --project . --dry-run触发上下文加载；若命令未找到，进入安装与路径修复——检查node/npm路径、手动注入npm prefix至系统path，并确保windows用户名为英文；桌面端白屏需物理清理缓存、禁用代理、安装旧版msix；多任务崩溃须kill异常会话、清sessions文件夹、配置auto_cleanup_on_exit；文件写入失败则降级沙箱模式、迁移sandbox文件夹、重跑codex setup-default-sandbox。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在执行Codex任务时突然弹出报错、卡死、返回空结果或提示“something went wrong”，不能直接重试或刷新页面——错误背后往往对应着具体阶段的环境失配、权限缺失或上下文污染，必须分层定位。
先确认错误发生在哪个环节
打开Codex CLI终端，输入codex status→观察输出中最后成功执行的步骤标记（如“✅ read project structure”“⚠️ failed to write file”）。若无此输出，立即运行codex read --project . --dry-run，强制触发一次轻量上下文加载，看它卡在哪一行。这一步跳过会导致后续所有排查都偏离真实故障点。
如果连codex status都命令未找到，说明PATH未生效或CLI根本未安装成功，直接进入“安装与路径修复”环节。
安装与路径修复
方法一：刷新终端环境变量
关闭所有已打开的PowerShell/终端窗口→重新以管理员身份启动PowerShell→执行node -v && npm -v。若任一命令报“不是内部或外部命令”，说明Node/npm路径未写入系统PATH。
方法二：手动注入npm全局路径
执行npm config get prefix→复制返回路径（如C:\Users\Alice\AppData\Roaming\npm）→右键“此电脑”→属性→高级系统设置→环境变量→在“系统变量”中找到Path→编辑→新建→粘贴该路径→确定。完成后务必重启所有终端窗口。
【关键前提】Windows用户名含中文（如“张伟”）会导致Codex初始化时静默失败，且不报任何错误。此时必须启用WSL2或新建纯英文本地账户，否则所有修复均无效。
深度清理被风控的桌面端
当Codex桌面端启动即白屏，或弹出“Something went wrong”黑字报错，这是网络代理泄露+版本风控叠加触发的典型症状。卸载重装无效，必须执行物理级缓存清除：
第一步：以管理员身份运行PowerShell→依次执行以下三行命令（每行回车后无报错即成功）：
Remove-Item -Path "$env:APPDATA\Codex", "$env:LOCALAPPDATA\Codex", "$env:LOCALAPPDATA\Programs\Codex" -Recurse -Force -ErrorAction SilentlyContinue
[Environment]::SetEnvironmentVariable("Path", (($env:Path -split ';' | Where-Object { $_ -notlike "*Codex*" }) -join ';'), "User")
Get-ChildItem -Path "$env:LOCALAPPDATA\Packages" -Filter "*Codex*" | Remove-Item -Recurse -Force
第二步：关闭所有代理软件，切换至纯净直连网络→从官方渠道下载旧版Codex_1.3.7_x64.msix→右键该文件→选择“使用PowerShell安装”→等待完成。切勿通过微软商店安装，商店版会自动升级到被风控的新版本。
多任务崩溃专项处理
第一步：立即止血
新开一个终端→执行codex session list→找出状态为Alive但实际无响应的会话ID→对每个ID运行codex session kill
第二步：重置会话管理器
关闭所有Codex进程（包括后台隐藏任务）→删除%LOCALAPPDATA%\Codex\cache\sessions整个文件夹→用记事本打开%LOCALAPPDATA%\Codex\config.toml→在[unified_exec]段落下新增两行：
auto_cleanup_on_exit = true
max_concurrent_sessions = 8
第三步：验证修复效果
重启Codex CLI→执行codex session new --name "test-stability"→输入sleep 3 && echo done→等待稳定返回“done”字样。成功则说明会话资源管理已恢复正常。
文件读写权限异常修复
当Codex在“工作区写入”模式下创建文件卡住、报错windows sandbox: CreateProcessWithLogonW failed: 1009，本质是elevated沙箱账户配置损坏，而非系统注册表故障。
第一步：临时降级沙箱模式
编辑%LOCALAPPDATA%\Codex\config.toml→将[windows] sandbox = "elevated"改为sandbox = "unelevated"→保存→重启Codex。
第二步：隔离损坏配置
将%LOCALAPPDATA%\Packages\Microsoft.Codex_*\LocalState\Sandbox整个文件夹剪切到D盘根目录下暂存（不要删除）。
第三步：重建沙箱环境
确保已安装匹配的最新版Codex CLI→在终端中执行codex setup-default-sandbox→等待提示“Sandbox initialized successfully”→重启Codex→切回“工作区写入”模式测试文件创建与读取。
