> For the complete documentation index, see [llms.txt](https://befriends.gitbook.io/free-vpn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://befriends.gitbook.io/free-vpn/ai/codex.md).

# OpenAI Codex / ChatGPT 教程

## OpenAI Codex 使用教程

> 从零开始使用 OpenAI Codex，让 AI 成为你的编程助手

### 目录

* 一、什么是 OpenAI Codex
* 二、Codex 能做什么
* 三、使用前准备
* 四、Codex 使用方式
* 五、Codex CLI 安装教程
* 六、第一次运行 Codex
* 七、常用操作
* 八、高质量提示词写法
* 九、完整项目开发流程
* 十、实际案例
* 十一、进阶技巧
* 十二、常见问题

***

## 一、什么是 OpenAI Codex

OpenAI Codex 是 OpenAI 推出的 **AI 编程智能体（AI Coding Agent）**。

它不仅可以生成代码，还可以理解整个项目环境，帮助开发者完成：

* 编写代码
* 修改代码
* 分析项目结构
* 修复 Bug
* 编写测试
* 优化程序
* 执行开发任务

传统 AI：

```
提出问题
 ↓
获得代码答案
 ↓
手动复制修改
```

Codex：

```
提出目标
 ↓
分析项目
 ↓
修改文件
 ↓
运行测试
 ↓
完成任务
```

简单理解：

> Codex 更像一个 AI 程序员，而不是普通代码生成工具。

***

## 二、Codex 能做什么

### 1. 开发新项目

例如：

```
创建一个 Vue3 后台管理系统

要求：

- 用户登录
- 权限管理
- 数据统计
- 响应式设计
```

Codex 可以自动：

* 创建项目结构
* 编写代码
* 配置环境
* 添加依赖

***

### 2. 阅读已有项目

例如：

```
分析当前项目结构

告诉我：

1. 使用了什么技术
2. 每个目录作用
3. 存在哪些问题
```

Codex 会读取：

```
src/

config/

package.json

README.md
```

然后生成项目分析。

***

### 3. 修复 Bug

例如：

```
检查为什么用户登录失败

分析原因并修复
```

Codex 会：

1. 查看代码
2. 定位问题
3. 修改文件
4. 给出原因

***

### 4. 优化代码

例如：

```
优化这个接口性能

要求：

保持功能不变

降低数据库查询次数
```

***

## 三、使用前准备

### 基础要求

建议了解：

* Linux 基础命令
* Git 使用
* 至少一种编程语言

推荐：

| 语言         | 用途        |
| ---------- | --------- |
| Python     | 自动化、AI、后端 |
| JavaScript | 网站开发      |
| Go         | 服务器程序     |
| Java       | 企业应用      |

***

## 四、Codex 使用方式

目前主要有：

| 方式        | 适合用户  |
| --------- | ----- |
| 网页版 Codex | 普通用户  |
| Codex App | 多项目开发 |
| IDE 插件    | 程序员   |
| Codex CLI | 高级用户  |

***

## 五、Codex CLI 安装教程

### 1. 安装 Node.js

检查：

```bash
node -v
```

如果没有安装：

访问：

```
https://nodejs.org
```

安装最新版 Node.js

***

### 2. 安装 Codex CLI

执行：

```bash
npm install -g @openai/codex
```

查看版本：

```bash
codex --version
```

如果显示版本号：

说明安装成功。

***

## 六、第一次运行 Codex

进入项目目录：

```bash
cd your-project
```

启动：

```bash
codex
```

首次运行需要登录账号。

成功后：

```
Codex >
```

表示进入 AI 编程环境。

***

## 七、常用操作

### 1. 分析项目

输入：

```
分析当前项目结构

告诉我：

- 技术栈
- 文件作用
- 优化建议
```

***

### 2. 修改代码

例如：

```
优化用户登录功能

增加：

- 错误提示
- 登录次数限制
- 日志记录
```

***

### 3. 创建功能

例如：

```
增加用户注册功能

要求：

- 使用 JWT
- 保存数据库
- 添加接口验证
```

***

### 4. 修复错误

输入：

```
运行项目

检查所有报错

并修复
```

***

## 八、高质量提示词写法

不要这样：

```
帮我写一个网站
```

效果：

需求不明确。

推荐：

```
使用 React + TypeScript 创建一个后台管理系统

要求：

1. 用户登录
2. 权限管理
3. 数据统计
4. 使用 Tailwind CSS
5. 输出完整项目结构
```

原则：

### 描述目标

告诉 AI：

你想实现什么。

### 描述技术

例如：

```
Vue3

Node.js

MySQL

Docker
```

### 描述限制

例如：

```
不要改变现有接口

保持兼容
```

***

## 九、完整项目开发流程

### 第一步：项目分析

输入：

```
不要修改代码

先分析：

- 项目结构
- 技术架构
- 存在问题
```

***

### 第二步：制定方案

输入：

```
根据分析结果

制定详细修改计划
```

***

### 第三步：执行修改

输入：

```
按照方案修改代码

每一步说明原因

完成后测试
```

***

### 第四步：代码检查

输入：

```
检查所有修改

确认：

- 是否有错误
- 是否影响其他功能
```

***

## 十、实际案例

## 案例一：创建网站

提示：

```
创建一个企业官网

技术：

React + Tailwind

功能：

- 首页
- 产品介绍
- 联系页面
- 手机适配

生成完整项目
```

***

## 案例二：开发 Telegram Bot

提示：

```
使用 Python 开发 Telegram Bot

功能：

1. 用户绑定
2. Token验证
3. 数据库存储
4. 管理后台
5. 日志系统
```

***

## 案例三：服务器程序优化

提示：

```
分析这个 Linux 服务

目标：

降低 CPU 使用率

要求：

不要改变功能

给出优化方案
```

***

## 十一、进阶技巧

### 使用 AGENTS.md

在项目根目录创建：

```
AGENTS.md
```

内容：

```md
# 项目开发规则


代码规范：

- 使用 TypeScript
- 使用 ESLint


测试：

npm test


提交：

必须通过测试
```

以后 Codex 会自动遵守这些规则。

***

## 十二、Git 配合 Codex

推荐流程：

```
创建分支

↓

Codex 修改

↓

测试

↓

Git diff检查

↓

提交代码
```

查看修改：

```bash
git diff
```

提交：

```bash
git add .

git commit -m "update"
```

***

## 十三、常见问题

### Codex 会删除我的代码吗？

有可能。

建议：

* 使用 Git
* 修改前备份
* 让 Codex 先制定方案

***

### 不会编程可以使用吗？

可以。

但是建议学习：

* 文件结构
* 基础代码概念
* 命令行操作

***

### Codex 和 Cursor 区别？

| 工具     | 特点      |
| ------ | ------- |
| Cursor | AI代码编辑器 |
| Codex  | AI开发助手  |

Cursor：

> 辅助写代码

Codex：

> 完成开发任务

***

## 十四、总结

Codex 的正确使用方式：

不要：

```
帮我写代码
```

应该：

```
分析项目

制定方案

修改代码

测试结果
```

把 Codex 当成：

> 一个能够阅读代码、修改代码、完成任务的 AI 工程师。

***

### 推荐学习路线

```
基础命令

↓

Git

↓

Linux

↓

项目结构

↓

Codex 自动开发

↓

自动部署
```

掌握 Codex 后，可以大幅提高：

* 网站开发效率
* 运维效率
* 自动化能力
* 项目维护效率