Codex 国内下载安装指南：Windows 和 macOS 官方版下载

Codex 国内下载安装指南：Windows 和 macOS 官方版下载

分别介绍 Codex Windows 与 macOS 官方桌面版下载、系统安装、API Key 登录和 APIBest 自定义 API 配置。

Codex 国内下载安装指南：Windows 和 macOS 官方版下载#

Windows 和 macOS 的 Codex 桌面应用都应从 OpenAI 官方页面下载，但安装确认、文件权限和环境变量处理略有不同。本文先分别说明两个系统，再给出共用的 APIBest 自定义 API 配置，基础地址为 https://apibest.org/v1。

官方下载入口只有一个#

前往 OpenAI Codex 产品页

产品页会提供当前可用平台和系统要求。为了避免版本过期，不建议从其他文章复制固定安装文件直链。

::: warning 不要混淆来源 “官方版”指桌面应用由 OpenAI 提供。后文 APIBest 是第三方模型 API 服务，不是安装包镜像，也不是 OpenAI 官方服务。 :::

Windows 官方版安装#

下载前#

打开“设置 -> 系统 -> 系统信息”，确认 Windows 版本与系统类型。公司设备还应先确认是否允许安装新软件。

安装时#

  1. 从 Codex 产品页下载 Windows 安装程序。
  2. 检查文件来源和发布者。
  3. 运行安装向导。
  4. 按系统提示完成安装。

Windows SmartScreen 可能显示确认页面。看清发布者后再继续，不要通过关闭安全软件来运行未知文件。

安装后#

从开始菜单打开 Codex。如果应用无法访问项目目录，先检查文件夹权限、云盘同步状态和企业设备策略。

macOS 官方版安装#

下载前#

在“苹果菜单 -> 关于本机”查看芯片与系统版本。若官方页面提供多个架构包，应选择与本机匹配的版本。

安装时#

  1. 打开官方下载的安装包。
  2. 将应用放入“应用程序”目录。
  3. 从 Launchpad 或 Finder 启动。

安装后#

macOS 可能请求应用来源确认或文件夹访问权限。只授权实际项目目录，不要关闭 Gatekeeper，也不要授予无关磁盘范围。

两个平台共有的 API Key 登录步骤#

无论 Windows 还是 macOS，首次打开应用都会看到 Codex 欢迎页。准备使用 API Key 时：

  1. 跳过“使用 ChatGPT 继续”。
  2. 点击 “使用其他方式登录”。

Windows 和 macOS 均选择使用其他方式登录

下一页输入 API Key：

Codex 桌面版 API Key 登录框

可先填 sk-123456 作为格式占位。使用第三方 API 时，登录输入框不能代替基础地址与提供商配置。

从 APIBest 复制 Key#

进入 APIBest API 密钥页面，复制用于 Codex 的 Key。

APIBest 控制台中的 API Key 复制按钮

建议使用独立 Key，便于控制额度和随时停用。不要将密钥写进仓库或公开文档。

Windows 如何准备环境变量#

PowerShell 当前会话可以这样设置：

powershell
$env:APIBEST_API_KEY="你的 API Key"

这个变量只属于当前 PowerShell。若从开始菜单启动 Codex，应把 APIBEST_API_KEY 保存为当前 Windows 用户的环境变量，或使用应用当前提供的安全设置入口。

macOS 如何准备环境变量#

Terminal 当前会话：

bash
export APIBEST_API_KEY="你的 API Key"

从 Launchpad 启动的图形应用不一定继承 Terminal 临时变量。长期使用时，要确保桌面进程能够从用户环境或 Codex 安全设置读取 Key。

两个平台的配置文件路径#

系统用户级配置
Windows$HOME\.codex\config.toml
macOS~/.codex/config.toml

不存在时可创建目录和文件。请勿把模型提供商配置放到项目仓库中。

共用的 APIBest 配置#

Windows 和 macOS 使用相同的 TOML 内容：

toml
model = "gpt-5.6-sol"
model_provider = "apibest"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.apibest]
name = "APIBest"
base_url = "https://apibest.org/v1"
env_key = "APIBEST_API_KEY"
wire_api = "responses"

配置关系可以理解为：

text
Codex 桌面应用
  -> model_provider = "apibest"
  -> base_url = "https://apibest.org/v1"
  -> env_key = "APIBEST_API_KEY"
  -> 系统用户环境中的真实 Key

env_key 只保存变量名。把真实 Key 直接粘进 TOML 会增加误提交和泄漏风险。

保存后如何重载#

  1. 完全退出 Codex。
  2. 检查用户环境中存在 APIBEST_API_KEY。
  3. 重新打开桌面应用。
  4. 新建任务，让应用使用新提供商和模型。

Windows 常见问题#

应用安装被拦截#

优先检查发布者、系统更新和设备管理策略，不要改用不明重打包版本。

Key 在 PowerShell 中存在，应用仍报 401#

开始菜单启动的应用可能没有继承临时 PowerShell 变量。把 Key 放到用户级环境后重新启动应用。

macOS 常见问题#

应用打不开#

重新从官方页面下载，检查芯片架构和系统版本。不要关闭系统安全功能运行未知文件。

Terminal 中变量存在，Launchpad 启动后无效#

这是图形应用环境继承差异。应使用用户环境或应用设置，让桌面进程能读取密钥。

两个平台都可能出现的 API 错误#

  • 401/403：Key、额度、权限或环境变量问题。
  • 404：base_url 拼写或端点兼容问题。
  • 模型不存在：控制台模型 ID 不一致。
  • 工具调用失败：Responses 流式协议兼容不完整。

总结#

Windows 与 macOS 的区别主要在安装确认和环境变量传递；APIBest 的 config.toml 内容完全一致。只要安装包来自 OpenAI、Key 对桌面进程可见、提供商配置位于用户目录，两套系统都可以沿用同一条自定义 API 路线。

参考资料#