> 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 后，可以大幅提高：

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://befriends.gitbook.io/free-vpn/ai/codex.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.