1 Codex 解决手机号验证码问题
适用场景:配置 OpenAI Codex CLI 或者 登录 Codex APP 桌面端 时,登录要求绑定手机号、收不到短信验证码,或无法正常完成短信验证。
亲测有效:在 Chrome 中登录 ChatGPT 后,用本地插件导出
auth.json放到 Codex 配置目录,即可跳过 CLI 侧或者 APP 侧 的手机号验证。
1.1 背景
Codex CLI 首次登录时,部分账号会卡在:
- 强制绑定手机号;
- 短信验证码收不到或延迟;
- 地区/运营商限制。
若你已在 Chrome 里登录 chatgpt.com,可直接把浏览器会话导出为 auth.json,让 Codex 复用该凭证,无需在 CLI 再走短信流程。
1.2 前置条件
- 已安装 Chrome(或支持加载未打包扩展的 Chromium 浏览器)。
- 拥有可正常使用的 ChatGPT 账号。
- 能在浏览器中完成 chatgpt.com/ 登录。
- 本机已安装或准备安装 Codex CLI。
1.3 安装插件导出 auth.json
核心思路:在已登录 ChatGPT 的 Chrome 中,用本地扩展读取会话并生成 Codex 规范的 auth.json,全程不上传任何服务器。
1.3.1 步骤 1:下载插件
任选其一:
- 原作者仓库(推荐):github.com/zhishile/co…
- 百度网盘:pan.baidu.com/s/1cVsiug11…
下载后解压,确认目录中有 extension/manifest.json。
1.3.2 步骤 2:解压并加载扩展程序
准备工作:将压缩包解压为文件夹(不要直接在 zip 内加载)。
- 打开 Chrome,地址栏输入
chrome://extensions/并回车。 - 开启右上角 「开发者模式」(Developer mode)。
- 点击 「加载已解压的扩展程序」(Load unpacked)。
- 选择解压后的
extension目录(该目录下必须有manifest.json)。
1.3.3 步骤 3:检查是否加载成功
在扩展列表中应能看到 Codex 认证助手,启用状态正常,无报错。
若加载失败,常见原因:
- 选错了目录(应选
extension文件夹,而非仓库根目录)。 - 压缩包未完整解压。
- 浏览器版本过旧,不支持 Manifest V3。
1.3.4 步骤 4:固定扩展程序
点击工具栏 拼图图标 → 找到 Codex 认证助手 → 固定。
1.3.5 步骤 5:导出身份信息
- 先在 Chrome 中打开并登录 chatgpt.com/。
- 点击 Codex 认证助手 图标。
- 插件会检测登录状态;若未登录,先在网页完成登录。
- 点击 「导出身份信息」 或 「生成并保存 auth.json」,浏览器会下载
auth.json。
1.3.6 步骤 6:放置 auth.json 并验证 Codex
将下载的文件放到 Codex 认证目录(建议先备份再覆盖):
| 系统 | 路径 |
|---|---|
| Windows | %USERPROFILE%\.codex\auth.json |
| macOS / Linux | ~/.codex/auth.json |
# Windows
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"
Copy-Item "C:\Users\你的用户名\Downloads\auth.json" "$env:USERPROFILE\.codex\auth.json"
# macOS / Linux
mkdir -p ~/.codex
cp ~/Downloads/auth.json ~/.codex/auth.json
chmod 600 ~/.codex/auth.json
在终端运行 Codex,确认不再弹出手机号验证。【Codex APP 重启即可】
建议:导出后另存一份备份(如
auth.json.bak),Token 过期时可快速恢复。
1.4 安全须知
auth.json 等同于 ChatGPT 登录凭证,请勿上传公开网盘、提交 GitHub 或发给他人。Token 过期后重新导出;若怀疑泄露,请在 ChatGPT 设置中退出所有设备并改密。
1.5 常见问题
| 现象 | 处理办法 |
|---|---|
| 插件显示未登录 | 先在 chatgpt.com 网页登录;检查广告拦截是否拦截 Cookie |
| 导出后 Codex 仍要验证 | 确认路径为 ~/.codex/auth.json;重新导出;查看插件 Token 倒计时 |
| 扩展无法加载 | 必须选择含 manifest.json 的 extension 目录 |
| auth.json 异常偏小 | 退出 ChatGPT 重新登录后再导出 |
1.6 维护说明
关注插件中的 Token 有效期,临近过期时重新登录 ChatGPT 并导出,覆盖 ~/.codex/auth.json 即可。
1.7 参考链接
- codex-auth-helper
- ChatGPT
- Chrome 扩展:
chrome://extensions/
最后更新:2026-06-03 · 亲测有效