## 摘要

Codex 客户端登录时强制要求绑定海外手机号，这是国内开发者最头疼的问题之一。本文介绍一种完全免费的解决方案——借助开源浏览器扩展，直接从已登录的 ChatGPT 网页会话中导出 Codex 可用的 `auth.json` 认证文件，然后覆盖本地配置，让 Codex 跳过手机号验证流程直接完成登录。全程无需接码平台、无需海外手机号，只需一个正常可用的 ChatGPT 账号。教程涵盖扩展的下载安装、凭证导出、文件覆盖及 CC-Switch 多账号管理配置。

## 关键词

Codex免手机验证、ChatGPT登录凭证导出、auth.json、浏览器扩展、CC-Switch、开源工具

## 一、原理说明

Codex 客户端在登录时，会向 OpenAI 服务器请求授权，如果检测到账号未绑定手机号，就会强制弹出验证流程。但如果你已经通过浏览器登录了 ChatGPT 网页版，浏览器本地就保存着一套完整的认证信息（包括 `access_token`、`id_token` 等）。

我们需要做的，就是用浏览器扩展读取这套认证信息，转换成 Codex 能识别的 `auth.json` 格式，然后写入 Codex 的配置目录。Codex 启动时读取到这个文件，就认为你已经登录成功了，从而完全跳过手机验证。

**重要前提**：整个过程需要**开启代理节点**，确保浏览器和 Codex 客户端都能正常访问 `chatgpt.com` 和 OpenAI 的 API 服务。节点不稳定会导致扩展读取不到会话或 Codex 无法正常工作。

## 二、准备工作

### 2.1 确认 ChatGPT 网页版已登录

在浏览器中打开 `https://chatgpt.com`，确认已经登录了你的 ChatGPT 账号（Free、Plus 或 Pro 均可）。如果还没有账号，需要先注册一个。注册时同样建议开启节点，选择支持的地区。

### 2.2 下载并安装 Codex 客户端

Codex 现已整合到 ChatGPT 客户端中。访问 OpenAI 官网下载 ChatGPT 桌面客户端（macOS / Windows 均有），完成安装后先不要启动，等配置完成后再打开。

### 2.3 确认 Codex 配置目录

Codex 的认证文件通常位于：

-   **macOS / Linux**：`~/.codex/auth.json`
    
-   **Windows**：`%USERPROFILE%\.codex\auth.json`（即 `C:\Users\你的用户名\.codex\auth.json`）
    

如果 `.codex` 目录还不存在，首次运行 Codex 后会自动创建。

## 三、下载并安装开源扩展

目前有多个开源项目可以实现这个功能，以下三个均可使用：

### 方案A：Codex Auth Helper（推荐，3.4K Star）

这是目前社区使用最广泛、维护最活跃的项目。

**下载地址**：`https://github.com/zhishile/codex-auth-helper`

**安装步骤**：

1.  打开上述链接，点击绿色的 **Code** 按钮，选择 **Download ZIP**，将仓库下载到本地并解压缩。
    
2.  打开 Chrome 浏览器，在地址栏输入 `chrome://extensions/` 并回车。
    
3.  打开右上角的 **“开发者模式”** 开关。
    
4.  点击左上角的 **“加载已解压的扩展程序”** 。
    
5.  选择解压后目录中的 `extension` 文件夹（即包含 `manifest.json` 的目录）。
    
6.  安装成功后，在浏览器工具栏的“拼图”图标中找到 **Codex 认证助手**，点击固定到工具栏。
    

### 方案B：Codex Auth Bridge

**下载地址**：`https://github.com/ChenSir886/codex-auth-bridge-manual`

安装方式与方案A完全一致：下载 ZIP → 解压 → 加载 `extension/` 目录。

### 方案C：Codex Auth Exporter

**下载地址**：`https://github.com/1insxxxp/codex-extension`

同样下载后加载已解压的扩展程序目录。

> 三个方案功能相同，任选其一即可。推荐使用方案A，更新更频繁。

## 四、导出 auth.json

扩展安装完成后，操作流程如下：

**第一步**：确保浏览器中已经登录了 ChatGPT 网页版（`https://chatgpt.com`）。

**第二步**：点击浏览器工具栏中的扩展图标（Codex 认证助手 / Codex Auth Bridge）。扩展会自动读取当前登录状态，并显示账号信息，包括头像、邮箱、订阅计划（Free / Plus / Pro）以及 Token 有效期倒计时。

**第三步**：点击 **“生成并保存 auth.json”** 按钮，扩展会自动生成符合 Codex 规范的配置文件并下载到本地。

生成的 `auth.json` 中包含以下核心字段：

-   `tokens.access_token`：访问令牌
    
-   `tokens.id_token`：身份令牌
    
-   `tokens.account_id`：账号 ID
    
-   `last_refresh`：最后刷新时间
    

## 五、覆盖 Codex 配置文件

### 5.1 备份原文件（重要）

在覆盖之前，先备份原有的认证文件，以防万一需要恢复：

bash

```bash
cp ~/.codex/auth.json ~/.codex/auth.json.bak
```

Windows 用户可以在文件管理器中找到 `C:\Users\你的用户名\.codex\` 目录，手动复制一份 `auth.json` 作为备份。

### 5.2 覆盖 auth.json

将扩展生成的 `auth.json` 文件复制到 Codex 的配置目录：

-   **macOS / Linux**：`~/.codex/auth.json`
    
-   **Windows**：`C:\Users\你的用户名\.codex\auth.json`
    

覆盖后，重启 Codex 客户端。客户端会直接读取 `auth.json` 中的认证信息，不再弹出手机验证界面。

## 六、配置到 CC-Switch 实现多账号管理

如果你需要管理多个 ChatGPT 账号，或者希望在不同公益站之间切换，可以把 `auth.json` 配置到 CC-Switch 中，实现一键切换。

### 6.1 下载 CC-Switch

访问 `https://ccswitch.io/zh/` 下载并安装 CC-Switch。

### 6.2 配置 Codex 账号

1.  打开 CC-Switch，在顶部选择 **Codex** 面板。
    
2.  点击右上角 **+** 按钮，新增一个供应商/账号条目。
    
3.  将扩展导出的 `auth.json` 内容粘贴到对应账号的配置中。
    
4.  保存后，在 CC-Switch 中激活该账号，CC-Switch 会自动将 `auth.json` 写入 Codex 的配置目录。
    

这样，你可以在不同账号之间一键切换，无需每次手动替换文件。

## 七、验证与常见问题

### 7.1 验证登录是否成功

重启 Codex 客户端后，如果不再弹出手机验证界面，而是直接进入主界面并能正常使用，说明配置成功。

### 7.2 常见问题

**Q：Codex 仍然弹出手机验证怎么办？**  
首先检查 `auth.json` 是否覆盖到了正确的路径。其次确认代理节点是否正常工作。最后，部分用户反馈需要开启 MFA（多因素认证）才能生效。

**Q：Token 过期了怎么办？**  
ChatGPT Web session 的 token 会过期。过期后，重新登录 ChatGPT 网页版，打开扩展，重新生成并复制新的 `auth.json`，再次覆盖即可。

**Q：扩展提示“未检测到 ChatGPT 登录状态”？**  
确认浏览器中已经登录 `chatgpt.com`，并且代理节点处于开启状态。如果 ChatGPT 网页版本身都无法正常访问，扩展自然也无法读取会话。

**Q：auth.json 安全吗？**  
`auth.json` 包含可以访问你 ChatGPT 账号的敏感 Token，**绝对不要分享给他人、截图发到网上或提交到公开仓库**。扩展本身是纯本地处理，不上传任何数据到第三方服务器。

## 八、注意事项

**代理节点必须开启**：整个流程依赖对 `chatgpt.com` 的访问，没有稳定的节点，扩展和 Codex 都无法正常工作。

**Token 有效期有限**：`auth.json` 不是永久有效的，Token 过期后需要重新导出。建议把扩展固定到工具栏，方便随时重新生成。

**仅用于个人账号**：本方法是为了让拥有 ChatGPT 账号的用户绕过不必要的手机验证步骤，请勿用于滥用或分享他人账号。

**选择开源项目**：以上扩展均为开源项目，代码可审计。请仅从本文提供的 GitHub 链接下载，不要从不明来源获取，以免植入恶意代码。

## 九、总结

整个流程可以归纳为五步：

1.  **开启节点**，确保能正常访问 ChatGPT。
    
2.  **安装扩展**，从 GitHub 下载开源扩展并加载到 Chrome。
    
3.  **导出凭证**，在已登录 ChatGPT 的浏览器中一键生成 `auth.json`。
    
4.  **覆盖配置**，将文件写入 `~/.codex/auth.json`。
    
5.  **重启 Codex**，验证是否跳过手机验证。
    

如果管理多账号，可以配合 CC-Switch 实现一键切换。整个过程完全免费，不需要任何接码平台或海外手机号。

摘要 Codex 客户端登录时强制要求绑定海外手机号，这是国内开发者最头疼的问题之一。本文介绍一种完全免费的解决方案——借助开源浏览器扩展，直接从已登录的 ChatGPT 网页会话中导出 Codex 可用的 auth.json 认证文件，然后覆盖本地配置，让 Codex 跳过手机号验证流程直接完成登录。全程无需接码平台、无需海外手机号，只需一个正常可用的 ChatGPT 账号。教程涵盖扩展的下载安

Codex 免手机验证登录教程：用开源扩展导出 ChatGPT 凭证

学生

开发工具

后端

职业发展

本文介绍如何通过开源浏览器扩展，从已登录的 ChatGPT 网页会话导出 auth.json 认证文件，覆盖 Codex 本地配置，从而跳过海外手机号验证，实现免费登录。教程涵盖扩展安装、凭证导出、文件覆盖及 CC-Switch 多账号管理，全程无需接码平台，仅需一个可用的 ChatGPT 账号。

多因素认证

服务器

ChatGPT

Windows

GitHub

Linux

2026上云采购 | AI焕新·智启新局

organization

apigw

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Codex 免手机验证登录教程：用开源扩展导出 ChatGPT 凭证-腾讯云开发者社区-腾讯云

Codex 免手机验证登录教程：用开源扩展导出 ChatGPT 凭证

Codex 免手机验证登录教程：用开源扩展导出 ChatGPT 凭证

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐