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 和活动线程。

查看详情 →

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