OpenAI Codex App 下载与安装教程：macOS、Windows 官方下载及登录配置

OpenAI Codex App 是 Codex 的桌面客户端，可以直接打开本地项目，让 AI 阅读代码、修改文件、运行命令、检查代码差异，并同时处理多个开发任务。

目前 Codex App 已支持 macOS 和 Windows。

本文将介绍：

• Codex App 官方网站
• macOS 版下载方式
• Windows 版下载方式
• 首次启动时的登录与配置
• Codex CLI 配置能否与桌面版共用

一、OpenAI Codex App 官网

Codex App 官方文档：

打开 OpenAI Codex App 官网

官方文档中包含 Codex App 的功能介绍、使用方法、配置选项、安全机制以及 Windows 专属说明。

访问提示 部分地区或网络环境可能无法正常打开 OpenAI 官网、登录页面或相关下载服务。使用前请确认所在地区是否支持 OpenAI 服务，并遵守当地法律法规及 OpenAI 服务条款。

二、Codex Desktop App 下载方法

1. macOS 版下载

macOS 用户可以通过官方安装包直接下载 Codex App：

下载 Codex App macOS 版

下载完成后：

1. 双击打开 Codex.dmg
2. 将 Codex 拖入 Applications 文件夹
3. 在“应用程序”中打开 Codex
4. 按照页面提示完成登录和初始化

如果 macOS 提示无法打开应用，可以进入：

系统设置 → 隐私与安全性

检查是否需要手动允许 Codex 运行。

2. Windows 版下载

Windows 用户可以通过 Microsoft Store 官方页面安装 Codex App：

下载 Codex App Windows 版

安装步骤：

1. 打开 Microsoft Store 下载页面
2. 点击“下载”或“在 Microsoft Store 中查看”
3. 按照微软安装程序提示完成安装
4. 安装完成后，从开始菜单打开 Codex

Windows 版 Codex App 默认使用 Windows 原生运行环境，也可以根据需要配置 PowerShell、命令提示符、Git Bash 或 WSL。

三、安装完成后为什么还不能直接使用

安装 Codex App 只代表客户端已经安装完成。

第一次启动时，通常还需要完成以下步骤：

1. 登录 ChatGPT 账号
2. 授权 Codex 访问本地项目目录
3. 选择需要打开的代码项目
4. 根据任务确认文件修改或命令执行权限
5. 检查本地 Git、Node.js、Python 等开发环境

因此，安装完成后看到登录页面、项目选择页面或权限提示，通常属于正常情况。

四、Codex App 是否必须配置 API Key

通常不需要。

Codex App 当前主要使用 ChatGPT 账号登录。只要你的账号具有相应的 Codex 使用权限，就可以通过 ChatGPT 登录进入桌面应用。

因此，不建议把下面这句话作为通用安装说明：

Codex Desktop App 安装后必须先配置 API Key。

更准确的表达应该是：

Codex Desktop App 安装完成后，需要登录 ChatGPT 账号并完成首次初始化。

API Key 主要用于调用 OpenAI API，和 Codex App 的 ChatGPT 账号登录不是同一套使用方式。

具体可用额度和账号要求可能随 OpenAI 产品政策调整，请以软件内提示和官方页面为准。

五、以前用过 Codex CLI，还需要重新配置吗

如果你以前已经在同一台电脑上使用过 Codex CLI 或 Codex IDE 扩展，Codex App 通常可以读取已有的：

• 登录状态
• Codex 配置
• 项目配置
• 会话历史
• Skills 配置
• MCP 配置

OpenAI 官方说明，Codex App 可以从 Codex CLI 和 IDE 扩展中读取会话历史与配置，因此很多用户不需要从头设置。

但能否直接共享，还取决于你的操作系统和 CLI 安装位置。

六、Windows 用户需要注意 WSL 配置

Windows 版 Codex App 默认使用以下目录保存配置：

%USERPROFILE%\.codex

如果你使用的是 Windows 原生版本 Codex CLI，桌面版与 CLI 通常会使用相同的 Codex 配置目录。

但是，如果你在 WSL 中安装并使用 Codex CLI，WSL 默认使用 Linux 用户目录：

~/.codex

这意味着：

• Windows Codex App 使用 %USERPROFILE%\.codex
• WSL Codex CLI 使用 ~/.codex
• 两者默认不会自动共享登录状态、配置和会话历史

OpenAI 官方文档建议，可以通过同步两个目录，或者在 WSL 中设置 CODEX_HOME，让 WSL CLI 使用 Windows 的 Codex 配置目录。

例如：

export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

将 <windows-user> 替换为你的 Windows 用户名。

如果希望每次打开 WSL 都自动生效，可以把这行配置添加到：

~/.bashrc

或者：

~/.zshrc

不熟悉 WSL 和环境变量的新手，可以暂时不修改。直接在 Codex App 中重新登录通常更加简单。

七、Codex App 首次启动流程

第一次打开 Codex App，可以按照下面的顺序操作。

第一步：登录账号

打开 Codex App，使用支持 Codex 的 ChatGPT 账号登录。

第二步：添加项目

点击添加项目，选择电脑上的代码目录。

建议第一次使用时选择一个测试项目，不要直接打开包含生产环境密钥或重要数据的项目。

第三步：确认项目范围

Codex 会在你选择的项目目录中读取和修改文件。

因此，应该只选择当前任务所需的项目目录，不要直接授权整个磁盘或包含大量无关文件的上级目录。

第四步：检查开发环境

根据项目类型，可能需要提前安装：

• Git
• Node.js
• Python
• Java
• .NET SDK
• GitHub CLI

并不是所有项目都需要安装以上工具。Codex 会根据项目使用的技术栈调用相应命令。

第五步：发送第一个任务

可以先发送一个不会修改代码的任务：

请先阅读当前项目，不要修改任何文件。

告诉我：
1. 这是一个什么项目
2. 使用了哪些主要技术
3. 应该如何启动
4. 主要代码位于哪些目录
5. 当前是否存在明显的配置问题

确认 Codex 能够正常读取项目后，再让它执行代码修改任务。

八、安装后无法使用的常见原因

1. 无法打开登录页面

可能与当前网络环境、浏览器授权或地区可用性有关。

可以检查：

• 浏览器是否能够正常打开 OpenAI 登录页面
• 系统时间是否正确
• 防火墙是否拦截 Codex
• 当前账号是否具有 Codex 使用权限

2. Codex 没有读取已有 CLI 配置

Windows 用户应检查 Codex CLI 是安装在：

• Windows 原生环境
• PowerShell
• WSL
• 其他 Linux 虚拟环境

安装位置不同，使用的配置目录也可能不同。

3. 无法打开项目

检查项目目录是否：

• 已经被删除或移动
• 位于无权限访问的目录
• 位于异常的网络磁盘
• 包含不受支持的文件路径
• 被其他安全软件阻止访问

4. 无法运行 Git 命令

Codex App 的代码差异查看、版本管理和部分恢复功能依赖 Git。

Windows 用户可以在 PowerShell 中检查：

git --version

如果提示找不到命令，需要先安装 Git。

5. 无法运行项目命令

例如 Codex 执行下面的命令失败：

npm install
npm test
python main.py

通常说明对应的开发环境尚未安装，或者没有加入系统环境变量。

九、下载与配置总结

Codex App 的安装流程可以概括为：

打开官方页面
  ↓
下载 macOS 或 Windows 版本
  ↓
安装并打开 Codex App
  ↓
登录 ChatGPT 账号
  ↓
添加本地项目
  ↓
确认文件和命令权限
  ↓
开始使用 Codex

需要特别注意：

• Codex App 通常使用 ChatGPT 账号登录
• 一般不要求用户先配置 API Key
• 已使用 Codex CLI 的用户可能可以直接复用已有配置
• Windows 原生 CLI 与 Codex App 通常共享配置目录
• WSL 中的 Codex CLI 默认不会与 Windows App 自动共享配置
• 第一次使用时，建议先在测试项目中熟悉权限和工作流程

完成安装和登录后，就可以让 Codex 阅读项目、解释代码、修复问题或实现新的功能。