一、 背景与常见痛点
不少开发者在本地安装并启动 Codex 客户端后,往往在第一步登录就遇到了阻碍:
-
强制验证海外手机号:明明在浏览器中可以正常使用 ChatGPT 网页版,但打开 Codex 登录时,却强制弹出海外手机号绑定页面。
-
接码成本与失效问题:市面上的接码平台、Google Voice 或海外实体卡成本较高,且验证码经常接收失败,即使绑定成功也容易在短期内失效。
-
手动抓取 Cookie 门槛高:手动在开发者工具中抓取 Session Token 或修改 JSON 配置文件极为繁琐,格式稍有错漏就会直接提示认证失败。
解决思路:只要你的浏览器能正常登录 ChatGPT 网页端,就可以借助开源的“Codex 认证助手”扩展程序,直接提取浏览器中的登录会话凭据,并一键生成 Codex 所需的配置文件,全程不到一分钟即可完成授权登录。
二、 准备工作
-
正常登录的 ChatGPT 网页端:使用 Chrome 或 Edge 浏览器打开 ChatGPT 官网并确保处于正常登录状态。
-
下载开源扩展:
-
GitHub 官方源:Codex 认证助手 Releases
-
国内网盘分流:夸克网盘下载通道
-
下载最新的压缩包文件(ZIP 格式)保存到本地电脑。
-
三、 详细操作步骤
第一步:解压扩展安装包
将下载好的 ZIP 压缩包解压到本地电脑的任意文件夹中,解压后会得到包含扩展程序完整代码的文件夹。
第二步:在浏览器中加载扩展程序
-
打开 Chrome 或 Edge 浏览器,进入 “扩展程序” 管理页面:
-
Chrome 浏览器在地址栏输入:
chrome://extensions/ -
Edge 浏览器在地址栏输入:
edge://extensions/
-
-
开启页面右上角的 “开发者模式” 开关。
-
点击页面左上角的 “加载已解压的扩展程序” 按钮。
-
选中刚才解压出来的文件夹,加载成功后列表中将显示 “Codex 认证助手” 插件图标。
第三步:一键导出身份凭据
-
切换到已经登录好账号的 ChatGPT 网页端标签页。
-
点击浏览器右上角扩展栏中的 “Codex 认证助手” 图标展开面板。
-
扩展程序会自动检测当前账号登录状态及有效期。
-
点击面板下方的 “导出身份信息” 按钮,浏览器会自动生成并下载配置文件。
第四步:放置凭据至 Codex 根目录
-
打开 Windows 文件资源管理器,进入当前用户主目录下的
.codex文件夹,默认路径为:PlaintextC:\Users\<你的Windows用户名>\.codex\ -
将刚才导出的配置文件直接复制粘贴到
.codex根目录下。注意:必须直接存放在
.codex根目录下,切勿放进内部的子文件夹中,否则客户端无法正确定位读取。
第五步:重启 Codex 客户端
关闭之前卡住的登录窗口,重新打开 Codex 客户端并点击登录。客户端会自动读取本地凭证并直接进入操作界面,完全跳过手机号验证流程。
四、 注意事项与常见问题排查
-
同浏览器环境:扩展程序只能读取当前安装该插件的浏览器会话。如果在 Chrome 中登录了 ChatGPT,扩展也必须安装在 Chrome 中。
-
凭据安全保密:导出的凭据文件包含核心登录 Token,相当于你的临时登录身份。切勿将其公开发布至 GitHub、网盘或分享给陌生人;若怀疑凭据泄露,请立即在官网退出所有设备并重新登录。
-
凭据过期处理:若长时间未使用或在网页端退出了 ChatGPT 账号,凭据可能会失效。遇到无法连接时,只需重新打开网页端扩展,再次点击“导出身份信息”覆盖本地旧文件即可,无需重复安装扩展。
-
登录失败排查清单:
-
检查配置文件是否准确放置在
.codex根目录下,且文件名未被系统加上(1)等重命名后缀。 -
检查 ChatGPT 网页端当前是否仍保持正常登录状态。
-
确认 Codex 客户端已更新至最新版本。
-
检查本地网络代理环境是否正常可用。
-
本文作者为桃子味,转载请注明。
