系统要求#

第一步：打开 PowerShell#

1. 按键盘上的 Win 键（有 Windows 图标的键，在键盘左下角）
2. 输入 “powershell”
3. 找到 “Windows PowerShell”
4. 右键 → “以管理员身份运行”
5. 弹出权限提示点 “是”

什么是 PowerShell？ Windows 自带的命令行工具，你在里面输入命令，电脑就会执行。

第二步：运行安装命令#

复制下面这行命令，在 PowerShell 窗口里 右键 粘贴，按 回车：

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

怎么粘贴？ 复制命令后，在 PowerShell 窗口里直接 右键 就能粘贴（不是 Ctrl+V）。

第三步：等待安装#

脚本会自动下载并安装 Codex，大概 1-3 分钟。不需要操作，等着就行。

第四步：验证安装#

关闭当前 PowerShell，重新打开一个新的（不需要管理员），输入：

1
codex --version

显示版本号就说明装好了。

第五步：开始使用#

1
codex

第一次会让你登录（见下面”登录”章节）。

备用方式：npm 安装#

如果你电脑上已经有 Node.js（v18+），可以直接用 npm 装：

1
npm install -g @openai/codex

检查 Node.js 是否已安装：

1
node --version

如果没有或版本太低，先去 https://nodejs.org 下载安装 Node.js。

备用方式：手动下载#

1. 访问 https://github.com/openai/codex/releases/latest
2. 找到 Assets，下载 codex-x86_64-pc-windows-msvc.zip
3. 解压到一个文件夹（比如 C:\codex）
4. 把这个文件夹添加到系统 PATH：
   • 按 Win 键，输入 “环境变量”
   • 点 “编辑系统环境变量” → “环境变量”
   • 在 “系统变量” 中找到 “Path”，点 “编辑”
   • 点 “新建”，输入文件夹路径（比如 C:\codex）
   • 一路点 “确定”
5. 重新打开 PowerShell，输入 codex --version

第一步：打开终端#

1. 按 Command + 空格键（同时按这两个键）
2. 弹出 Spotlight 搜索框
3. 输入 “终端” 或 “Terminal”
4. 按 回车 打开

什么是终端？ Mac 的命令行工具，输入文字命令让电脑执行。

第二步：运行安装命令#

复制下面这行命令，在终端里粘贴（Command + V），按 回车：

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

第三步：输入密码#

可能会要求输入 Mac 开机密码（登录 Mac 时用的密码）。

为什么输密码看不见？ 这是正常的，Mac 终端输入密码不显示任何字符。直接输密码，按回车就行。

第四步：等待安装#

大概 1-3 分钟，自动完成。

第五步：验证安装#

1
codex --version

显示版本号就装好了。

第六步：开始使用#

1
codex

第一次会让你登录。

备用方式：Homebrew 安装#

如果你有 Homebrew（Mac 的软件管理器）：

1
brew install --cask codex

没有 Homebrew？先装它：

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

备用方式：手动下载#

1. 访问 https://github.com/openai/codex/releases/latest
2. 找到 Assets，根据芯片下载：
   • Apple Silicon（M1/M2/M3/M4）：codex-aarch64-apple-darwin.tar.gz
   • Intel：codex-x86_64-apple-darwin.tar.gz
3. 解压，把 codex 文件移动到系统目录：

   1
   sudo mv codex /usr/local/bin/

4. 验证：codex --version

怎么知道我的 Mac 是什么芯片？ 点左上角 → “关于本机” → 看 “芯片” 一栏。

用 ChatGPT 账号登录（推荐）#

1. 运行 codex
2. 选择 “Sign in with ChatGPT”
3. 浏览器自动打开 OpenAI 登录页
4. 输入 ChatGPT 账号密码
5. 点 “授权” / “Allow”
6. 回到终端，登录成功！

需要什么套餐？

• ChatGPT Plus ✅
• ChatGPT Pro ✅
• ChatGPT Business / Edu / Enterprise ✅
• 免费账号 ❌ 不能用

用 API Key 登录#

1. 访问 https://platform.openai.com/api-keys
2. 点 “Create new secret key”
3. 复制生成的 Key
4. 在 Codex 中选择 “Sign in with an API key”
5. 粘贴 Key

基本用法#

启动交互式对话：

1
codex

然后在对话框里输入你的需求，AI 会帮你执行。

单次提问（不进入交互模式）：

1
codex "帮我写一个 Python 的 Hello World"

指定工作目录：

1
cd ~/my-project
2
codex

AI 会在你当前所在的目录里操作文件。

常用命令#

使用技巧#

1. 先 cd 到项目目录 — 在运行 codex 之前，先用 cd 命令进入你的代码目录
2. 描述清楚需求 — 越具体越好，比如”帮我用 Python 写一个计算器，支持加减乘除”
3. 粘贴报错信息 — 遇到 Bug 时，把完整报错信息发给 Codex
4. 确认操作 — Codex 执行危险操作前会问你，输入 y 确认，n 拒绝

codex: command not found#

Windows：

• 重新打开 PowerShell 再试
• 如果还不行，重新安装

macOS：

1
source ~/.zshrc
2
codex --version

如果还不行：

1
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
2
source ~/.zshrc

登录失败#

1. 确认 ChatGPT 账号有 Plus 或 Pro 套餐
2. 先在浏览器里打开 https://chatgpt.com 确认能登录
3. 确保网络能正常访问 openai.com

网络超时#

如果下载超时，可以手动下载安装包（见”手动下载”部分）。

执行策略错误（Windows）#

1
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

然后重新运行安装命令。

遇到问题？ 访问 https://developers.openai.com/codex 或 https://www.reddit.com/r/codex/