快速开始
在 IDE、CLI 或云端开始使用 Codex
每个 ChatGPT 套餐都包含 Codex。
你也可以使用 OpenAI API 密钥登录,并通过 API credits 使用 Codex。
设置
Codex App 支持 macOS(Apple Silicon),并提供单独的 Windows 版本。
- 1
- 2
打开 Codex 并登录
下载安装完成后,打开 Codex,并使用你的 ChatGPT 账号或 OpenAI API 密钥登录。
如果你使用 OpenAI API 密钥登录,某些功能可能不可用,例如云端线程。
- 3
选择项目
选择一个你希望 Codex 参与工作的项目文件夹。
如果你以前用过 Codex App、CLI 或 IDE 扩展,这里还会显示你之前处理过的项目。
- 4
发送第一条消息
选好项目后,确认已选中 Local(本地模式),让 Codex 在你的机器上工作,然后向 Codex 发送第一条消息。
你可以询问 Codex 关于这个项目的问题,也可以让它帮助处理你电脑上的一般性开发任务。下面是一些示例:
告诉我这个项目是做什么的
在这个仓库里实现一个经典的 Snake 游戏
以最小且高置信度的改动修复我代码库里的 bug
如果你需要更多灵感,可以查看探索;如果你刚开始使用 Codex,建议先读最佳实践指南。
进一步了解 Codex App →
为你的 IDE 安装 Codex 扩展。
- 1
- 2
打开 Codex 面板
安装完成后,Codex 扩展会出现在侧边栏,与其他扩展一起显示。
它可能被折叠在隐藏区域里;如果你愿意,也可以把 Codex 面板移动到编辑器右侧。
- 3
登录并开始你的第一个任务
使用 ChatGPT 账号或 API 密钥登录即可开始。
Codex 默认以 Agent mode(智能体模式)启动,这样它就可以读取文件、运行命令,并在你的项目目录中写入改动。
告诉我这个项目是做什么的
在这个仓库里实现一个经典 Snake 游戏
以最小且高置信度的改动修复我代码库里的 bug
- 4
使用 Git 检查点
Codex 可能会修改你的代码库,因此建议你在每个任务前后都创建 Git 检查点,以便在需要时轻松回滚。
如果你刚开始使用 Codex,建议先读最佳实践指南。
进一步了解 Codex IDE 扩展 →
Codex CLI 支持 macOS、Windows 和 Linux。
- 1
安装 Codex CLI
你可以使用 npm 或 Homebrew 安装:
npmnpm install -g @openai/codexHomebrewbrew install codex - 2
运行 codex 并登录
在终端中运行 codex 即可开始。
系统会提示你使用 ChatGPT 账号或 API 密钥登录。
- 3
让 Codex 在当前目录工作
完成认证后,你就可以让 Codex 在当前目录中执行任务。
下面这些示例可以作为第一批任务的起点:
告诉我这个项目是做什么的
在这个仓库里实现一个经典 Snake 游戏
以最小且高置信度的改动修复我代码库里的 bug
- 4
使用 Git 检查点
Codex 可能会修改你的代码库,因此建议你在每个任务前后都创建 Git 检查点,以便在需要时轻松回滚。
如果你刚开始使用 Codex,建议先读最佳实践指南。
进一步了解 Codex CLI →
在 chatgpt.com/codex 的云端使用 Codex。
- 1
在浏览器中打开 Codex
你也可以在 GitHub 拉取请求评论中
@codex,把任务委派给 Codex。 - 2
- 3
启动任务并监控进度
环境准备好后,你可以从 Codex 界面 发起编码任务。
你可以通过查看日志实时监控进度,也可以让任务在后台运行。
告诉我这个项目是做什么的
解释我这个应用架构中最主要的失败模式
以最小且高置信度的改动修复我代码库里的 bug
- 4
审查改动并创建拉取请求
任务完成后,在 diff 视图中审查建议的改动。你可以继续迭代结果,也可以直接在 GitHub 仓库中创建拉取请求。
如果你想先在本地验证改动,也可以先把对应分支检出下来进行测试:
进一步了解 Codex 云端 →在本地检出分支git fetch git checkout <branch-name>