codex安装后双击无反应、终端报“不是内部或外部命令”，说明path未生效或可执行文件缺失；需确认安装路径、手动添加至系统环境变量并重启电脑验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex安装后双击图标无反应、启动几秒后自动退出、终端执行codex命令报“不是内部或外部命令”，说明程序卡在环境准备、签名验证、路径解析或权限拦截任一环节，必须按真实错误现象匹配修复路径。
先确认是哪类失败
打开 PowerShell（无需管理员权限），逐行执行：
codex --version
如果返回版本号（如 codex 26.506.21252），说明 CLI 正常，问题只出在 Desktop 应用外壳；如果提示“command not found”，说明 PATH 或安装路径根本未就位——跳转到「PATH 未生效」板块；如果报错 “failed to start codex app-server: The system cannot find the path specified”，说明 Desktop 启动器找不到本地服务进程，进入「app-server 启动失败」排查。
PATH 未生效（Windows）
第一步：确认 Codex 可执行文件真实位置
打开资源管理器，前往你安装时指定的目录（如 D:\Codex\），检查是否存在 codex.exe 或 codex.cmd。若只有 .config、.sqlite 子文件夹，说明安装程序未释放主二进制——需重新运行安装包，在自定义安装界面勾选“将可执行文件放入根目录”。
第二步：手动添加路径到系统环境变量
Win + R → 输入 sysdm.cpl → 「高级」→ 「环境变量」→ 在「系统变量」中双击 Path → 「新建」→ 粘贴你的 Codex 根路径（如 D:\Codex），【末尾不能加反斜杠 \】 → 全部「确定」。
第三步：强制刷新并验证
关闭所有已打开的终端窗口 → 以管理员身份启动新 PowerShell → 执行：
$env:Path += ";D:\Codex"
codex --version
若此时能返回版本号，证明路径正确，但系统级 PATH 尚未被 Explorer 和后台服务加载——必须重启电脑才能彻底生效。
app-server 启动失败（Windows）
方法一：清空残留进程再试
Ctrl + Shift + Esc 打开任务管理器 → 切换到「详细信息」选项卡 → 查找所有 codex.exe 进程 → 全部右键「结束任务」→ 关闭管理器 → 双击桌面图标重试。这一步能绕过“单实例锁死”导致的静默失败。
方法二：跳过 Desktop，直接用 CLI 出活
PowerShell 中执行 codex login → codex run --prompt "写一个 Python 脚本列出当前目录下所有 .py 文件"。只要 codex --version 正常，你的账号、密钥、模型访问权限全部有效，Desktop 崩溃只是外壳 bug，不影响核心功能使用。
Mac M系列芯片打不开（签名+隔离）
第一步：确认是否被 Gatekeeper 拦截
打开终端，执行：
ls -l@ /Applications/Codex.app
若输出中含 com.apple.quarantine，说明系统已打上隔离标记，后续所有操作都必须先清除它，否则白签。
第二步：清除隔离属性
执行：
sudo xattr -rd com.apple.quarantine /Applications/Codex.app
输入开机密码（屏幕不显示字符，输完直接回车）。
第三步：强制重签名
执行：
sudo codesign --force --deep --sign - /Applications/Codex.app
【--deep 参数不可省略】，否则仅签名主程序，内部 arm64 子模块仍被拦截。
第四步：验证签名结果
执行：
codesign -dv /Applications/Codex.app
若输出末尾出现 “signed Bundle with Mach-O thin (arm64)”，且无 error 字样，即可双击启动。
Windows 11 闪退（0xC0000135）
错误码 0xC0000135 明确指向缺失 VC++ 运行库。这不是配置问题，也不是网络问题。
下载 vc_redist.x64.exe（微软官方可再发行组件）→ 双击安装 → 点「安装」→ 完成后【必须重启电脑】。不重启，系统 DLL 加载器仍会复用旧缓存路径，Codex 继续静默退出。
若已装过旧版，先去「设置 → 应用 → 已安装的应用」中卸载所有 vc_redist 版本，再装最新版（2023 v143）。
数据库无法访问（Codex cannot access its local database）
报错提示 Database path: C:\Users\XXX\.codex\sqlite\codex-dev.db，但实际该路径根本不存在——这不是文件丢失，而是 Codex 创建目录时因权限或路径编码失败，导致 .codex 成为一个“伪目录”（NTFS 重解析点或符号链接残留）。
以管理员身份运行 PowerShell，执行：
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex"
然后重启 Codex。它会自动重建完整目录结构，包括 sqlite 子目录和数据库文件。
