📚AI 编程官方教程中文版
📘 OpenAI Codex理解版 · 从原理到实战

06 · App、IDE、CLI、Cloud 怎么选

很多人一上手就把 4 个入口全装上。真相是不需要 —— 翔宇本人就只用 App + CLI 两件套。看一天怎么过的:

⏱️ 预计阅读 12 分钟 | 🎯 目标:4 个入口不是「谁强谁弱」,是「谁更合你当前的场景

上一篇讲了 Codex 的安全边界(sandbox + approval)。这一篇换一个维度 —— 从你坐在哪、做什么,决定打开哪个入口。 Codex 现在有 4 个表面(surface):CLI、IDE 扩展、App、Cloud。新手最大的错是「选最强的那个」,正确做法是「选最容易验收当前任务的那个」。


🎬 一个真实工作日:App + CLI 两件套足够了

很多人一上手就把 4 个入口全装上。真相是不需要 —— 翔宇本人就只用 App + CLI 两件套。看一天怎么过的:

journey
    title 翔宇的一天 · App + CLI 主战场
    section 早上 · 接活
      App 打开项目 看待办: 5: App
      在 App 里起 Agent 接任务: 5: App
    section 上午 · 多任务并行
      App 同时跑 3 个 Agent 修不同 bug: 5: App
      用 worktree 隔离避免冲突: 5: App
    section 下午 · 自动化
      CLI 写 codex exec 脚本批量改文件: 5: CLI
      CLI 接 CI 自动 review PR: 5: CLI
    section 傍晚 · 长任务
      CLI 一行 codex cloud exec 扔云端跑: 4: CLI
      喝咖啡 看 App 里的进度: 5: App
    section 收工
      App 审 diff 合并: 5: App

💡 观察:翔宇没装 IDE 扩展也很少直接打开 ChatGPT 网页App 是指挥中心 + CLI 是自动化武器,两个搭配把所有场景全包了。

⚠️ 不是劝你照搬翔宇的组合 —— 程序员有程序员的活法(IDE 主场),轻量用户有轻量用户的活法(Cloud 直接用)。 关键是按自己的身份选 1-2 个,而不是「都装上以备不时之需」。


🗺️ 4 个入口的全景图

先把它们摆成一张图。同一个 Codex 引擎(GPT-5.4 / 5.5),外壳不同

flowchart TB
    Engine["🧠 共用一个 Codex 引擎<br/>GPT-5.4 / 5.5 · 1M context · ChatGPT 账号统一"]

    subgraph Local["💻 本地(你的电脑上跑)"]
        CLI["🖥️ Codex CLI<br/>终端原住民"]
        IDE["📝 IDE Extension<br/>VS Code / Cursor / JetBrains"]
        App["🏢 Codex App<br/>多 Agent 指挥中心<br/>macOS 2026-02 / Windows 2026-03"]
    end

    subgraph Remote["☁️ 云端(OpenAI 隔离容器)"]
        Cloud["🌐 Codex Cloud<br/>异步长任务"]
    end

    Engine --> CLI
    Engine --> IDE
    Engine --> App
    Engine --> Cloud

    CLI `<-.跨入口接力.->` Cloud
    IDE `<-.跨入口接力.->` Cloud
    App `<-.跨入口接力.->` Cloud

    style Engine fill:#dcfce7,stroke:#22c55e,stroke-width:2px
    style Cloud fill:#dbeafe,stroke:#3b82f6

🎯 关键事实 1:4 个入口共用同一个账号 + 同一个引擎,可以无缝接力(IDE 起的会话,CLI 用 codex resume 接着跑)。 🎯 关键事实 2:CLI / IDE / App 数据在你本机处理;Cloud 在 OpenAI 隔离容器里跑,专为处理仓库异步设计


📋 4 入口对比矩阵

最实用的一张表。对号入座

维度🖥️ CLI📝 IDE 扩展🏢 App☁️ Cloud
位置本地终端本地编辑器本地桌面应用OpenAI 远程沙箱
最适合脚本 / 自动化 / SSH 远程编辑器内对话 + 文件上下文多 Agent 并行 / Worktrees异步长任务 / 隔离环境
执行位置本地本地 + 可委托云端本地 + 并行 worktree隔离云容器
典型任务CI 跑 Codex / 批量改文件边写代码边问 / 调 bug同时修 3 个 bug / Skills 复用"升级所有依赖" / 跑大重构
是否需联网取决于任务取决于任务取决于任务本身就在云上
用户画像🚀 自动化 / 编排
常和 App 配合
👨‍💻 程序员主场
天天写代码
🚀 多 Agent 编排
常和 CLI 配合
🌱 轻量 / 移动
不想装东西

🎯 你属于哪类用户?按身份选 1-2 个,不是每个都装

新手最大的浪费是「把所有入口都装上」。其实按身份对号入座,1-2 个就够:

你是谁推荐组合为什么
👨‍💻 程序员
天天写代码、改 bug、做 feature
📝 IDE 扩展(主)
+ 偶尔 ☁️ Cloud
编辑器是你的主战场,IDE 扩展把 Codex 嵌在你已经熟悉的 VS Code / Cursor / JetBrains 里 —— 选中代码就能问、文件用 @ 拖进对话。长任务可以一键委托给 Cloud,回 IDE 看 diff
🚀 AI 编程深度玩家
多 Agent 并行、自动化流程、Skills 沉淀
🏢 App + 🖥️ CLI
组合用
App 是多 Agent 指挥中心(worktrees / Skills / Automations),CLI 是脚本化武器(codex exec 进 CI、codex cloud exec 一行扔云)。两个搭配 = 编排能力 + 自动化能力
🌱 轻量用户 / 第一次试
偶尔用一下、手机上用、不想装东西
☁️ Cloud
(通过 ChatGPT 网页 / 手机 App)
不用装任何东西,打开 chat.openai.com 或手机 ChatGPT 就能调 Codex。隔离容器跑你的活儿,地铁上也能发任务。入门成本最低

💡 关键判断:先看你主要工作是什么,再选 1-2 个入口装熟它。 ❌ 不要「我都装上以备不时之需」—— 这只会让你 4 个都用不熟。

⚠️ 常见误区

  • 程序员被「App 看起来更高级」吸引去装 App → 实际上写代码的主战场永远是 IDE
  • 轻量用户跟风装 CLI → 终端命令对非工程师是反效率
  • 「多 Agent」对单 Agent 还没玩转的人意义不大 —— 先把单 Agent 用熟再说

🤔 决策树:我该用哪个?

flowchart TD
    Start["🤔 我要做的事"]
    Q1{"任务时长?"}
    Q2{"在编辑代码吗?"}
    Q3{"要并行多个任务吗?"}
    Q4{"在终端 / SSH 上?"}

    Start --> Q1
    Q1 -->|"超过 30 分钟<br/>不想等"| Cloud["☁️ Cloud<br/>异步跑,去喝咖啡"]
    Q1 -->|"短任务 + 想看着它做"| Q2

    Q2 -->|是| IDE["📝 IDE 扩展<br/>编辑器旁边问"]
    Q2 -->|否| Q3

    Q3 -->|是| App["🏢 App<br/>worktree 并行"]
    Q3 -->|否| Q4

    Q4 -->|是| CLI["🖥️ CLI<br/>终端工作流"]
    Q4 -->|否| IDE

    style Cloud fill:#dbeafe,stroke:#3b82f6
    style IDE fill:#dcfce7,stroke:#22c55e
    style App fill:#fef3c7,stroke:#f59e0b
    style CLI fill:#f3e8ff,stroke:#a855f7

🎯 判断口诀长任务上云、改代码进 IDE、并行用 App、终端走 CLI


🖥️ 什么时候用 CLI · 终端原住民

$ codex
# 进入全屏交互式 TUI(终端用户界面)

$ codex exec "把所有 console.log 替换为 logger.debug"
# 非交互单次执行,适合 CI

$ codex cloud
# 浏览 / 启动云端任务的交互式选择器

$ codex cloud exec "升级 Next.js 到最新版" --attempts 4
# 直接在终端发起云任务,要求 best-of-4(生成 4 个候选选最好的)

$ codex resume
# 恢复之前的会话,不用重新讲上下文

何时用

  • 🚀 CI/CD 自动化:在 GitHub Actions / GitLab CI 里跑 Codex
  • 🔌 SSH 远程开发:连服务器调试,没有图形界面
  • 📜 批量脚本:「把项目里所有过期 API 调用替换为新写法」
  • 快速一次性任务:不需要持续对话的活儿

别用 CLI 的场景

  • ❌ 你需要边看页面边改 UI(用 IDE / App)
  • ❌ 你要并行多个 Agent(用 App)

📝 什么时候用 IDE 扩展 · 编辑器伴侣

支持的编辑器(2026 现状):

编辑器安装方式
🔵 VS Code应用商店搜 "Codex"
🟣 Cursor内置兼容 Codex
🟢 Windsurf兼容
🟠 JetBrains 全家桶(IntelliJ / PyCharm / WebStorm / Rider)JetBrains Marketplace

三档自治模式(在 IDE 里切换):

模式自治程度何时用
💬 Chat只回答解释代码 / 找 bug 原因
🤖 Agent(默认)改文件 + 跑命令,越界问你日常开发 ⭐
🔥 Agent (Full Access)全自治不打扰你完全信任的小任务

何时用 IDE

  • ✏️ 边写代码边问:选中一段代码 → "解释这段在做什么"
  • 📎 文件上下文标记:用 @filename 把任意文件塞进对话
  • 🔄 委托云任务又能在编辑器里看进度:起 Cloud 任务、回 IDE 看 diff
  • 🎨 生成 UI 资产:让 Codex 直接出 SVG 占位图、布局原型

💡 新手强烈推荐IDE 扩展是上手成本最低的入口。你已经有 VS Code,装个扩展登录就能用。


🏢 什么时候用 App · 多 Agent 指挥中心

App 是 2026 年初新上的入口(macOS 2 月、Windows 3 月)。OpenAI 把它定位成 command center(指挥中心)你不再操心「Codex 怎么写代码」,而操心「怎么同时调度多个 Agent」

App 独有的 4 件武器:

flowchart LR
    subgraph App["🏢 Codex App"]
        Worktree["🌿 Worktrees<br/>每个 Agent 一份代码副本<br/>互不踩脚"]
        Skills["🛠️ Skills<br/>把重复多步流程<br/>沉淀成可复用"]
        Auto["⏰ Automations<br/>无人值守干活<br/>(issue 分类 / 报警监控)"]
        Browser["🌐 内置浏览器<br/>验收 UI / 复现 bug"]
    end

    style Worktree fill:#dcfce7,stroke:#22c55e
    style Skills fill:#dbeafe,stroke:#3b82f6
    style Auto fill:#fef3c7,stroke:#f59e0b
    style Browser fill:#f3e8ff,stroke:#a855f7

何时用 App

  • 👥 同时跑 3-5 个 Agent:3 个 bug 一起修,每个独立 worktree(工作树)不冲突
  • 🔁 重复流程做成 Skill:每周做一次"PR review"?做成 Skill 一键调
  • 无人值守任务:CI 失败自动分类、issue 自动打标签、报警自动诊断
  • 🌐 UI 验收:让 Codex 用内置浏览器点几下页面确认 bug 修了

⚠️ 新手别一上来就用 App。先用 IDE 把单 Agent 用熟,再来 App 玩多 Agent。


☁️ 什么时候用 Cloud · 异步长任务

Cloud 在 OpenAI 的隔离容器里跑,2026 年关键改进:

改进价值
🚀 容器缓存中位完成时间降 90%
🔧 自动 setup自动扫描 setup 脚本 + 执行(装依赖 / 准备环境)
🌐 可选联网默认离线 / 配域名白名单可联网
🔐 隔离运行不接触你的本机文件,专为处理仓库设计

何时用 Cloud

  • 任务超过 30 分钟:「升级所有依赖到最新大版本」「重构 X 模块」—— 别本地 hang 着,扔云上
  • 🛡️ 不想本地跑陌生代码:让它在隔离环境装东西、跑脚本
  • 📱 手机上发任务:通过 ChatGPT iOS App 给 Codex 发活儿
  • 🐙 GitHub 集成:在 PR 里直接 @Codex 让它干活

接入方式

# 从 CLI 发起
$ codex cloud exec "升级 Next.js" --attempts 4

# 从 IDE 委托(IDE 扩展里点 "Run on Cloud")

# 从 ChatGPT 网页 / 手机 App
# 直接在对话里 @Codex

💡 典型组合:在 IDE 里写需求 → 委托 Cloud 跑 → 回 IDE 看 diff → 满意就 apply 到本地。


🔁 跨入口接力:同一个任务在不同入口流转

这是 2026 Codex 最被低估的能力。看真实场景:

flowchart LR
    A["💬 ChatGPT 手机 App<br/>地铁上发任务<br/>'明天升级依赖'"]
    B["☁️ Cloud<br/>隔离容器<br/>实际跑升级"]
    C["📝 IDE 扩展<br/>到公司打开 VS Code<br/>看 diff"]
    D["🖥️ CLI<br/>合并到本地分支<br/>git checkout / merge"]
    E["✅ 完成"]

    A --> B --> C --> D --> E

    style A fill:#fef3c7,stroke:#f59e0b
    style B fill:#dbeafe,stroke:#3b82f6
    style C fill:#dcfce7,stroke:#22c55e
    style D fill:#f3e8ff,stroke:#a855f7
接力点关键能力
📱 → ☁️手机发任务,云端实际执行(你不用电脑)
☁️ → 📝在 IDE 里看云任务进度 + 拉 diff 到本地
📝 → 🖥️IDE 起的会话,CLI 用 codex resume 继续
🖥️ → ☁️CLI 里 codex cloud exec 一行扔云

🎯 背后机制:所有入口共用 ChatGPT 账号 + 上下文。你切入口,Codex 不丢记忆


🚫 常见误解 → ✅ 正确理解

❌ 误解✅ 正解
App 最新最强,应该一上来就用App 是多 Agent 编排工具;新手先用 IDE 把单 Agent 用熟
CLI 比 IDE 高级它们各管不同场景;CLI 强在自动化,IDE 强在编辑器集成
Cloud 比本地快短任务本地更快(无网络开销);长任务才上云
不同入口配置要写多份共用一份 ~/.codex/config.toml,CLI / IDE 等共享配置
Cloud 不安全(代码上传)Cloud 是 OpenAI 隔离容器,专为代码任务设计;企业可走 ChatGPT Business 通道
必须在所有入口都装 Codex按需装。新手只用 IDE 就够了

🔍 想再深一层(点击展开)

🛠️ CLI 自动化场景:在 CI 里跑 Codex

CLI 的杀手级用法是非交互模式codex exec),可以塞进任何 CI/CD 流水线:

# .github/workflows/codex-review.yml
name: Codex PR Review
on: pull_request

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Codex
        run: |
          codex exec "review the diff in this PR, output \
            risks and suggestions in markdown"
        env:
          CODEX_API_KEY: ${{ secrets.CODEX_API_KEY }}

典型用法

  • PR 自动 review
  • 每日跑测试覆盖率分析
  • 文档过期检测
  • 安全扫描

📖 来源:Codex CLI Features

🎚️ IDE 三档自治模式详解
模式sandboxapproval适合
💬 Chatread-only任何动作都问探索陌生代码 / 解释代码 / 找 bug
🤖 Agent(默认推荐)workspace-writeon-request日常开发
🔥 Agent (Full Access)danger-full-accessnever你完全信任的小任务

切换技巧

  • 进入陌生项目 → Chat 模式建立认知
  • 开始改代码 → Agent
  • 重复跑相同小任务 → Full Access(但慎用)

⚠️ Full Access 别在生产仓库默认开。它跳过所有审批,一旦 prompt injection 命中就没救。

🌐 Codex Cloud 内部机制

Cloud 实际工作流:

1. 你提交任务(IDE / CLI / 手机)
2. OpenAI 起一个隔离容器
3. 容器拉取你的仓库 read-only 副本
4. setup 阶段:扫描 setup 脚本 + 装依赖(可联网)
5. agent 阶段:Codex 实际干活(默认离线,可显式开网)
6. 任务完成:输出 diff + 测试结果
7. 你拉到本地审查 + apply

安全特性

  • 容器与你本机完全隔离
  • 凭据只在 setup 阶段可见,agent 阶段被擦除
  • 默认 agent 阶段离线,防 prompt injection

📖 来源:OpenAI Codex 升级公告

🆚 GPT-5.4 / 5.5 在 4 个入口的可用性
模型何时上线CLIIDEAppCloud
GPT-5.3-Codex2026-02-05
GPT-5.42026 春
GPT-5.52026 上线后

1M context window(GPT-5.4 起实验支持)也全平台可用。这意味着:

  • 选入口时不用考虑「哪个模型更强」 —— 都一样
  • 真正影响选择的是「场景适配度」

📖 来源:Codex Changelog

📖 术语速查表
英文 / 缩写中文一句话解释
surface表面 / 入口Codex 的不同接入方式(CLI / IDE / App / Cloud)
TUI终端用户界面Terminal User Interface,全屏文字界面
worktree工作树Git 同一仓库多个独立工作目录,避免分支切换冲突
Skills技能可复用的多步工作流,跨项目使用
Automations自动化任务App 的"无人值守"模式:CI 失败自动分类、issue 自动打标签
best-of-NN 选最优生成 N 个候选答案选最好的(CLI 的 --attempts 1-4
ChatGPT iOS AppiPhone 上的 ChatGPT 应用,可用 Codex 发任务
JetBrainsIntelliJ / PyCharm / WebStorm 等编辑器的开发商

📖 官方文档来源:


📝 本章自检

#问题对应章节自检
14 个入口共用什么?分别对应什么场景?🗺️ 全景图 + 📋 对比矩阵
2「升级所有依赖到最新版」这种长任务用哪个入口最合适?为什么?☁️ 什么时候用 Cloud
3跨入口接力的"同一个会话"是怎么实现的?🔁 跨入口接力

过关标准:能用一句话说清 —— "4 个入口共用同一个 Codex 引擎,差别在表面 —— 选入口看场景,不看强弱。"


📚 下一篇


🧭 一句话记住

4 个入口共用同一个 Codex 引擎,差别在表面。
选入口看场景,不看强弱 ——
长任务上云,改代码进 IDE,并行用 App,终端走 CLI。

On this page