快速入门

下载并安装 Codex 应用程序

下载适用于 macOS 或 Windows 的 Codex 应用程序。如果您使用的是 Intel 芯片的 Mac，请选择 Intel 版本。

打开 Codex 并登录

下载并安装 Codex 应用程序后，打开它并使用您的 ChatGPT 账号或 OpenAI API 密钥登录。

如果您使用 OpenAI API 密钥登录，某些功能（例如云端对话线程）可能无法使用。

选择项目

选择您希望 Codex 在其中工作的项目文件夹。

如果您之前使用过 Codex 应用程序、CLI 或 IDE 扩展，您将看到过去处理过的项目。

发送您的第一条消息

选择项目后，请确保选中“本地 (Local)”模式，以便 Codex 在您的计算机上运行，然后向 Codex 发送您的第一条消息。

您可以向 Codex 询问有关该项目或计算机的任何问题。以下是一些示例：

向我介绍一下这个项目已复制在这个仓库中构建一个经典的贪吃蛇游戏。已复制在我的代码库中查找并修复错误，并进行最小化、高置信度的更改。已复制

如果您需要更多灵感，请探索 Codex 使用案例。如果您是 Codex 新手，请阅读 最佳实践指南。

安装 Codex 扩展

下载编辑器插件

• 下载 Visual Studio Code 版
• 下载 Cursor 版
• 下载 Windsurf 版
• 下载 Visual Studio Code Insiders 版

打开 Codex 面板

安装完成后，Codex 扩展将出现在侧边栏中（与其他扩展并列）。如果被折叠，可能需要展开查看。您可以根据偏好将 Codex 面板移动到编辑器的右侧。

登录并开始您的第一个任务

使用您的 ChatGPT 账号或 API 密钥登录以开始使用。

Codex 默认以代理（Agent）模式启动，该模式允许它读取文件、运行命令并在您的项目目录中进行修改。

向我介绍一下这个项目已复制在这个仓库中构建一个经典的贪吃蛇游戏。已复制在我的代码库中查找并修复错误，并进行最小化、高置信度的更改。已复制

使用 Git 检查点

Codex 可以修改您的代码库，因此请考虑在执行任务前后创建 Git 检查点，以便在需要时轻松撤销更改。如果您是 Codex 新手，请阅读 最佳实践指南。

安装 Codex CLI

使用 npm 安装

npm install -g @openai/codex

使用 Homebrew 安装

brew install codex

运行 codex 并登录

在您的终端运行 codex 以开始。系统将提示您使用 ChatGPT 账号或 API 密钥登录。

要求 Codex 在当前目录中工作

身份验证完成后，您可以要求 Codex 在当前目录下执行任务。

向我介绍一下这个项目已复制在这个仓库中构建一个经典的贪吃蛇游戏。已复制在我的代码库中查找并修复错误，并进行最小化、高置信度的更改。已复制

使用 Git 检查点

Codex 可以修改您的代码库，因此请考虑在执行任务前后创建 Git 检查点，以便在需要时轻松撤销更改。如果您是 Codex 新手，请阅读 最佳实践指南。

在浏览器中打开 Codex

前往 chatgpt.com/codex。您也可以通过在 GitHub 拉取请求（PR）评论中添加 @codex 标签来委托任务（需先登录 ChatGPT）。

设置环境

在开始第一个任务前，请先为 Codex 设置环境。请访问 chatgpt.com/codex 打开环境设置，并按照步骤连接 GitHub 仓库。

启动任务并监控进度

环境就绪后，您可以从 Codex 界面启动编码任务。您可以通过查看日志实时监控进度，也可以让任务在后台运行。

向我介绍一下这个项目已复制解释我应用程序架构中的主要故障模式。已复制在我的代码库中查找并修复错误，并进行最小化、高置信度的更改。已复制

审查更改并创建拉取请求

任务完成后，请在 diff 视图中审查提出的更改。您可以对结果进行迭代优化，或直接在 GitHub 仓库中创建拉取请求。

Codex 还提供更改预览。您可以直接接受 PR，或在本地检出该分支以测试更改。

git fetch
git checkout <branch-name>