首次发布 最近更新
Codex 是 OpenAI 推出的编程助手,可以读懂你的项目代码,帮你写功能、改 Bug、跑测试、做代码审查。很多人第一次接触 Codex,最先卡住的就是安装:到底该下载哪个?命令行和桌面应用有什么区别?Windows 能不能用?本文按三种安装方式,一步步讲清楚怎么装、怎么登录、装好后怎么用,最后整理了常见问题的解决办法。
先说结论
- 新手最简单的方式是下载 ChatGPT 桌面应用,在左上角切换到 Codex 就能用,Windows 和 Mac 都支持。
- 习惯用终端的,装 Codex CLI,一条命令就能装好。
- 平时用 VS Code、Cursor 写代码的,直接装编辑器插件。
- 三种方式都用同一个 ChatGPT 账号登录,额度也是共用的。
一、Codex 有哪几种用法
Codex 不是只有一个软件,而是有好几种使用入口。它们背后是同一个 Codex,用的是同一个账号和同一份额度,区别只在于你在哪里和它交流。
| 用法 | 适合谁 | 支持的系统 |
|---|---|---|
| ChatGPT 桌面应用(Codex 模式) | 新手、不想碰命令行的人 | Windows、macOS |
| Codex CLI(命令行) | 习惯用终端的开发者 | Windows、macOS、Linux |
| 编辑器插件 | 用 VS Code、Cursor、Windsurf 写代码的人 | 跟随编辑器 |
| 网页版 | 临时使用、不方便安装软件时 | 浏览器 |
需要特别说明的是:原来单独的 Codex 桌面应用,现在已经合并进了新的 ChatGPT 桌面应用。按照 OpenAI 官方的说明,老用户更新后,原来的 Codex 应用会变成新的 ChatGPT 桌面应用,里面同时有聊天和 Codex,以前的对话和项目都会保留。所以网上一些教程里说的“单独下载 Codex 应用”,现在对应的就是 ChatGPT 桌面应用。
二、安装前的准备
安装之前,先确认下面几件事,能省掉很多麻烦:
- 一个 ChatGPT 账号:Codex 用 ChatGPT 账号登录,不需要单独注册。
- 合适的套餐:官方说明免费版和 Go 也包含 Codex,但额度很少、能用的功能也有限;命令行工具的官方页面写的是需要 Plus、Pro 或企业类套餐。想每天用 Codex 写代码,建议至少开通 Plus。各档怎么选,见 Codex 代充:开 Plus 还是 Pro。
- 能正常访问 ChatGPT 的网络:安装和登录都需要连接 OpenAI 的服务。
- 一个项目文件夹:Codex 是在你的项目里干活的,提前准备好要让它处理的代码目录。
- 建议使用 Git:Codex 会直接修改文件,项目用 Git 管理的话,改坏了随时可以回退。
三、方法一:ChatGPT 桌面应用(最简单)
这是最适合新手的方式,全程不需要打开命令行。
- 下载安装:从 OpenAI 官网下载 ChatGPT 桌面应用,Windows 和 macOS 都有对应的版本,按提示完成安装。
- 登录账号:打开应用,用你的 ChatGPT 账号登录。
- 切换到 Codex:在应用左上角的菜单里,选择 Codex。
- 选择项目:打开或添加你的项目文件夹,Codex 会在这个文件夹里读取和修改代码。
- 开始提需求:直接用中文描述你想做的事,比如“帮我看看这个项目是做什么的”“给登录页加一个记住密码的选项”。
如果你以前装过单独的 Codex 应用,直接更新即可,更新后就是新的 ChatGPT 桌面应用,原来的对话和项目不会丢。
四、方法二:Codex CLI(命令行)
Codex CLI 是在终端里运行的版本,适合习惯用命令行的开发者,也方便写脚本自动化。
Windows 安装
Codex CLI 可以直接在 Windows 的 PowerShell 里运行,官方提供了 Windows 沙箱支持。打开 PowerShell,运行下面这条命令:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
如果你的项目本来就在 Linux 环境里开发,也可以在 WSL2 里按下面 Linux 的方法安装。
Mac 和 Linux 安装
打开终端,运行官方的安装脚本:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Mac 用户也可以用 Homebrew 安装:
brew install --cask codex
用 npm 安装
如果电脑上已经装好了 Node.js,也可以用 npm 安装,Windows、Mac、Linux 都适用:
npm install -g @openai/codex
第一次运行和登录
安装完成后,关闭并重新打开一次终端,然后进入你的项目文件夹,输入:
codex
第一次运行时会提示你登录。这里有两个选项:用 ChatGPT 账号登录,或者用 API Key。想使用会员额度,一定要选 ChatGPT 账号登录。用 API Key 的话,会按 API 单独计费,不会使用你的 Plus 或 Pro 额度。两者的区别见 ChatGPT Plus、Codex 额度和 API 充值一样吗。
怎么更新
Codex CLI 更新很频繁。需要更新时,重新运行一次上面的安装命令即可。
五、方法三:编辑器插件
如果你平时在 VS Code、Cursor 或 Windsurf 里写代码,装插件是最顺手的方式,不用在编辑器和其他窗口之间来回切换。
- 打开编辑器的扩展市场;
- 搜索 Codex,认准发布者是 OpenAI 的官方插件,不要装名字相似的第三方插件;
- 安装后在侧边栏打开 Codex,用 ChatGPT 账号登录;
- 打开项目文件夹,就可以在编辑器里直接和 Codex 对话、让它修改代码。
六、装好之后怎么用
提需求的方法
Codex 能理解中文,但需求说得越清楚,结果越好。建议这样提:
- 先让它熟悉项目:第一次用时,先让它“读一下这个项目,说说整体结构和主要功能”,确认它理解对了再开始改。
- 一次只做一件事:“修复登录页在手机上的排版问题”比“把网站优化一下”好得多。
- 说清楚验收标准:比如“改完后运行测试,确认全部通过”。
- 重要的改动先看方案:可以先让它“只给方案,不要改代码”,你确认后再让它动手。
常用命令
在 Codex CLI 里,以斜杠开头的是命令,最常用的有这几个:
| 命令 | 作用 |
|---|---|
/model | 切换模型和推理强度,简单任务用低一档,能省额度 |
/status | 查看当前的额度使用情况和重置时间 |
codex exec | 在脚本里直接执行一个任务,适合自动化 |
安全使用的几个习惯
- 修改文件和运行命令前看一眼:Codex 会按照设置,在修改文件或运行命令前征求你的同意,不熟悉的操作不要直接放行。
- 用 Git 管理项目:每完成一个小功能就提交一次,出问题可以随时回退。
- 不要把密码、密钥写进代码:Codex 会读取项目里的文件,敏感信息放在环境变量或配置文件里,并加入忽略列表。
七、常见问题排查
| 问题 | 常见原因 | 解决办法 |
|---|---|---|
| 提示找不到 codex 命令 | 安装后终端没有重新打开,或者 npm 的全局路径没有加入系统环境变量 | 关闭终端重新打开;用 npm 安装的,检查 npm 全局目录是否在 PATH 里 |
| 登录页面打不开或登录失败 | 网络无法正常访问 OpenAI 的服务 | 确认网络能正常打开 ChatGPT 后再试 |
| 用的不是会员额度 | 登录时选了 API Key | 退出登录,重新选择用 ChatGPT 账号登录 |
| 提示达到用量上限 | 当前套餐的额度用完了 | 用 /status 查看重置时间,或者升级套餐 |
| Windows 上个别命令运行异常 | 项目依赖 Linux 环境 | 在 WSL2 里安装和运行 Codex |
八、额度不够用怎么办
Codex 没有单独的会员,它的额度来自你的 ChatGPT 套餐:免费版额度很少,Plus 适合大多数个人开发,Pro 5x 和 Pro 20x 的额度更多,适合长时间跑任务或者同时开多个任务。所有入口共用同一份额度,在桌面应用里用掉的,命令行里就少了。
如果经常碰到上限,可以先试试这几个办法:简单的任务切换到低一档的模型;把大任务拆小;每次只让它读取需要的文件。还是不够用的话,就该考虑升级套餐了,怎么选见 Codex 代充:开 Plus 还是 Pro。没有海外支付方式的,可以看 GPT 代充服务说明。
MixLivo 是独立第三方服务,不代表 OpenAI 官方。Codex 的安装方式、支持的系统和套餐规则更新很快,请以 OpenAI 官方说明为准。
常见问题
Codex 免费吗?
官方说明免费版也包含 Codex,但额度很少、功能有限,适合先体验。想每天用来写代码,建议开通 Plus 或更高的套餐。
Windows 能用 Codex 吗?
能。可以用 ChatGPT 桌面应用,也可以在 PowerShell 里安装 Codex CLI;项目依赖 Linux 环境的,可以在 WSL2 里使用。
安装 Codex 一定要装 Node.js 吗?
不一定。只有用 npm 安装时才需要 Node.js。用官方安装脚本、Homebrew 或者桌面应用,都不需要。
Codex 和 ChatGPT 是同一个账号吗?
是的。Codex 用 ChatGPT 账号登录,额度也来自 ChatGPT 的套餐,桌面应用、命令行、编辑器插件和网页版共用同一份额度。
原来的 Codex 应用去哪了?
已经合并进新的 ChatGPT 桌面应用。更新后在左上角的菜单里选择 Codex 即可,原来的对话和项目都会保留。