快速入门

下载并安装 Codex 应用

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

打开 Codex 并登录

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

如果你使用 OpenAI API 密钥登录，某些功能（例如 云端会话 ）可能不可用。

选择一个项目

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

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

发送你的第一条消息

选择项目后，请确保 本地 已选中，以便让 Codex 在你的机器上工作，然后向 Codex 发送你的第一条消息。

你可以向 Codex 询问有关该项目的任何信息，或者关于你电脑的一般问题。以下是一些示例：

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

如果你需要更多灵感，请探索 Codex 使用案例。如果你刚开始使用 Codex，请阅读 最佳实践指南.

安装 Codex 扩展

为你的编辑器下载：

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

打开 Codex 面板

安装完成后，Codex 扩展会与其他扩展一起显示在侧边栏中。它可能被折叠隐藏了。你可以根据需要将 Codex 面板移至编辑器右侧。

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

使用你的 ChatGPT 账户或 API 密钥登录以开始使用。

Codex 默认以 Agent 模式启动，允许它读取文件、运行命令并在你的项目目录中写入更改。

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

使用 Git 检查点

Codex 可以修改你的代码库，因此建议在每次任务前后创建 Git 检查点，以便在需要时轻松还原更改。如果你刚开始使用 Codex，请阅读 最佳实践指南.

安装 Codex CLI

在 macOS 或 Linux 上，使用独立安装程序：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

在 Windows 上，运行：

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

你也可以使用 npm 或 Homebrew 安装 Codex CLI：

npm install -g @openai/codex

brew install --cask codex

在 Agent Builder 内部运行 codex and sign in

在 Agent Builder 内部运行 codex 在你的终端中即可开始。系统将提示你使用 ChatGPT 账户或 API 密钥登录。

让 Codex 在你当前的目录中工作

完成身份验证后，你可以让 Codex 在当前目录中执行任务。

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

使用 Git 检查点

Codex 可以修改你的代码库，因此建议在每次任务前后创建 Git 检查点，以便在需要时轻松还原更改。如果你刚开始使用 Codex，请阅读 最佳实践指南.

在你的浏览器中打开 Codex

Go to chatgpt.com/codex。您也可以通过提及 Codex 来将任务委派给它 @codex 在 GitHub 拉取请求评论中（需要登录 ChatGPT）。

设置环境

在开始第一个任务之前，请为 Codex 设置一个环境。通过以下地址打开环境设置： chatgpt.com/codex 并按照步骤连接 GitHub 仓库。

启动任务并监控进度

环境准备就绪后，从 Codex 界面。您可以通过查看日志来实时监控进度，或者让任务在后台运行。

向我介绍这个项目已复制分析我的应用架构的主要故障模式。已复制以最小化、高置信度的更改查找并修复我代码库中的 bug。已复制

审查变更并创建拉取请求

当任务完成时，在差异视图中查看建议的更改。你可以迭代结果，或直接在你的 GitHub 仓库中创建 Pull Request。

Codex 还会提供更改的预览。你可以原样接受该 PR，也可以在本地检出分支以测试这些更改：

git fetch
git checkout <branch-name>