在 IDE、终端或云端开始使用 Codex
所有 ChatGPT 套餐均包含 Codex。你也可以使用 OpenAI API 密钥登录，通过 API 额度来使用 Codex。
请选择你偏好的使用方式：
Codex 桌面应用支持 macOS 和 Windows。大多数功能在两个平台上均可使用，平台相关的例外情况会在相关文档中注明。
1. 下载并安装 Codex 桌面应用
Section titled “1. 下载并安装 Codex 桌面应用”下载适用于 macOS 或 Windows 的 Codex 桌面应用。
Windows 下载
不同的操作系统：
2. 打开 Codex 并登录
Section titled “2. 打开 Codex 并登录”下载安装完成后，打开 Codex 并使用你的 ChatGPT 账户或 OpenAI API 密钥登录。
3. 选择一个项目
Section titled “3. 选择一个项目”选择你想让 Codex 工作的项目文件夹。
如果你之前使用过 Codex 应用程序、CLI（命令行界面）或 IDE 扩展，会看到过去的工作项目列表。
4. 发送第一条消息
Section titled “4. 发送第一条消息”选择项目后，确保选中 本地（Local）模式，让 Codex 在你的机器上工作，然后发送第一条消息给 Codex。
你可以询问 Codex 关于项目或计算机的任何问题。例如：
告诉我这个项目是做什么的
在这个仓库中构建一个经典的贪吃蛇游戏
在我的代码库中查找并修复 bug
如果需要更多灵感，可以浏览 Codex 使用场景。如果你是 Codex 新手，建议阅读 最佳实践指南。
为你的 IDE 安装 Codex 扩展。
1. 安装 Codex 扩展
Section titled “1. 安装 Codex 扩展”为你的编辑器下载 Codex 扩展：
2. 打开 Codex 面板
Section titled “2. 打开 Codex 面板”安装完成后，Codex 扩展会出现在侧边栏中（与其他扩展并列）。如果找不到，它可能隐藏在折叠区域中。你可以根据自己的偏好将 Codex 面板移到编辑器右侧。
3. 登录并开始第一个任务
Section titled “3. 登录并开始第一个任务”使用你的 ChatGPT 账户或 API 密钥登录即可开始使用。Codex 默认以 智能体模式（Agent mode） 启动，这允许它读取文件、运行命令以及在项目目录中写入更改。
4. 使用 Git 检查点
Section titled “4. 使用 Git 检查点”Codex 可以修改你的代码库，因此建议 在每个任务前后创建 Git 检查点，以便在需要时轻松回退更改。如果您是首次使用 Codex，请阅读最佳实践指南。
了解更多关于 Codex IDE 扩展 →
Codex CLI 支持 macOS、Windows 和 Linux。
1. 安装 Codex CLI
Section titled “1. 安装 Codex CLI”在 macOS 或 Linux 上，使用独立安装程序：
curl -fsSL [https://chatgpt.com/codex/install.sh](https://chatgpt.com/codex/install.sh) | sh在 Windows 上，运行：
powershell -ExecutionPolicy ByPass -c "irm [https://chatgpt.com/codex/install.ps1](https://chatgpt.com/codex/install.ps1) | iex"对于无人值守安装，在运行下载的安装程序的 Shell 上设置 CODEX_NON_INTERACTIVE=1。有关详细信息，请参阅 环境变量。
curl -fsSL [https://chatgpt.com/codex/install.sh](https://chatgpt.com/codex/install.sh) | CODEX_NON_INTERACTIVE=1 sh$env:CODEX_NON_INTERACTIVE=1; irm [https://chatgpt.com/codex/install.ps1](https://chatgpt.com/codex/install.ps1) | iex您也可以使用 npm 或 Homebrew 安装 Codex CLI：
npm install -g @openai/codexbrew install --cask codex2. 运行 codex 并登录
Section titled “2. 运行 codex 并登录”在终端中运行 codex 即可开始使用。系统会提示你使用 ChatGPT 账户或 API 密钥登录。
3. 让 Codex 在当前目录工作
Section titled “3. 让 Codex 在当前目录工作”认证完成后，你可以让 Codex 在当前目录中执行任务。例如：
- 告诉我这个项目是做什么的
- 在这个仓库中构建一个经典的贪吃蛇游戏
- 在我的代码库中查找并修复 bug
4. 使用 Git 检查点
Section titled “4. 使用 Git 检查点”Codex 可以修改你的代码库，因此建议在每个任务前后创建 Git 检查点。如果您是首次使用 Codex，请阅读最佳实践指南。
了解更多关于 Codex CLI →
在 chatgpt.com/codex 上云端使用 Codex。
1. 在浏览器中打开 Codex
Section titled “1. 在浏览器中打开 Codex”访问 chatgpt.com/codex。你也可以通过在 GitHub PR 评论中标记 @codex 来将任务委托给 Codex（需要登录 ChatGPT）。
2. 设置环境
Section titled “2. 设置环境”在开始第一个任务之前，为 Codex 设置一个运行环境。打开 环境设置 并按照步骤连接一个 GitHub 仓库。
3. 启动任务并监控进度
Section titled “3. 启动任务并监控进度”一旦您的环境准备就绪，即可从 Codex 界面 启动编码任务。您可以通过查看日志实时监控进度，或者让任务在后台运行。
4. 审查变更并创建 PR
Section titled “4. 审查变更并创建 PR”当任务完成时，请在差异视图（diff view）中审查建议的更改。您可以对结果进行迭代，或者直接在您的 GitHub 仓库中创建拉取请求（pull request）。
Codex 还提供了更改的预览。您可以按原样接受拉取请求（PR），或者在本地切出分支以测试这些更改：
git fetchgit checkout <branch-name>了解更多关于 Codex 云端 →
- 了解更多关于 Codex 桌面应用 — 使用 Codex 桌面应用处理本地项目
- 迁移到 Codex — 将受支持的指令文件、MCP 服务器配置、技能和子智能体迁移到 Codex