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

通常不需要。但是由于网络限制部分地区用户建议首选中转api,比如：DKAPI - AI API Gateway

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

Codex Desktop 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 阅读项目、解释代码、修复问题或实现新的功能。