codex-auth-helper README

The project's README from github.com/zhishile/codex-auth-helper. As one markdown file: README.md.

🔐 Codex 认证助手 (Codex Auth Helper)

Version Manifest V3 Local Only License

Codex 认证助手 是一款专为 Codex 开发者设计的安全、轻量、高颜值的凭证管理与本地配置备份辅助 Chrome 扩展程序。

通过高度安全的本地沙盒机制,本插件能够帮助您一键将 ChatGPT 登录会话凭证快速安全地导出,并自动转换为符合 Codex 运行规范的 auth.json 配置文件。


🌟 核心特性


🚀 极速上手

1. 开发者模式安装 (本地加载)

  1. 下载或克隆本仓库到您的本地电脑。
  2. 打开 Chrome 浏览器,在地址栏输入 chrome://extensions/ 并回车。
  3. 在右上角开启 "开发者模式" (Developer mode) 开关。
  4. 点击左上角的 "加载已解压的扩展程序" (Load unpacked)。
  5. 选择本仓库中的 extension 文件夹(即包含 manifest.json 的目录)。
  6. 安装完成后,在浏览器工具栏的“拼图”图标中找到 Codex 认证助手 并将其固定。

2. 导出 auth.json

  1. 确保您在当前浏览器中已经登录了 ChatGPT 官网。
  2. 点击浏览器右上角的插件图标,打开 Codex 认证助手 弹窗。
  3. 插件会自动读取已登录的会话。如果未登录,可点击 一键前往登录。
  4. 状态识别成功后,点击 生成并保存 auth.json,即可一键下载已组装完毕的配置文件。

🔒 安全与隐私承诺

[!IMPORTANT] 您的身份凭证与 Session 属于极度敏感的用户隐私,绝对不能泄露或上传到任何服务器!


📜 许可证

本项目基于 MIT License 开源,允许任何个人或团队进行自由修改与二次分发,但请务必保留原作者署名及开源协议声明。

codex-auth-helper (zhishile/codex-auth-helper)

cli-tool
Searching Database…

What is this?Codex Auth Helper is a Chrome extension that exports your logged-in ChatGPT session locally and converts it into an auth.json file matching the Codex CLI's expected credential format.
Is this a browser extension or a standalone app?It is a Chrome browser extension with a popup UI; it is not a standalone desktop or CLI app.
How do I install and use it?Clone the repo, enable Developer mode in chrome://extensions/, click 'Load unpacked', and select the extension folder containing manifest.json. Then log into ChatGPT, open the extension popup, and click 'generate and save auth.json' to download the file.
Do I need anything besides Chrome and a ChatGPT login?No external tools are needed — just Chrome in Developer mode and an active logged-in ChatGPT session in that browser.
Does it need to be loaded manually since it's not on the Chrome Web Store?Yes, it's distributed only as an unpacked extension that you load manually in Developer mode; there's no Chrome Web Store listing mentioned.
What exactly does the auth.json file contain?It contains a synthetic JWT-style id_token plus account info (avatar, email, subscription plan) assembled to match the format Codex CLI expects for authentication.
What permissions does the extension request?It only declares the 'downloads' permission to save the generated file, keeping its footprint minimal and auditable.
Can I verify the extension isn't doing anything sneaky?Yes — all code is unminified and locally bundled with no external CDN dependencies, so you can inspect background.js and popup.js directly via Chrome DevTools.
Does it show how much time is left on my session?Yes, the popup displays a real-time, second-level countdown of the token's remaining validity period.
Creator
zhishile
Size
0.1 MB
Stars
19.2K
Age
4mo
Commits · 90 Days