codex报错需按类型精准修复：白屏卡死须物理清洗缓存并重装.msix；超时需配置%userprofile%.codex.env代理；401需检查环境变量并清理auth.json；沙盒失败需重命名config.toml；command not found需修正path。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
遇到Codex报错时，不能盲目重试或卸载重装，必须按错误类型精准切入——白屏卡死、连接超时、401认证失败、沙盒初始化失败、命令找不到，每种报错对应完全不同的修复路径和关键操作点。
白屏或弹出“Something went wrong”
这是网络风控叠加本地缓存污染导致的前端加载崩溃，微软商店重装无效，必须执行物理级清洗。
第一步：以管理员身份打开 Windows PowerShell，逐行执行以下命令（每行回车后无报错即成功）：
PowerShell Remove-Item -Path "$env:APPDATA\Codex", "$env:LOCALAPPDATA\Codex", "$env:LOCALAPPDATA\Programs\Codex", "D:\codex*" -Recurse -Force -ErrorAction SilentlyContinue
第二步：清除环境变量中残留的 Codex 路径，避免后续 PATH 冲突：
PowerShell [Environment]::SetEnvironmentVariable("Path", (($env:Path -split ';' | Where-Object { $_ -notlike "*Codex*" }) -join ';'), "User")
第三步：手动下载历史版 .msix 安装包（勿通过 Microsoft Store），用 PowerShell 强制静默部署：【必须使用本地 .msix 文件 + Add-AppxPackage 命令，否则仍会触发风控】
报错“reconnecting”或“request timeout”
本质是代理配置未被 Codex 读取，仅改系统代理无效，必须写入专用 .env 文件。
方法一：创建 .env 配置文件
新建一个空文本文件 → 输入三行内容（端口请替换为你本地代理实际监听端口）：
HTTP_PROXY="http://127.0.0.1:7892"
HTTPS_PROXY="http://127.0.0.1:7892"
NO_PROXY="localhost,127.0.0.1,::1"
保存路径为：【%USERPROFILE%\.codex\】，文件名必须为 【.env】（不是 .env.txt）。
方法二：验证是否生效
在 CMD 或 PowerShell 中运行：type %USERPROFILE%\.codex\.env，若输出上述三行内容，说明写入成功。
最后强制结束进程并重启：taskkill /F /IM codex.exe
报错 401 Unauthorized
服务端明确拒绝了你的身份凭证，问题一定出在登录态或 API Key 的传递链路上。
先检查环境变量是否生效：
echo $OPENAI_API_KEY（Linux/macOS）或 echo %OPENAI_API_KEY%（Windows），如果为空，说明变量根本没加载。
再清理本地认证缓存：
删除 【~/.codex/auth.json】（Linux/macOS）或 【%USERPROFILE%\.codex\auth.json】（Windows），然后重新执行 codex login。
注意：如果你在 VSCode 插件和 CLI 之间切换过账号，务必确认两者读取的是同一个 auth.json 文件，否则插件可能仍在用旧 token。
报错“无法设置管理员沙盒”或“sandbox initialization failed”
90% 以上情况不是权限不足，而是 config.toml 文件损坏或字段冲突。
直接进入用户目录：C:\Users\YOUR_USER_NAME\.codex\
找到 config.toml 文件，将其重命名为 config_backup.toml。
这一步会强制 Codex 启动时生成全新默认配置，跳过所有异常字段解析。
重启客户端，沙盒即可正常初始化。
报错“command not found: codex”
npm 安装成功但终端找不到命令，说明全局 bin 目录没进系统 PATH。
Windows 用户执行：
$p = [Environment]::GetEnvironmentVariable('PATH','User')
[Environment]::SetEnvironmentVariable('PATH', "$p;$env:USERPROFILE\.local\bin", 'User')
Linux/macOS 用户根据 shell 类型执行对应命令：
Zsh 用户：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
Bash 用户：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
验证：codex --version
