Codex桌面版是OpenAI推出的独立AI编程智能体客户端，可以直接打开本地项目文件夹，让AI阅读代码、修改文件、运行命令、检查代码差异，并同时处理多个开发任务。对于习惯图形界面操作的开发者来说，它比终端CLI版本的上手门槛低了不少。下面是一份完整的安装与使用教程，覆盖Windows和macOS两大平台。
一、安装之前需要搞清楚的三件事
1. Codex桌面版对系统的要求
在动手下载之前，先确认自己的电脑能不能跑。Windows方面，需要Windows 10 21H2及以上或Windows 11，内存最低4GB但推荐8GB以上，磁盘空闲空间至少留500MB。macOS方面，目前要求macOS 13及以上，且需要区分Apple Silicon（M系列芯片）和Intel芯片两个版本。如果你用的是Linux系统，目前桌面版尚未正式支持，可以考虑Codex CLI替代方案。
2. 账号权限要提前确认
Codex桌面版的完整功能（包括多Agent并行、Skills、Automations等）需要ChatGPT Plus及以上套餐。免费账号登录后部分功能会受限。如果你打算用API Key登录，部分云端会话功能会不可用。
3. 官网下载地址汇总
官方入口建议以OpenAI开发者文档为准：
官方产品页：https://openai.com/codex/官方文档下载页：https://developers.openai.com/codex/appWindows微软商店：https://apps.microsoft.com/detail/9plm9xgg6vks通用入口：https://chatgpt.com/codex/get-started二、Windows平台安装步骤
方法一：通过微软商店安装（最省事）
打开Windows开始菜单，搜索“Microsoft Store”并打开，在搜索栏输入“Codex”或“OpenAI Codex”，注意认准发布者为OpenAI，点击“获取”或“安装”按钮即可。整个下载和部署过程由系统自动完成，安装好后从开始菜单直接打开。
方法二：用命令行一键安装
如果你习惯用终端操作，打开PowerShell，运行以下命令：
text
winget install Codex -s msstore这条命令会直接从微软商店拉取安装包并完成安装。
方法三：国内网络环境下的离线安装方案
国内用户经常遇到微软商店连接不稳定、下载卡住的问题。这种情况下可以使用开源安装器，它会自动从GitHub Release拉取官方MSIX安装包，做SHA256校验后静默安装，并创建桌面快捷方式。下载CodexAppInstaller.exe后双击运行，UAC弹窗点“是”，后续按照提示操作即可。安装完成后需要完全退出Codex（包括系统托盘）再重新打开，配置才会生效。
注意：Codex桌面版在Windows上是原生运行的，基于PowerShell和Windows sandbox，不需要安装WSL就能正常使用。
三、macOS平台安装步骤
1. 确认芯片类型并下载安装包
点击屏幕左上角苹果菜单 →“关于本机”，查看芯片信息。Apple Silicon（M系列芯片）下载Codex.dmg，Intel芯片下载Codex-latest-x64.dmg。下载完成后，双击打开dmg文件，将Codex图标拖入“应用程序”文件夹即可完成安装。
2. 首次打开可能遇到的权限问题
macOS的安全机制有时会阻止应用启动。如果出现“无法打开，因为来自身份不明的开发者”之类的提示，进入系统设置 → 隐私与安全性，在页面底部找到相关提示，点击“仍要打开”即可。
四、装好之后怎么用：首次启动配置
1. 登录与认证
打开Codex桌面版后，首先需要登录。推荐使用ChatGPT账号登录，如果你的账号有Codex使用权限，直接授权即可。也可以用OpenAI API Key登录，但需要注意这种方式下部分功能（如云端线程）可能不可用。
2. 选择项目文件夹
登录成功后，界面会提示你选择一个项目文件夹。Codex需要知道它要在哪个代码库中工作。如果你之前用过Codex CLI或IDE扩展，之前打开过的项目会直接显示在列表中。
3. 发送第一条任务
选好项目后，确认界面上的“Local”模式处于选中状态，然后在对话框中输入你的第一条指令。可以试试让Codex分析当前项目的代码结构、找出某个函数的潜在问题，或者直接让它帮你写一段新代码。
五、几个容易踩的坑和解决办法
1. 登录后一进对话就掉登录
这是桌面版比较常见的问题。解决方法：先退出Codex桌面应用，在ChatGPT网页端登出所有已注册的Codex设备，同时登出网页版ChatGPT，把Codex桌面应用更新到最新版本后重新登录。如果仍然不行，试试把登录链接放到浏览器的无痕窗口中完成授权。
2. 安装后配置不生效
Codex桌面版的配置文件存放在用户主目录的.codex文件夹中（Windows路径为%USERPROFILE%\.codex，macOS为~/.codex）。如果你手动修改了config.toml或auth.json，记得完全退出应用（包括托盘进程）再重新打开，否则改动不会生效。
3. API Key登录后功能不全
如果你选择用API Key而非ChatGPT账号登录，部分依赖云端的功能将无法使用。官方文档明确提示：使用OpenAI API Key登录时，cloud threads等功能可能不可用。如果这些功能对你重要，建议使用ChatGPT账号登录。
总的来说，Codex桌面版把AI编程Agent的能力从终端搬到了图形界面里，安装流程本身并不复杂，关键在于选对下载渠道、确认账号权限，以及第一次启动时的初始化配置。实际用起来之后你会发现，它最大的价值在于能同时管理多个并行任务，每个任务在独立的工作树中运行，代码改动互不干扰，合并前可以逐个审查diff再决定是否采纳。希望这份教程能帮你顺利跑通第一步。