Codex安装完成后出现闪退,通常由三种因素导致:签名缺失、运行库未安装,或配置文件损坏。Mac用户只需一条终端命令进行强制重签名即可修复;Windows用户则需要先安装VC++运行库;若以上方法均无效,删除配置文件让其自动重新生成便能解决。接下来,按优先级详细说明。

无论使用Mac还是Windows系统,安装Codex后双击图标时,可能出现程序瞬间消失、启动几秒后自动退出,甚至通过终端执行open /Applications/Codex.app或codex命令也无响应的情况。这类闪退并非偶然,核心原因集中在签名、配置、运行库三类问题上。好消息是,排查步骤非常清晰,只需按优先级依次尝试,绝大多数问题都能迎刃而解。
Mac用户:终端强制重签名修复启动闪退
第一步:打开终端。使用快捷键Command + Space,输入Terminal并按下回车键。
第二步:复制并执行以下命令:
sudo codesign --force --deep --sign - /Applications/Codex.app
第三步:输入Mac开机密码(输入时屏幕不会显示字符,完成后直接回车)。该步骤必须通过sudo提升权限,否则codesign会因权限不足而静默失败。【--deep参数必须保留】——仅对主程序签名,内部的arm64子模块仍会被Gatekeeper拦截。
第四步:验证签名是否成功。
执行codesign -dv /Applications/Codex.app,若输出中包含"designated => …"且无error字样,表示签名已修复。
Windows用户:安装VC++运行库修复闪退
方法一(推荐):直接安装运行库。
下载vc_redist.x64.exe(最新的微软Visual C++可再发行组件),双击运行,点击Install,等待安装完成即可。
方法二:临时禁用WSL子系统(绕过问题)。
使用记事本打开C:\Users\你的用户名\.codex\config.toml,在文件末尾新增以下三行:
[wsl]
enabled = false
保存后重启Codex。
【0xc0000135错误码表示缺少VC++运行库】,这并非配置问题或网络故障,安装对应运行库后即可启动。如果之前安装过旧版本,建议先卸载再安装最新版(推荐2024或2024 v143版本)。
通用方案:删除损坏的配置文件修复闪退
方法1:重命名config.toml。
定位到C:\Users\用户名\.codex(Windows)或~/.codex(macOS/Linux),将config.toml重命名为config.toml.bak。
方法2:清空整个.codex目录(请谨慎操作)。
此方法适用于更新后出现闪退,且日志中反复显示"sandbox initialization failed"或"无法设置管理员沙盒"的情况。删除前请确认未手动修改过模型密钥等关键配置。
完成后重新打开Codex,程序将自动生成全新的config.toml配置文件,登录流程也会重新进行。如果之前卡在沙盒初始化阶段,现在即可顺利进入主界面。
