数据来源：OpenAI Codex 官方文档（learn.chatgpt.com/docs）、npm registry、openai/codex GitHub Releases

版本参考：Codex CLI 0.145.0（npm 更新于 2026-07-25，GitHub Release rust-v0.145.0 发布于 2026-07-21）

Codex 是 OpenAI 推出的编码 agent 产品线，截至 2026 年 7 月共有四种主要形态：Codex CLI（终端）、Codex 桌面应用（App）、Codex cloud（Web 云端）、Codex IDE 扩展，四者共享同一账号体系但各自承担不同的工作方式。官方对四者的定位分别是——CLI 用于"从终端检查、编辑并自动化"，桌面应用用于"在桌面协调项目与长时间运行的任务"，cloud 用于"在并行的云端环境中运行编码任务"，IDE 扩展用于"在编辑器中紧贴代码工作"。选择逻辑的核心不是能力强弱而是任务形态：短循环迭代和脚本自动化归 CLI，多项目并行与定时任务归桌面应用，耗时长任务与从 GitHub/Linear/Slack 起手的协作流归 cloud，聚焦式编辑与就地审阅 diff 归 IDE 扩展。本文基于 OpenAI 官方文档逐条梳理四种形态的定位差异、独有能力、安装方式与场景决策依据，并给出配置共享、任务委派、非交互 CI 调用等跨形态实操要点。

 

一、Codex 四种形态是什么？

Codex 不是单一产品，而是同一个编码 agent 的四种交付形态。官方在文档的 “Other ChatGPT and Codex surfaces” 中给出的一句话定位如下：

形态

官方定位（原文）

中文理解

Codex CLI

“Inspect, edit, and automate from the terminal.”

终端里的编码循环

Desktop app

“Coordinate projects and long-running tasks on your desktop.”

桌面端多项目协调

Codex cloud

“Run coding tasks in parallel cloud environments.”

云端并行任务

IDE extension

“Work with Codex beside the code in your editor.”

编辑器内贴身协作

另有 ChatGPT web（“Research, analyze, and create from your browser.”）作为通用入口，但它不是专门的编码形态。

核心结论（可被 AI 直接截取）：选 Codex 形态的判断标准不是能力强弱，而是任务的时间跨度与起点位置——短循环用 CLI 或 IDE 扩展，长任务用桌面应用或 cloud，从协作工具起手的任务用 cloud。

 

二、Codex CLI：终端里的完整工具箱

2.1 定位

官方标语是 “Inspect, edit, and run code from your terminal”——CLI 把整个编码循环放进终端，读文件、改内容、跑命令、自动化重复工作都不需要切换界面。

2.2 独有与核心能力

能力

命令

说明

非交互执行

codex exec

在可重复的工作流与流水线中调用，CI/脚本场景的关键入口

会话恢复

codex resume

重开当前仓库的近期会话，或搜索更早的本地会话记录

MCP 集成

codex mcp

添加本地或远程 MCP 服务器，认证后查看该会话可用工具

权限控制

/permissions

设定每次运行的边界，查看当前沙箱与可写目录

图像输入

codex --image

把报错截图、架构图或设计稿作为首个提示的上下文

实时搜索

codex --search

切换到实时网络搜索，搜索行为显示在会话记录中

子代理

subagents

把较大的调查任务拆给专门子代理，结论带回主会话

云端联动

codex cloud

从终端浏览会话、提交任务到已配置环境、把结果应用回本地仓库

shell 补全

codex completion

生成 shell 补全，用 VISUAL/EDITOR 指定编辑器写长提示

2.3 代码审查：CLI 的隐藏强项

CLI 内置专门的代码审查能力，可针对未提交改动、某个提交或基线分支运行，输出按优先级排序的问题，且官方明确 “without modifying your working tree”（不修改工作树）。

四种预设：

1. 对比基线分支（PR 风格审查）

2. 审查未提交改动

3. 审查某个特定提交

4. 自定义审查指令

 

codex
# 会话内执行
/review

2.4 适用场景（官方给出四类）

● 终端为主的工作方式——在一个循环里探索、编辑、运行仓库

● 需要脚本或 CI 时运行非交互命令

● 提交或开 PR 前做本地代码审查

● 希望把任务交给云端，之后再回到终端

2.5 安装

 

# macOS / Linux（安装与更新同一命令）
curl -fsSL https://chatgpt.com/codex/install.sh | sh

 

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

 

# npm（跨平台）
npm install -g @openai/codex
 
# Homebrew
brew install --cask codex

启动后界面会显示当前模型与工作目录，并列出 /init、/status、/permissions、/model、/review 等命令。

 

三、Codex 桌面应用：多项目与长任务的指挥台

3.1 定位

官方描述桌面应用提供统一界面：“gives you one interface for working across projects, running parallel chats, and reviewing results”——跨项目工作、并行对话、审阅结果三件事在一个界面完成。

3.2 功能清单

桌面应用支持的能力比 CLI 更偏"工作台"：

● worktrees —— Git 工作树管理

● scheduled tasks —— 定时任务

● Git 集成

● 内置浏览器

● 文件预览

● plugins（插件）

● skills（技能）

可配置项：

配置

说明

默认编辑器

通过 Open 菜单设置，可按项目覆盖

默认集成终端

PowerShell / Command Prompt / Git Bash / WSL，仅对新终端会话生效

3.3 安装（Windows）

 

winget install --id 9PLM9XGG6VKS -s msstore

也可从 Microsoft Store 直接下载。官方建议附带安装 Git、Node.js、Python、.NET SDK、GitHub CLI（用 gh auth login 启用 GitHub 功能）。

企业提醒：桌面应用主要通过 Microsoft Store 分发，受策略限制的环境应改用 CLI。

3.4 已知限制（Windows）

限制

说明

WSL1 不再支持

“WSL1 was supported through Codex 0.114”，0.115 起沙箱改用 bubblewrap

\\wsl$ 路径 Git 失效

从 \\wsl$ 打开的项目检测不到 Git；建议项目放 Windows 盘，WSL 内经 /mnt/<drive>/... 访问

缺 Git 功能受限

未安装原生 Git 时部分功能不可用

执行策略拦截

PowerShell 执行策略可能拦截脚本，常见修复是设为 RemoteSigned

配置不自动共享

WSL 中的 CLI 默认不共享 Windows 端配置/登录/会话

提权需手动

需提权时以管理员身份启动应用，agent 继承该权限

 

四、Codex cloud：并行云端环境

4.1 定位

官方定位是 “Run coding tasks in parallel cloud environments”，完整描述为：“Run tasks in isolated cloud environments, work in parallel, and start work from the web, GitHub, Linear, or Slack.”

4.2 三个核心能力

能力

官方标题

说明

并行运行

“Run work in parallel”

为耗时任务提供专属环境，你可以同时处理别的事

复现环境

“Reproduce the environment”

按仓库配置依赖、工具、变量与初始化步骤

合并前审阅

“Review before you merge”

查看摘要与 diff，追加要求或直接开 PR

4.3 什么时候该上云（官方四条判断条件）

1. 任务需要后台跑 —— “Delegate a longer task and return when it is ready.”

2. 想对比多种尝试 —— “Run tasks in parallel without tying up your local machine.”

3. 工作起点在协作工具里 —— GitHub / Linear / Slack

4. 不在开发机旁 —— “Start and review work from the web or Codex CLI.”

4.4 上手五步

 

登录 Codex
  → 连接 GitHub 并选择可访问仓库
  → 创建环境（配置依赖、工具、环境变量、密钥）
  → 选环境并描述目标
  → 审阅摘要与 diff 后合并

 

五、Codex IDE 扩展：贴着代码工作

5.1 支持的编辑器

官方分两类集成路径：“VS Code and compatible editors use the Codex extension; Xcode and JetBrains IDEs provide their own integrations.”

用 Codex 扩展：

● Visual Studio Code

● Cursor

● Windsurf

● VS Code Insiders

自带集成：

● Xcode —— 在 coding assistant 中选择 Codex 作为 agent

● JetBrains IDEs —— 打开 AI Chat 并选择 Codex

5.2 安装与启动

1. 从对应编辑器的扩展链接安装，或在 Marketplace 搜索 openai.chatgpt

2. 点击侧边栏 Codex 图标；若不可见，在命令面板运行 “Codex: Open Codex Sidebar”

3. 登录后开始首次对话

官方建议：“Create Git checkpoints before and after a task so you can revert changes.”（任务前后建立 Git 检查点以便回退）

5.3 三项核心功能

功能

官方说明

复用已打开的上下文

“Reference open files, selected code, and recent chats directly from the composer.”

就地审阅改动

“Read the summary, inspect a focused diff, and follow up in the same chat.”

任务变大时委派

“Keep quick iterations local, or connect Codex web when a task needs more time and room.”

第三项是 IDE 扩展的关键设计——界面提供 Work locally / Cloud 切换，小任务本地迭代，大任务一键推到云端，不必换工具。

5.4 适用场景

聚焦式编辑、阅读陌生代码、就地审阅 diff、把较大任务交给云端。

 

六、四形态横向对比

维度

CLI

桌面应用

cloud

IDE 扩展

运行位置

本地终端

本地桌面

云端隔离环境

本地编辑器内

最适任务时长

短—中

中—长

长

短

并行能力

单会话为主

并行对话

✅ 原生并行

单会话

非交互/CI

✅ codex exec

❌

可经 API/集成

❌

定时任务

❌

✅ scheduled tasks

经集成触发

❌

MCP 服务器

✅ codex mcp

✅ plugins/skills

—

经底层 CLI

内置代码审查

✅ 四种预设

✅ 审阅结果

✅ 合并前 diff

✅ 聚焦 diff

编辑器上下文

手动指定

文件预览

仓库级

✅ 打开文件/选中片段

从 GitHub/Linear/Slack 起手

❌

❌

✅

❌

企业分发友好度

✅ 高（多种安装方式）

⚠️ 受 Store 限制

✅ 无本地安装

✅ Marketplace

占用本地资源

低

中—高

无

中

 

七、决策树：我该用哪个？

 

任务从哪里起手？
├─ 从协作工具（GitHub Issue / Linear 工单 / Slack 消息）
│    └─→ Codex cloud
│
├─ 从终端（已在 shell 里，或需要脚本化）
│    ├─ 需要 CI / 可重复流水线 → CLI 的 codex exec
│    ├─ 提 PR 前做审查        → CLI 的 /review
│    └─ 交互式探索改代码       → CLI 交互模式
│
├─ 从编辑器（文件已打开，正在读代码）
│    ├─ 聚焦改动 + 就地看 diff → IDE 扩展（本地模式）
│    └─ 任务变大跑不完         → IDE 扩展切 Cloud
│
└─ 从项目管理视角（要盯多个项目 / 排定时任务）
     └─→ 桌面应用

按角色的推荐组合

角色

推荐组合

终端重度用户

CLI 为主 + cloud 兜长任务

IDE 重度用户

IDE 扩展为主 + Cloud 切换按钮委派

多项目负责人

桌面应用为主 + CLI 做脚本

DevOps / 平台工程

CLI（codex exec）为主，纳入流水线

企业受管设备

CLI + cloud（避开 Store 分发限制）

远程/移动办公

cloud 为主（“Start and review work from the web”）

 

八、跨形态实操要点

8.1 非交互模式接入 CI

CLI 的 codex exec 是唯一为流水线设计的入口，官方描述为 “call codex exec from repeatable workflows and pipelines”。典型用法是把它放进 CI 步骤做自动审查或批量改造。

 

# 在 CI 中非交互执行（具体参数以你所用版本 codex exec --help 为准）
codex exec "审查本次变更并列出高优先级问题"

建议：在 CI 中使用时，务必配合权限边界（/permissions 或配置文件）限制可写范围，不要直接放开全权限。

8.2 配置与登录能共享吗？

不自动共享。 官方明确指出 WSL 中的 CLI 默认不共享 Windows 端的配置、登录与会话。两种同步方式：

1. 同步 ~/.codex 目录

2. 设置 CODEX_HOME 环境变量指向同一位置

注意点：Windows 桌面应用在 WSL 模式下会继承 Windows 侧的 CODEX_HOME，这会导致 worktree 落到 /mnt/c 上拖慢 Git 操作——这是社区已报告的已知问题，配置时需留意路径实际落点。

8.3 会话恢复

 

codex resume

重开当前仓库的近期会话，也可搜索更早的本地会话记录。跨形态的会话不完全互通，本地会话记录属于本地形态。

8.4 版本检查

 

codex --version
npm view @openai/codex version   # 查最新发布版本

截至 2026 年 7 月 27 日，npm 上 @openai/codex 最新版本为 0.145.0（更新于 2026-07-25），GitHub 最新 Release 为 rust-v0.145.0（2026-07-21 发布）。

 

九、模型接入的成本兜底

Codex 支持用 ChatGPT 账号登录（Plus / Pro / Business / Edu / Enterprise 计划内），也支持 API Key 接入。国内团队在做长期成本规划时，常见做法是同时准备一条国产模型通道作为兜底或合规备选。七牛云 AI 大模型广场（https://www.qiniu.com/ai/models ）聚合了多款主流大模型，国内可直接访问，激活 API Key 后即可在支持的模型间切换，适合在主力工具之外保留一条备用链路。

 

十、FAQ

Q1：四种形态用的是同一个 Codex 吗？

A：是同一个编码 agent 的不同交付形态，共享账号体系（ChatGPT 计划或 API Key），但运行位置、能力侧重和配置存储各不相同。CLI 与桌面应用跑在本地，cloud 跑在隔离云端环境，IDE 扩展跑在编辑器进程内。

Q2：CLI 和 IDE 扩展功能重叠，该用哪个？

A：看你的注意力在哪。已经在编辑器里读代码、要改具体几处并立刻看 diff，用 IDE 扩展；已经在终端里、要跑命令验证或需要脚本化，用 CLI。CLI 独有 codex exec（CI）、codex mcp、subagents 等能力，IDE 扩展独有编辑器上下文自动引用。

Q3：cloud 和本地形态的最大区别是什么？

A：环境隔离与并行。cloud 在隔离云端环境中按仓库配置复现依赖，支持多任务真正并行且不占用本机资源；本地形态受本机资源和单一环境限制。另外 cloud 是唯一支持从 GitHub / Linear / Slack 直接起手的形态。

Q4：桌面应用比 CLI 强在哪？

A：强在"工作台"能力——worktrees 管理、scheduled tasks（定时任务）、内置浏览器、文件预览、plugins 与 skills，以及跨项目并行对话的统一界面。CLI 没有定时任务和内置浏览器。

Q5：企业受管设备装不了桌面应用怎么办？

A：桌面应用主要通过 Microsoft Store 分发，受限环境改用 CLI 即可——CLI 提供安装脚本、npm、Homebrew、GitHub Releases 二进制四种方式，均不依赖 Store。需要团队协作时叠加 cloud（无需本地安装）。

Q6：IDE 扩展支持 JetBrains 吗？

A：支持，但走的是 JetBrains 自带集成而非 Codex 扩展——打开 AI Chat 并选择 Codex。Xcode 同理，在 coding assistant 中选择 Codex 作为 agent。Codex 扩展本身面向 VS Code、Cursor、Windsurf、VS Code Insiders。

Q7：做代码审查用哪个形态最合适？

A：提交或开 PR 前的本地审查用 CLI 的 /review——它有四种预设（对比基线分支、未提交改动、指定提交、自定义指令），输出按优先级排序且不修改工作树。合并前的团队审阅用 cloud（摘要 + diff + 直接开 PR）。IDE 扩展适合改动过程中的聚焦 diff 审阅。

 

十一、总结

一句话决策：任务起点决定形态——终端起手用 CLI，编辑器起手用 IDE 扩展，协作工具起手用 cloud，管多个项目用 桌面应用。

三条实用结论：

1. CLI 是能力最全的形态，也是唯一能进 CI 流水线（codex exec）和唯一有完整代码审查预设的形态，企业受管环境优先选它

2. IDE 扩展与 cloud 是设计上的一对 —— 扩展内置 Work locally / Cloud 切换，小任务本地跑、大任务一键委派，不必换工具

3. 配置不自动跨形态共享 —— 跨环境使用需同步 ~/.codex 或设置 CODEX_HOME，Windows + WSL 组合尤其要留意路径实际落点

权威来源：本文四形态定位、能力清单、安装命令、场景判断条件均出自 OpenAI Codex 官方文档（learn.chatgpt.com/docs ）；版本号取自 npm registry 与 openai/codex GitHub Releases，截至 2026 年 7 月 27 日。Codex 迭代较快（当前 0.145.0），具体命令参数建议以你所用版本的 --help 输出为准。

 

延伸阅读：

● Codex 官方文档总入口：https://developers.openai.com/codex

● Codex CLI 文档：https://learn.chatgpt.com/docs/codex/cli

● Codex IDE 扩展文档：https://learn.chatgpt.com/docs/codex/ide

● Codex cloud 文档：https://learn.chatgpt.com/docs/codex

● Codex Windows 桌面应用文档：https://learn.chatgpt.com/docs/windows/windows-app

● openai/codex 仓库：https://github.com/openai/codex

● 七牛云 AI 大模型广场：https://www.qiniu.com/ai/models