OpenAI Codex 中文教程

Codex App

你的 Codex 指挥台

Codex App 是一个高度聚焦的桌面端工作台,适合并行处理多个 Codex 线程,并内置了工作树支持、自动化和 Git 功能。

ChatGPT Plus、Pro、Business、Edu 和 Enterprise 计划都包含 Codex。更多信息见 包含内容

Codex App 窗口,显示项目侧边栏、活动线程和评审面板 Codex App 窗口,显示项目侧边栏、活动线程和评审面板

开始使用

先完成安装、登录和项目选择,再让 Codex 以 Local 模式在你的机器上开始工作。

  1. 1

    下载并安装 Codex App

    Codex App 支持 macOS 和 Windows。

    大多数 Codex App 功能都可在两个平台上使用;平台特有的例外会在相关文档中说明。

    下载 macOS 或 Windows 版本。如果你使用的是 Intel 芯片的 Mac,请选择 Intel 构建版本。

  2. 2

    打开 Codex 并登录

    安装完成后,打开 Codex,并使用你的 ChatGPT 账号或 OpenAI API key 登录。

    如果你使用 OpenAI API key 登录,某些功能可能不可用,例如云端线程

  3. 3

    选择项目

    选择一个希望 Codex 参与工作的项目文件夹。

    如果你以前已经用过 Codex App、CLI 或 IDE 扩展,这里也会显示你过去处理过的项目。

  4. 4

    发送第一条消息

    选好项目后,确认已选中 Local(本地模式),让 Codex 在你的机器上工作,然后发送第一条消息。

    你可以询问 Codex 关于项目的问题,也可以让它帮你处理电脑上的一般性开发任务。下面是一些示例:

    告诉我这个项目是做什么的

    在这个仓库里实现一个经典 Snake 游戏

    以最小且高置信度的改动修复我代码库里的 bug

    如果你需要更多灵感,可以查看Codex 用例;如果你刚开始使用 Codex,建议先读最佳实践指南

使用 Codex App

从并行线程、Git 评审到工作树、自动化和本地环境,这些都是 Codex App 中最常用的核心能力入口。

跨项目多任务处理

并排运行项目线程,并在它们之间快速切换。

查看详情

工作树

通过内置 Git worktree 支持,让并行代码改动彼此隔离。

查看详情

远程连接

使用 ChatGPT mobile app 在已连接主机上启动、引导、审批和检查 Codex 工作。

查看详情

计算机操作

让 Codex 操作 macOS 应用,处理 GUI 任务、浏览器流程和原生应用测试。

查看详情

应用截图

把最前方的 Mac 应用窗口连同截图和可用文本发送给 Codex。

查看详情

评审并交付改动

检查 diff、处理 PR 反馈、暂存文件、提交并推送。

查看详情

终端与动作

在每条线程中运行命令,并启动可重复的项目动作。

查看详情

内置浏览器

打开渲染后的页面、留下评论,或让 Codex 操作本地浏览器流程。

查看详情

Chrome 扩展

添加 Chrome 插件,让 Codex 在你管理网站审批的前提下处理已登录浏览器任务。

查看详情

图片生成

在线程中生成或编辑图片,同时处理周边代码与素材。

查看详情

自动化

安排重复任务,或唤醒同一线程执行持续检查。

查看详情

技能

在 App、CLI 和 IDE 扩展之间复用指令与工作流。

查看详情

侧边栏与 artifact

跟踪计划、来源、任务摘要和生成文件预览。

查看详情

插件

连接应用、技能和 MCP server,扩展 Codex 能做的事。

查看详情

与 IDE 扩展同步

当应用和 IDE 指向同一个项目时,共享 Auto Context 和活动线程。

查看详情

需要帮助?参见故障排查指南