Codex安装失败主因是Windows应用商店、npm权限、系统组件缺失或网络策略问题，而非软件本身故障；国内用户应绕过Store直接下载.msix离线包，用rg-adguard.net获取并双击安装，若提示找不到应用则需先安装Windows App Installer。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex安装失败不是因为软件本身坏了，而是卡在了Windows应用商店、npm权限、系统组件缺失或网络策略这些环节上。国内用户点开官网下载链接后跳转到Microsoft Store，页面转圈、提示地区不可用、点击安装没反应，或者根本搜不到应用——这些问题90%都跟Codex无关，只跟你的本地环境有关。
绕过微软商店，直接下离线安装包
这一步最稳，不依赖Store前台页面、不走网络验证、不触发企业策略拦截。
打开浏览器，访问 https://www.php.cn/link/884e49a58a63060782d767feed8e6c88；
在微软商店中搜索“Codex”，进入其详情页，复制地址栏完整URL（形如 https://apps.microsoft.com/detail/9plm9xgg6vks?hl=zh-CN&gl=CN）；
把刚复制的URL粘贴进 rg-adguard.net 的输入框，点击“查询”；
等待页面加载出文件列表，找到后缀为 .msix 的最新版本安装包（通常文件名含 Codex 和版本号），点击下载；
下载完成后双击该 .msix 文件，系统会自动调用 Windows App Installer 完成安装——如果提示“找不到应用来打开此文件”，说明你缺少 App Installer 组件，需先去 Microsoft 官网下载安装 Windows App Installer（不是 Store 应用，是独立exe）。
CLI 命令行版装不上？先查 Node 和 PATH
报错“codex: command not found”或“不是内部或外部命令”，大概率是 npm 全局 bin 目录没进系统 PATH。
方法一：用 nvm 管理 Node（推荐）
① 运行命令安装 nvm：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash；
② 重启终端或执行 source ~/.zshrc（macOS/Linux）或重新加载 PowerShell 配置；
③ 安装 LTS 版 Node：nvm install --lts && nvm use --lts；
④ 此时全局 npm 目录已落在用户目录下，直接运行：npm install -g @openai/codex；
方法二：手动加 PATH（Windows PowerShell 用户）
运行以下三行命令（逐行复制粘贴，回车执行）：
$p = [Environment]::GetEnvironmentVariable('PATH', 'User')；
[Environment]::SetEnvironmentVariable('PATH', "$p;$env:USERPROFILE\.local\bin", 'User')；
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
codex --version —— 若仍报错，必须重启 PowerShell 或 CMD 窗口，否则 PATH 不生效。
装完打不开或闪退？看系统和签名
Windows 用户遇到“已损坏”“无法打开”“版本不符合最低要求”，不是文件问题，是运行环境缺组件。
确认系统为 Windows 10 19041 或更高版本（Win + R → 输入 winver 查看）；
若提示缺少运行库，去微软官网下载并安装 .NET Desktop Runtime 和 WebView2 Runtime；
若安装包下载后双击无反应，可能是被安全软件拦截或文件损坏，重新下载，并在 PowerShell 中运行：Get-AuthenticodeSignature "CodexInstaller.exe"，检查 Status 是否为 Valid；
Mac 用户若提示“已损坏，无法打开”，打开终端执行：sudo xattr -rd com.apple.quarantine /Applications/Codex.app。
插件装不上？别单独重装 codex-plugin-cc
codex-plugin-cc 安装失败，90% 是因为底层 codex CLI 没装、Node 版本低于 18.18，或装完没执行 /reload-plugins。
先验证前置条件：
运行 node -v，确保输出 ≥ v18.18；
运行 codex --version，必须有返回值；
运行 codex login，完成账号绑定；
在 Claude Code 中依次输入四条命令：
/plugin marketplace add openai/codex-plugin-cc；
/plugin install codex@openai-codex；
/reload-plugins —— 这步漏掉，插件永远不生效；
/codex:setup —— 它会自动检测 CLI 就绪状态并开启 review gate。
