codex · 管家:安装与接入指南
本指南适用于 Windows 与 macOS 的 codex · 管家 0.1.41。通过「codex官方 / 第三方接入」完成配置和启动;实际可用模型与额度取决于对应账号和服务权限。
下载与安装
从 codex · 管家独立页选择对应平台的安装包。Windows 使用 Windows 64 位安装程序,macOS 使用 M 系列芯片的 DMG;安装包名称、大小和版本以下载区的发行记录为准。
Windows 运行安装程序,按提示选择安装位置并完成安装。更新和修复复用已登记位置。macOS 打开 DMG,将应用拖入应用程序目录,再按系统提示打开。
本地运行组件随安装包提供。Windows 缺少 WebView2 时需联网补齐;登录和模型请求也需要可用网络、账号与额度。
使用 codex官方
在左侧选择「codex官方」。如果当前使用其他接入,先点击「切换到官方」,再点击「启动 Codex」。运行中切换按提示确认。
官方账号登录与官方 API Key 在 Codex 中管理。官方订阅充值可在网站的订阅充值页联系客服办理;短信验证仅用于适用的登录验证流程。
添加中转站
进入「第三方接入」,点击「添加」。接入类型选择「中转站」,选择对应站点并继续。
填写服务提供的地址、API Key 和可用模型。中转站可以按实际服务配置多个模型 ID;不要把网页地址、兑换码或账号密码填入 API Key。
点击「保存」,然后选择「切换」或「启动 Codex」。以「当前接入」标识确认实际使用的配置。Token 额度属于相应中转服务,与官方账号订阅分别管理。
添加模型服务商
进入「第三方接入 → 添加」,接入类型选择「服务商」,选择目录内的服务商并继续。
按该服务商提供的接入方式填写 API Key、订阅密钥或进行订阅登录。Grok 与 Google Antigravity 的订阅登录是各自独立的接入方式;账号权限与额度以服务商为准。
完成后点击「保存」,再切换或启动 Codex。服务商模型在 Codex 内选择。服务商目录和接入能力以所安装版本的实际界面为准。
配置、切换与启动
保存只提交配置,不自动切换当前接入。订阅登录也不会自行切换路由;未保存的修改须先保存,再进行切换或启动。
修改当前接入后,可按「配置后处理」设置选择询问、自动重新打开或稍后生效。「切换后启动」控制切换后的启动行为;「关闭后驻留系统托盘」控制关闭窗口后的驻留。
更多菜单还提供软件更新、导出诊断和退出程序。退出管家与关闭 Codex 是不同操作;请以客户端运行状态为准。
更新与常见问题
软件更新引导到网站手动下载完整安装包。不要根据教程截图猜测版本,始终核对下载区所列平台和实际版本。
认证失败时检查接入方式、密钥和账号权限;额度不足时到对应服务商核对。模型不可用时核对模型 ID 与套餐允许的模型。
运行中切换提示需要关闭 Codex 时,先保存工作再确认。程序损坏可重新运行对应版本安装包修复;需要协助时通过网站右下角客服咨询,并提供不含密钥的诊断信息。