Codex界面白屏、卡死或报“图形硬件不兼容”本质是Electron框架显卡驱动调用失败；macOS可强制ANGLE渲染或禁用GPU，Windows需DDU清理并修改INF文件匹配真实硬件ID。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex安装后命令行能运行但界面白屏、卡死或报“图形硬件不兼容”，本质是Codex底层Electron框架调用显卡驱动失败，而非Codex本身代码问题。这类现象在Intel核显Mac、AMD核显Windows设备上高频出现，尤其当系统未启用硬件加速或驱动版本与GPU ID不匹配时。
确认是否为显卡驱动兼容性问题
先验证问题根源：打开终端（macOS）或命令提示符（Windows），执行 codex --version。若能正常返回版本号，说明Codex核心已安装成功；若此时启动GUI客户端却白屏/卡死/报错“此环境中的Codex版本过旧”，【基本可锁定为图形渲染层驱动兼容性问题】。跳过重装Codex，直接进入驱动排查环节。
macOS Intel设备白屏修复
方法一：强制指定ANGLE渲染后端
在终端中完整输入以下命令并回车：/Applications/Codex.app/Contents/MacOS/Codex --use-angle=gl
这会绕过默认的Metal后端，改用OpenGL兼容路径启动。首次执行可能稍慢，但界面应正常渲染。若有效，可将该命令保存为Shell脚本或创建桌面快捷方式长期使用。
方法二：禁用硬件加速（备用方案）
若方法一无效，尝试彻底关闭GPU加速：/Applications/Codex.app/Contents/MacOS/Codex --disable-gpu --disable-software-rasterizer
注意：此模式下界面动画和滚动性能下降，仅作临时诊断用，不建议日常启用。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
Windows设备驱动冲突处理
第一步：识别真实硬件ID
右键“此电脑”→“管理”→“设备管理器”，展开“显示适配器”。若Codex启动时触发蓝屏或设备管理器中出现“Microsoft 基本显示适配器”带黄色感叹号，右键该设备→“属性”→“详细信息”→下拉选择“硬件ID”，复制其中以SUBSYS_开头的8位十六进制值（如SUBSYS_888810DE）。
第二步：修改驱动INF文件
下载对应显卡品牌（NVIDIA/AMD/Intel）的最新官方驱动安装包，用7-Zip解压到本地文件夹。进入Display.Driver子目录，用记事本打开所有.inf文件（如nv_disp.inf），搜索你的显卡型号，定位到含SUBSYS_的行，将后面8位字符全部替换为第一步复制的真实ID，保存文件。
第三步：DDU深度清理后强制安装
下载Display Driver Uninstaller（DDU）最新版，在安全模式下以管理员身份运行，选择对应显卡品牌点击【清除并重启】。重启后立即断网，右键设备管理器中的未知显示设备→“更新驱动程序”→“浏览我的电脑”→“从磁盘安装”，指向你修改后的.inf文件完成安装。
第四步：验证Codex启动
安装完成后，不要立即启动Codex。先在PowerShell中执行：setx CODEX_DISABLE_GPU 1 /M
然后重启终端，再运行codex。若界面正常，说明驱动已生效；若仍异常，需检查auth.json是否为空对象{}并确认config.toml路径是否为C:\Users\用户名\.codex\config.toml。
