OpenAI Codex 5分钟上手：写代码与调试路径
从项目、线程到Worktree，快速掌握桌面应用的编码与调试工作流。
什么是Codex桌面应用？
OpenAI Codex桌面应用是一个基于Electron的集成开发环境（IDE），它提供了项目侧边栏、线程（Thread）管理、内置终端和代码审查面板。与终端版不同，桌面应用强调可视化体验，支持内联diff（inline diffing）、图片预览和可下载的计划。你可以通过桌面应用、VS Code扩展、CLI或Codex Cloud四种方式使用Codex，本文聚焦桌面应用。
两种工作模式：Local与Cloud
Local模式：任务在你的本地机器上运行，简单直接。
Cloud模式：任务发送到OpenAI的服务器执行。你需要连接GitHub，工作流围绕推送代码到GitHub进行。Cloud模式的好处是你可以关闭电脑后回来继续任务。
核心概念：项目、线程、Worktree
项目（Project）：每个顶级项是一个项目，代表一个代码仓库。
线程（Thread）：每个线程是一个独立的代理（agent）实例。你可以在项目内创建多个线程，每个线程处理一个任务。线程具有持久性——即使硬关闭Codex，重新打开后之前的线程依然存在（缓存于本地）。
Worktree：基于Git worktree的并行工作区。Codex将当前分支克隆到一个独立的Git工作树中，让你可以在同一个代码库上运行两个代理而不会互相干扰。你可以在侧边栏看到不同的worktree，并在每个worktree内创建线程。
实操步骤：从创建线程到调试
1. 打开项目
启动Codex桌面应用后，你会看到项目列表。将你的Git仓库所在文件夹添加为项目。Worktree要求项目必须是Git仓库。
2. 创建线程并描述任务
在项目内，点击新建线程（Thread）。在输入框中描述你的编码任务，例如“为这个API添加身份验证中间件”。Codex会生成代码并以内联diff显示在审查面板中。你可以打开内置终端运行测试，查看结果。
3. 使用Worktree并行开发
当需要同时处理多个任务时，在新建线程时选择Worktree模式。首先选择基础分支（如main或当前分支），然后提交你的提示。Codex会自动创建一个Git worktree，并在其中执行任务。你可以在侧边栏看到所有的worktree，并随时切换。完成后，你可以通过Handoff功能将线程移动回本地（Local），以便检查或合并。
4. 调试与修复
内置终端可以实时运行代码。如果遇到错误，将错误信息复制回原线程（或新线程），Codex会读取并尝试修复。审查面板中的内联diff让你清晰看到每次修改。注意：Worktree仅支持Git仓库，Cloud模式需要提前授权GitHub并确保仓库已推送。
注意事项
桌面应用的线程持久化依赖本地文件（~/.codex/sessions/），服务器不存储对话历史。
Cloud模式需要GitHub连接，且工作流偏向于“推送后远程执行”，与本地模式哲学不同。
Worktree使用Git worktree底层机制，每次创建会生成独立的检出副本，共享元数据。
Codex桌面应用目前仍处于积极开发中，建议关注官方文档获取最新更新。