在Windows 下 Codex 安装、配置与使用详细指南

最新推荐文章于 2026-07-04 13:41:08 发布

原创最新推荐文章于 2026-07-04 13:41:08 发布 · 265 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏，讲透 AI 如何接管脏活累活

一键订阅

OpenAI Codex 是一款强大的 AI 编程助手，支持代码生成、调试、重构及自动化任务。在 Windows 环境下，Codex 提供了多种安装方式，包括桌面应用版（Microsoft Store）、命令行工具版（CLI）以及 IDE 集成版。以下是基于 2026 年最新版本的详细安装、配置及使用指南。

一、前置准备与环境要求
在安装 Codex 之前，需确保系统满足以下基本要求，以避免兼容性问题：

‌操作系统‌：Windows 10 (v1809+) 或 Windows 11（推荐 64 位系统）。
‌硬件配置‌：最低 4GB 内存，推荐 8GB 及以上；确保有足够的磁盘空间用于缓存和日志。
‌网络环境‌：稳定的互联网连接，用于下载依赖包、验证授权及调用模型接口。
‌权限要求‌：建议以管理员身份运行终端，以便正确配置环境变量和沙箱权限。
核心依赖：Node.js 安装（仅 CLI 模式需要）
若选择使用命令行版本（CLI），必须预先安装 Node.js 环境。

‌下载‌：访问 Node.js 官网，下载 Windows 64 位 .msi 安装包。建议选择 LTS 长期支持版本（如 Node.js 22+），以确保与最新 Codex 版本兼容。
‌安装‌：双击安装包，‌务必勾选 "Add to PATH"‌（自动配置系统环境变量），其余选项保持默认，点击“下一步”直至完成。
‌验证‌：以管理员身份打开 PowerShell 或 CMD，输入以下命令：
powershell
node -v # 应输出 v22.x.x 等版本号
npm -v # 应输出对应 npm 版本号
‌镜像加速（可选）‌：国内用户可配置淘宝镜像源以提升下载速度：
powershell
npm config set registry https://registry.npmmirror.com
二、安装方式选择与步骤
根据使用习惯，可选择以下三种主要安装方式：

方式一：桌面应用版（推荐新手/日常使用）
图形化界面操作简便，支持 Computer Use（屏幕操控）功能。

‌通过 Microsoft Store 安装‌：
打开 Microsoft Store，搜索 “Codex”。
确认发布者是否为 OpenAI，点击“获取”或“安装”。
安装完成后启动应用。
‌通过 Winget 安装（命令行）‌：
以管理员身份打开 PowerShell，执行：
powershell
winget install Codex -s msstore --accept-source-agreements --accept-package-agreements
‌离线安装包（备选）‌：
若微软商店无法访问，可从官方 GitHub Releases 页面下载最新的 codex-x86_64-pc-windows-msvc.exe 或通过可信第三方渠道获取已提取的安装包进行手动部署。
方式二：命令行工具版（CLI，推荐开发者）
适合熟悉终端操作、需要集成到 CI/CD 或脚本中的高级用户。

‌全局安装‌：
以管理员身份打开终端，执行以下命令：
powershell

官方原版

npm install -g @openai/codex

或使用国内镜像加速（推荐）

npm install -g @openai/codex --registry=https://registry.npmmirror.com
‌验证安装‌：
安装完成后，输入以下命令检查版本：
powershell
codex --version
若提示 command not found，请重启终端或手动将 Node.js 安装路径（如 C:\Program Files\nodejs）和 npm 全局路径（如 C:\Users\你的用户名\AppData\Roaming\npm）添加到系统环境变量 Path 中。
方式三：IDE 集成版（VS Code / JetBrains）
适合希望在编辑器内直接获得 AI 辅助的用户。

‌VS Code‌：
打开 VS Code，进入扩展市场（Extensions）。
搜索 “Codex”，安装官方扩展。
重启 VS Code，侧边栏会出现 Codex 图标，按提示登录即可。
‌JetBrains 系列‌：
在 Plugin Marketplace 中搜索并安装 Codex 插件，配置 API Key 或登录账号。
三、授权与配置
安装完成后，必须进行身份验证才能使用 AI 功能。目前主要有两种授权方式：

方式一：ChatGPT 账号登录（官方授权）
适用于拥有 ChatGPT Plus/Pro/Team 订阅的用户。

‌CLI 模式‌：
在终端输入 codex login。
浏览器会自动跳转至 ChatGPT 登录页面。
输入账号密码并授权，成功后终端显示 Login successful，Token 将保存至本地 ~/.codex/token。
‌桌面应用版‌：
启动应用，点击 “Sign in with ChatGPT”。
跟随浏览器指引完成登录授权。
方式二：API Key 配置（中转平台/自建）
适用于无 Plus 订阅或希望使用特定模型端点的用户。

‌获取 API Key‌：
注册并登录支持 OpenAI 兼容接口的中转平台（如 AIGC BAR 等）。
在控制台创建 API 令牌，分组选择 “codex专属”（如有此选项），复制生成的 sk-xxxxxx 密钥。
‌配置文件设置‌：
进入用户目录下的 .codex 文件夹（路径：C:\Users\你的用户名.codex，若无则手动创建）。
‌auth.json‌：存储 API Key。
json
{
“OPENAI_API_KEY”: “sk-your-actual-api-key-here”
}
‌config.toml‌：配置模型和中转地址。
toml
model_provider = “OpenAI”
model = “gpt-5.5”
review_model = “gpt-5.5”
model_reasoning_effort = “xhigh”
disable_response_storage = true
network_access = “enabled”

[model_providers.OpenAI]
name = “OpenAI”
base_url = “https://api.aigc.bar/v1” # 替换为你的中转地址
wire_api = “responses”
requires_openai_auth = true
‌生效验证‌：
修改配置后，‌必须重启终端‌或重启桌面应用。
输入 codex 启动交互式界面，若无报错则配置成功。
四、常用使用方法

CLI 交互式用法
‌启动交互模式‌：
powershell
codex
‌指定初始提示‌：
powershell
codex “帮我解释当前目录下 main.py 的代码逻辑”
‌非交互模式执行任务‌（适合脚本）：
powershell
codex exec “修复 src/utils.js 中的空指针异常”
‌指定高推理模型‌：
powershell
codex --model “gpt-5-codex-high” “优化这段算法的性能”
桌面应用版用法
‌绑定工作区‌：首次使用时，选择项目根目录作为工作区。
‌Computer Use 权限‌：当指令涉及操作其他应用（如打开浏览器、点击按钮）时，系统会请求屏幕截图和辅助功能权限，请务必允许。
‌并行 Agent‌：利用 Git Worktree 功能，可同时启动多个 Agent 处理不同分支的任务，避免冲突。
IDE 插件用法
在编辑器中选中代码，右键选择 Codex 相关选项（如“解释代码”、“生成测试”、“修复 Bug”）。
或在聊天面板中直接输入自然语言指令。
五、常见问题排查
问题现象可能原因解决方案
‌安装失败/权限不足‌ 未以管理员身份运行终端右键终端图标，选择“以管理员身份运行”后重试。
‌command not found‌ 环境变量未生效 1. 重启终端。
检查 Node.js 和 npm 路径是否加入系统 Path。
手动添加 C:\Program Files\nodejs 和 %APPDATA%\npm 到 Path。
‌No Active Subscription‌ API Key 错误或过期 1. 检查 auth.json 中的 Key 是否正确。
2