安装Codex，先选好使用方式，再完成安装、登录和首次运行。本文以Codex CLI，也就是终端版为主，分别说明Windows和macOS、Linux的操作。在青蛙博客，我们也提供ChatGPT会员充值服务；但安装工具本身不需要先购买Pro，建议先完成安装，再根据账号权限和实际用量选择套餐。

一、选对版本，不用全部安装

Codex有不同使用入口，按自己的习惯选一种即可：

下面安装CLI版。它在本地运行，但模型请求仍需要联网和有效登录，不能理解成离线大模型。

二、Windows安装Codex

打开PowerShell，使用官方提供的安装命令：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

这条命令会下载并执行安装脚本，请核对域名和完整内容，不要随意替换成不明来源的“一键安装命令”。公司管理的设备应遵循组织的软件安装要求。

等待安装结束，重新打开终端，检查版本：

codex --version

显示版本号，说明终端已经能够找到Codex。

如果提示无法识别命令，先关闭并重新打开PowerShell，再检查安装输出是否有失败提示，以及安装目录是否加入PATH。不要因为这一条报错就重复安装多个版本。

三、macOS和Linux安装Codex

打开终端，运行官方安装命令：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

安装完成后，新开一个终端窗口检查：

codex --version

如果Mac已经安装Homebrew，也可以选择：

brew install --cask codex

已经配置Node.js和npm的用户，还有一种安装方式：

npm install -g @openai/codex

以上方式选一种即可。 没有Node.js，不需要为了安装Codex专门走npm路线；混用多种安装方式，反而可能让后续更新和版本排查更复杂。

四、进入项目目录，再启动登录

Codex会围绕当前目录开展工作，因此不要直接在整个用户目录里开始第一次任务。建议选择一个测试项目，或者先备份已有代码。

例如，Windows项目位于D:\projects\demo：

cd D:\projects\demo

codex

macOS或Linux的示例：

cd ~/projects/demo

codex

路径要换成自己电脑上真实存在的项目目录。

首次启动后，按提示选择“Sign in with ChatGPT”，在登录页面完成账号验证，再返回终端。也可以使用API Key等可用方式，但API调用另外计费，不包含在Plus或Pro订阅费用中。

如果准备通过青蛙博客购买Plus或Pro充值服务，请给后续登录Codex的同一个ChatGPT账号开通。购买前确认套餐、周期和账号条件，完成后核对会员状态。第三方充值不会改变官方地区支持范围。

五、用一个只读任务检查是否正常

登录完成后，不建议立即让Codex重写整个项目。先输入：

请查看当前项目的目录结构，说明主要技术栈和启动方式。暂时不要修改文件，也不要安装依赖。

这个任务可以帮助你检查：目录是否选对、文件能否读取，以及模型请求是否正常。

确认没问题，再给一个范围明确的小任务：

请定位页面标题对应的文件，先说明修改方案，等我确认后再编辑。

遇到文件修改、命令执行或网络访问的权限提示，先阅读操作内容，不要为了省事直接放开所有权限。已有Git项目，任务前保留一次提交，完成后查看差异，方便撤回不合适的修改。

六、装好了却不能用，按症状排查

找不到codex命令：检查安装是否成功、终端是否重新打开，以及PATH配置。

能启动但登录失败：先检查浏览器中的账号状态、终端提示和网络连接。能打开聊天网页，不代表终端里的请求一定正常。

提示没有可用模型或用量不足：查看当前账号、可选模型和用量页面。安装成功与账号权限是两回事，重新安装通常不会增加额度。

代码生成了，但项目跑不起来：查看是否缺少项目要求的Python、Node.js、数据库或其他依赖。Codex安装完成，不代表所有开发环境也已配置。

后续更新，尽量沿用原安装方式。例如npm安装的版本，可执行：

npm install -g @openai/codex@latest

更新后再用codex --version检查即可。

先完成安装、登录和一个小任务，再决定是否增加会员预算。需要开通或升级时，可以查看青蛙博客当前套餐，按实际使用量选择Plus或具体Pro档位。