Windows 小白如何安装 Codex？不会命令行也能用的完整教程

一、Codex 是什么？

Codex 是 OpenAI 开发的编程助手，可以帮你理解文件、修改代码、运行命令。你用日常语言描述任务，它会在允许的范围内操作项目。

本文说的是 Codex CLI：运行在终端里的 Codex。图形化安装助手帮你完成安装与配置，安装后使用的仍是 Codex CLI；它不会把 CLI 变成 OpenAI 官方桌面应用。

二、Windows 安装 Codex 为什么让小白觉得麻烦？

难点通常是环境和账号配置，不是记住一条安装命令。先认清下面几个名称，就不容易走错步骤。

Node.js 与 npm

Node.js 是一种运行环境，npm 是随它常见的包管理工具。只有选择 npm 安装路线时才需要准备它们。

PowerShell / 命令行

用文字给电脑下指令的窗口。手动安装需要输入命令；助手把安装操作做成中文界面。

环境变量 PATH

电脑寻找程序的路径清单。安装后旧窗口可能还没读取新路径，需要重新打开终端。

API 配置

让 Codex 连接具体模型服务。API Key 类似账户钥匙，模型服务的可用额度也要单独准备。

三、安装 Codex 有哪两种方式？

熟悉命令行可以手动安装；不想自己处理安装路径与模型配置，可以使用图形化安装助手。两种方式按你的基础和需求选择。

方式 1：手动安装

适合懂 PowerShell、愿意自行排查的人。可从 OpenAI 的 Codex CLI 安装文档选择 Windows 安装方式；若选 npm 方式，先准备 Node.js/npm，再执行：

npm install -g @openai/codex
codex --version
codex

在自己的项目目录启动后，按 Codex 提示完成可用的登录方式。安装成功与账号可用是两回事；安装助手也不会替你提供 OpenAI 账号或接口额度。

已有自己的ChatGPT账号，如需开通Plus，可用支付宝在麻球商城购买。

方式 2：图形化安装助手

适合不会命令行、希望按中文提示操作的用户。麻球AI Codex 小白助手（软件名：Codex安装助手）提供环境检查、原生 Codex 下载与校验、DeepSeek 密钥配置，以及 OpenAI / DeepSeek 配置切换。

这是第三方辅助工具，不是 OpenAI 官方产品。当前官网下载包为 2.3；安装包免费下载，完整安装与配置功能需要 ¥9.90 激活码，模型服务另行计费。

四、Windows 小白安装步骤

先下载助手并激活，再按实际界面选择使用方式。以下按当前正式包沿用的安装流程说明；DeepSeek 安装向导与 OpenAI 配置切换分别处理。

1. 打开本产品下载页

   进入 Codex安装助手产品与下载页，点击“立即下载 Windows 版”。这里是麻球AI产品下载页，不是 OpenAI 官方下载页。

2. 下载并运行 Windows 安装程序

   保存安装程序后双击运行，按中文安装提示完成助手安装，再打开 Codex安装助手。

3. 输入激活码

   已有激活码就输入并点击“立即激活”。没有激活码时，点击“购买激活码”进入现有官网购买页；支付宝支付 ¥9.90 后获得自动生成的激活码，再返回助手激活。

4. 选择 DeepSeek，检查电脑环境

   需要安装并连接 DeepSeek 时，点击“使用 DeepSeek”。助手检测 Windows、网络、Codex 和必要组件；按照检查结果处理提示。未安装时显示“一键安装”，已可用时显示“继续”，检测到损坏时显示“自动修复”。

5. 等待 Codex 安装与验证

   助手优先从本站下载清单取得原生 Codex 安装资源并校验大小与 SHA-256，必要时尝试官方 GitHub 发行资源。当前链路不执行 npm 安装；已有可用 Codex 时会复用，不保证每次都替换成另一版本。安装完成后点击“下一步”。

6. 准备并复制 DeepSeek API Key

   在“登录 DeepSeek”页面打开 DeepSeek 官网，准备 API 余额，创建并复制自己的密钥，然后点击“我已经复制好了”。助手会读取复制的密钥，保存配置并测试连接；不要把 Key 发给客服或贴到公开截图。

7. 完成测试并首次运行

   配置完成后按“查看下一步”的提示启动 Codex。在一个专门的工作文件夹里，先输入简单任务，例如“请介绍这个文件夹里的内容，暂时不要修改文件”，确认能够得到回复。

“官方下载”指本安装助手的产品官网，不代表 OpenAI 官方渠道。

五、需要准备什么？

准备 Windows x64 电脑、可用网络和你自己的模型服务账号。下载助手不等于已经获得模型服务。

• 电脑：Windows 10 / Windows 11 x64。当前推荐 Windows 11；不把 ARM、32 位系统、Windows 7 或手机列为本助手已验证范围。
• 网络：能够访问本站下载资源、激活服务，以及你选择的模型接口。国内用户选择服务时，也需要实际确认该服务可访问和账号可用，不能只看安装是否成功。
• 授权：已有激活码，或通过官网现有流程购买 ¥9.90 的激活码。
• DeepSeek：自己的 API Key 和可用 API 余额；网页版登录不等于已经配置 API。
• OpenAI：自己可用的官方登录方式或 API 凭据，按所选方式完成登录与计费设置。
• 组件：助手会检查 PowerShell、Git 等项目。若提示组件或权限问题，先按提示处理，不把所有检查项理解为会自动安装。

兼容性说明：现有记录已验证 Windows 11 开发账户中的安装和 DeepSeek 对话；Windows 10 实机、全新普通账户及重启后的完整验收仍待补齐。不要把“支持范围”理解为每台电脑都已经测试过。

六、不会 Node.js / npm 能不能装？

可以，而且使用当前助手安装链路不需要先学习或安装 Node.js/npm。从 2.2 起，助手下载的是 Windows 原生 Codex 程序，当前 2.3 沿用这一路线。

只有你选择手动 npm 安装时，才需要准备 Node.js/npm。电脑已有 Node.js 也不必为了安装助手卸载；如果以后让 Codex 运行某个 JavaScript 项目，该项目仍可能需要 Node.js，这与安装 Codex 本身是两件事。

七、Codex 能不能配 DeepSeek？

可以，当前助手提供 DeepSeek 配置与连接测试。在助手的 DeepSeek 引导里创建并复制自己的 API Key，随后完成保存、配置和测试。

当前实现直接连接 DeepSeek 服务，切换前保留原有配置备份，密钥使用 Windows 用户级加密保存。DeepSeek 模式使用的是 DeepSeek 模型，不是把 OpenAI 模型变成免费服务，也不表示两个服务的能力完全相同。

DeepSeek API 费用由 DeepSeek 收取，按其平台用量规则结算；安装助手 ¥9.90 激活码是另一笔费用。API 价格与余额请在 DeepSeek 开放平台查看。OpenAI 模式同样需要自己的有效账号或接口额度。

八、常见安装失败问题怎么处理？

先区分下载、程序启动和模型连接三个阶段，再处理对应报错。以下依据当前实现中的错误处理和已有验证记录整理，不代表这些问题一定会发生。

下载失败，或提示校验不通过

检查本站资源能否访问，再使用安装页的“重新下载”。助手会检查缓存大小与哈希，损坏缓存会重新获取；不要拿来源不明的 ZIP 替换下载文件。

旧环境或旧配置冲突

助手会识别已有 Codex；切换模型前先关闭正在运行的 Codex。不要直接删除整个 .codex 文件夹，里面可能有自己的配置和会话。需要恢复时使用软件已有恢复功能，并核对界面说明。

API Key 错误，或测试无法通过

确认复制的是 DeepSeek API Key，检查余额和网络。按页面提示使用“重新复制AI密钥”或“自动修复一次”；修复仍失败就保留错误信息，不要连续反复试错。

安装后提示找不到 codex 命令

先关闭旧终端并重新打开，使其读取新的用户 PATH。再尝试助手完成页的启动入口；仍无法运行时生成诊断报告。新终端和重启场景尚未全部验收，不承诺只重开窗口就一定解决。

仍然失败，怎样联系售后？

在“高级设置”中使用“生成诊断报告”或“打开日志目录”，准备 Windows 版本、失败步骤、报错截图和订单信息，发送至 kefu@maqiu.pro。发送前隐藏 API Key、密码和不相关的私人文件内容。

九、手动安装和一键安装怎么选？

有技术基础选手动，想减少环境配置步骤选图形化助手。手动安装是完整可用的选择；安装助手的价值是把部分重复操作和排查做成中文引导。

十、常见问题 FAQ