📚AI 编程官方教程中文版
官方教程中文版产品入口

使用桌面版 Codex

Codex App 是一个专注的桌面体验,用来并行处理 Codex threads(Codex 线程)。它内置 worktree support(worktre

Codex App 是一个专注的桌面体验,用来并行处理 Codex threads(Codex 线程)。它内置 worktree support(worktree 支持)、automations(自动化)和 Git 功能。

ChatGPT Plus、Pro、Business、Edu 和 Enterprise 套餐都包含 Codex。你可以在官方 pricing 页面了解具体包含内容:

https://developers.openai.com/codex/pricing

官方页面配图

官方页面按平台展示 Codex App 截图。

Windows 截图:

alt        Codex app for Windows showing a project sidebar, active thread, and review pane
lightSrc   /images/codex/windows/codex-windows-light.webp
darkSrc    /images/codex/windows/codex-windows-dark.webp

通用 App 截图:

alt        Codex app window with a project sidebar, active thread, and review pane
lightSrc   /images/codex/app/app-screenshot-light.webp
darkSrc    /images/codex/app/app-screenshot-dark.webp

开始使用

Codex App 支持 macOS 和 Windows。

大多数 Codex App 功能在两个平台上都可用。如果某个功能存在平台差异,官方会在对应文档里单独说明。

1. 下载并安装 Codex App

下载 macOS 或 Windows 版本的 Codex App。如果你使用的是 Intel 芯片 Mac,需要选择 Intel build(Intel 构建版本)。

官方下载入口在 Quickstart 页面:

https://developers.openai.com/codex/quickstart

如果你在等待 Linux 版本,可以在这个表单里登记通知:

https://openai.com/form/codex-app/

2. 打开 Codex 并登录

下载并安装 Codex App 后,打开应用,用 ChatGPT 账号或 OpenAI API key 登录。

如果你使用 OpenAI API key 登录,部分功能可能不可用,例如 cloud threads(云端线程):

https://developers.openai.com/codex/prompting#threads

3. 选择项目

选择一个你希望 Codex 处理的项目文件夹。

如果你以前使用过 Codex app、CLI 或 IDE Extension,会看到之前处理过的项目。

4. 发送第一条消息

选择项目后,确认当前任务选择的是 Local。Local 的意思是让 Codex 在你的机器上工作。

然后发送第一条消息。你可以问 Codex 任何与当前项目或本机有关的问题。官方给了三个示例。

示例任务:了解这个项目

请介绍一下这个项目。

示例任务:在这个仓库里做一个经典贪吃蛇游戏

请在这个仓库里实现一个经典贪吃蛇游戏。

范围和约束:
- 只实现经典贪吃蛇的核心循环:网格移动、蛇身增长、食物生成、计分、游戏结束、重新开始。
- 复用项目现有工具链和框架;除非确实必要,不要添加新依赖。
- UI 保持简洁,并尽量贴合仓库现有样式;不要引入新的设计系统,也不要添加额外动画。

实现计划:
1. 先检查仓库,找到适合加入小型交互游戏的位置,例如已有页面、路由或组件。
2. 实现游戏状态:蛇的位置、方向、食物、分数、计时器。核心逻辑要确定、可测试。
3. 渲染一个简单网格,显示蛇和食物;支持键盘方向键 / WASD。如果项目已有移动端界面,也补充屏幕控制。
4. 如果仓库已有测试工具,为核心游戏逻辑补基础测试,例如移动、碰撞、增长、食物放置。

交付内容:
- 少量命名清晰的文件和改动。
- 简短运行说明:如何启动开发服务器、打开哪个页面。
- 一份手动检查清单:控制、暂停 / 重启、边界碰撞等。

示例任务:用最小且高置信度的改动查找并修复 bug

请在我的代码库里查找并修复 bug,要求改动尽量小,并且只做有把握的修改。

方法要求:
1. 复现:运行测试、lint、build,或者按照仓库已有脚本复现。如果我提供了报错,先复现同一个失败。
2. 定位:根据堆栈、失败测试、日志,找到涉及的最小文件和行号范围。
3. 修复:只做解决问题所需的最小改动,不做重构,也不做无关清理。
4. 证明:添加或更新一个聚焦测试,或者给出一个紧凑复现方式,能证明修复前失败、修复后通过。

约束:
- 不要编造错误,也不要假装运行了无法运行的命令。
- 不要扩大范围:不加新功能,不做 UI 装饰,不改整体样式。
- 如果信息缺失,请说明哪些是从仓库确认的,哪些仍然未知。

输出:
- 先给 3-6 句话总结:哪里坏了、为什么坏、怎么修。
- 然后最多 5 条 bullet:改了什么、在哪里改、证据是什么、风险是什么、下一步是什么。

如果你想获得更多任务灵感,可以阅读 Codex use cases:

https://developers.openai.com/codex/use-cases

如果你是 Codex 新手,建议阅读官方 best practices guide:

https://developers.openai.com/codex/learn/best-practices

使用 Codex App 工作

跨项目多任务

你可以把多个 project threads(项目线程)并排运行,并在它们之间快速切换。

官方对应页面:

https://developers.openai.com/codex/app/features#multitask-across-projects

Worktrees

Codex App 内置 Git worktree 支持,可以把并行代码改动隔离开。

官方对应页面:

https://developers.openai.com/codex/app/worktrees

Computer use

你可以让 Codex 使用 macOS app 来完成 GUI tasks(图形界面任务)、browser flows(浏览器流程)和 native app testing(原生应用测试)。

官方对应页面:

https://developers.openai.com/codex/app/computer-use

审查并交付改动

你可以检查 diffs(差异)、处理 PR feedback(PR 反馈)、stage files(暂存文件)、commit(提交)和 push(推送)。

官方对应页面:

https://developers.openai.com/codex/app/review

终端和操作

你可以在每个 thread(线程)里运行命令,并启动可重复的 project actions(项目动作)。

官方对应页面:

https://developers.openai.com/codex/app/features#integrated-terminal

App 内浏览器

你可以打开渲染后的页面、留下 comments(评论),或者让 Codex 操作本地浏览器流程。

官方对应页面:

https://developers.openai.com/codex/app/browser

图片生成

你可以在处理代码和资源的同时,在同一个 thread 里生成或编辑图片。

官方对应页面:

https://developers.openai.com/codex/app/features#image-generation

Automations

你可以安排 recurring tasks(周期性任务),或者唤醒同一个 thread 来做持续检查。

官方对应页面:

https://developers.openai.com/codex/app/automations

Skills

你可以在 App、CLI 和 IDE Extension 之间复用 instructions(指令)和 workflows(工作流)。

官方对应页面:

https://developers.openai.com/codex/app/features#skills-support

侧边栏和 artifacts

你可以跟踪 plans(计划)、sources(来源)、task summaries(任务摘要)和生成文件预览。

官方对应页面:

https://developers.openai.com/codex/app/features#richer-outputs-and-artifacts

Plugins

你可以连接 apps(应用)、skills(技能)和 MCP servers(MCP 服务器),扩展 Codex 的能力。

官方对应页面:

https://developers.openai.com/codex/plugins

IDE Extension sync

你可以在 App 和 IDE 会话之间共享 Auto Context(自动上下文)和 active threads(活跃线程)。

官方对应页面:

https://developers.openai.com/codex/app/features#sync-with-the-ide-extension

需要帮助

如果遇到问题,请访问 troubleshooting guide(故障排查指南):

https://developers.openai.com/codex/app/troubleshooting

On this page