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

OpenAI 官方 AI 编程 Agent并行处理任务的云端智能工程师 2026 年 4 月更新 | ⏱ 阅读约 8 分钟目录什么是 ChatGPT Codex三种使用方式前置准备云端网页版使用CLI 命令行安装VS Code 扩展安装实战演示常用命令速查使用建议与注意事项一、什么是 ChatGPT CodexChatGPT 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.jsv18推荐 v22node -v操作系统macOS / LinuxWindows 需 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.jsnode-v# 如果版本低于 v18需要先升级 Node.js# macOS: brew install node# Linux: sudo apt install nodejs npm步骤二安装 Codex CLI# 全局安装 Codex CLI推荐npminstall-gopenai/codex# 国内加速安装npminstall-gopenai/codex--registryhttps://registry.npmmirror.com# 验证安装codex--version# macOS Homebrew 安装brewinstallcodex codex--version步骤三登录认证方式一ChatGPT 账号直接登录推荐无需 API Key# 启动 Codex系统会自动打开浏览器进行 ChatGPT 授权codex# 登录成功后token 自动保存到 ~/.codex/token方式二API Key 认证# macOS / Linux 临时设置exportOPENAI_API_KEYsk-xxxxxxxx# 永久写入推荐echoexport OPENAI_API_KEYsk-xxxxxxxx~/.zshrcsource~/.zshrc# Windows PowerShell$env:OPENAI_API_KEYsk-xxxxxxxx步骤四配置默认模型可选新建配置文件~/.codex/config.tomlmodel gpt-5-codex # 指定使用的模型 temperature 0.2 # 降低随机性代码生成更稳定六、VS Code 扩展安装步骤一打开扩展市场在 VS Code 中按CtrlShiftXMac:CmdShiftX打开扩展市场步骤二搜索并安装搜索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 文件。示例 4MCP 配置与扩展# 添加 Chrome DevTools MCPcodex mcp add-json chrome-devtools{command: npx, args: [chrome-devtools-mcplatest]}# 查看所有 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 工具实战教程