24. Codex 桌面应用

本节目标：搞懂 ChatGPT 桌面应用的 Codex 集成—界面怎么分区、项目怎么选、三种运行模式怎么挑、怎么用 Git 检查点保护改动、怎么设自动化任务。

自 v0.144.0 起，Codex 正式整合进 ChatGPT 桌面应用。你不用再单独装一个 Codex App，打开 ChatGPT 桌面版就能用。官方把宝压在这个入口上—它的功能反而是所有入口里最满的。

桌面应用是什么定位

很多人以为桌面应用是 CLI 的简化版，给不会命令行的人用的。这个判断在 Codex 身上是错的。

桌面应用是同一个 Codex 换了个「为并行和可视化打造的工作台外壳」。它跟 CLI、IDE 扩展跑的是同一个 Codex，共享同一份 AGENTS.md、同一套 MCP 配置、同一批 Skills。但图形界面让它多了几样 CLI 给不了的东西：可视化审阅、内置终端、一键 Actions、定时自动化。

Note

桌面应用只有 macOS 和 Windows，Linux 暂不支持。登录优先用 ChatGPT 账号—用 API key 登录部分功能会受限。

界面三栏布局

打开桌面应用，画面大致分三竖条。记住这条主线：左边挑去哪、中间下指令、右边看结果。

左边栏：导航总台

左边栏从上到下是你管理一切的入口：

新线程：开一个全新任务，用得最勤的按钮
搜索：翻历史对话和项目记录
插件：给 Codex 加外部能力，比如浏览器、GitHub
自动化：让 Codex 定时自动跑任务
项目：你绑定的代码仓库或文件夹列表
普通对话：不绑项目的纯聊天

Tip

项目（Project）和普通对话（Chat）要分清。项目绑定到你电脑上的具体文件夹，Codex 能读文件、改代码、跑命令。普通对话不挂任何项目，适合查资料、做调研。

中间区：对话和下指令

中间主工作区是核心。上半是 Codex 的对话流—它读了啥、改了啥、跑了啥命令一路滚下来。底部是输入框，这一排藏着几个关键开关：

模式选择：Local / Worktree / Cloud，决定这个线程在哪跑
模型选择：切当前用哪个模型，会话中途也能换
权限选择：审批策略，控制 Codex 动手前问不问你

右边面板：看结果

右边面板默认可能收着，点右上角的面板图标展开。最常用的三样：Diff 审阅、内置终端、预览。

项目选择与管理

第一次用，先加一个项目。在左边栏点新建项目，选一个 Git 仓库文件夹。Codex 只会在这个目录内工作。

项目绑定文件夹后，Codex 能基于整个代码仓库理解上下文，不是普通的问答聊天。多个项目在左边栏列表里切换，互不干扰。

Warning

如果你的项目不是 Git 仓库，审阅面板和 Worktree 模式都用不了。先 git init 或换个已有的仓库。

三种运行模式

发第一条消息前，输入框下方让你选运行模式。这是桌面应用里最该一次搞懂的设定。

模式	在哪跑	改动落在哪	啥时候用
Local	你本机，当前项目目录	直接改你的工作目录	日常开发，想立刻看到结果
Worktree	你本机，独立 Git worktree	隔离的副本里，不碰主目录	试新想法、多任务并行不打架
Cloud	OpenAI 云端隔离环境	云上沙箱，结果以 PR 回来	长任务挂后台，不占本机

Local 和 Worktree 都跑在你自己电脑上，只有 Cloud 是远程的。

Worktree：并行不打架的命根子

Worktree 给每个任务复印一套完整的代码副本，各改各的，谁也动不到别人那份。底层就是 git worktree。

几个必须知道的事实：

只能用在 Git 仓库里—没 Git 玩不转
只继承 Git 里的文件—.gitignore 里的东西（.env、node_modules）不会跟着进去
存在 $CODEX_HOME/worktrees 下，默认 detached HEAD 状态，不污染你的分支
默认保留最近 15 个，旧的自动删（删前存快照，能恢复）

Tip

想把一个线程在 Local 和 Worktree 之间挪，用线程头部的 Hand off 按钮。Codex 自己处理底层 Git 操作。

可视化审阅与 Git 检查点

这是图形界面相对终端最直观的提升。Codex 改完代码，审阅面板把它变成能点、能逐行批注、能按块接受或回滚的可视化界面。

审阅面板的核心能力

默认看未提交的改动：反映整个 Git 仓库的状态，不只是 Codex 改的
能切看的范围：未提交改动、跟基线分支比、只看最近一轮改了啥
逐行内联批注：鼠标悬到某一行，点 + 按钮写反馈，Codex 照着改
按粒度暂存或回滚：整份 diff、单个文件、单个代码块三种粒度

Git 检查点

审完满意了，直接在应用里 commit、push、建 Pull Request，不用切终端。这就是 Git 检查点—Codex 的改动在你点头之前都待在副本里，你审完确认了才落地。

Codex 还支持 /undo 命令（需在 config.toml 里开 features.undo = true），通过 git ghost 快照让你随时撤销最近的改动。

# 开启 undo 支持
[features]
undo = true

Warning

要在应用里处理 GitHub 上的 PR 评论，机器上得装好并登录 GitHub CLI（gh）。跑一句 gh auth login 授权，否则 PR 上下文可能加载不出来。

内置终端与 Actions

内置终端

每个线程都自带一个内置终端，工作目录就是当前项目或 worktree。你在里头跑 git status 或 npm test，看到的就是 Codex 正在改的那一份文件。Codex 还能读这个终端的输出，帮你分析构建为什么挂了。

Actions

老敲同一串命令太烦。桌面应用让你把常用命令存成 Action，变成窗口顶部一个一键按钮。配置存在项目根目录的 .codex 文件夹里，能提交进 Git 全队共享。

# .codex/setup.sh（新建 worktree 时自动跑）
npm install
npm run build

设置脚本是「新建 worktree 时自动跑」的，专治 worktree 缺依赖的问题。Actions 是「你手动点着跑」的，两者搭配使用。

自动化任务

Automations 让 Codex 按时间表自动跑任务—定时、每天、每周都行。

几个实用场景：

每日代码库简报：分析最近提交，生成一份「昨天改了啥」的摘要
遥测错误监控：定期检查报错，试着自动修
线程自动化：让某个线程定时醒来继续长期任务，保留上下文

Note

Automations 要正常跑，得保持应用开着、对应项目在磁盘上可用。任务结果会添加到收件箱。

快捷键速查

macOS 上最该记的几个（Windows 键位看本机 Settings > Keyboard Shortcuts 面板）：

快捷键	作用
`Cmd + K` 或 `Cmd + Shift + P`	打开命令菜单，啥都能从这搜
`Cmd + N`	新建线程
`Cmd + J`	切换内置终端
`Cmd + Option + B`	切换 Diff 审阅面板
`Cmd + B`	切换左边栏
`Cmd + G`	搜历史线程
`Cmd + ,`	打开设置
`Ctrl + L`	清空终端（不是 `Cmd + K`）

Tip

记不住一堆键就先记 Cmd + K—命令菜单啥都能搜。斜杠命令里 /status 看用量、/review 开审查最值钱。

小结

定位：不是 CLI 的简化版，是同一个 Codex 套了个为并行和可视化打造的工作台外壳
三栏布局：左边栏挑去哪、中间下指令、右边看结果；项目能动代码、普通对话只闲聊
三种模式：Local 直改主目录、Worktree 给每个任务隔离副本、Cloud 外包到云
Git 检查点：审阅面板逐行批注、按块回滚，满意了再 commit、push、开 PR
CLI 给不了的：可视化审阅、共享环境内置终端、一键 Actions、定时 Automations
快捷键：先记 Cmd + K 和 Cmd + N，Windows 键位看本机设置面板

下一章讲 IDE 扩展—把 Codex 塞进 VS Code、Cursor、Windsurf 这些编辑器里，不用切窗口就能用。