Codex: Codex 安装与使用
最后更新：2026-08-31
Codex 提供多种安装方式，根据你的操作系统和使用习惯选择最适合的。
📋 前置知识：了解基本命令行操作，已安装 Node.js（CLI 方式需要）
1. 安装方式总览
| 方式 | 适用场景 | 推荐度 |
|---|---|---|
| Codex App | 桌面用户、全功能体验 | ⭐⭐⭐⭐ |
| Codex CLI | 开发者日常、终端流 | ⭐⭐⭐⭐⭐ |
| Homebrew | Mac 用户 | ⭐⭐⭐⭐ |
| 二进制包 | 无 Node.js 环境 | ⭐⭐⭐ |
| IDE 插件 | VS Code / Cursor 用户 | ⭐⭐⭐⭐ |
2. Codex App（桌面应用）
最简单的方式，直接下载桌面客户端。
访问 https://chatgpt.com/codex，下载对应平台的应用。
(1) 安装步骤
TEXT
📖 仅展示
1. 访问 chatgpt.com/codex
2. 点击 "Download for macOS/Windows"
3. 安装应用
4. 登录 ChatGPT 账号
5. 开始使用
(2) 首次运行
登录后进入三栏界面：左侧任务列表，中间对话窗口，右侧多功能区。
Codex App 是经典的三栏布局：任务列表 + 对话窗口 + 多功能区。
3. Codex CLI（命令行）
开发者最常用的方式。CLI 在本地运行，代码不会上传到云端。
(1) 安装
BASH
# 使用 npm 安装
sudo npm install -g @openai/codex
# 国内镜像加速
sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com
(2) 登录
首次运行需要登录，三种方式：
方式一：ChatGPT 登录（推荐）
BASH
codex
# 选择 "Sign in with ChatGPT"
# 浏览器自动打开登录页面
方式二：API Key 登录
BASH
# macOS/Linux 临时设置
export OPENAI_API_KEY="sk-你的API密钥"
# 永久配置（添加到 shell 配置文件）
echo 'export OPENAI_API_KEY="sk-你的API密钥"' >> ~/.zshrc
source ~/.zshrc
# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的API密钥"
# 指定模型启动
codex --model gpt-5-codex
方式三：auth.json 文件
BASH
mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
"OPENAI_API_KEY": "sk-你的API密钥"
}
EOF
(3) 首次运行
BASH
cd my-project
codex
# 输入：分析下当前的项目结构
▶ 示例 1: Alice 的首次体验
BASH
# Alice 创建测试项目
mkdir codex-test && cd codex-test
# 创建一个简单文件
echo 'print("Hello World")' > test.py
# 启动 Codex
codex
# Alice 输入：
# "为 test.py 添加命令行参数支持，支持 --name 参数"
4. 三种运行模式
Codex CLI 提供三种安全模式：
| 模式 | 功能 | 安全级别 |
|---|---|---|
| Suggest | 只建议修改，需手动确认 | 高（默认） |
| Auto Edit | 自动修改文件，命令需确认 | 中 |
| Full Auto | 自动执行所有操作 | 低（谨慎使用） |
BASH
# 默认模式
codex
# Auto Edit 模式
codex --auto-edit
# Full Auto 模式
codex --full-auto
▶ 示例 2: 模式选择
PYTHON
def choose_mode(task_risk, task_complexity):
if task_risk == "high":
return "Suggest - 逐条确认安全"
elif task_complexity == "low":
return "Full Auto - 简单任务快速完成"
else:
return "Auto Edit - 文件自动改，命令人工审"
5. Homebrew 安装（Mac 推荐）
BASH
# 安装
brew install --cask codex
# 运行
codex
适合不想安装 Node.js 的 Mac 开发者。
6. 二进制包安装
从 GitHub Release 直接下载：
BASH
# 下载地址：https://github.com/openai/codex/releases
# Mac Apple Silicon
tar -xzf codex-aarch64-apple-darwin.tar.gz
# Linux
tar -xzf codex-x86_64-unknown-linux-musl.tar.gz
# 加入 PATH
sudo mv codex /usr/local/bin
# 运行
codex
7. IDE 插件安装
支持 VS Code、Cursor、Windsurf 等 IDE。
(1) 安装步骤
TEXT
📖 仅展示
1. 打开 IDE 插件市场
2. 搜索 "Codex"
3. 安装插件
4. 登录 ChatGPT 账号
(2) IDE 内功能
- 自动修复代码
- 自动生成函数
- 自动重构代码
- 选中代码右键发送给 Codex
8. 更新与卸载
BASH
# CLI 更新
npm update -g @openai/codex
# 强制重装最新版
npm install -g @openai/codex@latest
# 卸载
npm uninstall -g @openai/codex
# Homebrew 卸载
brew uninstall --cask codex
9. 系统支持
| 系统 | 支持情况 |
|---|---|
| macOS | 完整支持 |
| Linux | 完整支持 |
| Windows | 实验支持（建议 WSL） |
10. 网络问题
国内用户访问 Codex 可能遇到网络障碍，可考虑：
- 使用网络代理
- 尝试阿里 Qoder Quest 或字节 Trae Solo 等类似产品
❓ 常见问题
Q 安装 CLI 前需要什么？
A 需要安装 Node.js（v18+），npm 已包含在 Node.js 中。Mac 用户可用 Homebrew 直接安装 Codex 跳过 Node.js。
Q Windows 能用 Codex CLI 吗？
A 实验性支持，建议通过 WSL（Windows Subsystem for Linux）使用，体验更稳定。
Q API Key 和 ChatGPT 登录哪个好？
A ChatGPT 登录更简单，适合大多数用户；API Key 适合开发者需要精确控制模型和成本的场景。
Q Full Auto 模式安全吗？
A 有一定风险。Codex 会自动执行所有操作包括 shell 命令，建议只在可信项目中使用，或配合沙箱模式。
Q 如何查看 Codex 版本？
A 运行
codex --version 即可查看当前版本。📖 小节
- 五种安装方式：App / CLI / Homebrew / 二进制 / IDE 插件
- CLI 是开发者首选，
npm install -g @openai/codex一行搞定 - 三种安全模式：Suggest / Auto Edit / Full Auto
- 首次运行需登录：ChatGPT 登录（推荐）/ API Key / auth.json
- Windows 用户建议通过 WSL 使用
📝 作业
- 基础题（难度⭐）：安装 Codex CLI 并成功登录，截图你的首次运行界面。
- 进阶题（难度⭐⭐）：分别用 Suggest 和 Auto Edit 模式完成同一任务，对比两者体验差异。
- 挑战题（难度⭐⭐⭐）：在 WSL 环境下安装 Codex CLI，写一份安装踩坑笔记。
