OpenAI Codex 这页适合想快速完成安装、登录、选择项目并发出第一条任务的用户，覆盖 App、IDE extension、CLI 和 Cloud 四种入口。按平台安装后可用 ChatGPT 账号或 OpenAI API key 登录；如果用 API key，部分 cloud threads 可能不可用，Cloud 还需要先连接 GitHub repository。
Codex 使用教程：安装下载、登录与第一次对话
Every ChatGPT plan includes Codex。
你也可以用 OpenAI API key，通过 API credits 使用 Codex。
Codex 下载安装
| 平台 | 下载方式 |
|---|---|
| Windows | Microsoft Store 下载 或 winget install Codex -s msstore |
| macOS | 官网下载 Codex app（支持 Apple Silicon 和 Intel） |
| Linux | 暂无桌面版，可 登记通知；CLI 支持 Linux |
| CLI（跨平台） | npm install -g @openai/codex 或 brew install codex |
| Cloud | 无需安装，浏览器访问 chatgpt.com/codex |
CLI 详细安装和配置见 Codex CLI 文档。
Setup
Codex app 怎么安装和登录
The Codex app is available on macOS and Windows。
大多数 Codex app 功能在两个平台都可用；平台差异会在相关文档里单独说明。
-
下载并安装 Codex app
下载适用于 macOS 或 Windows 的 Codex app。如果你用的是 Intel Mac，请选择 Intel build。
-
打开 Codex 并登录
安装完成后，打开 Codex app，用你的 ChatGPT 账号或 OpenAI API key 登录。
如果你使用 OpenAI API key 登录，像 cloud threads 这样的部分功能可能不可用。
-
选择一个项目
选择一个希望 Codex 处理的项目文件夹。
如果你以前用过 Codex app、CLI 或 IDE extension，会看到你之前处理过的项目。
-
发送第一条消息
选好项目后，确认 Local 已选中，这样 Codex 就会在你的机器上工作，然后发送第一条消息。
你可以直接问 Codex 关于项目的问题，也可以问电脑里的通用问题。比如：
Tell me about this projectBuild a classic Snake game in this repo.Find and fix bugs in my codebase with minimal, high-confidence changes.
如果你想看更多任务写法，可以浏览 Codex use cases。如果你是第一次用 Codex，建议先读 best practices guide。
怎么安装和使用 IDE 扩展
Install the Codex extension for your IDE。
-
安装 Codex 扩展
下载对应编辑器版本：
-
打开 Codex 面板
安装后，Codex extension 会出现在侧边栏，和其他扩展一起显示。它也可能被折叠起来。你可以把 Codex 面板移动到编辑器右侧。
-
登录并开始第一个任务
用 ChatGPT 账号或 API key 登录即可开始。
Codex 默认进入 Agent mode，可以读取文件、运行命令，并在你的项目目录里写入改动。
-
使用 Git checkpoints
Codex 可以修改你的 codebase，所以建议在每个任务前后创建 Git checkpoints，方便需要时快速回滚。
如果你刚开始用 Codex，可以继续看 best practices guide。
怎么安装和运行 Codex CLI
The Codex CLI is supported on macOS, Windows, and Linux。
-
安装 Codex CLI
使用 npm 安装：
npm install -g @openai/codex或者使用 Homebrew 安装：
brew install codex -
运行
codex并登录在终端里运行
codex，然后按提示用 ChatGPT 账号或 API key 登录。 -
让 Codex 在当前目录工作
认证完成后，你就可以让 Codex 在当前目录执行任务。
你可以让 Codex 做这些任务：
Tell me about this projectBuild a classic Snake game in this repo.Find and fix bugs in my codebase with minimal, high-confidence changes.
-
使用 Git checkpoints
Codex 可以改动你的 codebase，建议在每次任务前后创建 Git checkpoints，便于需要时快速回滚。
如果你刚开始用 Codex，可以继续看 best practices guide。
怎么在 Cloud 使用 Codex
Use Codex in the cloud at chatgpt.com/codex。
-
在浏览器里打开 Codex
访问 chatgpt.com/codex。你也可以在 GitHub pull request 评论里标记
@codex把任务委托给 Codex，这需要先登录 ChatGPT。 -
设置环境
在开始第一个任务之前，先为 Codex 配置环境。打开 chatgpt.com/codex/settings/environments，按步骤连接 GitHub repository。
-
发起任务并查看进度
环境准备好后，就可以从 Codex interface 发起编码任务。你可以实时查看 logs，也可以让任务在后台运行。
你可以发给 Codex 的任务包括：
Tell me about this projectExplain the top failure modes of my application's architecture.Find and fix bugs in my codebase with minimal, high-confidence changes.
-
审查改动并创建 pull request
任务完成后，在 diff view 里审查改动。你可以继续迭代，也可以直接在 GitHub repository 里创建 pull request。
Codex 也会提供改动预览。你可以直接接受 PR，也可以把分支检出到本地测试：
git fetch git checkout <branch-name>
下一步
常见问题
OpenAI Codex 可以只用 ChatGPT 账号吗？
可以。Every ChatGPT plan includes Codex，所以只要有 ChatGPT 计划就能用，不一定要 OpenAI API key。
用 OpenAI API key 登录时会少什么功能？
可以用 OpenAI API key 通过 API credits 使用 Codex，但部分功能，比如 cloud threads，可能不可用。
Linux 上能安装 Codex app 吗？
当前 Codex app 提供的是 macOS 和 Windows 版本。Linux 用户可以先登记通知；Codex CLI 支持 Linux。