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

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

1. 什么是 ChatGPT Codex
2. 三种使用方式
3. 前置准备
4. 云端网页版使用
5. CLI 命令行安装
6. VS Code 扩展安装
7. 实战演示
8. 常用命令速查
9. 使用建议与注意事项

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

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

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

核心能力

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

账号与订阅要求

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

CLI 安装的系统要求

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

步骤一：访问 Codex 页面

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

步骤二：连接 GitHub 仓库

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

步骤三：选择任务模式

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

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

步骤四：输入任务指令

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

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

步骤一：检查 Node.js

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

步骤二：安装 Codex CLI

# 全局安装 Codex CLI（推荐） npm install -g @openai/codex # 国内加速安装 npm install -g @openai/codex --registry=https://registry.npmmirror.com # 验证安装 codex --version

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

步骤三：登录认证

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

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

 
方式二：API Key 认证
 
        
    
          
 
           
# 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：

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

步骤一：打开扩展市场

在 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 配置与扩展
 
         
    
           
 
            
# 添加 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 并行工作流示例

 
         
    
           
 
            
# 连接仓库后，同时发起多个任务（并行执行） 
 
            
任务 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 工具实战教程