# codex-auth-switcher

**Repository Path**: wetion/codex-auth-switcher

## Basic Information

- **Project Name**: codex-auth-switcher
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-26
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Codex Auth Switcher

[English](README.en.md) | 简体中文

VS Code 扩展，用于管理多个 Codex `auth.json` 账号、查看配额、快速切换当前生效账号，并改善多窗口账号同步体验。

![Version](https://img.shields.io/badge/version-0.1.11-blue)
![VS Code](https://img.shields.io/badge/VS%20Code-%5E1.96.0-007acc)
![License](https://img.shields.io/github/license/wetiontop/codex-auth-switcher)

## 主要功能

- 多账号保存、切换、删除、详情查看。
- OAuth 添加账号，或导入当前本机 `auth.json`。
- 首次启动自动检测本地 Codex 账号，并提示绑定。
- 查看 5 小时、每周、Code Review 配额和重置时间。
- Dashboard 总览面板、账号详情页、状态栏配额提示。
- 多窗口同步：其他 VS Code 窗口切换账号后，当前窗口会检测并提示重载同步内置 Codex 会话。
- 自动刷新配额、后台 Token 续期、低配额提醒和自动切换账号。
- 导出/导入共享 JSON，支持备份恢复。
- 可选联动 Codex App 重启策略。
- 扩展内语言可单独设置为自动、English、简体中文等。

## 使用方式

1. 安装扩展。
2. 首次启动时，如果本机已有 Codex `auth.json`，按提示绑定当前账号。
3. 也可以从命令面板运行 `Codex Auth Switcher: Add Account via OAuth` 添加账号。
4. 运行 `Codex Auth Switcher: Show Quota Summary` 打开总览面板。
5. 在面板里刷新配额、切换账号、导入导出、批量操作或查看详情。

## 常用命令

- `Codex Auth Switcher: Add Account via OAuth`
- `Codex Auth Switcher: Import Current auth.json`
- `Codex Auth Switcher: Reauthorize Account`
- `Codex Auth Switcher: Switch Account`
- `Codex Auth Switcher: Refresh Quota`
- `Codex Auth Switcher: Refresh All Quotas`
- `Codex Auth Switcher: Restore Accounts from Backup`
- `Codex Auth Switcher: Restore Accounts from auth.json`
- `Codex Auth Switcher: Restore Accounts from Shared JSON`
- `Codex Auth Switcher: Remove Account`
- `Codex Auth Switcher: Toggle Status Bar Account`
- `Codex Auth Switcher: Open Details`
- `Codex Auth Switcher: Show Quota Summary`

## 本地安装 VSIX

```bash
npm install
npm run package
code --install-extension codex-auth-switcher-x.y.z.vsix
```

从源码调试时，在 VS Code 中打开本项目并按 `F5` 启动 Extension Development Host。

## 历史说明

本项目由旧的 `Codex Accounts Manager` / `Codex Tools` 迭代而来，旧项目地址仅作为历史引用：

- 旧项目：<https://github.com/wannanbigpig/codex-tools>
- 当前项目：<https://github.com/wetiontop/codex-auth-switcher>

当前扩展名称、包名、图标、公告和后续维护均以 `Codex Auth Switcher` 为准。

## 注意事项

- 账号数据保存在本机，导出的共享 JSON 会包含敏感凭证，请妥善保存和传输。
- 切换账号会更新当前机器全局生效的 Codex `auth.json`。
- 切换后当前 VS Code/Codex 会话可能仍需重载，扩展会显示重载提示。
- 请仅管理你合法拥有并有权使用的账号，并自行遵守相关平台规则。

## License

MIT