Codex下载、安装、配置保姆级教程（2026最新版）

Codex下载、安装、配置保姆级教程（2026最新版）

按步骤完成 Codex 桌面应用下载、Windows/macOS 安装、API Key 登录和 APIBest 自定义 API 配置。

Codex下载、安装、配置保姆级教程（2026最新版）#

本文按操作顺序介绍 Codex 桌面端：下载官方应用、安装、选择 API Key 登录，再连接 APIBest 自定义 API。需要先准备 Key 的读者可访问 https://apibest.org，API 基础地址为 https://apibest.org/v1。

::: warning 开始前知道两件事 Codex 安装包必须来自 OpenAI 官方页面；APIBest 是第三方 API 服务。客户端安全与代码数据安全都需要单独判断。 :::

第 1 步：打开官方下载页面#

进入：

OpenAI Codex 官方下载页面

不要保存别人分享的安装包直链。官方版本变化时，产品页会提供当前有效的下载方式和系统要求。

下载之前核对：

  • 域名是 openai.com。
  • 选择的是 macOS 或 Windows 对应版本。
  • 设备有足够磁盘空间。
  • 企业设备允许安装开发工具。

第 2 步：安装 macOS 版本#

Mac 用户按以下顺序操作：

  1. 在“关于本机”查看芯片和系统版本。
  2. 下载与本机匹配的官方安装包。
  3. 打开安装包，把应用放入“应用程序”。
  4. 从 Launchpad 或 Finder 启动 Codex。

首次启动出现来源确认时，先检查安装包确实来自 OpenAI。不要关闭 Gatekeeper，也不要一次授权整个磁盘。

第 3 步：安装 Windows 版本#

Windows 用户按以下顺序操作：

  1. 从同一官方产品页下载 Windows 安装程序。
  2. 核对文件发布者。
  3. 双击运行安装向导。
  4. 从开始菜单打开 Codex。

SmartScreen 出现提醒不等于一定有风险，但必须先核对来源。公司电脑若被管理员策略拦截，应通过正规审批安装。

第 4 步：选择“使用其他方式登录”#

打开 Codex 后会看到欢迎页面。如果计划使用 API Key：

  1. 不选择“使用 ChatGPT 继续”。
  2. 点击 “使用其他方式登录”。
  3. 进入 API Key 输入页面。

在 Codex 欢迎页选择其他登录方式

API Key 页面如下：

Codex 的 OpenAI API 密钥输入框

可以用 sk-123456 临时确认输入格式，实际使用时再换成自己的 Key。官方 OpenAI Key 可按界面直接登录；APIBest Key 还要完成后面的地址和提供商配置。

第 5 步：复制 APIBest API Key#

打开 APIBest 并进入 API 密钥页面，复制目标 Key。

从 APIBest 控制台复制 API Key

不要把完整 Key 粘贴到文章、Git 提交或公开错误截图。建议专门为 Codex 创建一个便于停用和轮换的密钥。

第 6 步：保存密钥变量#

Codex 配置通过环境变量名称读取 Key。本文使用 APIBEST_API_KEY。

macOS 当前终端：

bash
export APIBEST_API_KEY="你的 API Key"

Windows PowerShell 当前会话：

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

这两条命令都是临时设置。从桌面图标启动应用时，Codex 可能读取不到终端变量。长期使用应通过系统用户环境或应用当前提供的安全设置入口保存。

第 7 步：找到 config.toml#

macOS 用户配置文件：

text
~/.codex/config.toml

Windows 用户配置文件：

text
$HOME\.codex\config.toml

目录或文件不存在时可以创建。这里必须使用用户目录，而不是项目里的 .codex/config.toml，因为模型提供商属于机器级设置。

第 8 步：粘贴完整配置#

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_provider 与表名中的 apibest 一致。
  • base_url 只出现一个 /v1。
  • env_key 写变量名 APIBEST_API_KEY。
  • wire_api 设置为 responses。
  • model 与 APIBest 控制台可用模型 ID 一致。

::: danger 不要把 Key 粘到 TOML 中 真实密钥不应替换 env_key，也不应写成额外的 api_key = "..."。凭据与配置分离可以降低误提交风险。 :::

第 9 步：重启桌面应用#

保存配置后：

  1. 完全退出 Codex，而不是只关闭窗口。
  2. 确认系统用户环境中存在 APIBEST_API_KEY。
  3. 重新启动应用。
  4. 新建任务，使新的模型提供商配置生效。

第 10 步：根据错误快速定位#

401 或 403#

Key 不存在、失效、余额不足或没有模型权限。检查桌面应用是否真正读取到了环境变量。

404#

检查 base_url。正确写法是：

toml
base_url = "https://apibest.org/v1"

不要追加 /responses。

模型不存在#

以 APIBest 控制台显示的模型 ID 为准，不要根据产品名称自行拼写。

文本正常但工具失败#

这通常与 Responses 流式事件或工具调用兼容性有关，而不是桌面应用安装问题。

完成检查表#

  • [ ] 客户端来自 OpenAI 官方页面。
  • [ ] 已选择 API Key 登录入口。
  • [ ] Key 已从 APIBest 控制台复制。
  • [ ] APIBEST_API_KEY 对桌面应用可见。
  • [ ] 用户级 config.toml 已保存。
  • [ ] base_url、模型 ID 和 wire_api 正确。
  • [ ] Codex 已完全退出并重新打开。

总结#

这套保姆级流程可以简化为：官网下载桌面端 -> 选择其他登录方式 -> 复制 APIBest Key -> 保存环境变量 -> 写入用户级 config.toml -> 重启 Codex。遇到错误时按状态码排查，不要从头反复安装。

参考资料#