跳到主要内容

Codex Desktop 安装与使用

Codex Desktop 是 OpenAI Codex 的桌面端，适合在图形界面里打开本地项目、查看文件改动、运行任务和验证页面。新用户建议先装桌面端，再根据需要安装 Codex CLI。

Windows 安装​

Windows 用户优先使用 Microsoft Store 渠道。这个链接通常比 OpenAI 官网更容易直接打开：

  1. 打开 Codex - Microsoft Store。
  2. 点击获取或安装。
  3. 安装完成后，从开始菜单打开 Codex。

如果浏览器没有自动拉起商店应用，可以复制下面这个链接到浏览器地址栏：

ms-windows-store://pdp/?productid=9PLM9XGG6VKS

Windows 备用渠道​

如果 Microsoft Store 页面打不开，可以按下面顺序尝试：

  1. 先用 PowerShell 安装，不需要打开商店界面：
winget install --id 9PLM9XGG6VKS --source msstore
  1. 如果 winget 找不到包，刷新 Windows 包管理器源：
winget source reset --force
winget source update

刷新完成后回到第 1 步重试安装。

  1. 如果公司网络、系统策略或精简版 Windows 禁用了 Microsoft Store，建议换网络后再安装，或先使用 Codex CLI。

Codex CLI 不依赖 Microsoft Store，Windows 上可以直接用安装脚本：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
注意

不建议下载第三方重打包的 Codex 安装包或来路不明的 MSIX 文件。除非你能确认来源可信，否则这类包可能存在篡改、版本滞后或自动更新失效的问题。

安装后确认：

Get-Command codex -ErrorAction SilentlyContinue

桌面端主要从开始菜单启动；命令行能力请看 Codex CLI。

macOS 安装​

在 OpenAI Codex 官方页面下载或按官方提示安装 Codex App。安装完成后，把常用项目文件夹加入 Codex 的工作区。

Linux 说明​

桌面端支持情况以 OpenAI 官方页面为准。Linux 用户通常优先使用 Codex CLI。

基本使用​

  1. 打开 Codex Desktop。
  2. 选择本地项目目录，例如 D:\programs\NewAPI。
  3. 输入任务，例如“帮我新增一页安装文档”或“检查这个 Docusaurus 页面为什么打不开”。
  4. 查看 Codex 给出的文件改动、命令输出和预览结果。
  5. 确认没问题后再保存、提交或部署。

接入本站 API Key​

Codex Desktop 的登录和 provider 能力会随版本变化。推荐做法是：

  1. 先完成桌面端安装和登录。
  2. 再安装 CC Switch。
  3. 在 CC Switch 里为 Codex 添加 77code AI provider。
  4. 如果当前 Codex Desktop 版本支持被 CC Switch 接管 provider，就通过 CC Switch 切换到本站配置。

如果桌面端没有暴露自定义接口地址，本站 API Key 主要用于 Codex CLI、Claude Code 和其他支持自定义 base URL 的工具。

参考链接​

适合用 Desktop 的场景​

  • 想在图形界面里看文件差异。
  • 想让 Codex 帮你打开本地页面并检查效果。
  • 不熟悉命令行，但希望先跑通 AI 编程工作流。
  • 需要在多个文件之间来回确认改动。