Win11 新手友好版 Codex 安装教程

本教程专为新手设计，全程避开复杂命令和专业操作，优先选择「微软商店一键安装」（最省心、零配置），备用「npm 简单安装」，每一步都配清晰指引，跟着做就能成功，无需担心出错。

一、前期准备（新手必看，30秒完成）

安装前只需准备2件事，无需额外下载复杂工具：

1. 确保你的 Win11 是 64 位系统（目前 Win11 基本都是，无需特意检查）；

2. 拥有 OpenAI 账号（没有的话，先去 OpenAI 官网注册，注册流程和普通网站一样，填邮箱、设密码即可）；

3. 网络能正常访问 OpenAI 服务（国内用户需配置合规网络，否则后续登录会受限）。

二、推荐方法：微软商店一键安装（新手首选，最省心）

这种方式无需手动配置环境、不用输命令，点击几下就能完成安装，和安装普通软件（如微信、QQ）一样简单。

1. 打开微软商店：点击 Win11 桌面左下角「开始菜单」，搜索「微软商店」，点击打开（图标是一个购物袋）；

2. 搜索 Codex：在微软商店顶部的搜索框中，输入「Codex」，找到「OpenAI Codex」（认准官方图标，无广告、无捆绑）；

3. 一键安装：点击应用详情页的「获取」（或「安装」）按钮，系统会自动下载、安装，全程无需手动操作；

4. 等待安装完成：安装过程中会显示「正在下载」「正在安装」，耐心等1-5分钟（速度取决于网络，网络快的话几十秒就好）；

5. 确认安装成功：当按钮变成「打开」，说明已经安装完成，点击「打开」就能启动 Codex。

三、备用方法：npm 简单安装（微软商店安装失败时用）

如果微软商店找不到 Codex、安装卡住，就用这种方法，全程只需复制粘贴命令，不用手动输入，新手也能搞定。

步骤1：安装 Node.js（Codex 运行必需，一键安装）

1. 打开 Node.js 官网：复制链接 https://nodejs.org/zh-cn/download/，粘贴到浏览器地址栏，按回车；

2. 下载安装包：找到「Windows 安装包（64位）」，点击下载（推荐 LTS 版，更稳定，新手不用纠结版本）；

3. 安装 Node.js：双击下载好的安装包，全程点击「下一步」，重点：安装时一定要勾选「Add Node.js to PATH」（勾选后才能正常使用命令，默认是勾选的，不用特意修改）；

4. 验证安装：安装完成后，重启电脑（新手必做，避免环境配置失败），然后点击「开始菜单」，搜索「PowerShell」，点击打开；

5. 复制粘贴命令：在 PowerShell 中，分别复制以下2条命令，每条命令粘贴后按回车，能输出版本号就说明安装成功：

命令1：node -v（输出版本号如 v20.10.0 即可）命令2：npm -v（输出版本号如 v10.2.3 即可）

步骤2：安装 Codex（复制命令即可，无需手动输入）

1. 继续在刚才打开的 PowerShell 中操作，先复制这条命令（解决国内网络安装慢的问题），粘贴后按回车：

npm config set registry https://registry.npmmirror.com

1. 再复制这条核心安装命令，粘贴后按回车，等待安装完成（期间会显示进度，不用操作）：npm install -g @openai/codex

2. 验证安装：安装完成后，复制这条命令，粘贴后按回车，能输出版本号（如 0.42.0），就说明 Codex 安装成功：

codex --version

步骤3：简单配置 API Key（必做，否则无法使用）

这一步是为了让 Codex 能正常调用 OpenAI 服务，全程图形化操作，不用输复杂命令。

1. 获取 API Key：打开 OpenAI 官网，登录你的账号，找到「API Key」页面（登录后搜“API Key”就能找到），点击「创建新的 API Key」，复制生成的密钥（格式是 sk-xxxxxx，复制后保存好，不要泄露）；

2. 创建配置文件夹：打开「此电脑」，进入「C盘」→「用户」→ 找到你自己的用户名文件夹（比如你的用户名是“张三”，就进入“张三”文件夹）；

3. 显示隐藏文件夹：点击文件夹顶部的「查看」，勾选「隐藏的项目」，就能看到隐藏文件夹；

4. 新建文件夹：在当前文件夹中，右键→「新建」→「文件夹」，文件夹名称输入「.codex」（注意前面有个点，输入时直接打“点codex”即可）；

5. 新建配置文件：进入「.codex」文件夹，右键→「新建」→「文本文档」，命名为「auth.json」（注意后缀是 .json，不是 .txt）；

6. 编辑配置文件：双击打开「auth.json」，复制以下内容，将「sk-你的真实API密钥」替换成你刚才复制的 API Key，然后保存并关闭文件：

{ "OPENAI_API_KEY": "sk-你的真实API密钥" }示例：如果你的 API Key 是 sk-123456，就改成 { "OPENAI_API_KEY": "sk-123456" }

四、启动 Codex 并测试（新手必做，确认能正常使用）

情况1：微软商店安装的 Codex（首选方法）

1. 点击「开始菜单」，搜索「Codex」，点击打开；

2. 登录账号：打开后会提示登录 OpenAI 账号，输入你的账号密码，登录成功后就能进入主界面；

3. 测试功能：在主界面输入「写一个简单的Python函数，计算1+1」，点击发送，能正常输出代码，就说明能用了。

情况2：npm 安装的 Codex（备用方法）

1. 打开 PowerShell，复制这条命令，粘贴后按回车：

codex "写一个简单的Python函数，计算1+1"

1. 如果能正常输出代码（类似下面的示例），就说明安装和配置都成功了：

def add():    return 1 + 1print(add()) # 输出2

五、新手常见问题（遇到问题先看这里，不用慌）

1. 微软商店找不到 Codex / 提示“地区不可用”？

解决：点击「设置」→「时间和语言」→「语言和区域」，将区域切换为「美国」，重启微软商店再搜索安装。

1. npm 安装时提示“权限不足”？

解决：关闭当前 PowerShell，右键点击「PowerShell」，选择「以管理员身份运行」，再重新执行安装命令。

1. 输入 codex 命令提示“不是内部或外部命令”？

解决：重启电脑，重新打开 PowerShell，再输入命令；如果还是不行，重新安装 Node.js（确保勾选 Add to PATH）。

1. 启动后无法登录 / 调用失败？

解决：检查网络是否能访问 OpenAI，API Key 是否复制正确（没有多余空格），如果 API Key 过期，重新创建一个即可。

总结：新手优先选「微软商店一键安装」，全程不用输命令、不用配置环境；如果安装失败，再用「npm 安装」，复制粘贴命令就能完成，遇到问题看常见问题，基本都能解决。