Codex CLI 完美配置指南Windows 篇告别网络问题10 分钟丝滑安装 前言在配置 OpenAI Codex CLI 时90% 的问题都源于网络。直接使用 npm 官方源在国内极其缓慢且极易失败。本指南的核心只有一句话先换源再安装。✅ 全流程配置步骤第一步安装 Node.js (LTS)方法一终端命令推荐以管理员身份打开 PowerShell执行powershellwinget install -e --id OpenJS.NodeJS.LTS方法二官网下载访问 Node.js 官网下载 LTS 版本安装包一路默认下一步。安装后验证需重启终端powershellnode -v npm -v可能遇到的问题如果npm命令因执行策略被禁止执行以下命令解决powershellSet-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force第二步配置国内镜像源最关键这一步必须在安装 Codex 之前完成否则后续步骤极易卡死或失败。powershellnpm config set registry https://registry.npmmirror.com npm config get registry # 验证应显示上述地址第三步安装 Codex CLIpowershellnpm install -g openai/codex配置镜像后安装速度应在 1 分钟内完成。如果出现added 2 packages in XXs的提示即表示成功。验证安装powershellcodex --version如果提示codex命令不存在请重启 PowerShell或手动刷新 PATHpowershell$env:Path [System.Environment]::GetEnvironmentVariable(Path,Machine) ; [System.Environment]::GetEnvironmentVariable(Path,User)第四步获取并配置 Token访问您的 Codex Mirror 服务商控制台获取 Access Token在 PowerShell 中创建配置文件powershell# 创建配置目录 mkdir $env:USERPROFILE\.codex -Force创建 config.tomlpowershell model gpt-5.3-codex model_provider mirror [model_providers.mirror] name mirror base_url https://gpt.tool2ai.com/codex wire_api responses requires_openai_auth true | Out-File -FilePath $env:USERPROFILE\.codex\config.toml -Encoding ASCII创建 auth.jsonpowershell { OPENAI_API_KEY: your-actual-token-here } | Out-File -FilePath $env:USERPROFILE\.codex\auth.json -Encoding ASCII⚠️重要请务必将your-actual-token-here替换为您在控制台获取的真实 Token。切勿将真实 Token 直接粘贴在公开文章中。编码陷阱如果配置文件编码错误如带 BOM 的 UTF-8Codex 会报错expected value at line 1 column 1。务必使用-Encoding ASCII确保兼容性。第五步启动 Codexpowershellcodex首次运行选择API Key登录方式输入您的 Access Token即auth.json中设置的值即可进入交互界面。验证完整依赖powershelldir $env:USERPROFILE\AppData\Roaming\npm\node_modules\openai\成功时应看到两个文件夹codex和codex-win32-x64。 常见问题与解决问题现象根本原因解决方案npm install极慢或卡死默认使用国外 npm 源执行npm config set registry https://registry.npmmirror.com换源后重试npm命令提示执行策略错误PowerShell 禁止运行脚本执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Forcecodex命令找不到PATH 环境变量未刷新重启 PowerShell 或手动刷新 PATH运行报错Missing optional dependency openai/codex-win32-x64网络问题导致平台特定依赖下载不全确保已换源然后手动补装cd $env:USERPROFILE\AppData\Roaming\npm\node_modules和npm install openai/codex-win32-x64运行报错expected value at line 1 column 1配置文件编码错误使用-Encoding ASCII重新写入配置文件登录时提示认证失败Token 错误或已过期检查auth.json中的 Token 是否正确或登录控制台重置 Token 总结先换源后安装——解决一切网络问题的根本编码要选对——ASCII 或无 BOM 的 UTF-8 是配置文件不出错的保障路径要刷新——安装后重启终端或手动刷新 PATH避免命令找不到Token 要保密——切勿在公开文章或代码中暴露真实 Token务必使用your-actual-token-here等占位符 参考资料Node.js 官网npm 淘宝镜像站Codex CLI 官方文档本文由 Codex 用户实践经验整理而成旨在帮助更多人避开配置过程中的常见坑点。如有问题欢迎交流讨论。