Codex国内下载、安装、配置保姆级教程(2026最新版)
发布时间:2026-10-03 | 浏览:1
本文按操作顺序介绍 Codex 桌面端:下载官方应用、安装、选择 API Key 登录,再连接 APIBest 自定义 API。需要先准备 Key 的读者可访问 https://apibest.org ,API 基础地址为 https://apibest.org/v1 。
OpenAI Codex 官方下载页面
不要保存别人分享的安装包直链。官方版本变化时,产品页会提供当前有效的下载方式和系统要求。
域名是 openai.com 。
选择的是 macOS 或 Windows 对应版本。
第 2 步:安装 macOS 版本
在“关于本机”查看芯片和系统版本。
打开安装包,把应用放入“应用程序”。
从 Launchpad 或 Finder 启动 Codex。
首次启动出现来源确认时,先检查安装包确实来自 OpenAI。不要关闭 Gatekeeper,也不要一次授权整个磁盘。
第 3 步:安装 Windows 版本
Windows 用户按以下顺序操作:
从同一官方产品页下载 Windows 安装程序。
SmartScreen 出现提醒不等于一定有风险,但必须先核对来源。公司电脑若被管理员策略拦截,应通过正规审批安装。
第 4 步:选择“使用其他方式登录”
打开 Codex 后会看到欢迎页面。如果计划使用 API Key:
不选择“使用 ChatGPT 继续”。
点击 “使用其他方式登录” 。
进入 API Key 输入页面。
可以用 sk-123456 临时确认输入格式,实际使用时再换成自己的 Key。官方 OpenAI Key 可按界面直接登录;APIBest Key 还要完成后面的地址和提供商配置。
第 5 步:复制 APIBest API Key
打开 APIBest 并进入 API 密钥页面,复制目标 Key。
不要把完整 Key 粘贴到文章、Git 提交或公开错误截图。建议专门为 Codex 创建一个便于停用和轮换的密钥。
Codex 配置通过环境变量名称读取 Key。本文使用 APIBEST_API_KEY 。
Windows PowerShell 当前会话:
这两条命令都是临时设置。从桌面图标启动应用时,Codex 可能读取不到终端变量。长期使用应通过系统用户环境或应用当前提供的安全设置入口保存。
第 7 步:找到 config.toml
Windows 用户配置文件:
目录或文件不存在时可以创建。这里必须使用用户目录,而不是项目里的 .codex/config.toml ,因为模型提供商属于机器级设置。
model_provider 与表名中的 apibest 一致。
base_url 只出现一个 /v1 。
env_key 写变量名 APIBEST_API_KEY 。
wire_api 设置为 responses 。
model 与 APIBest 控制台可用模型 ID 一致。
::: danger 不要把 Key 粘到 TOML 中 真实密钥不应替换 env_key ,也不应写成额外的 api_key = "..." 。凭据与配置分离可以降低误提交风险。 :::
完全退出 Codex,而不是只关闭窗口。
确认系统用户环境中存在 APIBEST_API_KEY 。
新建任务,使新的模型提供商配置生效。
第 10 步:根据错误快速定位
Key 不存在、失效、余额不足或没有模型权限。检查桌面应用是否真正读取到了环境变量。
检查 base_url 。正确写法是:
不要追加 /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。遇到错误时按状态码排查,不要从头反复安装。
OpenAI Codex 官方页面
Codex 自定义 API 排错