根本原因是系统环境、路径编码、运行库或配置不匹配；需验证Node.js/npm安装与PATH配置，中文用户名须用WSL2或新建英文账户解决，code=3221225781缺VC++运行库需重启修复，402错误系路由至云端，应检查config.toml中model配置及auth.json为空。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Windows 10或11安装Codex后反复报错、命令找不到、启动闪退、402付费提示，根本原因往往不是软件本身坏了，而是系统环境、路径编码、运行库或配置层级中某一个细节没对齐。
确认Node.js和npm是否真正就位
打开 PowerShell（必须以管理员身份运行），依次执行：
node -v → 若无输出或报错，说明 Node.js 没装好或 PATH 没生效；若输出 v22.2.0 类似版本号，继续下一步。
npm -v → 必须输出 npm 10+ 版本号；若提示“不是内部命令”，说明 npm 全局路径未加入系统环境变量，此时不要重装，先重启终端再试一次——很多用户卡在这一步，只是因为终端会话还是旧的。
如果仍失败，手动检查 npm 全局路径：npm config get prefix，把该路径（如 C:\Users\用户名\AppData\Roaming\npm）添加进系统环境变量的 Path 中，然后彻底关闭所有终端窗口再重开。
中文用户名导致安装失败的两种安全解法
Windows 用户名含中文时，Codex 在创建 C:\Users\中文用户名\.codex 目录时会因路径编码异常直接报 EPERM 或静默失败，这是已知兼容性缺陷。
方法一：启用 WSL2（官方首推）
在 PowerShell（管理员）中执行：wsl --install → 自动安装最新 WSL2 内核与 Ubuntu 发行版 → 安装完成后重启 → 启动 Ubuntu，运行 sudo apt update && sudo apt install nodejs npm → 再执行 npm install -g @openai/codex。所有操作都在 Linux 环境下进行，彻底绕过 Windows 路径编码问题。
方法二：新建纯英文本地账户
设置 → 账户 → 家庭和其他用户 → 将其他人添加到这台电脑 → 我没有这个人的登录信息 → 添加没有 Microsoft 账户的用户 → 输入全英文用户名（如 codexuser）→ 设为本地账户 → 登录新账户后，再执行完整安装流程。注意：原账户的 .codex 配置不会继承，必须在新账户中重新配置 auth.json 和 config.toml。
⚠️ 绝对禁止直接重命名 C:\Users\中文文件夹——这会破坏注册表关联、权限继承和大量系统服务，微软明确警告此操作不可逆。
解决 code=3221225781 闪退错误
该错误码（0xC0000135）本质是 Windows 缺少 Visual C++ 运行时库，与配置无关，重装 Codex 或修改 config.toml 均无效。
第一步：下载官方运行库
访问微软官网或使用镜像链接下载 vc_redist.x64.exe（x64 版本，Win10/11 均适用）。
第二步：安装并重启
双击运行安装程序 → 点击“安装” → 完成后必须重启电脑，否则部分 DLL 不会被加载进系统进程空间。
第三步：验证修复效果
重启后直接启动 Codex 桌面客户端或运行 codex --version，不再弹窗报错即表示修复成功。
处理 402 Payment Required 错误
本地运行 Codex 出现 402 报错，说明请求被路由到了 OpenAI 官方云端 API，而非你本地部署的服务端。这通常意味着模型路由配置失效。
① 打开配置文件：C:\Users\你的用户名\.codex\config.toml
② 定位到 [model] 区块，确认以下三项全部显式声明：
provider = "local"name = "gpt-5.4"base_url = "http://localhost:8000/v1"（假设你本地服务监听在该地址）
③ 检查 auth.json 是否存在且为空——本地模式下该文件应为空对象 {} 或干脆删除，留空反而会触发 fallback 到云端鉴权。
④ 关闭所有终端和 VSCode 窗口，重新启动本地服务（如 python -m codex.run），再新开终端执行 codex generate --prompt "test" 测试。
