Appearance
04 · 四种入口与界面
📚 系列导航：上一篇 03 核心概念 把代理循环、沙箱、审批讲透了。这一篇认全四副面孔，再把快捷键焊进肌肉记忆。
01 四种入口
| 入口 | 形态 | 跑在哪 | 适合谁 |
|---|---|---|---|
| 桌面 App | 独立应用，图形界面 | 你本机 | 不想碰命令行、喜欢可视化 diff |
| CLI | 终端里敲 codex | 你本机 | 习惯终端、要自动化 |
| IDE 扩展 | VS Code / JetBrains 侧边栏 | 你本机 | 泡在编辑器里写代码 |
| 云端 Web | 浏览器开 chatgpt.com/codex | 云端沙箱 | 长任务挂后台、并行跑 |
TIP
配置能打通——你写的 AGENTS.md、定义的 Skill，在桌面 App / CLI / IDE 扩展之间复用。四种入口互不冲突，完全可以在同一天以不同搭配使用。
02 桌面 App
特点： 图形界面、可视化看 diff、多任务并排跑。每个会话自动用 Git worktree 隔离，项目 A 的改动不会污染项目 B 的工作区。
安装： 去 chatgpt.com/codex 下载对应平台包。Mac 注意分 Intel / Apple Silicon。
入口： 打开后选项目文件夹，确认左下角选 Local（本机干活），别选 Cloud。
独特工作流——「主控台」模式： 桌面 App 最适合当你在整块时间里的主战场——打开它，左边跑着项目重构，右边开一个快速探索的会话，中间实时看 diff。视觉反馈比终端直接刷屏直观得多。
与 CLI 的文件系统互通： 桌面 App 和 CLI 共享同一套 ~/.codex/ 配置目录。你在桌面 App 里建的 Skill，CLI 会话也能用；CLI 里写进 AGENTS.md 的规矩，桌面 App 进来自动读到。无缝切换。
03 CLI
特点： 功能最全、跨平台无死角、适合脚本化和自动化。与原版 Claude Code 的终端原生体验对标。
启动： cd /path/to/your-project && codex
非交互模式——最有用的隐藏武器：
bash
codex -p "给 src/main.py 的所有函数补上类型注解"干完就退，不会保持在交互模式等你。适合场景：
- 加到 CI 脚本里：跑测试前让 Codex 补一个漏掉的测试
- 加到 Git hooks 里：提交前自动审一遍 diff
- 批量任务：写个 Shell 脚本，循环跑多个项目的批量修改
与桌面 App 的切换节奏： 很多开发者的日常是「CLI 快速提问 + 桌面 App 深度任务」。CLI 里 Esc 刹车看一眼输出，搞不定的活 clear 了切到桌面 App 的大屏继续。
04 IDE 扩展
特点： 集成在编辑器里，选中代码自动喂上下文，diff 直接弹在编辑器里。
支持的 IDE：VS Code、Cursor、Windsurf、JetBrains 全家桶（IntelliJ IDEA / PyCharm / WebStorm 等）。
安装： 在扩展市场搜索 Codex，认准 OpenAI 官方扩展。
独特工作流——「选中即上下文」： IDE 扩展会自动把你当前打开的文件列表和选中的文本范围当成上下文带进去。在 VS Code 里你光标选中哪几行，Codex 就知道你说的是那几行，不用你再描述。
最佳配合：
- 日常编码：IDE 扩展 + 桌面 App 双开，IDE 里专注改代码，桌面 App 里跑长任务
- Codex 改完的 diff 直接在编辑器里以行内标注显示，比 CLI 的终端打印清晰很多
05 云端 Web
特点： 任务在 OpenAI 云沙箱里跑，高速且每次新克隆 GitHub 仓库，干完改分支推给你。关掉网页它继续跑。
适合：
- 并行跑多个任务——本地桌面 App 跑着一个，云端再挂三个
- 改本地没克隆的仓库——给个 GitHub 链接就开工
- 不想配环境——云端沙箱自带常用工具链
前提： 需要 ChatGPT Plus/Pro 订阅，且有个 GitHub 仓库。
注意： 云端 Web 默认自动接受编辑（不会弹审批），所以任务描述务必写具体——范围约束不到位，它可能在你不注意的地方改了东西。
06 界面三要素与快捷键
界面三要素
- 输入框：最底下，打字、贴代码、敲特殊命令全在这儿
- 状态行：显示当前目录、后台任务、模式提示
- 模式提示：当前权限模式（
workspace-write/read-only等）
核心快捷键
| 快捷键 | 作用 |
|---|---|
Esc | 中断 Codex 当前回答或工具调用 |
Ctrl+C | 中断；空输入框时第一次清输入、第二次退出 |
Ctrl+D | 退出会话 |
Ctrl+L | 重绘屏幕 |
↑ / ↓ | 翻命令历史 |
/ | 斜杠命令入口 |
特殊前缀
| 符号 | 作用 | 示例 |
|---|---|---|
@ | 点名文件 | @src/auth.ts 这里的逻辑有问题吗？ |
/ | 斜杠命令 | /model、/clear、/plan |
多行输入
Enter 默认是发送。要换行：\ + Enter 在任何终端都行，Ctrl+G 开编辑器写长指令。
07 四种入口的典型搭配方案
| 角色 | 桌面 App | CLI | IDE 扩展 | 云端 Web |
|---|---|---|---|---|
| 日常开发者 | 主控台跑深度任务 | 快速提问和脚本 | 编码时随时调 | 不常用 |
| 运维/DevOps | 偶尔用 | 主力（脚本/非交互） | 不常用 | 跑并行长任务 |
| 独立开发者全栈 | 审 diff 和并行 | 多项目管理 | 写前端时常用 | 打包/测试挂云上 |
| 纯小白 | 主力（图形界面最稳） | 不熟悉 | 可选 | 出问题才用 |
08 小结
| 入口 | 最适合场景 | 独特优势 |
|---|---|---|
| 桌面 App | 图形界面、可视化审阅、并行多任务 | 可视化 diff，多会话并排 |
| CLI | 终端流、自动化、跨平台 | 非交互模式 -p |
| IDE 扩展 | 编辑器集成、选中即上下文 | 选中代码自动喂上下文 |
| 云端 Web | 长任务挂后台、并行、免安装 | 关网页继续跑，不占本机 |
NOTE
下一篇：05 提示词四件套：把需求说清楚，Codex 不跑偏。