---
title: "产品入口"
description: "基于官方 Codex 产品教程，帮新手分清 CLI、IDE、App、Web、Windows 和自动化入口各自适合什么任务。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

> [!NOTE]
> 这一章不是安装清单，而是入口选择手册。先判断任务发生在哪里，再决定用 CLI、IDE、App、Cloud、Windows 还是自动化入口。

Codex 有多个产品入口：CLI、桌面 App、Web / Cloud、IDE 扩展、Windows 入口，以及 Worktrees、App Server、Automations、Computer Use 等配套能力。新手不要按“哪个功能最多”选择，而要按执行位置、审查方式和权限边界选择。

```mermaid
flowchart TB
  Task[当前任务] --> Where{任务在哪里发生}
  Where --> Terminal[终端和本地仓库]
  Where --> IDE[编辑器现场]
  Where --> App[多任务审查和可视化工作流]
  Where --> Cloud[异步远程环境]
  Where --> Windows[Windows 开发环境]

  Terminal --> CLI[CLI / codex exec]
  IDE --> Extension[IDE extension]
  App --> Desktop[Codex App]
  Cloud --> Web[Codex Cloud]
  Windows --> Win[Windows App / Windows CLI]
```

## 按任务选入口

<Cards>
  <Card title="终端和脚本" description="本地仓库、命令行工作流、codex exec、CI 前置实验，优先从 CLI 开始。" href="/docs/codex/official/01-products/26-cli-features" />
  <Card title="编辑器现场" description="边读代码边改局部文件，优先看 IDE 安装、功能、设置和命令。" href="/docs/codex/official/01-products/20-ide-install" />
  <Card title="多任务可视化" description="需要 review、worktree、automations、内置浏览器和任务面板，优先看 Codex App。" href="/docs/codex/official/01-products/04-app" />
  <Card title="异步远程任务" description="长任务、云端运行、GitHub 触发或不占用本机资源，进入 Cloud / Web 章节。" href="/docs/codex/official/05-cloud-remote" />
  <Card title="Windows 环境" description="在 Windows 上使用 Codex 时，重点检查 shell、路径、sandbox 和权限差异。" href="/docs/codex/official/01-products/120-windows-codex" />
  <Card title="自动化与工作树" description="需要定时、并行、可回滚分支或 app server，再看 Automations、Worktrees 和 App Server。" href="/docs/codex/official/01-products/35-app-automation" />
</Cards>

## 章节速查

CLI 相关：使用命令行版、CLI 斜杠命令、CLI 功能、CLI 参数、非交互任务。

IDE 相关：安装 IDE 扩展、IDE 功能、IDE 设置、IDE 命令、IDE 斜杠命令。

桌面 App 相关：桌面版、App Server、App 核心、App 设置、Automations、内置浏览器、App 命令、Computer Use、本地运行环境、App Review、App 排障、Worktrees。

Web / Windows 相关：网页版、Windows 版 App、Windows 上使用 Codex。

## 入口判断

如果你每天都在终端里开发，先用 CLI。它最接近仓库现场，也最容易和已有脚本、测试、CI 思维衔接。

如果你主要在 VS Code、Cursor、Windsurf 或同类编辑器里读写代码，先用 IDE 扩展。它适合局部上下文和边看边改。

如果你要同时跟进多个任务、看 diff、用 worktree、跑 automations，先用桌面 App。它的价值在任务管理和审查面，不只是“另一个聊天窗口”。

如果任务很长、可以异步等待、适合云端环境，先用 Web / Cloud。涉及本机密钥、本机 GUI、本机未提交状态时要重新评估。

如果要接 CI、定时任务或脚本，直接看 non-interactive mode、GitHub Action 和 CI/CD auth，不要把交互式 prompt 硬塞进无人值守环境。

## 新手常见坑

- 一次装太多入口，哪个都没跑通。
- 用 Cloud 处理必须依赖本机密钥和本机状态的任务。
- 用 CLI 做需要大量可视化 review 的任务。
- 用 App automations 处理还没手动验证过的 prompt。
- 忽略入口背后的执行环境：本机、云端、远程、worktree 的文件状态可能不同。

## 怎么验收入口选对了

- 能说清 Codex 在哪里读文件、在哪里执行命令、在哪里产生 diff。
- 能在该入口里完成一次只读理解项目任务。
- 能完成一个小改动，并找到 diff 和验证结果。
- 能知道任务失败时该查本地环境、IDE 集成、App 设置、Cloud 环境还是 CI runner。

## 配套从原理到实战

- [App、IDE、CLI、Cloud 怎么选](/docs/codex/understanding/cli-app-ide-cloud)

## 接下来去哪

<Cards>
  <Card title="CLI 功能" description="先理解终端入口能做什么，再决定是否进入非交互任务。" href="/docs/codex/official/01-products/26-cli-features" />
  <Card title="IDE 功能" description="查看编辑器里可用的上下文、命令、审查和交互方式。" href="/docs/codex/official/01-products/21-ide-features" />
  <Card title="Codex App 核心" description="理解桌面 App 的任务面板、review、automation 和多项目工作流。" href="/docs/codex/official/01-products/33-app-core" />
  <Card title="非交互任务" description="把人工对话改成可脚本化、可记录、可失败处理的 codex exec 流程。" href="/docs/codex/official/01-products/28-non-interactive" />
</Cards>

## 官方资料

- [Codex CLI features](https://developers.openai.com/codex/cli/features)
- [Codex App features](https://developers.openai.com/codex/app/features)
- [Codex IDE extension](https://developers.openai.com/codex/ide)
- [Codex Web environments](https://developers.openai.com/codex/cloud/environments)
