ChatGPT Codex 实战指南：从安装到使用

📗 OpenAI 官方 AI 编程 Agent，并行处理任务的云端智能工程师

📅 2026 年 4 月更新 | ⏱ 阅读约 8 分钟

一、什么是 ChatGPT Codex

ChatGPT Codex 是 OpenAI 推出的 AI 编程代理（Coding Agent），底层模型为针对编程任务专门调优的 GPT-5-Codex（又称 GPT-5.3-Codex）。

与 GitHub Copilot 等传统代码补全工具不同，Codex 是真正意义上的自主编程 Agent------它能独立运行测试、修复 Bug、生成 Pull Request、安装依赖，甚至跨文件重构整个项目。

💡 Codex 的核心定位： 从"代码补全工具"升级为"虚拟软件工程师"。

核心能力

能力	说明
⚡ 并行任务处理	Codex Cloud 可同时运行多个 Agent 处理不同任务，大幅提升开发效率
🔗 深度 GitHub 集成	直接连接 GitHub 仓库，自动生成 PR、处理 Issues、运行 CI/CD
🎯 精准指令遵循	GPT-5 强大的指令遵循能力，让你改 CSS 就只改 CSS，绝不越界
🔧 多模型切换	原生支持外接不同 AI 模型，可同时配置多个模型随时切换

二、三种使用方式

Codex 提供三种接入方式，根据使用场景选择最适合的：

方式	说明	适合场景
☁️ Codex Cloud（网页版）	直接在 chatgpt.com/codex 使用，连接 GitHub 仓库，无需本地安装	快速试用、云端任务
💻 Codex CLI（命令行）	本地终端工具，支持 macOS/Linux/WSL，离线可用	需要本地代码控制的开发者
🧩 VS Code 扩展	集成在 IDE 内，将本地 CLI 和云端 Codex 整合，提供内联建议	习惯 IDE 的开发者

三、前置准备

账号与订阅要求

Codex 目前包含在以下 ChatGPT 订阅计划中：

套餐	价格	说明
Free（限时）	$0/月	限时提供 Codex 访问，额度有限
Plus	$20/月	每 5 小时 30-150 条消息，适合个人开发者
Pro ⭐	$200/月	每 5 小时 300-1500 条消息，体验最丝滑
Team / Enterprise	按需	企业级管理功能，支持 RBAC 权限控制

CLI 安装的系统要求

依赖项	要求	验证命令
Node.js	v18+（推荐 v22）	`node -v`
操作系统	macOS / Linux（Windows 需 WSL）	---
ChatGPT 账号	Plus / Pro 或更高订阅	---
网络	可访问 OpenAI 服务	---

四、云端网页版使用（最简单）

对于想快速上手 Codex 的用户，云端版本是最简便的方式，无需任何安装：

步骤一：访问 Codex 页面

打开浏览器，访问 chatgpt.com/codex，使用 ChatGPT 账号登录（需 Plus 或更高级别订阅）

步骤二：连接 GitHub 仓库

点击「Connect GitHub」，授权 Codex 访问你的仓库。选择需要操作的项目作为工作环境。没有仓库时，先在 GitHub 创建一个空白仓库，刷新 Codex 页面后选择。

步骤三：选择任务模式

Codex 云端版提供两种工作模式：

Ask 模式：对话问答，不修改代码
Code 模式：直接操作代码库，会产生实际文件变更

步骤四：输入任务指令

在对话框中用自然语言描述你的编程需求，Codex 将自动分析仓库、规划方案、执行任务。

🔵 Codex Cloud 最强大的功能是并行任务处理：你可以同时委派多个不同的任务给多个 Agent，它们将在云端并行执行，相当于你同时指挥多位工程师工作。

五、CLI 命令行安装与配置

步骤一：检查 Node.js

bash 复制代码

node -v
# 如果版本低于 v18，需要先升级 Node.js
# macOS: brew install node
# Linux: sudo apt install nodejs npm

步骤二：安装 Codex CLI

bash 复制代码

# 全局安装 Codex CLI（推荐）
npm install -g @openai/codex

# 国内加速安装
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 验证安装
codex --version

bash 复制代码

# macOS Homebrew 安装
brew install codex
codex --version

步骤三：登录认证

方式一：ChatGPT 账号直接登录（推荐，无需 API Key）

bash 复制代码

# 启动 Codex，系统会自动打开浏览器进行 ChatGPT 授权
codex
# 登录成功后，token 自动保存到 ~/.codex/token

方式二：API Key 认证

bash 复制代码

# macOS / Linux 临时设置
export OPENAI_API_KEY="sk-xxxxxxxx"

# 永久写入（推荐）
echo 'export OPENAI_API_KEY="sk-xxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

# Windows PowerShell
$env:OPENAI_API_KEY="sk-xxxxxxxx"

步骤四：配置默认模型（可选）

新建配置文件 ~/.codex/config.toml：

toml 复制代码

model = "gpt-5-codex"     # 指定使用的模型
temperature = 0.2         # 降低随机性，代码生成更稳定

六、VS Code 扩展安装

步骤一：打开扩展市场

在 VS Code 中按 Ctrl+Shift+X（Mac: Cmd+Shift+X）打开扩展市场

步骤二：搜索并安装

搜索 OpenAI Codex，找到 OpenAI 官方发布的扩展，点击「Install」安装

步骤三：激活与登录

安装完成后，VS Code 左侧出现 OpenAI 图标。点击图标 → 使用 ChatGPT 账号登录授权

步骤四：配置偏好（建议）

首次使用建议进行基础配置优化：选择模型版本、设置代码风格偏好、启用/禁用自动建议

ℹ️ Codex VS Code 扩展兼容大多数 VS Code 派生版本（如 VSCodium、Cursor 等）。对于其他 IDE，可以在 IDE 内置终端中运行 Codex CLI 来使用。

七、实战演示

示例 1：添加用户认证功能

复制代码

为这个项目添加用户认证功能，使用 JWT token，
包括登录、注册和中间件。

Codex 会自动创建新文件、安装 JWT 相关依赖、编写代码并运行测试，全程自主完成。

示例 2：参考已有代码实现新功能（Codex 的强项）

复制代码

参考 src/api/users.js 的代码风格和结构，
实现 src/api/products.js，只创建这一个文件，
不要修改其他任何文件。

这是 Codex 的核心优势之一------精准的指令遵循：它会看懂已有代码、照样子写新代码，不会"顺手"重构其他无关代码。

示例 3：修改 CSS 只改 CSS

复制代码

把 src/styles/button.css 中所有按钮的圆角从 4px 改为 8px，
只修改这个 CSS 文件。

示例 4：MCP 配置与扩展

bash 复制代码

# 添加 Chrome DevTools MCP
codex mcp add-json chrome-devtools '{"command": "npx", "args": ["chrome-devtools-mcp@latest"]}'

# 查看所有 MCP 服务
codex mcp list

# 删除 MCP 服务
codex mcp remove chrome-devtools

八、常用命令速查

命令	功能说明
`codex`	启动 Codex 交互模式
`codex --version`	查看当前版本
`codex -m gpt-5-codex`	指定使用的模型版本
`codex mcp add`	添加 MCP 服务器
`codex mcp list`	查看已安装 MCP 服务
`codex mcp remove`	删除 MCP 服务

云端 Codex 并行工作流示例

复制代码

# 连接仓库后，同时发起多个任务（并行执行）

任务 A：修复登录页面的 XSS 漏洞
任务 B：给 UserService 添加单元测试
任务 C：重构数据库连接池逻辑

# 所有任务并行处理完成后，审查每个 PR 并合并

九、使用建议与注意事项

安全注意事项

本地模式：你的源代码不会离开你的机器，安全性有保障
云端模式：OpenAI 承诺不会将代码用于训练模型，Enterprise 版提供 SOC 2 合规认证
建议在执行大规模代码修改前，先确保代码已提交 git，方便回滚
使用 Code 模式前仔细阅读 Codex 的执行计划，确认无误再批准

提升效率的技巧

在 GitHub 仓库中添加 AGENTS.md 文件，说明项目规范，让 Codex 更了解你的项目
对于需要精确控制的任务，在指令中明确说明"只修改 X 文件""不要改动其他代码"
复杂任务拆分成多个小任务并行执行，充分利用 Codex Cloud 的并行处理优势
开启 Plus/Pro 双倍速率限制福利（限时活动），尽量在高峰期前完成大任务

总结

ChatGPT Codex 的最大优势在于精准的指令遵循 和云端并行任务处理。特别适合需要在代码规范严格的大型项目中工作，或者需要同时处理多个开发任务的场景。配合 VS Code 扩展使用，体验尤为顺滑。

ChatGPT Codex 官方文档：https://openai.com/codex

如有帮助，欢迎点赞收藏 ⭐ 关注获取更多 AI 工具实战教程

ChatGPT Codex 实战指南：从安装到使用

目录

一、什么是 ChatGPT Codex

核心能力

二、三种使用方式

三、前置准备

账号与订阅要求

CLI 安装的系统要求

四、云端网页版使用（最简单）

五、CLI 命令行安装与配置

步骤一：检查 Node.js

步骤二：安装 Codex CLI

步骤三：登录认证

步骤四：配置默认模型（可选）

六、VS Code 扩展安装

七、实战演示

示例 1：添加用户认证功能

示例 2：参考已有代码实现新功能（Codex 的强项）

示例 3：修改 CSS 只改 CSS

示例 4：MCP 配置与扩展

八、常用命令速查

云端 Codex 并行工作流示例

九、使用建议与注意事项

安全注意事项

提升效率的技巧

总结