如果你已经用过 Cursor、Claude Code 或 GitHub Copilot那么一定要试试 Codex。它已经不仅仅是一个 AI 补全工具而是真正能够理解整个项目、修改代码、执行命令、调试 Bug甚至完成完整开发任务的 AI Agent。这篇文章不聊概念直接从安装开始一步步带你跑通整个流程。照着操作二十分钟左右就能把第一个项目跑起来。一、Codex 是什么Codex 是 OpenAI 推出的 AI 编程 Agent。和传统 AI 编程助手最大的区别在于✅ 能理解整个项目✅ 能执行 Terminal 命令✅ 能修改多个文件✅ 能自动运行测试✅ 能持续迭代直到完成任务现在主要有三种使用方式ChatGPT Codex DesktopCodex CLI推荐IDE 插件VSCode / Cursor 等本文主要介绍目前开发者使用最多的Codex CLI。二、准备工作正式安装之前需要准备下面几个环境。1、Node.js建议Node.js 20查看版本node -v如果没有安装可以去 Node 官网下载安装。2、Git检查git --version没有的话安装 Git。3、ChatGPT 账号推荐直接登录 ChatGPT这样不用自己管理 API Key。Codex 已支持使用 ChatGPT 账号登录。三、安装 Codex CLI目前官方推荐三种安装方式。方法一npm推荐npm install -g openai/codex安装完成codex --version如果输出版本号0.xxx.x说明安装成功。方法二Windows 安装脚本PowerShellpowershell -ExecutionPolicy ByPass -c irm https://chatgpt.com/codex/install.ps1 | iex官方已经提供一键安装脚本。方法三MacHomebrewbrew install --cask codex四、第一次登录终端输入codex第一次会出现Sign in with ChatGPT浏览器会自动打开登录即可。整个过程不到一分钟。五、创建第一个项目假设我们准备开发一个 Todo App。创建目录mkdir todo-app cd todo-app然后codexCodex 会识别当前目录作为 Project后续所有修改都在这里进行。六、第一个 Prompt不要一开始就让它帮我写一个商城。这样效果肯定是不好的推荐先从小任务开始。例如帮我创建一个 React Todo 项目。 要求 使用 TypeScript 使用 Vite 使用 Tailwind CSS 支持新增删除任务 代码符合 ESLintCodex 会开始创建项目安装依赖编写代码修改配置自动完成任务整个过程几乎不用自己写代码。七、让 Codex 修改已有项目这是 Codex 最强大的地方。例如帮我把整个项目改成暗黑主题。或者帮我把所有 axios 请求改成 fetch。或者把整个项目升级到 React 19。它会找文件修改文件修复引用更新依赖比传统 AI 高效很多。八、最常用的 Prompt修改 Bug帮我修复登录失败的问题。 原因 点击登录按钮没有任何反应。 请找到真正原因。重构帮我优化整个项目结构。 要求 拆分组件 减少重复代码 遵循最佳实践。阅读项目解释整个项目架构。 重点说明 入口 数据流 路由 API 状态管理这是新人最快了解项目的方法。写单元测试帮我为整个项目补充单元测试。 要求 使用 Vitest 覆盖率尽量高。写文档帮我生成 README。 包含 安装 运行 目录结构 开发说明九、如何写出高质量 Prompt很多人觉得 Codex 不够智能。实际上大部分问题都是 Prompt 太简单。例如❌帮我做个后台。改成✅帮我开发后台。 要求 Vue3 Pinia TypeScript Element Plus JWT 登录 RBAC 权限 REST API 目录符合企业开发规范Prompt 越详细效果越稳定。十、推荐建立 AGENTS.md这是很多新手不知道的技巧。在项目根目录创建AGENTS.md例如# Project Rules Run Tests npm test Lint npm run lint Code Style 使用 TypeScript 优先函数式组件 不要修改公共组件Codex 会优先读取这里面的规则再执行任务从而保证整个项目风格一致。十一、开发效率最高的工作流推荐下面这套流程需求 ↓ Codex 创建项目 ↓ Codex 写功能 ↓ Codex 修 Bug ↓ Codex 写测试 ↓ 人工 Review ↓ Git Commit大部分 CRUD 项目都可以这样完成。十二、Codex 使用技巧不要一次问十几个问题一个 Prompt 一个任务。尽量给完整上下文告诉它项目类型技术栈文件位置修改目标成功率会明显提升。多让它解释例如解释为什么这样修改。很多时候能学到新的开发思路。每完成一个功能及时 Commit方便git diff查看修改内容。十三、新手最容易踩的坑Node 版本太低很多安装失败都是因为 Node 版本过低。建议直接使用最新版 LTS。Prompt 太模糊越详细越好。一次修改整个项目建议一次一个功能。这样方便回滚。不检查 AI 代码一定要自己 Review自己测试自己运行毕竟 AI 也会犯错。总结相比传统 AI 编程助手Codex 已经从“代码补全工具”升级为能够理解项目并执行开发任务的 “AI Agent”。目前支持通过 ChatGPT 账号登录、本地 CLI、桌面应用以及 IDE 等多种方式使用适合新项目开发、旧项目重构、Bug 修复和代码理解等场景。如果这是你第一次接触 Codex建议先把整个流程跑通了再去做自己的项目。等熟悉了它的工作方式后你会发现很多重复性工作都可以交给它自己只需要把更多精力放在产品设计和业务逻辑上。