ChatGPT Codex 官网国内访问 + 完整安装教程：macOS / Windows
国内用户安装 ChatGPT Codex 时，通常会遇到四类彼此独立的问题：官网能否打开、安装包能否下载、账号能否登录、模型 API 能否正常调用。本文会按这个顺序讲清楚 macOS 和 Windows 的完整安装流程。需要自定义 API 的读者可以访问 API 中转站：https://apibest.org 获取 API Key，API 基础地址是 https://apibest.org/v1。
第三方服务说明
APIBest 不是 OpenAI 官方服务。模型映射、可用性、价格、数据处理和协议兼容性由 APIBest 负责。公司代码、客户数据或生产日志是否允许发送给第三方服务，应先完成安全与合规确认。
一、ChatGPT Codex 官方网站入口
Codex 产品介绍和下载入口：
Codex 官方文档：
认证说明：
下载时建议从产品页面进入，不要使用论坛附件、网盘安装包或搜索广告中的不明链接。官方安装包地址和产品命名可能随版本更新，固定的 .dmg、.exe 或其他文件直链容易过期，也不便于确认发布者。
二、国内访问官网时如何分层排查
“Codex 用不了”可能发生在不同环节。先判断具体卡在哪一层：
| 环节 | 正常表现 | 常见问题方向 |
|---|---|---|
| 官网访问 | 产品页面能完整打开 | DNS、网络连接、浏览器缓存或地区可用性 |
| 安装包下载 | 文件可以完成下载 | 下载中断、代理配置、磁盘空间或安全软件 |
| 账号登录 | 浏览器授权后返回应用 | 账号状态、工作区权限、系统时间或网络回调 |
| API 请求 | Codex 能稳定返回并调用工具 | API Key、模型权限、协议兼容、限流或超时 |
不要在登录失败时反复重装，也不要在安装包下载失败时修改 config.toml。先定位当前所在环节，再处理对应问题。
官网打不开
可以先检查：
- 浏览器地址是否为
openai.com或learn.chatgpt.com官方域名。 - 系统日期和时间是否正确。
- DNS、网络连接和浏览器是否工作正常。
- 公司或校园网络是否存在访问策略。
- 当前地区、账号和组织策略是否支持所需产品。
本站不建议通过来路不明的镜像站登录 OpenAI 账号，也不要向第三方页面提交密码、验证码或会话信息。
官网能打开但下载失败
检查浏览器下载记录、磁盘空间、安全软件和企业设备策略。重新下载时仍应从官方产品页面进入，不要因为速度问题改用无法核实来源的安装包。
三、安装前要准备什么
1. 确认操作系统
macOS 用户可以在“苹果菜单 -> 关于本机”查看系统版本和芯片信息。Windows 用户可以在“设置 -> 系统 -> 系统信息”查看系统版本与系统类型。
如果官方页面提供多个架构版本，以页面当前说明和本机信息选择。不要仅根据别人分享的文件名判断。
2. 准备一个测试项目
建议准备一个小型 Git 项目，用于首次测试。项目中不要包含生产密钥、客户数据或大量未提交改动。
如果还没有 Git，可以从 Git 官网 安装。检查命令：
git --version3. 决定使用桌面应用还是 CLI
桌面应用适合希望使用图形界面的用户；CLI 适合经常在终端中工作的开发者。两种方式可以同时使用。
四、macOS 官方版下载和安装
第一步：从官网下载
打开 OpenAI Codex 官方页面，选择页面当前提供的 macOS 下载方式。
下载前确认：
- 浏览器地址属于 OpenAI 官方域名。
- 安装包与当前 Mac 芯片和系统版本匹配。
- 文件没有经过第三方重新打包。
第二步：安装应用
打开下载完成的安装包，根据界面提示把应用放入“应用程序”目录。完成后从 Launchpad 或 Finder 的“应用程序”中启动。
第三步：处理系统提示
第一次打开时，macOS 可能显示应用来源确认，或请求访问项目文件夹。确认安装包来自官方页面后，再按系统正常流程继续。
只授予实际需要的目录权限。不要为了安装而关闭 Gatekeeper，也不要默认开放整个磁盘。
第四步：添加项目
登录完成后选择一个本地 Git 项目。打开后确认：
- 路径确实是目标仓库。
- 当前分支符合预期。
- 已有未提交改动已经了解。
- 项目不包含不应发送给模型的敏感文件。
五、Windows 官方版下载和安装
第一步：下载安装程序
访问 OpenAI Codex 官方页面，选择 Windows 下载方式。不要使用所谓“绿色版”“便携破解版”或网盘重新打包版本。
第二步：运行安装
双击安装程序，按向导完成安装。Windows 显示 SmartScreen 或发布者确认时，先检查文件来源和发布者，再决定是否继续。
公司设备可能限制软件安装。如果安装被组织策略阻止，应联系设备管理员，不要绕过安全策略。
第三步：启动应用
从开始菜单启动应用，并按界面提示完成登录。随后选择一个本地项目进行测试。
第四步：Windows 原生与 WSL2
如果项目和开发工具都在 Windows 中，可以使用原生应用或 PowerShell。如果项目主要位于 WSL2 中，建议在 WSL2 内安装 Node.js、Git 和 Codex CLI，避免混用 Windows 与 Linux 路径和依赖。
六、安装 Codex CLI（可选）
习惯终端操作的用户可以同时安装 CLI。
1. 安装 Node.js
建议使用 Node.js 当前 LTS 版本：
node -v
npm -v2. 安装 Codex CLI
npm install -g @openai/codex验证版本：
codex --version进入项目：
cd /你的项目路径
codex更新 CLI：
npm install -g @openai/codex@latest如果提示 codex: command not found，重新打开终端，并检查 npm prefix -g 对应的全局可执行目录是否已加入 PATH。
七、首次登录方式
根据 OpenAI 当前认证文档，本地 Codex 支持两种 OpenAI 认证方式：
- 使用 ChatGPT 登录，获得相应订阅或工作区权限。
- 使用 OpenAI Platform API Key，按 API 平台用量计费。
桌面应用、CLI 和 IDE 扩展都支持本地登录。ChatGPT 登录通常会打开浏览器，完成授权后返回 Codex。使用 API Key 登录时，部分依赖 ChatGPT 工作区或云端服务的能力可能不可用。
本文推荐使用 API Key 的读者按下面操作：
- 安装完成后打开 Codex。
- 在登录页面不要点击账号登录或“使用 ChatGPT 登录”。
- 点击 “使用其他方式”（英文界面为 Sign in another way）。
- 选择 API Key 登录，输入你的 API Key。
- 点击继续，进入 Codex。
如果输入的是 OpenAI Platform API Key，可以使用官方 API Key 登录流程。如果使用 APIBest Key，仍需完成下一节的自定义提供商配置；登录框只负责输入凭据，不会自动将 API 地址切换为 https://apibest.org/v1。
账号登录成功不等于任意模型和功能都已开放。最终以账号套餐、工作区角色、管理员设置和客户端界面为准。
八、国内自定义 API 配置
如果没有合适的官方账号或希望使用 OpenAI-compatible API，可以参考下面的 APIBest 配置：
- API 中转站：https://apibest.org
- API 基础地址：
https://apibest.org/v1 - 示例模型：
gpt-5.6-sol
1. 创建 API Key
访问 APIBest，在控制台创建 API Key。密钥不要发给他人，不要截图公开，也不要写进 Git 仓库。
2. 设置环境变量
macOS Terminal：
export APIBEST_API_KEY="你的 API Key"Windows PowerShell：
$env:APIBEST_API_KEY="你的 API Key"以上命令只对当前终端会话有效。从桌面图标启动的应用不一定继承终端临时环境变量；长期配置时应使用操作系统用户环境或当前 Codex 版本提供的安全配置入口。
3. 编辑用户级 config.toml
macOS：
~/.codex/config.tomlWindows PowerShell：
$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"字段说明：
| 字段 | 作用 |
|---|---|
model | APIBest 控制台实际提供的模型 ID |
model_provider | 选择下方定义的 apibest 提供商 |
base_url | API 基础地址，保留 /v1 |
env_key | 保存密钥的环境变量名称，不是密钥值 |
wire_api | 使用适合 Codex 工具工作流的 Responses API |
approval_policy | 需要更高权限时请求用户确认 |
sandbox_mode | 默认只在当前工作区范围内写入 |
自定义提供商属于机器级设置，应放在用户目录下。项目内 .codex/config.toml 不能覆盖 model_provider 和 model_providers 等机器级提供商配置。
不要把真实 API Key 写进配置
env_key = "APIBEST_API_KEY" 填的是环境变量名称。不要把它替换成真实密钥，也不要添加包含真实密钥的 api_key 字段。
九、验证 API 是否真正兼容 Codex
普通聊天能返回文字，只能证明基础请求成功。Codex 日常开发还需要文件工具、流式输出、命令执行和工具结果回传。
建议依次测试：
1. 只读项目
阅读 README 和项目目录，说明技术栈、启动方式和测试命令。不要修改文件，也不要安装依赖。
2. 读取单个文件
读取 package.json 或 pyproject.toml，总结其中的脚本、依赖和项目配置。不要修改文件。
3. 小范围修改
为一个简单工具函数补充边界条件测试，只修改相关测试文件，并运行对应测试。
如果只读回复正常，但文件读取或命令执行失败，应分别检查本地权限和第三方 API 的 Responses 流式协议、工具调用兼容性。
十、新手推荐的权限设置
建议保留：
approval_policy = "on-request"
sandbox_mode = "workspace-write"这允许 Codex 在当前工作区完成大多数任务，超出范围时会请求确认。批准前重点检查：
- 命令是否会删除或覆盖文件。
- 目标路径是否属于当前项目。
- 是否要安装软件或访问外部服务。
- 是否可能上传源码、日志或密钥。
十一、macOS 常见问题
应用无法打开
重新从官方页面下载，检查系统版本、芯片架构和磁盘空间。不要通过关闭系统安全保护运行无法确认来源的安装包。
无法读取项目目录
检查系统设置中的文件与文件夹权限，只为实际使用的项目目录授权。
终端找不到 codex
桌面应用和 CLI 是不同入口。需要 CLI 时，应安装 Node.js 后单独运行 npm 安装命令。
十二、Windows 常见问题
安装程序被阻止
核对文件来源、发布者和企业设备策略。公司电脑可能需要管理员批准。
项目路径无法访问
检查文件夹权限、云盘同步状态和路径位置。先用本地磁盘中的小型 Git 仓库测试。
PowerShell 与 WSL2 混用
确保 Node.js、Git、Codex 和项目位于同一套环境。WSL2 项目应优先使用 WSL2 内安装的 CLI。
十三、API 常见错误
401 或 403
检查 API Key 是否存在、是否失效，以及 Codex 进程能否读取 APIBEST_API_KEY。
404 或地址重复
正确地址是：
base_url = "https://apibest.org/v1"不要写成 .../v1/v1，也不要自行追加 /responses。
模型不存在
模型 ID 以 APIBest 控制台实际显示为准。不同账号或时期可用范围可能不同。
能回答但不能调用工具
先检查本地工作区权限；如果权限正常，需要确认第三方 API 是否完整支持 Responses API、流式事件、工具调用和工具结果回传。
更多排错步骤见 Codex 自定义 API 常见错误与排查。
十四、安全使用清单
- 只从 OpenAI 官方页面下载安装包。
- 不在第三方页面输入 OpenAI 密码或验证码。
- 不把 API Key 写进 Git 仓库。
- 打开项目后先检查路径、分支和未提交改动。
- 对删除文件、安装软件和外部访问保持人工确认。
- 使用第三方 API 前确认代码的数据与合规要求。
- Codex 完成任务后检查实际差异和测试结果。
总结
ChatGPT Codex 的官网访问、客户端安装、账号登录和模型 API 是四个独立环节。macOS 和 Windows 用户都应从 OpenAI Codex 官方页面 获取当前版本，并按操作系统正常安全流程完成安装。
需要自定义 API 时，可以访问 https://apibest.org 获取 API Key，把基础地址设置为 https://apibest.org/v1，再通过用户级 ~/.codex/config.toml 配置提供商。最后按照“只读项目、读取文件、小范围修改并运行测试”的顺序验证完整能力。