Codex 桌面版
不用命令行也能用

国内微软商店经常有问题，几个解决方案：

方案 1：直接下载安装包（推荐）

在向导第一步选「官网直接下载」，不走商店，下载 .exe 安装包双击安装即可。

方案 2：用 winget 命令行安装

# Windows 10/11 自带 winget，命令行安装
winget install OpenAI.Codex

方案 3：用 GitHub 镜像

访问 github.com/Wangnov/codex-app-mirror，有国内用户维护的安装包镜像。

官方 CDN（oaistatic.com）在国内速度一般，可以尝试：

• 使用下载工具（IDM、aria2）多线程加速
• 去 GitHub 镜像项目下载离线安装包
• macOS 用户可以用 Homebrew：brew install --cask codex（如果有源的话）

桌面版启动时会连接 OpenAI 服务器验证登录。如果你在国内直连：

• 用第三方 API：在设置里填 DeepSeek / 阿里云的 Base URL 和 API Key，跳过 OpenAI 服务器
• 用环境变量：设置 OPENAI_BASE_URL 指向国内兼容服务

# 方式一：系统环境变量（Windows）
# 设置 → 系统 → 关于 → 高级系统设置 → 环境变量
# 添加 OPENAI_BASE_URL = https://api.deepseek.com/v1

# 方式二：临时启动
# PowerShell：
$env:OPENAI_BASE_URL = "https://api.deepseek.com/v1"
codex

# 方式三：写入配置文件
# 见向导第三步

完全可以！两者共享 ~/.codex/ 目录下的配置文件：

• ~/.codex/config.toml —— 模型、Provider 配置
• ~/.codex/auth.json —— API Key

你在桌面版里配好的 API，CLI 版也能直接用；反过来也一样。很多用户两个都用 —— 桌面版处理复杂项目，CLI 版快速提问。

桌面版可以直接在 Windows 上运行，不需要 WSL2（这点和 CLI 版不一样）。

但如果你想让桌面版在 WSL2 环境下运行（比如操作 Linux 项目）：

1. 先安装 WSL2：wsl --install
2. 打开桌面版设置 → 终端类型 → 选择 WSL
3. 之后 Agent 执行的命令会跑在 WSL2 里

桌面版有图形化的设置界面，不用手动改文件：

1. 打开 Codex 桌面版
2. 点击左上角 ⚙️ 设置（或按 Ctrl/Cmd + ,）
3. 找到 「模型提供者 / Model Providers」
4. 点击 「添加提供者 / Add Provider」
5. 填写：名称、Base URL、API Key、API 类型（选 Chat Completions）
6. 保存后在模型列表里选择新添加的模型

取决于你的 Mac 用的是什么芯片：

• M1 / M2 / M3 / M4 系列 → 选 Apple Silicon (ARM) 版
• Intel 芯片（2020 年前的 Mac） → 选 Intel (x64) 版

怎么查看自己的芯片？

点击左上角 → 「关于本机」→ 看「芯片」或「处理器」一栏。