如果你已经用过 Cursor、Claude Code 或 GitHub Copilot，那么一定要试试 Codex。

它已经不仅仅是一个 AI 补全工具，而是真正能够理解整个项目、修改代码、执行命令、调试 Bug，甚至完成完整开发任务的 AI Agent。

这篇文章不聊概念，直接从安装开始，一步步带你跑通整个流程。照着操作，二十分钟左右就能把第一个项目跑起来。

---

一、Codex 是什么？

Codex 是 OpenAI 推出的 AI 编程 Agent。

和传统 AI 编程助手最大的区别在于：

✅ 能理解整个项目

✅ 能执行 Terminal 命令

✅ 能修改多个文件

✅ 能自动运行测试

✅ 能持续迭代直到完成任务

现在主要有三种使用方式：

• ChatGPT Codex Desktop

• Codex 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 安装脚本

PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

官方已经提供一键安装脚本。

---

方法三：Mac

Homebrew：

brew install --cask codex

---

四、第一次登录

终端输入：

codex

第一次会出现：

Sign in with ChatGPT

浏览器会自动打开，登录即可。

整个过程不到一分钟。

---

五、创建第一个项目

假设我们准备开发一个 Todo App。

创建目录：

mkdir todo-app

cd todo-app

然后：

codex

Codex 会识别当前目录作为 Project，后续所有修改都在这里进行。

---

六、第一个 Prompt

不要一开始就让它：

帮我写一个商城。

这样效果肯定是不好的，推荐先从小任务开始。

例如：

帮我创建一个 React Todo 项目。

要求：

使用 TypeScript

使用 Vite

使用 Tailwind CSS

支持新增删除任务

代码符合 ESLint

Codex 会开始：

• 创建项目

• 安装依赖

• 编写代码

• 修改配置

• 自动完成任务

整个过程几乎不用自己写代码。

---

七、让 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，建议先把整个流程跑通了，再去做自己的项目。等熟悉了它的工作方式后，你会发现很多重复性工作都可以交给它，自己只需要把更多精力放在产品设计和业务逻辑上。