Codex三端安装的完整指南(Windows/Mac/Linux)
最近来找我聊Codex的朋友，问得最多的问题几乎一模一样：
Codex到底怎么装？Windows能不能用上？Mac用户怎么整？Linux服务器上能不能跑起来？
核心先说一句：如果你平时经常敲代码、改项目、读源码，那Codex确实值得花点时间装上。它可不是那种“聊天机器人帮你写代码”的玩具，而是一个能跑在你本地终端里的
AI Coding Agent
OpenAI对Codex CLI的官方定位也说得很清楚：它是一个在本地终端运行的coding agent，可以读取、修改并运行你当前目录下的代码。
那就不绕弯子了，下面按朋友间手把手教的那种节奏，带你走一遍
Windows、Mac、Linux
一、先说结论：Codex有哪几种安装方式？
现在常见的Codex CLI安装方式，主要就这几种：
- 官方提供的一键安装脚本
- 通过npm安装
- Homebrew安装（主要照顾Mac用户）
- Windows专用的PowerShell安装脚本
官方GitHub和npm页面上给出的安装命令也很清楚：Mac/Linux用curl脚本，Windows用PowerShell脚本，当然也可以通过npm install -g @openai/codex或者brew install --cask codex来装。
从实际体验出发，优先建议是这样的：
- ：先走Homebrew或官方脚本，最省心。
Mac用户
- ：首选官方脚本，不行再试npm。
Linux用户
- ：优先用PowerShell脚本，搞不定再走npm。
Windows用户
- ：直接npm搞定，全平台通用。
开发者或喜欢折腾的
二、安装前准备
动手装Codex之前，先把下面这些东西准备好，能省很多弯路。
1. 一个正常可用的OpenAI/ChatGPT账号
Codex本质上是OpenAI推出的coding agent，所以你需要一个能正常登录的OpenAI账号。
如果是在国内网络环境下使用，可能会遇到登录失败、授权超时之类的问题。这类情况通常不是Codex本身坏了，而是网络或账号环境导致的，排查时先往这个方向看。
2. 一个趁手的终端工具
不同系统对应的终端不一样：
- Windows：PowerShell 或 Windows Terminal
- Mac：系统自带的 Terminal，或者 iTerm2
- Linux：系统自带 Terminal，或者 SSH 终端
Windows用户建议直接装一个
Windows Terminal
3. Node.js，推荐备一个
虽然官方现在有一键安装脚本，但很多朋友最终还是会在npm这条路遇到。提前把Node.js装好总是没错的。
检查方法很简单：
node -v npm -v
能正常显示版本号，就说明Node.js和npm都已经就位了。
三、Windows安装Codex
Windows用户可以走官方PowerShell脚本路线。
1. 打开PowerShell
右键点击开始菜单，选择：
Windows PowerShell
或者直接打开：
Windows Terminal
建议用管理员身份运行，省去后面可能出现的权限问题。
2. 执行安装命令
直接复制下面这行命令丢进去：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
执行后它就会自动下载并安装Codex CLI。官方GitHub上给出的Windows安装方式也就是这个PowerShell脚本。
3. 检查是否安装成功
安装完成后，输入：
codex --version
或者直接输入：
codex
如果能顺利进入Codex交互界面，就说明安装成功了。
4. Windows常见问题
问题一：提示无法运行脚本
如果PowerShell提示脚本无法执行，可以先运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
然后再重新执行安装命令。
问题二：提示codex不是内部或外部命令
这大概率是环境变量没刷新。可以试试：
- 先把当前PowerShell关掉
- 重新打开Windows Terminal
- 再输入
codex
如果还不行，重启电脑一般就能解决。
问题三：Windows安装后闪退
这类情况可能是依赖、路径或终端兼容的问题。可以换个npm安装方式：
npm install -g @openai/codex
然后再执行codex试试。
四、Mac安装Codex
Mac是目前用Codex体验比较好的平台，尤其适合程序员本地开发。
Mac上有三种推荐的安装方式：
方式一：官方脚本安装
打开终端，执行：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
这是官方给Mac/Linux用户提供的一键安装方式。安装完成后执行codex，能打开就说明成功了。
方式二：Homebrew安装
如果Mac上已经装了Homebrew，那就更简单了：
brew install --cask codex
官方安装说明里也列了Homebrew这种方式。
方式三：npm安装
如果对npm更熟悉，也可以：
npm install -g @openai/codex
装好后同样执行codex即可。
Mac常见问题
问题一：提示brew command not found
这说明Homebrew还没装。可以先装Homebrew，或者直接走官方脚本方式：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
问题二：提示permission denied
检查一下当前用户权限，或者换个npm的全局目录。临时解决可以试：
sudo npm install -g @openai/codex
不过长期用sudo npm装全局包容易带来权限混乱，不建议养成这个习惯。
问题三：安装成功但codex命令找不到
大概率是PATH没生效。可以先跑一下：
echo $PATH
然后重启终端，或者检查~/.zshrc/~/.bashrc的配置。
五、Linux安装Codex
Linux用户通常面对两种场景：一种是自己的Linux桌面系统，另一种是服务器SSH环境。如果是用服务器跑项目，Codex也可以直接在项目目录里用。
方式一：官方脚本安装
直接执行：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
这是Mac/Linux通用的官方安装脚本。装完跑codex即可。
方式二：npm安装
如果已经装了Node.js和npm：
npm install -g @openai/codex
然后运行codex。npm官方页面也展示了这种安装方式。
Linux常见问题
问题一：没有curl
如果提示curl: command not found，Ubuntu/Debian可以执行：
sudo apt update sudo apt install -y curl
CentOS/Rocky/AlmaLinux可以执行：
sudo yum install -y curl
或者：
sudo dnf install -y curl
问题二：没有Node.js
Ubuntu可以这样装：
sudo apt update sudo apt install -y nodejs npm
装完检查一下版本：
node -v npm -v
如果版本太旧，建议去Node.js官网重新装一个较新的LTS版本。
问题三：npm全局安装没权限
如果遇到权限问题，可以先看看：
npm config get prefix
不建议上来就乱用sudo。更干净的方式是用nvm来管理Node.js。当然，如果只是临时测试，也可以：
sudo npm install -g @openai/codex
六、第一次使用Codex
安装完成后，建议进到一个真实项目目录里，比如：
cd my-project
然后执行：
codex
第一次运行时，一般会让你登录或授权，按提示操作就行。
进入Codex后，就可以直接用自然语言下指令了：
帮我分析这个项目的目录结构
或者：
帮我找一下登录接口在哪里
再比如：
帮我修复这个报错，并告诉我你改了哪些文件
Codex和普通ChatGPT最大的区别就在这里：它不只是回答问题，而是能结合当前项目文件来分析问题。
七、推荐的使用姿势
很多人装完Codex，第一反应是不知道问什么好。这里整理几个实用提示词：
1. 分析项目
请先阅读当前项目结构，告诉我这个项目的技术栈、主要模块、启动方式和关键配置文件。
2. 找Bug
这个项目现在启动报错，请你帮我定位原因。先别直接改代码，先告诉我可能的问题点。
3. 改功能
请帮我新增一个用户列表接口，要求使用现有项目风格，不要引入新的框架。
4. 写文档
请根据当前项目生成一份README.md，包含项目介绍、环境要求、启动方式、目录结构和常见问题。
5. 写测试
请帮我为这个模块补充单元测试，优先覆盖正常流程和常见异常流程。
八、Codex适合什么人？
从实际使用场景来看，Codex特别适合这几类朋友：
1. 经常接手老项目的人
老项目最痛苦的不是写代码，而是看不懂结构。让Codex先帮你读目录、看配置、找入口，这一步就能省下大量时间。
2. 后端开发
比如Go、Ja va、Python、Node.js项目，Codex可以帮你找接口、补CRUD、写测试、改配置。
3. 前端开发
比如Vue、React、Next.js项目，Codex能帮你找组件、改样式、分析页面结构。
4. 运维和部署
像Dockerfile、docker-compose、Nginx、CI/CD这类配置，Codex也能帮你看出问题。
5. 自媒体或教程作者
这个点很多人容易忽略。Codex不仅能写代码，还能根据项目生成教程、README、部署文档、接口说明，非常适合做技术内容输出。
九、Codex安装失败怎么办？
提供一个排查顺序，遇到问题可以按这个步骤来：
1. 先确认命令有没有输错
比如npm安装命令应该是：
npm install -g @openai/codex
不要装到一些奇怪的第三方包。之前也出现过假冒Codex相关工具的供应链安全事件，有恶意npm包伪装成Codex周边工具窃取认证信息，所以安装时一定要认准OpenAI官方仓库或官方npm包。
2. 确认网络是否正常
很多报错其实不是安装本身的问题，而是网络访问失败。可以先测试：
curl https://chatgpt.com
如果访问不了，Codex的安装和登录大概率也会失败。
3. 确认Node.js/npm是否正常
执行：
node -v npm -v
没有版本号的话，先去装Node.js。
4. 确认环境变量
如果安装成功但运行不了，多半是PATH的问题。关闭终端重新打开试试，或者检查一下环境变量设置。
5. 换一种安装方式
官方脚本不行就换npm，npm不行Mac可以换Homebrew，总有一种能通。
十、推荐的个人安装选择
最后，直接给出一套简明的优先级方案：
Windows
优先：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
备用：
npm install -g @openai/codex
Mac
优先：
brew install --cask codex
或者：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
备用：
npm install -g @openai/codex
Linux
优先：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
备用：
npm install -g @openai/codex
十一、最后说几句
Codex这类AI Coding Agent，和以前的代码补全工具已经完全不是同一个东西了。以前用AI写代码，大多数场景是复制一段需求，让它生成一段代码，然后自己粘进去。现在Codex更像是直接进入你的项目，帮你读代码、改代码、跑命令、解释问题。
当然，它也不是万能的。核心建议只有一句：
小改动可以放心让它直接做，大改动一定要让它先分析方案。
比如你可以先问：
先别改代码，请先分析这个需求需要改哪些文件，以及可能有哪些风险。
等它分析清楚后，再让它动手。这样用起来会稳很多。
如果你是第一次接触AI编程工具，从Codex CLI开始是个不错的选择。安装不算难，使用门槛也不高，真正用起来之后你会发现，它在项目理解、Bug定位、代码重构和文档生成这些方面，确实能帮上大忙。
这篇Codex安装教程就到这儿，希望能帮你少踩几个坑。
