Codex 是 OpenAI 推出的 AI 编程助手集代码生成、解释、调试、重构于一体支持 CLI命令行、IDE 插件等多种使用方式尤其适合 Windows 开发者提升编码效率。本文基于 2026 年最新版本手把手教你完成 Codex 在 Windows 系统下的安装、详细配置及日常使用覆盖从前置准备到常见问题排查的全流程新手也能轻松上手。一、前置准备在安装 Codex 前需确保系统环境满足要求提前安装必要依赖否则会导致安装失败或功能异常。1.1 系统要求操作系统Windows 10 或 Windows 1164位32位系统不支持内存最低 4GB推荐 8GB 及以上保证运行流畅网络稳定联网用于下载依赖、验证安装及后续使用权限管理员权限安装过程中需修改系统环境变量1.2 必备依赖安装Codex CLI 基于 Node.js 开发必须先安装 Node.js 环境推荐使用最新 LTS 版本避免版本过低导致兼容性问题。下载 Node.js访问 Node.js 官网下载 Windows 版本.msi 格式64位建议选择 Node.js 22 版本兼容最新 Codex 版本。安装 Node.js双击安装包勾选「Add to PATH」关键步骤自动配置环境变量其他选项保持默认点击「下一步」直至安装完成。验证安装以管理员身份打开 CMD 或 PowerShell输入以下命令若能正常输出版本号说明 Node.js 安装成功。node -v # 输出 Node.js 版本如 v22.2.0 npm -v # 输出 npm 版本如 v10.7.0若国内网络下载 Node.js 速度较慢可使用淘宝镜像加速安装完成后执行以下命令配置镜像npm config set registry https://registry.npmmirror.com二、Codex 安装步骤Codex 支持通过 npm 全局安装确保已完成前置准备后按以下步骤执行。2.1 管理员身份启动终端按下 Win R输入 cmd 或 powershell右键选择「以管理员身份运行」避免因权限不足导致安装失败。2.2 全局安装 Codex在终端中输入以下命令执行 Codex 安装国内用户可添加镜像加速可选npm install -g openai/codex # 国内镜像加速安装 npm install -g openai/codex --registryhttps://registry.npmmirror.com安装过程中终端会显示下载进度耐心等待即可若出现警告信息无需理会继续等待安装完成。2.3 验证安装成功安装完成后在终端中输入以下命令若能正常输出 Codex 版本号说明安装成功codex --version # 输出版本号如 0.42.0 及以上常见问题若提示「command not found」大概率是 Node.js 环境变量配置失败重启终端后重新尝试若仍失败需手动配置环境变量详见文末常见问题。三、Codex 详细配置Codex 安装完成后需进行 API 配置或账号授权才能正常使用。目前支持两种授权方式ChatGPT Plus 账号登录、国内中转平台 API Key 配置推荐国内用户使用第二种。3.1 授权方式选择方式一ChatGPT Plus/Pro/Team 订阅账号官方授权无需手动配置 API Key方式二API Key3.2 方式一ChatGPT Plus 账号授权在终端中输入以下命令启动 Codex 授权流程codex login执行命令后会自动弹出浏览器跳转至 ChatGPT 登录页面输入你的 ChatGPT Plus 账号邮箱密码。登录成功后点击「授权」按钮系统会自动将授权 Token 保存至本地路径C:\Users\你的用户名\.codex\token无需手动配置。授权完成后关闭浏览器返回终端提示「Login successful」即授权成功。3.3 方式二API Key 配置若没有 ChatGPT Plus 账号可通过获取 API Key的方式使用步骤如下3.3.1 获取 API Keyhttps://api.aigc.bar/register?aff9Fyu访问注册并登录账号。登录后点击顶部「控制台」→「API令牌」进入令牌管理页面。点击「添加令牌」填写相关信息令牌分组务必选择「codex专属」令牌名称随意填写如「Codex-Windows」额度设置建议设置为「无限额度」其他选项保持默认。点击「创建」生成 API Key格式sk-xxxxxx复制该密钥后续会用到。3.3.2 创建并配置配置文件打开文件资源管理器进入用户目录路径C:\Users\你的用户名开启「显示隐藏的项目」顶部「查看」选项卡勾选找到 .codex 文件夹若没有手动创建。在 .codex 文件夹中手动创建两个文件auth.json 和 config.toml。配置 auth.json 文件存储 API Key 用记事本或 VS Code 打开 auth.json粘贴以下内容将 sk-xxx 替换为你获取到的实际 API Key{ OPENAI_API_KEY: sk-xxx // 替换为你的 API Key }配置 config.toml 文件配置模型和中转地址 用记事本或 VS Code 打开 config.toml粘贴以下内容直接复制即可无需修改model_reasoning_effort 可根据需求调整model_provider OpenAI model gpt-5.5 review_model gpt-5.5 model_reasoning_effort xhigh disable_response_storage true network_access enabled windows_wsl_setup_acknowledged true model_context_window 1000000 model_auto_compact_token_limit 900000 [model_providers.OpenAI] name OpenAI base_url https://api.aigc.bar/v1 wire_api responses requires_openai_auth true保存两个文件配置完成。3.4 配置验证配置完成后重启终端关键步骤否则配置不生效输入以下命令启动 Codexcodex若终端显示 Codex 交互式界面无报错信息说明配置成功可以开始使用若出现报错检查 API Key 是否正确、配置文件格式是否有误。四、Codex 常用使用方法Codex 支持 CLI 交互式使用、IDE 插件使用两种方式。4.1 CLI 交互式使用通过终端启动 Codex 后进入交互式界面可直接输入指令实现代码生成、调试、解释等功能常用场景如下4.1.1 修复代码报错若代码运行报错可截图报错信息通过以下命令让 Codex 修复codex -i error.png 修掉图中报错 # error.png 是报错截图路径4.1.2 常用 CLI 命令速查命令作用使用场景codex启动交互式终端 UI日常开发人机协作编码codex 提示内容带初始提示启动 TUI直接指定任务省去输入步骤codex exec 任务非交互模式执行任务输出到 stdoutCI/CD 流水线、批量自动化codex login status查看当前认证状态检查是否已登录/配置成功codex --model gpt-5-codex-high指定高推理强度模型复杂代码生成、调试五、常见问题排查安装或使用过程中若出现报错可对照以下常见问题排查快速解决问题。5.1 问题1安装时提示「权限不足」解决方案确保终端是以「管理员身份运行」关闭其他可能占用权限的软件重新执行安装命令若仍失败可添加 sudo 前缀仅 PowerShell 支持sudo npm install -g openai/codex5.2 问题2验证安装时提示「command not found」原因Node.js 环境变量配置失败系统无法找到 Codex 可执行文件。解决方案重启终端重新尝试验证命令若仍失败手动配置环境变量右键「此电脑」→「属性」→「高级系统设置」→「环境变量」在「系统变量」中找到「Path」点击「编辑」添加 Node.js 安装路径默认路径C:\Program Files\nodejs和 Codex 安装路径默认路径C:\Users\你的用户名\AppData\Roaming\npm保存后重启终端重新验证。5.3 问题3启动 Codex 时提示「No Active Subscription」原因API Key 配置错误或中转平台未开通权限。解决方案检查 auth.json 中的 API Key 是否正确是否替换了 sk-xxx确认中转平台的令牌分组是否选择「codex专属」若仍报错联系中转平台客服开通权限。5.4 问题4Codex 生成代码报错无法运行解决方案切换模型使用高推理强度模型codex --model gpt-5-codex-high检查是否缺少相关依赖根据报错信息安装对应依赖如 pip install requests。