还在纠结怎么安装 OpenAI Codex？作为 AI 编程辅助神器，Codex 能自动补全代码、生成函数、排查 bug、重构项目，适配绝大多数编程语言，是开发者提效的必备工具。
很多新手安装时会遇到版本不兼容、安装失败、终端无法唤醒、权限报错等问题，今天这篇教程整理了 Windows / Mac / Linux 全平台方案，包含桌面端（新手首选）、CLI命令行（开发者首选）两种安装方式，零基础跟着步骤走，一次安装成功，附完整避坑指南！
一、先搞懂：两种安装方式怎么选？
为了适配不同使用场景，Codex 提供两种主流安装方案，大家可以按需选择，不用盲目跟风：
- 桌面客户端（推荐新手）：可视化界面、开箱即用、无需配置终端，支持一键对话、代码生成、项目联动，零学习成本，适合日常开发、快速调试。
- CLI 命令行工具（推荐开发者）：轻量化、跨终端适配、可嵌入脚本、支持批量操作，适合习惯终端开发、需要自动化集成的进阶用户。
二、安装前置准备（必看，避免90%报错）
正式安装前，提前准备好基础环境，杜绝安装后无法启动、依赖缺失等问题：
- 网络环境：需配置合规网络，正常访问 OpenAI 官方服务
- 基础环境（CLI必备）：安装 Node.js 18.0 及以上 LTS 稳定版（官方硬性要求，低版本会直接安装失败）
- 权限要求：Windows 建议管理员权限安装，Mac/Linux 避免普通用户权限不足报错
- 账号准备：提前注册 OpenAI 账号，用于登录激活工具
三、分平台详细安装步骤
方式一：桌面客户端安装（全平台通用，新手首选）
1、Windows 系统（Win10/Win11）
Windows 官方唯一正规渠道为微软应用商店，安装最稳定，无捆绑无报错：
- 访问 OpenAI Codex 官方下载页：
https://openai.com/zh-Hans-CN/codex/ - 页面自动识别 Windows 系统，点击「下载 for Windows」，获取轻量化引导安装包（Codex Installer.exe）
- 双击运行安装包，自动唤起 Microsoft Store 微软商店
- 点击「获取/安装」，等待自动完成部署，全程无需手动配置
- 安装完成后，在开始菜单找到 Codex，打开后登录 OpenAI 账号即可使用
Windows 避坑点：不要从第三方网站下载破解安装包，容易出现版本过期、植入插件、无法联网等问题。
2、Mac 系统（Intel/M1/M2/M3 通用）
- 进入 Codex 官网，下载对应 Mac 版本的 dmg 安装包
- 双击 dmg 文件，将 Codex 图标拖拽至「应用程序」文件夹
- 首次打开若提示「无法验证开发者」，前往系统设置-隐私与安全性，允许打开该应用
- 打开应用，登录 OpenAI 账号，完成初始化即可正常使用
3、Linux / WSL2 系统
Linux 桌面用户可直接下载官方二进制安装包，解压即用，适配 Ubuntu、CentOS 等主流发行版。
方式二：CLI 命令行安装（开发者专属，跨平台通用）
该方式适配 Windows、Mac、Linux 所有系统，依托 npm 安装，简洁高效，适合终端重度用户。
1、第一步：校验 Node.js 环境
打开终端，输入以下命令校验环境是否达标：
node -v
npm -v若版本低于 18.x，先升级 Node.js 至 LTS 稳定版，再继续安装。
2、第二步：一键安装 Codex CLI
执行官方推荐全局安装命令：
npm install -g @openai/codexMac/Linux 若提示权限错误，添加 sudo 权限安装：
sudo npm install -g @openai/codex3、第三步：校验安装成功
安装完成后，重启终端（必做！否则配置不生效），输入版本查询命令：
codex --version输出版本号即代表安装成功，无报错说明环境配置正常。
4、第四步：登录激活
终端输入登录命令，按照提示完成 OpenAI 账号授权：
codex login授权成功后，即可在任意项目目录下使用 Codex 命令行编程辅助功能。
四、Homebrew 专属安装（Mac/Linuxbrew 用户）
习惯使用 Homebrew 包管理器的用户，可直接通过brew一键安装，无需npm环境：
brew install openai-codex安装完成后，同样通过 codex --version 校验，codex login 激活即可。
五、首次使用基础操作
1、桌面端
- 登录账号后，直接在对话框输入编程需求：代码生成、bug 修复、代码重构、注释生成等
- 支持绑定本地项目文件夹，联动项目文件实现全局代码分析
2、CLI 端
- 进入项目目录：
cd 你的项目文件夹路径 - 快速发起编程指令：
codex 生成一个Python冒泡排序算法 - 查看帮助文档：
codex --help解锁全部指令功能
六、常见报错 & 解决方案（高频问题汇总）
1、安装成功后终端提示 codex 未找到命令
原因：环境变量未生效 / 未重启终端 解决方案：重启终端，若无效，手动配置 npm 全局环境变量
2、npm 安装报权限不足错误
解决方案：Mac/Linux 加 sudo 权限；Windows 以管理员身份打开终端重新安装
3、登录后无法使用功能、加载失败
原因：网络异常 / 账号未授权 解决方案：检查网络配置，重新执行 codex logout 退出后，再次 codex login 登录
4、Node版本正常但安装依赖失败
解决方案：切换npm官方源，清理缓存后重新安装：
npm cache clean -f七、写在最后
Codex 作为 OpenAI 主打 AI 编程工具，适配日常开发、学习练手、项目落地等多种场景，正确安装配置后，能极大降低代码编写、问题排查的时间成本。
新手优先选择桌面端，零配置快速上手；开发者推荐CLI终端版，适配自动化开发流程。按照本文步骤操作，基本可以规避所有安装踩坑问题。
后续会更新 Codex 高效使用技巧、自定义模型对接、项目实战教程，感兴趣可以持续关注！
