Codex Accounts Manager
English · 简体中文
VS Code 扩展，用于管理多个 Codex 账号、查看配额总览，并快速切换当前生效的全局 auth.json。
用于在 VS Code 中统一管理 Codex 多账号、查看配额、切换当前账号，并通过状态栏快速监控使用情况。
功能： 配额总览面板、多账号管理、OAuth 添加账号、首次本地账号自动检测与绑定、导入当前 auth.json 后立即刷新、跨窗口账号同步、共享 JSON 恢复/导出、Codex App 联动与可选重启、自动切号、后台 token 自动刷新、详情面板、多语言界面及本扩展语言覆盖设置。
语言： 默认跟随 VS Code 语言设置，当前主要支持简体中文、English，并提供其他语言的本地化支持。
界面预览
功能概览
配额总览面板
提供一个 Webview 仪表盘，用来集中查看和管理所有 Codex 账号：
- 当前账号摘要：显示当前账号、当前团队与快捷操作
- 配额仪表：展示 5 小时、每周、代码审查配额
- 已保存账号列表：集中查看所有已保存账号
- 快捷操作：添加账号、导入当前账号、刷新全部配额
- 支持从卡片进入账号详情、切换账号、刷新、重新授权、重连会话、编辑标签、分享/导入恢复
多账号管理
- 通过 OAuth 添加新账号
- 无已绑定账号时自动检测本机已有的 Codex
auth.json
- 检测到本地账号后可一键绑定到扩展
- 导入当前本机正在使用的 Codex
auth.json
- 导入或绑定后立即刷新最新配额
- 本地保存多个账号
- 一键切换当前生效账号
- 删除不再使用的账号
- 从备份恢复全部账号
- 从
auth.json 恢复账号记录
- 从共享 JSON 恢复/导入账号并保留覆盖提示
跨窗口同步
- 监听全局
auth.json 变化
- 其他 VS Code 窗口切换账号后，当前窗口会自动同步激活账号状态
- 检测到外部账号切换时，会提示是否重载当前窗口以同步内置 Codex 会话
Codex App 联动
- 切换账号后可检测本机是否安装 Codex App
- 默认在 App 运行时尝试重启并应用新账号状态；未运行则跳过，不会强行拉起
- 支持“自动重启”与“手动确认重启”两种策略
- 允许配置自定义 Codex App 路径
- 当前已兼容 macOS、Windows、Linux 的常见安装路径与进程检测
自动切号与低配额提醒
刷新后按配置自动切换到可用备用账号- 可分别设置 5 小时与每周阈值（0~20%，默认 20%）
- 可设置临时锁定时长，避免刚触发后被频繁切号
- 配置低配额告警，触发后显示本地化提示
后台令牌刷新与网络调试
- 支持后台自动刷新已保存账号的 token（默认开启）
- 可查看上次检测、上次刷新、下次检测时间
- 可选开启
Codex Accounts Network 调试日志
配额查看
每个账号支持查看：
- 5 小时配额百分比
- 每周配额百分比
- 代码审查配额百分比
- 剩余重置时间
- 最近刷新时间
状态栏监控
- 在状态栏显示当前账号配额摘要
- 支持从总览面板将指定账号加入状态栏摘要（可选固定显示）
- 点击状态栏可直接打开完整配额面板
多语言界面
- 自动跟随 VS Code 当前语言环境
- 当前主要支持简体中文、English，并提供其他语言的本地化支持
- 配额总览面板、提示文案和交互文本会随语言切换
- 也可以在扩展设置中单独指定本扩展使用简体中文、English 或其他受支持语言，不影响 VS Code 其他界面
详情面板
支持打开单个账号详情页，查看更多原始信息，包括：
- 账号邮箱
- 团队 / 组织信息
- 用户 ID / 账号 ID
- 配额原始返回数据
更新公告
- Dashboard 在消息中心和弹窗中展示更新公告，支持单条标记已读 / 全部已读。
- 更新公告建议按
releaseVersion 声明当前版本，并且使用每个版本独立的 id，避免旧版本已读状态影响新版本显示。
announcements.json 以“当前版本的更新公告”为准，历史版本内容统一在 docs/CHANGELOG.md 追加记录，历史文档不删除。
设置项
可在总览面板右上角设置按钮中直接调整，也可以通过 VS Code Settings 搜索 codexAccounts 修改。
语言
自动（跟随 VS Code），或手动指定简体中文、English 及其他受支持语言- 仅影响本扩展的总览面板和提示文案
Codex App 重启策略
- 可开启或关闭该联动
- 开启后可选择：
自动重启：切换账号时如果 Codex App 正在运行则直接重启手动确认重启：切换后每次手动确认是否立即重启
配额自动刷新- 可关闭，或设置为
1 ~ 60 整数分钟
- 当前已支持
1~60 分钟的任意整数取值
自动切号
- 默认关闭
- 开启后可分别设置
5 小时 / 每周 配额阈值
- 刷新后如果当前激活账号触达阈值，会尝试自动切换到其他可用账号
Codex App 启动路径
仪表盘主题
auto（跟随 VS Code）lightdark
仪表盘显示
超额预警
- 可开启或关闭低配额提醒
- 默认关闭
- 开启后可设置
5% - 90% 阈值
- 刷新配额后，如果当前激活账号低于阈值，会弹出中英文预警提示
后台令牌刷新
- 可开启或关闭保存账号的后台 token 检测与更新
配额颜色阈值
- 可分别调整绿色与黄色阈值（配套 UI 提示颜色规则）
恢复数据操作
- 可在界面触发恢复备份 / 恢复
auth.json / 恢复共享 JSON
使用方式
- 安装扩展
- 首次启动时，如果本机已有本地 Codex
auth.json，扩展会提示是否立即绑定并刷新配额
- 也可以运行
Codex Accounts: Add Account via OAuth 添加账号
- 或运行
Codex Accounts: Import Current auth.json 导入当前账号
- 运行
Codex Accounts: Show Quota Summary 打开总览面板
- 在面板中可进行：刷新配额、切换账号、导入导出、批量重刷、状态栏管理等操作
- 打开详情页查看账号原始信息并执行会话/凭证修复
命令列表
在 VS Code 命令面板中可使用以下命令：
Codex Accounts: Add Account via OAuthCodex Accounts: Import Current auth.jsonCodex Accounts: Reauthorize AccountCodex Accounts: Switch AccountCodex Accounts: Refresh QuotaCodex Accounts: Refresh All QuotasCodex Accounts: Restore Accounts from BackupCodex Accounts: Restore Accounts from auth.jsonCodex Accounts: Restore Accounts from Shared JSONCodex Accounts: Remove AccountCodex Accounts: Toggle StatusBar AccountCodex Accounts: Open DetailsCodex Accounts: Open Codex HomeCodex Accounts: Show Quota Summary
安装
现在可以直接通过 VS Code 扩展市场安装，也保留 .vsix 和源码运行方式。
方式一：从扩展市场安装
- 打开 VS Code 扩展面板
- 搜索
Codex Accounts Manager
- 找到发布者
wannanbigpig 的扩展并点击安装
也可以直接打开市场页面：
Codex Accounts Manager - Visual Studio Marketplace
方式二：从 VSIX 安装
- 下载发布产物
.vsix
- 在 VS Code 中打开命令面板
- 执行
Extensions: Install from VSIX...
- 选择下载好的
.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
- 导入当前账号或首次绑定本地账号后，会立即刷新最新配额
- 如果其他窗口切换了账号，当前窗口会自动检测并提示同步
- 如果 Codex App 正在运行，切换账号后会尝试自动重启；未运行则跳过
- 配额显示依赖当前账号会话返回的数据
支持
💝 赞助项目
感谢你使用 Codex Accounts Manager。
如果这个项目对你有帮助，欢迎赞助项目的持续开发和维护。
许可证
本项目基于 MIT License 开源。
