AI帮助文档 main codex/setup-codex-app.md

title: 安装和登录 Codex App description: 面向新手说明 Codex App 的桌面入口、安装登录、项目选择、运行模式和第一次安全使用。 keywords:

  • Codex
  • Codex App
  • OpenAI Codex

安装和登录 Codex App

Codex App 是 OpenAI Codex 的桌面应用入口，适合在一个窗口里管理多个项目、多个线程和不同工作方式。它和 Codex CLI 都能在本地项目里帮你读代码、改代码、运行命令，但入口不同：CLI 在终端里使用，App 在桌面界面里使用。

本文只讲 Codex App 的入门使用，不展开 Git、内置终端、内置浏览器、自动化等高级功能。

适合什么时候用 App

如果你刚开始使用，可以这样理解：

入口 更适合
Codex CLI 在终端里快速处理当前目录、配合脚本或命令行习惯使用。
Codex App 在桌面界面里切换项目、管理多个线程、使用 Local 或 Worktree 隔离任务。

如果你正在按 ARAI/API 中转站和 CC Switch 路线配置本地工具，优先看 安装和登录 Codex CLI。如果你想用桌面窗口管理 Codex 线程，再看本页。

安装地址

Codex App 支持 macOS 和 Windows。下面直接列出当前可用下载地址，不需要再打开 OpenAI 官方文档站查找：

  • macOS Apple Silicon：https://persistent.oaistatic.com/codex-app-prod/Codex.dmg
  • macOS Intel：https://persistent.oaistatic.com/codex-app-prod/Codex-latest-x64.dmg
  • Windows：https://get.microsoft.com/installer/download/9PLM9XGG6VKS?cid=website_cta_psi

这些地址可能依赖海外 CDN、Microsoft Store 或当前网络环境。国内网络打不开时，不要卡在 App 下载上，优先回到 安装和登录 Codex CLI，先用 npm 国内镜像安装 CLI，再通过 ARAI/API 中转站和 CC Switch 跑通本地调用。

安装和登录

  1. 从上面的地址下载适合你系统的 Codex App。
  2. 安装完成后打开 Codex App。
  3. 使用 ChatGPT 账号或 OpenAI API Key 登录。
  4. 如果你使用的是 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 等计划，通常可以直接使用计划内包含的 Codex 能力。具体额度和功能以官方当前说明为准。

如果你用的是 API Key 登录，某些依赖 ChatGPT 工作区、云端环境或账户权益的功能可能不可用。如果你的网络无法稳定访问 ChatGPT 或 OpenAI，App 登录和 Cloud 功能也可能受影响，此时本地 CLI + ARAI/API 中转站路线更适合国内用户先跑通。

选择项目

登录后，Codex App 会让你选择一个项目文件夹。这个项目就是 Codex 当前要理解和操作的代码目录。

建议新手先选择一个自己熟悉、可以随时用 Git 撤回改动的项目。不要一开始就选择包含大量私人文件或多个无关仓库的上级目录。

选择运行模式

创建或进入线程时，Codex App 可能会让你选择运行模式：

模式 简单理解 新手建议
Local 直接在当前项目目录工作。 适合阅读、解释、小改动。
Worktree 在 Git worktree 里隔离改动。 适合尝试新功能或并行任务。
Cloud 在远程云端环境运行。 先确认账号、工作区和环境权限。

Local 和 Worktree 都是在你的电脑上运行。Cloud 依赖云端环境，不等同于本地 CLI 加中转站的路线。

第一个安全请求

第一次使用 App 时，不要马上让 Codex 大规模改项目。可以先发送：

请先阅读这个项目的 README 和目录结构，告诉我这个项目是做什么的。先不要修改文件。

这个请求只让 Codex 阅读和解释，适合确认 App 是否选中了正确项目，也能观察它如何引用文件和说明结论。

使用 ARAI/API 中转站时注意

ARAI/API 中转站和 CC Switch 路线更适合本地 Codex CLI 工作流。如果你在 Codex App 里选择 Local 模式，部分本地配置、MCP 或 Skills 可能和 CLI 有共同语境；但 App 的 Cloud 模式不等同于把本地中转站配置搬到云端。

如果目标是先跑通 ARAI 和 CC Switch，请按 安装和登录 Codex CLI 里的路径验证。

国内网络打不开时

如果 App 下载、登录或 Cloud 功能打不开，按这个顺序处理：

  1. 先确认 Codex CLI 能否通过 npm 国内镜像安装。
  2. 再确认 https://ai.feinian.net、ARAI API Key 和订阅状态是否正常。
  3. 使用 CC Switch 基础用法 把 ARAI 配置应用到 Codex CLI。
  4. 回到终端运行 codex，用小请求验证连接。
  5. 等网络条件允许时，再尝试 App、ChatGPT 登录或 Cloud 功能。

不要把 App 下载成功当成唯一目标。对国内用户来说，更重要的是先让本地 CLI 能稳定调用可用的模型服务。

验证结果

安装和登录完成后，确认：

  • Codex App 可以正常打开。
  • 已经选中正确的项目文件夹。
  • 线程模式符合你的预期，例如 Local 或 Worktree。
  • 第一个请求没有要求它修改文件。
  • 如果使用 Cloud，已经确认它使用的是你期望的账号、工作区和云端环境。

常见问题

App 和 CLI 可以一起用吗

可以。它们是 Codex 的不同入口。CLI 更偏终端和脚本，App 更偏桌面线程管理和可视化工作流。

App 里选 Local 就等于 CLI 吗

不完全等于。Local 模式和 CLI 都是在本机项目里工作，但 App 还有桌面线程、项目列表、Worktree、Git 面板等界面能力。

Cloud 能直接使用我的本地中转站配置吗

不要默认这样理解。Cloud 是远程环境，可能需要 ChatGPT 账号、工作区和云端环境配置；本地 ARAI/API 中转站路线更适合先用 CLI 验证。

相关页面