Codex 国内下载安装指南：Windows 和 macOS 官方版下载
Codex 桌面应用已经覆盖 Windows 和 macOS。下载安装时最重要的是从 OpenAI 官方页面获取当前版本，不要使用来源不明的网盘安装包。安装完成后，如果需要自定义 API，可以使用 API 中转站：https://apibest.org，API 基础地址为 https://apibest.org/v1。
先分清官方客户端和第三方 API
本文提供的是 OpenAI 官方客户端的下载方法；APIBest 是独立的第三方 OpenAI-compatible API 服务，不是 OpenAI 官方下载站。客户端来源与模型 API 来源是两个不同概念。
一、Codex 官方下载入口
请通过下面的 OpenAI 官方页面获取安装包：
前往 Codex 官方页面下载 Windows 或 macOS 版本
官方页面会根据当前版本显示支持的平台、安装方式和系统要求。本文不提供固定的 .dmg、.exe 或其他安装文件直链，原因是直链可能在版本更新后失效，也不便于判断文件是否仍由官方维护。
下载前请检查：
- 浏览器地址是否属于
openai.com官方域名。 - 页面是否提供与你操作系统匹配的版本。
- 下载完成后的文件来源和发布者是否可信。
- 公司设备是否允许安装第三方开发工具。
二、Windows 和 macOS 应该下载哪个版本
| 项目 | Windows | macOS |
|---|---|---|
| 常用安装入口 | 官方 Windows 安装程序 | 官方 macOS 安装包 |
| 启动位置 | 开始菜单 | 应用程序或 Launchpad |
| 常见系统确认 | SmartScreen、管理员或企业策略 | Gatekeeper、文件与目录权限 |
| CLI 可选环境 | PowerShell 或 WSL2 | Terminal、iTerm 等 |
如果官方页面提供不同架构版本，macOS 用户可以在“苹果菜单 -> 关于本机”查看芯片信息；Windows 用户可以在“设置 -> 系统 -> 系统信息”查看系统类型。具体可选版本以下载页面当时的内容为准。
三、Windows 官方版安装步骤
1. 下载安装程序
在官方 Codex 页面选择 Windows 版本并等待下载完成。不要从搜索广告、论坛附件或网盘镜像获取安装程序。
2. 运行安装
双击下载的安装程序，按向导完成安装。如果 Windows 显示安全确认：
- 核对文件确实来自 OpenAI 官方页面。
- 检查发布者信息。
- 确认公司设备没有禁止安装。
- 无法确认来源时取消安装并重新从官方页面下载。
不要通过关闭杀毒软件或系统安全保护来强行运行来源不明的文件。
3. 启动 Codex
安装完成后从开始菜单启动。首次运行时按界面提示登录，然后选择一个本地 Git 项目。
如果使用 CLI，并且项目主要位于 WSL2 中，建议在 WSL2 内单独安装 Node.js 和 Codex CLI；不要让 Windows 客户端路径与 WSL 工具链互相混用。
四、macOS 官方版安装步骤
1. 下载安装包
从官方 Codex 页面选择 macOS 版本。若页面区分芯片架构，请根据“关于本机”显示的 Apple 芯片或 Intel 信息选择。
2. 安装到应用程序目录
打开安装包，根据界面提示把 Codex 放入“应用程序”目录。完成后可以从 Launchpad 或 Finder 的“应用程序”中启动。
3. 处理首次打开提示
macOS 可能显示应用来源确认，或请求访问项目文件夹。先确认安装包来自 OpenAI，再按系统正常流程授权。只授予当前工作所需的目录权限，不要为了方便开放整个磁盘。
如果应用无法打开，优先重新从官方页面下载并检查系统版本、磁盘空间和企业设备策略，不建议关闭 Gatekeeper。
五、首次启动与登录
本地 Codex 支持使用 ChatGPT 登录，也支持 API Key 方式。可用功能、账号权限、套餐和计费方式以当前界面和官方说明为准。
首次打开后建议：
- 不要点击账号登录或“使用 ChatGPT 登录”。
- 点击 “使用其他方式”（英文界面为 Sign in another way）。
- 选择 API Key 登录，输入你的 API Key，然后点击继续。
- 进入 Codex 后添加一个用于测试的小型 Git 项目。
- 检查当前分支和未提交修改。
- 保持需要确认的权限模式。
- 先让 Codex 只读项目，不要立即安装依赖或修改大量文件。
APIBest 用户注意
如果输入的是 APIBest Key，还要完成下文的自定义提供商配置。API Key 登录入口不会自动把默认请求地址改成 https://apibest.org/v1。
可以发送：
阅读当前项目的 README 和目录结构，告诉我如何启动和运行测试。先不要修改文件，也不要执行安装命令。
六、没有合适账号时如何配置 API 中转站
需要自定义 API 时，可以使用：
- API 中转站：https://apibest.org
- API 基础地址：
https://apibest.org/v1 - 示例模型：
gpt-5.6-sol
APIBest 不是 OpenAI 官方服务，模型、计费、数据处理和兼容性以服务商说明为准。敏感项目使用前应先完成安全审查。
1. 创建 API Key
进入 APIBest 控制台创建密钥。不要把真实密钥写进项目或发送给他人。
2. 设置环境变量
Windows PowerShell 当前会话：
$env:APIBEST_API_KEY="你的 API Key"macOS Terminal 当前会话：
export APIBEST_API_KEY="你的 API Key"从桌面图标启动的应用不一定继承终端临时环境变量。如果桌面应用无法读取密钥，应通过操作系统用户环境或 Codex 当前版本提供的配置入口设置，并避免把密钥放进会被同步或提交的文件。
3. 编辑用户级配置
macOS：
~/.codex/config.tomlWindows：
$HOME\.codex\config.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"env_key 填写的是环境变量名称，不是密钥。提供商配置属于机器级设置，应写在用户目录下，不能依赖项目内 .codex/config.toml 覆盖。
七、验证 API 与工具调用
连接成功后先完成三层测试：
第一层：普通响应
让 Codex 解释一个简单文本文件，确认基础请求能够返回。
第二层：文件工具
要求 Codex 读取一个项目文件并总结。如果能聊天却不能读取文件，要分别检查本地权限和第三方 API 的工具调用兼容性。
第三层：命令与结果回传
让 Codex 对一个小测试文件做有限修改，并运行对应测试。检查它是否能够发起命令、读取结果并正确总结。
普通聊天成功并不代表第三方 API 已完整支持 Responses 流式协议、长上下文和工具结果回传。
八、Windows 常见下载与安装问题
安装程序无法启动
重新从官方页面下载，检查系统架构、Windows 更新、磁盘空间和设备管理策略。公司电脑可能需要管理员批准。
SmartScreen 显示提醒
先核对文件来源与发布者。不要因为急于安装而忽略来源检查，更不要运行其他网站提供的“绿色版”或破解版本。
项目无法打开
检查文件夹权限、云盘同步状态和路径长度。可以先用本地磁盘中的小型 Git 项目测试。
PowerShell 中找不到 codex
这是 CLI 的 PATH 问题，与桌面应用安装是两条路径。重新打开终端，并检查 npm 全局可执行目录。
九、macOS 常见下载与安装问题
提示应用无法打开
确认安装包来自官方页面，并检查 macOS 版本和芯片架构。不要用关闭系统安全功能的方式运行未知文件。
无法访问项目目录
在系统设置中检查应用的文件与文件夹权限。只授权实际需要使用的项目目录。
Apple 芯片与 Intel 版本选错
删除错误安装包，回到官方页面重新下载匹配版本。芯片类型可以在“关于本机”查看。
Terminal 中找不到 codex
桌面应用和 CLI 是不同入口。如果还需要 CLI，应安装 Node.js 后执行：
npm install -g @openai/codex十、API 配置常见错误
401 或 403
检查 API Key、额度和模型权限，并确认 Codex 进程能够读取 APIBEST_API_KEY。
404 或重复 /v1
基础地址应保持：
base_url = "https://apibest.org/v1"不要自行追加 /responses，也不要写成 .../v1/v1。
模型不存在
模型 ID 以 APIBest 控制台实际显示为准。不同账号或时期可用模型可能不同。
能回答但无法执行工具
先确认本地项目权限，再确认服务商是否完整兼容 Responses API、流式事件、工具调用和工具结果回传。
完整排错见 Codex 自定义 API 常见错误与排查。
十一、更新和卸载
桌面应用更新方式以应用内提示或官方页面为准。不要使用第三方更新程序。
卸载时按操作系统常规流程移除应用。用户目录下的 ~/.codex/ 可能仍包含配置和登录缓存，其中可能有敏感认证信息；只有确认不再需要时才手动处理，不要上传或分享该目录。
如果通过 npm 安装了 CLI，可以执行：
npm uninstall -g @openai/codex十二、安全检查清单
正式使用前确认：
- 安装包来自 OpenAI 官方页面。
- API Key 没有写入 Git 仓库。
- 当前打开的是正确项目和分支。
- 未提交改动已经了解或备份。
- Codex 只获得完成任务所需的权限。
- 第三方 API 符合项目的数据与合规要求。
- 每次修改都经过差异审查和测试验证。
总结
Windows 和 macOS 用户都应从 OpenAI Codex 官方页面 获取当前安装包，并按操作系统的正常安全流程安装。不要使用网盘重打包版，也不要为了安装关闭系统安全保护。
需要自定义 API 时，可以访问 https://apibest.org 获取 API Key，将基础地址配置为 https://apibest.org/v1，并通过环境变量保存密钥。完成后用只读、文件工具和测试命令三层任务验证，而不是只确认聊天能返回文字。