Codex 桌面版安装使用

1. 下载 Codex 桌面版

优先从 ChatGPT 下载页获取官方桌面版。

1.1 Windows

Windows 用户可以直接从 Microsoft Store 下载并安装。

如果商店安装失败，请先恢复 Microsoft Store 和防火墙服务，而不是使用来路不明的安装包。

1.2 macOS

从官方 ChatGPT 下载页获取 macOS 安装包，安装完成后使用已有 ChatGPT 账户登录。

2. Windows 商店修复

以下命令需要在“以管理员身份运行”的 PowerShell 中执行。

2.1 检查并启动防火墙服务

powershell

Set-Service -Name mpssvc -StartupType Automatic
Start-Service -Name mpssvc
Get-Service mpssvc, BFE

预期看到 BFE 和 mpssvc 为 Running。

2.2 重新注册 Microsoft Store

powershell

Get-AppxPackage -AllUsers *WindowsStore* | Foreach {
  Add-AppxPackage -DisableDevelopmentMode -Register "$($_.InstallLocation)\AppXManifest.xml"
}

完成后重启 Microsoft Store，再尝试安装。若企业设备受到策略限制，请联系系统管理员确认商店与防火墙服务策略。

3. 首次使用

安装完成后按下面的顺序完成初始化，避免一上来就跑复杂任务：

使用 ChatGPT 账户登录。登录失败时先确认浏览器可以正常打开 chatgpt.com，再检查系统代理设置。
在设置中确认模型可用。切换一两次模型，确认当前账户能正常响应。
打开一个小的测试项目文件夹，让桌面版“列出当前目录的文件并说明用途”，验证它对本地文件的读取能力。
需要执行命令、修改文件的任务，先确认桌面版弹出的权限申请内容，再决定是否放行。

桌面版的权限弹窗和 CLI 的审批机制是同一套思路：先看懂它要做什么，再授权。相关原则见《AI 使用安全清单》。

4. 桌面版与 CLI 的分工

桌面版和 Codex CLI 面向不同使用习惯，可以同时安装：

场景	更适合用
浏览代码、讨论方案、边看边问	桌面版
长时间自动执行的多步任务	CLI
需要精确控制每条命令的审批	CLI
在图形界面里查看改动差异	桌面版
脚本、CI、远程服务器环境	CLI

两者可以共用同一个账户，但配置相互独立。日常建议：探索和评审用桌面版，批量执行和自动化用 CLI。

5. 常见问题

登录页面打不开或一直转圈：多为网络环境问题，按 STJAPI 账户与网络设置的思路检查代理与直连规则。
安装后启动白屏或闪退：先完全退出进程再重新打开；仍无效时在系统设置中修复或重置应用（Windows：设置 → 应用 → 安装的应用 → 高级选项）。
无法访问项目文件夹：检查系统隐私/权限设置中是否授权了“文件与文件夹”访问；macOS 还需在“完全磁盘访问权限”中按需添加。
想用第三方接口跑 Codex：桌面版主要绑定官方账户登录；需要对接 STJAPI 时使用 Codex CLI 或通过 CC Switch 管理配置。
其他运行报错：按《通用排错手册》的通用流程定位，容量类提示见《Codex 模型繁忙处理》。