OpenAI Codex App 下载与安装教程：macOS、Windows 官方下载及登录配置 OpenAI Codex App 是 Codex 的桌面客户端，可以直接打开本地项目，让 AI 阅读代码、修改文件、运行命令、检查代码差异，并同时处理多个开发任务。 目前 Codex App 已支持 macOS 和 Windows。 Codex CLI 配置能否与桌面版共用 一、OpenAI Codex App 官网 Codex App 官方文档： 打开 OpenAI Codex App 官网 官方文档中包含 Codex App 的功能介绍、使用方法、配置选项、安全机制以及 Windows 专属说明。 访问提示 部分地区或网络环境可能无法正常打开 OpenAI 官网、登录页面或相关下载服务。使用前请确认所在地区是否支持 OpenAI 服务，并遵守当地法律法规及 OpenAI 服务条款。 二、Codex Desktop App 下载方法 macOS 用户可以通过官方安装包直接下载 Codex App： 下载 Codex App macOS 版 将 Codex 拖入 Applications 文件夹 在“应用程序”中打开 Codex 如果 macOS 提示无法打开应用，可以进入： 检查是否需要手动允许 Codex 运行。 Windows 用户可以通过 Microsoft Store 官方页面安装 Codex App： 下载 Codex App Windows 版 打开 Microsoft Store 下载页面 点击“下载”或“在 Microsoft Store 中查看” 安装完成后，从开始菜单打开 Codex Windows 版 Codex App 默认使用 Windows 原生运行环境，也可以根据需要配置 PowerShell、命令提示符、Git Bash 或 WSL。 三、安装完成后为什么还不能直接使用 安装 Codex App 只代表客户端已经安装完成。 第一次启动时，通常还需要完成以下步骤： 授权 Codex 访问本地项目目录 根据任务确认文件修改或命令执行权限 检查本地 Git、Node.js、Python 等开发环境 因此，安装完成后看到登录页面、项目选择页面或权限提示，通常属于正常情况。 四、Codex App 是否必须配置 API Key Codex App 当前主要使用 ChatGPT 账号登录。只要你的账号具有相应的 Codex 使用权限，就可以通过 ChatGPT 登录进入桌面应用。 因此，不建议把下面这句话作为通用安装说明： API Key 主要用于调用 OpenAI API，和 Codex App 的 ChatGPT 账号登录不是同一套使用方式。 具体可用额度和账号要求可能随 OpenAI 产品政策调整，请以软件内提示和官方页面为准。 五、以前用过 Codex CLI，还需要重新配置吗 如果你以前已经在同一台电脑上使用过 Codex CLI 或 Codex IDE 扩展，Codex App 通常可以读取已有的： OpenAI 官方说明，Codex App 可以从 Codex CLI 和 IDE 扩展中读取会话历史与配置，因此很多用户不需要从头设置。 但能否直接共享，还取决于你的操作系统和 CLI 安装位置。 六、Windows 用户需要注意 WSL 配置 Windows 版 Codex App 默认使用以下目录保存配置： 如果你使用的是 Windows 原生版本 Codex CLI，桌面版与 CLI 通常会使用相同的 Codex 配置目录。 但是，如果你在 WSL 中安装并使用 Codex CLI，WSL 默认使用 Linux 用户目录： Windows Codex App 使用 %USERPROFILE%\.codex WSL Codex CLI 使用 ~/.codex 两者默认不会自动共享登录状态、配置和会话历史 OpenAI 官方文档建议，可以通过同步两个目录，或者在 WSL 中设置 CODEX_HOME ，让 WSL CLI 使用 Windows 的 Codex 配置目录。 将 <windows-user> 替换为你的 Windows 用户名。 如果希望每次打开 WSL 都自动生效，可以把这行配置添加到：

不熟悉 WSL 和环境变量的新手，可以暂时不修改。直接在 Codex App 中重新登录通常更加简单。 七、Codex App 首次启动流程 第一次打开 Codex App，可以按照下面的顺序操作。 打开 Codex App，使用支持 Codex 的 ChatGPT 账号登录。 点击添加项目，选择电脑上的代码目录。 建议第一次使用时选择一个测试项目，不要直接打开包含生产环境密钥或重要数据的项目。 Codex 会在你选择的项目目录中读取和修改文件。 因此，应该只选择当前任务所需的项目目录，不要直接授权整个磁盘或包含大量无关文件的上级目录。 根据项目类型，可能需要提前安装： 并不是所有项目都需要安装以上工具。Codex 会根据项目使用的技术栈调用相应命令。 可以先发送一个不会修改代码的任务： 确认 Codex 能够正常读取项目后，再让它执行代码修改任务。 可能与当前网络环境、浏览器授权或地区可用性有关。 浏览器是否能够正常打开 OpenAI 登录页面 当前账号是否具有 Codex 使用权限 2. Codex 没有读取已有 CLI 配置 Windows 用户应检查 Codex CLI 是安装在： 安装位置不同，使用的配置目录也可能不同。 Codex App 的代码差异查看、版本管理和部分恢复功能依赖 Git。 Windows 用户可以在 PowerShell 中检查： 如果提示找不到命令，需要先安装 Git。 例如 Codex 执行下面的命令失败： 通常说明对应的开发环境尚未安装，或者没有加入系统环境变量。 Codex App 的安装流程可以概括为： Codex App 通常使用 ChatGPT 账号登录 一般不要求用户先配置 API Key 已使用 Codex CLI 的用户可能可以直接复用已有配置 Windows 原生 CLI 与 Codex App 通常共享配置目录 WSL 中的 Codex CLI 默认不会与 Windows App 自动共享配置 第一次使用时，建议先在测试项目中熟悉权限和工作流程 完成安装和登录后，就可以让 Codex 阅读项目、解释代码、修复问题或实现新的功能。 如有侵权，请联系 cloudcommunity@tencent.com 删除。 一、OpenAI Codex App 官网 二、Codex Desktop App 下载方法 1. macOS 版下载 2. Windows 版下载 三、安装完成后为什么还不能直接使用 四、Codex App 是否必须配置 API Key 五、以前用过 Codex CLI，还需要重新配置吗 六、Windows 用户需要注意 WSL 配置 七、Codex App 首次启动流程 第一步：登录账号 第二步：添加项目 第三步：确认项目范围 第四步：检查开发环境 第五步：发送第一个任务 八、安装后无法使用的常见原因 1. 无法打开登录页面 2. Codex 没有读取已有 CLI 配置 3. 无法打开项目 4. 无法运行 Git 命令 5. 无法运行项目命令 2. Codex 没有读取已有 CLI 配置 社区 技术文章 技术问答 技术沙龙 技术视频 学习中心 技术百科 技术专区 活动 自媒体同步曝光计划 邀请作者入驻 自荐上首页 技术竞赛 圈层 腾讯云最具价值专家 腾讯云架构师技术同盟 腾讯云创作之星 腾讯云TDP 关于 社区规范 免责声明 联系我们 友情链接 MCP广场开源版权声明 Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有 深圳市腾讯计算机系统有限公司 ICP备案/许可证号： 粤B2-20090059 粤公网安备44030502008569号 腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号