Codex 快速入门指南：工程级 AI 编程代理

订阅中包含的 Codex 特性：

• Web、CLI、IDE 扩展环境中的 Codex 辅助编码；
• 最新 Codex 模型（如 GPT-5.2-Codex）;
• 较高的本地／云端使用额度（Pro 计划更高）;
• 可用 ChatGPT 额度扩展（通过购买额外 credits）;

Codex 安装指南

系统与环境要求

在开始安装 Codex 之前，需要确保满足以下安装环境，整体配置门槛不高，主流开发环境均可顺利运行。

IDE 扩展

Codex 提供了 IDE 集成扩展，可以在熟悉的开发环境中启动 AI 编程助手，提升效率，官方 Quickstart 列出了多个常用编辑器的下载方式：

支持的 IDE 环境

• Visual Studio Code：vscode:extension/openai.chatgpt
• Cursor：cursor:extension/openai.chatgpt
• Windsurf：windsurf:extension/openai.chatgpt
• VS Code Insiders：https://marketplace.visualstudio.com/items?itemName=openai.chatgpt

安装与使用流程

1. 从下载链接下载安装对应扩展；
2. 在 IDE 中启用扩展后，Codex 会显示在侧边栏；
3. 使用 ChatGPT 账号或 API key 登录，完成授权；
4. Codex 会默认启动在 Agent 模式，可读取文件、运行命令并修改项目目录文件，建议配合 Git 管理变更记录。

CLI 安装

Codex CLI 是一款运行在本地终端的轻量级 AI 编程代理，可通过命令行与代码库交互，CLI 支持 macOS / Windows / Linux 平台，并可结合 Git 管理本地项目。

官方 Quickstart 提供了两个主流安装方式：

# 使用 npm 全局安装
npm install -g @openai/codex
# 或使用 Homebrew 安装
brew install codex 

安装完成后，在终端运行：

codex 

首次运行时，会提示你使用 ChatGPT 账号登录或 API key 登录，登录成功后，CLI 会提升权限读取当前目录的代码库，并允许你发出自然语言指令来完成任务。

Cloud（Web 云端）

Cloud 是 Codex 在线版，可直接在浏览器使用，无需本地安装。你可以在浏览器中创建项目、执行任务，并将 Codex 与 GitHub 仓库连接。使用流程如下：

1. 在浏览器打开 Cloud Codex 平台。
2. 登录 ChatGPT 账号；
3. 在环境设置中连接你需要操作的 GitHub 仓库；
4. 发起任务并监控执行进度；
5. 使用 diff 工具检查变更，可直接在网页上创建 Pull Request。

特点如下：

• 零安装：无需在本地配置，只要联网即可使用；
• 集成 GitHub：可将 AI 修改整合到团队协作流程；
• 实时预览：在浏览器中实时查看日志与变更摘要。

三种安装方式对比

Codex 快速入门（CLI 实战）

前面讲的可能都比较偏概念化，这里实际的来操作演示，效果可能更好。

初始化与授权登录

创建项目

初次使用，我们可以进入项目的根目录，这里为了方便演示，我新建了一个 html-project 的文件夹，然后执行 codex 命令如下：

mkdir html-project
cd html-project
codex 

登录与授权流程

运行后，会提示登录，这里提供两种登录方式，一种是直接跳转至 web 页面登录，一种是使用 API KEY，这里使用跳转 web 方式登录：

选择第一种之后，会自动跳转到浏览器授权页面：

点击 Continue 授权，授权成功后，页面会提示如下：

切换回终端，提示登录成功了，

登录成功页面如下：

用一句话完成一个真实需求

接下来，我们可以开发任务，例如：帮我创建一个静态的页面，打开后，是星空的动态效果。可以看到，Codex 在执行任务的过程中，会提示用户是否要执行该操作，上述有三个选项，我们可以选择 2，意思是整个执行的过程都同意，不需要每次都提示：

最后执行成功的结果如下：

打开生成的 HTML，可以看到如下效果，效果还是挺不错的。