Codex Accounts Manager

English · 简体中文

VS Code 扩展，用于管理多个 Codex 账号、查看配额总览，并快速切换当前生效的全局 auth.json。

用于在 VS Code 中统一管理 Codex 多账号、查看配额、切换当前账号，并通过状态栏快速监控使用情况。

功能： 配额总览面板、多账号管理、OAuth 添加账号、首次本地账号自动检测与绑定、导入当前 auth.json 后立即刷新、跨窗口账号同步、共享 JSON 恢复/导出、ChatGPT/Codex 桌面应用联动与可选重启、自动切号、后台 token 自动刷新、详情面板、多语言界面及本扩展语言覆盖设置。

语言： 默认跟随 VS Code 语言设置，当前主要支持简体中文、English，并提供其他语言的本地化支持。

扩展能力： 如果你需要更完整的会话管理、CLI 启动、多实例调度等 AI 开发工作台能力，可以安装 uTools 插件 AiDeck。AiDeck 项目地址：https://github.com/wannanbigpig/aideck。

界面预览

配额总览	详情面板
设置面板	状态栏

功能概览

配额总览面板

提供一个 Webview 仪表盘，用来集中查看和管理所有 Codex 账号：

• 当前账号摘要：显示当前账号、当前团队与快捷操作
• 配额仪表：展示 5 小时、每周、代码审查配额
• 已保存账号列表：集中查看所有已保存账号
• 快捷操作：添加账号、导入当前账号、刷新全部配额
• 支持从卡片进入账号详情、切换账号、刷新、重新授权、重连会话、编辑标签、分享/导入恢复

多账号管理

• 通过 OAuth 添加新账号
• 无已绑定账号时自动检测本机已有的 Codex auth.json
• 检测到本地账号后可一键绑定到扩展
• 导入当前本机正在使用的 Codex auth.json
• 导入或绑定后立即刷新最新配额
• 本地保存多个账号
• 一键切换当前生效账号
• 删除不再使用的账号
• 从备份恢复全部账号
• 从 auth.json 恢复账号记录
• 从共享 JSON 恢复/导入账号并保留覆盖提示

跨窗口同步

• 监听全局 auth.json 变化
• 其他 VS Code 窗口切换账号后，当前窗口会自动同步激活账号状态
• 检测到外部账号切换时，会提示是否重载当前窗口以同步内置 Codex 会话

ChatGPT / Codex 桌面应用联动

• 切换账号后可检测新版 ChatGPT.app 或旧版 Codex.app
• 默认在 App 运行时尝试重启并应用新账号状态；未运行则跳过，不会强行拉起
• 支持“自动重启”与“手动确认重启”两种策略
• 允许配置自定义桌面应用路径
• 当前已兼容 macOS、Windows、Linux 的常见安装路径与进程检测

与 AiDeck 搭配使用

本扩展专注于 VS Code 内的 Codex 多账号管理、配额查看与快速切换。如果你需要更完整的会话管理、会话恢复、Codex 等 CLI 启动与多实例调度能力，可以安装 uTools 插件 AiDeck。

AiDeck 提供面向 Antigravity、Codex 等环境的统一调度层，适合需要在多个账号、多个实例和不同 AI 开发入口之间切换的场景。

项目地址：https://github.com/wannanbigpig/aideck

自动切号与低配额提醒

• 5 小时配额控制 默认关闭；关闭时状态栏隐藏 5 小时配额，Dashboard 仍正常展示，且不会触发自动切号或低配额提醒
• 只有接口返回有效配额窗口时才会参与自动化判断，避免缺失窗口被误判为 0%
• 刷新后按配置自动切换到可用备用账号
• 可分别设置 5 小时与每周阈值（0~20%，默认 20%）
• 可设置临时锁定时长，避免刚触发后被频繁切号
• 配置低配额告警，触发后显示本地化提示

后台令牌刷新与网络调试

• 支持后台自动刷新已保存账号的 token（默认开启）
• 可查看上次检测、上次刷新、下次检测时间
• 可选开启 Codex Accounts Network 调试日志
• 扩展启动时自动读取 ~/.codex/.env（或 CODEX_HOME/.env）中的 HTTPS_PROXY、HTTP_PROXY、ALL_PROXY 和 NO_PROXY（兼容小写变量），并用于配额、OAuth、订阅等网络请求；进程已有的代理变量优先，空值可显式关闭对应配置
• 代理 URL 支持 http:// 和 https://；配置无效或使用不支持的协议时会阻止扩展网络请求并明确提示，不会静默回退直连

配额查看

每个账号支持查看：

• 5 小时配额百分比
• 每周配额百分比
• 代码审查配额百分比
• 剩余重置时间
• 最近刷新时间

状态栏监控

• 在状态栏显示当前账号配额摘要
• 支持从总览面板将指定账号加入状态栏摘要（可选固定显示）
• 点击状态栏可直接打开完整配额面板

多语言界面

• 自动跟随 VS Code 当前语言环境
• 当前主要支持简体中文、English，并提供其他语言的本地化支持
• 配额总览面板、提示文案和交互文本会随语言切换
• 也可以在扩展设置中单独指定本扩展使用简体中文、English 或其他受支持语言，不影响 VS Code 其他界面

详情面板

支持打开单个账号详情页，查看更多原始信息，包括：

• 账号邮箱
• 团队 / 组织信息
• 用户 ID / 账号 ID
• 配额原始返回数据

更新公告

• Dashboard 在消息中心和弹窗中展示更新公告，支持单条标记已读 / 全部已读。
• 更新公告建议按 releaseVersion 声明当前版本，并且使用每个版本独立的 id，避免旧版本已读状态影响新版本显示。
• announcements.json 以“当前版本的更新公告”为准，历史版本内容统一在 docs/CHANGELOG.md 追加记录，历史文档不删除。

设置项

可在总览面板右上角设置按钮中直接调整，也可以通过 VS Code Settings 搜索 codexAccounts 修改。

• 语言
  • 自动（跟随 VS Code），或手动指定简体中文、English 及其他受支持语言
  • 仅影响本扩展的总览面板和提示文案
• ChatGPT / Codex 桌面应用重启策略
  • 可开启或关闭该联动
  • 开启后可选择：
  • 自动重启：切换账号时如果对应桌面应用正在运行则直接重启
  • 手动确认重启：切换后每次手动确认是否立即重启
• 配额自动刷新
• 可关闭，或设置为 1 ~ 60 整数分钟
  • 默认关闭
  • 关闭后不再定时刷新
• 当前已支持 1~60 分钟的任意整数取值
• 自动切号
  • 默认关闭
  • 开启后可分别设置 5 小时 / 每周 配额阈值
  • 刷新后如果当前激活账号触达阈值，会尝试自动切换到其他可用账号
  • 5 小时阈值仅在 5 小时配额控制 开启时生效；每周阈值独立生效
• Codex App 启动路径
  • 可选自定义桌面端路径
  • 留空时使用自动检测
• 仪表盘主题
  • auto（跟随 VS Code）
  • light
  • dark
• 仪表盘显示
  • 可选择是否显示 Code Review 配额
• 超额预警
  • 可开启或关闭低配额提醒
  • 默认关闭
  • 开启后可设置 5% - 90% 阈值
  • 刷新配额后，如果当前激活账号低于阈值，会弹出中英文预警提示
  • 5 小时配额控制 关闭时，仅检查每周配额
• 后台令牌刷新
  • 可开启或关闭保存账号的后台 token 检测与更新
• 配额颜色阈值
  • 可分别调整绿色与黄色阈值（配套 UI 提示颜色规则）
• 恢复数据操作
  • 可在界面触发恢复备份 / 恢复 auth.json / 恢复共享 JSON

使用方式

1. 安装扩展
2. 首次启动时，如果本机已有本地 Codex auth.json，扩展会提示是否立即绑定并刷新配额
3. 也可以运行 Codex Accounts: Add Account via OAuth 添加账号
4. 或运行 Codex Accounts: Import Current auth.json 导入当前账号
5. 运行 Codex Accounts: Show Quota Summary 打开总览面板
6. 在面板中可进行：刷新配额、切换账号、导入导出、批量重刷、状态栏管理等操作
7. 打开详情页查看账号原始信息并执行会话/凭证修复

如何迁移账号到另一台电脑

1. 在账号管理界面勾选需要迁移的账号
2. 点击 导出选中账号 JSON
3. 在新电脑安装扩展
4. 点击 从 Shared JSON 恢复，或在添加账号窗口中导入 JSON
5. 完成账号恢复

命令列表

在 VS Code 命令面板中可使用以下命令：

• Codex Accounts: Add Account via OAuth
• Codex Accounts: Import Current auth.json
• Codex Accounts: Reauthorize Account
• Codex Accounts: Switch Account
• Codex Accounts: Refresh Quota
• Codex Accounts: Refresh All Quotas
• Codex Accounts: Restore Accounts from Backup
• Codex Accounts: Restore Accounts from auth.json
• Codex Accounts: Restore Accounts from Shared JSON
• Codex Accounts: Remove Account
• Codex Accounts: Toggle StatusBar Account
• Codex Accounts: Open Details
• Codex Accounts: Open Codex Home
• Codex Accounts: Show Quota Summary

安装

现在可以直接通过 VS Code 扩展市场安装，也保留 .vsix 和源码运行方式。

方式一：从扩展市场安装

1. 打开 VS Code 扩展面板
2. 搜索 Codex Accounts Manager
3. 找到发布者 wannanbigpig 的扩展并点击安装

也可以直接打开市场页面：

Codex Accounts Manager - Visual Studio Marketplace

方式二：从 VSIX 安装

1. 下载发布产物 .vsix
2. 在 VS Code 中打开命令面板
3. 执行 Extensions: Install from VSIX...
4. 选择下载好的 .vsix 文件完成安装

也可以使用命令行安装：

code --install-extension codex-accounts-manager-x.y.z.vsix

方式三：从源码运行

git clone https://github.com/wannanbigpig/codex-tools.git
cd codex-tools
npm install
npm run compile

在 VS Code 中按 F5 启动 Extension Development Host。

打包 VSIX

npx @vscode/vsce package

说明

• 账号数据保存在本地
• 切换账号会更新当前机器全局生效的 Codex auth.json
• 导入当前账号或首次绑定本地账号后，会立即刷新最新配额
• 如果其他窗口切换了账号，当前窗口会自动检测并提示同步
• 如果 ChatGPT/Codex 桌面应用正在运行，切换账号后会尝试自动重启；未运行则跳过
• Free 账户的 30 天配额窗口显示为“每月”；付费账户的 7 天窗口显示为“每周”
• 配额显示依赖当前账号会话返回的数据

支持

• ⭐ GitHub Star
• 💬 反馈问题

💝 赞助项目

感谢你使用 Codex Accounts Manager。

如果这个项目对你有帮助，欢迎赞助项目的持续开发和维护。

许可证

本项目基于 MIT License 开源。