Codex 账号切换工具

Codex 账号切换工具（Codex Switch）是一个面向 OpenAI Codex CLI 的本地桌面账号管理器。它把多份 ~/.codex/{auth.json,config.toml,sessions/...} 状态各自打包到独立账号备份目录，一键切换"当前 Codex 账号"，并把每个账号的 plan / 5 小时额度 / 周额度直接渲染在桌面端。

跟纯账号切换脚本不同，本项目内置 plan / quota 直读：登录后通过 ChatGPT OAuth 的 id_token + ChatGPT Web API account/rateLimits / Codex app-server JSON-RPC fallback 拉取真实计划等级和 rate-limit 窗口剩余比例，不需要本地解析 Codex sessions/jsonl 日志即可看到每个账号"还能用多久"。

当前版本 v1.5.10（详见 CHANGELOG 与 Releases）。

能做什么

同一台机器多账号管理：每个账号一个备份目录（含独立的 auth.json / config.toml / sessions/），切换时把目标账号 swap 进 ~/.codex/，旧账号自动归档到备份目录。
账号页：每页 8 个账号条目，横向单行布局展示「账号名 + 套餐」「5 小时额度 + 刷新时间」「周额度 + 刷新时间」「删除 / 重命名 / 刷新 / 登录 / Base / 切换」按钮。
登录可取消：进行中的 codex login OAuth 流程支持点击同一按钮取消（向子进程 SIGTERM / taskkill），解决浏览器关闭后应用卡在等待回调的场景。
plan / quota 智能缓存：bulk plan refresh 在 6 小时窗口内跳过已确认账号，per-card 刷新按钮也共享同一缓存；切换 / 登录 / 刷新后直接复用 backend 写回的 snapshot，不重复发 IPC。
Custom Base URL：每个账号可独立配置 OPENAI_BASE_URL；配置后按钮变红警示（自定义 Base 与 ChatGPT OAuth 账号互斥）。
Codex CLI 路径自检：自动定位 codex 可执行（PATH / ~/.codex/bin / Homebrew / nvm），找不到或路径错误时设置页可手动指定，结果写入 install_state.json 优先生效。
跨平台原生 Tauri：macOS arm64 与 Windows x64 提供原生窗口、原生标题栏 / 关闭按钮，配套 5 套浅色 / 深色主题与中英文界面。
本地预览模式：没有 Tauri 运行时（直接 vite 跑前端）时自动使用 mock snapshot，方便单纯调样式。

下载

最新版：https://github.com/Cmochance/Codex_Account_Switch/releases/latest

资产命名：

codex_switch_<版本>_aarch64.dmg            macOS Apple Silicon DMG（拖拽到 Applications）
codex_switch_<版本>_aarch64.pkg            macOS Apple Silicon PKG 安装包
codex_switch_<版本>_x64-setup.exe          Windows x64 NSIS 安装包

macOS / Windows 都暂未做代码签名，首次启动可能提示「未知开发者 / 未知发布者」；macOS 可在「系统设置 → 隐私与安全」放行，Windows 可在 SmartScreen 弹窗点「更多信息 → 仍要运行」。

快速开始

从 Releases 下载并安装 Codex Switch，启动桌面窗口。
进入「设置」页，确认 Codex CLI 路径 已自动填好（默认探测 PATH / ~/.codex/bin）；缺失时手动指定，状态变绿即可。
进入「账号」页，点「添加账号」→ 输入账号别名（落地为 ~/.codex/account_backup/<别名>/）。
在新账号条目点「登录」→ 浏览器完成 ChatGPT OAuth → 回到应用，套餐 + 额度自动加载。
多账号场景：在目标条目点「切换」即可一键替换当前 ~/.codex/，原账号自动归档。
需要清空 quota cache 或重新拉计划时，点对应账号的「刷新」（≥ 6h 走完整 OAuth rotation，< 6h 复用缓存）。

仓库结构

src-tauri/：Rust + Tauri 应用根目录。
src-tauri/mac/front/：macOS HTML 壳、样式、原生窗口控制。
src-tauri/win/front/：Windows HTML 壳、样式、自绘标题栏与窗口按钮。
src-tauri/shared/front/：跨平台前端 — state / render / actions / theme / i18n / Tauri bridge / mock preview。
src-tauri/mac/runtime/ / src-tauri/win/runtime/：各自平台的 runtime adapter（profile_actions / switch / login spawn）。
src-tauri/shared/runtime/：共享 runtime — chatgpt_api、models、switch_core、profiles_index、paths、metadata、process_lock、fs_ops。
src-tauri/shared/commands/：前端可见的 Tauri command 层（dashboard / switch / profile lifecycle）。
macOS-backup/：兼容老的 shell 流程（install.sh / uninstall.sh / codex-switch.sh），用于 desktop 不可用的回退场景。
scripts/：version-sync、macOS 产物布局、.pkg 生成、CHANGELOG 校验。
examples/account_backup/demo/：auth.json / profile.json 占位模板，演示账号备份目录结构。
docs/：发布、实现笔记、安全说明、上游协议参考。

构建输出（dist/、src-tauri/target/、node_modules/、.app / .dmg / .pkg / .exe）全部 .gitignore，不入仓。

本地开发

npm install
npm run tauri:dev                  # 起 Tauri 桌面 dev 窗口 + Vite HMR
npm run build                      # 仅前端 production build（vite + tsc）
npm run test                       # cargo test --manifest-path src-tauri/Cargo.toml
npm run check:rust:windows         # cross check Windows target（macOS 本地交叉验证）
npm run test:rust:windows          # 在 Windows runner 上跑（CI 主用）

桌面端打包

Tauri 2 没暴露 bundle 输出目录配置，macOS 打包脚本在 tauri build 前把 src-tauri/target/release/bundle/macos 与 bundle/dmg symlink 到 dist/，把最终 .app / .dmg / .pkg 直接落到仓库根目录的 dist/。

本地仅打包 .app（用于手测，不签名）：

npm run tauri:build:macos-app

发布构建（.dmg + .pkg）：

npm run tauri:build:macos-release

发布构建的 .app 会作为打包输入参与签名 / notarization 链路（CI 跑），随后从 dist/ 移除，只保留 .dmg / .pkg。旧版本产物会移动到 dist/history/v<旧版本>/ 下归档；重复构建当前版本只替换根目录的当前文件，不会再额外备份。

期望产物结构：

dist/
  codex_switch_<版本>_aarch64.dmg
  codex_switch_<版本>_aarch64.pkg
  codex_switch_<版本>_x64-setup.exe      （Windows runner）
  history/
    v<旧版本>/
      ...
  web/
    ...

Windows 构建走 CI 的 tauri build --target x86_64-pc-windows-msvc；本地 macOS 上一般只跑 check:rust:windows 做类型检查。

版本与发布

版本号源头是 package.json，npm run version:sync / npm run version:set -- <semver> 把同一版本写到 package-lock.json、src-tauri/Cargo.toml、src-tauri/Cargo.lock，并在 src-tauri/mac/front/index.html / win/front/index.html 通过 Vite-injected __CODEX_APP_VERSION__ 渲染到设置页。
GitHub Release tag 用完整 semver（如 v1.5.10）。push tag → .github/workflows/build.yml 自动跑 macOS arm64 + Windows x64 构建并把产物上传到一个 draft release，不会自动转 Latest。
不要把补丁版本的 asset 上传到旧的两段式 tag（如 1.5）。
macOS 安装包仅作 Release asset 发布，不提交到 Git。

常用命令：

npm run version:sync              # 把 package.json 当前 version 同步到 Cargo / lock
npm run version:set -- 1.5.11     # 一次性 bump 到指定版本
npm run version:check             # CI 用：拒绝把 semver 字面量写回 *.html

常见问题

没有 Codex CLI 怎么办

应用启动后会探测 codex 路径；探测失败时设置页会标红「Codex CLI 路径未找到」，可手动指定（写入 install_state.json 的 user_codex_path 优先级最高）。未装 Codex CLI 也能用 plan / quota 查看（走 ChatGPT OAuth token 直接拉 rate-limits），但「登录」按钮和切换后启动 Codex 等动作需要 CLI 存在。

切换账号会丢失原账号的 sessions / 历史吗

不会。切换时整个 ~/.codex/ 子集（auth.json / config.toml / sessions/）被原子归档到原账号的备份目录，目标账号的同名内容覆盖回 ~/.codex/。再切回来时全部恢复。

「刷新」按钮和「切换」之后会不会消耗 quota

不会真发 ChatGPT 对话请求。Plan 数据来自 id_token claims；quota 走 ChatGPT Web API account/rateLimits/read（HTTP GET），或 Codex 0.130+ 的 app-server JSON-RPC fallback。没有 LLM 调用，不消耗用户额度。

per-card「登录」按钮为什么有时变成「取消」

当 codex 进程已经起来并打开了浏览器，但 OAuth 回调没回来（用户关浏览器 / 网络异常），点同一按钮会向 codex login 子进程发 SIGTERM / taskkill 中止它，释放 .switch.lock 全局锁。

Custom Base URL 配置后能继续用 ChatGPT OAuth 吗

不能。Custom Base URL（指向第三方 OpenAI 兼容反代）和 ChatGPT 官方 OAuth 是互斥的 — OAuth id_token 校验只对官方 endpoint 生效。配置 Base 之后该卡片的「Base」按钮会变红警示。

macOS 提示「无法打开，因为无法验证开发者」

App 暂未做 Apple Developer 代码签名 / notarization。第一次启动按住 Control 点应用图标 → 选「打开」一次即可放行；后续直接双击就行。或在「系统设置 → 隐私与安全」放行。

Windows SmartScreen 提示「Windows 已保护你的电脑」

同上，未做 Authenticode 签名。SmartScreen 弹窗点「更多信息 → 仍要运行」即可。

日志和账号数据存在哪里

账号备份：~/.codex/account_backup/<别名>/（macOS / Linux）/ %USERPROFILE%\.codex\account_backup\<别名>\（Windows）
应用运行时 cache：~/.codex-switch/（plan / quota 缓存、install_state.json、switch.lock）
Codex 当前账号状态：~/.codex/auth.json + ~/.codex/config.toml

技术栈

后端 / runtime：Rust 1.80+ · Tauri 2.x · tokio + reqwest（rustls-tls）· chrono · serde
协议适配：shared/runtime/chatgpt_api.rs（ChatGPT Web API account/{read,rateLimits/read}）+ Codex app-server JSON-RPC fallback（codex ≥ 0.130 时 OAuth refresh 失败兜底）
前端：HTML + CSS + 原生 TypeScript（shared/front/{render,state,actions,theme,i18n,tauri}.ts），无前端框架；Vite 7 打包
跨平台 runtime：mac / win runtime 各自实现 spawn / process control / OS-native title bar；shared runtime 处理协议、profile lifecycle、JSON-RPC、缓存、文件锁
构建 / 发布：tauri build 单命令出 dmg / pkg / exe；.github/workflows/build.yml 出 draft release，全部 asset 由 GitHub Actions 上传

平台支持

macOS：原生 Tauri 桌面端（Apple Silicon），同时保留 macOS-backup/ 下的 legacy shell 流程兼容。
Windows：原生 Tauri 桌面端（x64），通过 Release 中的 .exe 分发。
Linux：暂未做正式发布；前端代码跨平台，理论可自行 cargo tauri build 出 AppImage / deb，但 macOS-backup 与 Codex CLI 路径探测未覆盖 Linux 路径约定。

平台专属逻辑放在 src-tauri/mac/** 或 src-tauri/win/**，跨平台逻辑都在 src-tauri/shared/**。

macOS 兼容脚本

老的 shell 流程仍然保留，作为桌面 GUI 不可用 / SSH 终端场景的兜底：

bash macOS-backup/install.sh
source ~/.zshrc

三种模式：

auto：优先尝试原生桌面 runtime，找不到回退到 legacy shell。
desktop：强制走原生桌面。
legacy：强制走 codex-switch.sh。

卸载：

bash macOS-backup/uninstall.sh                  # 只移除命令接入层
bash macOS-backup/uninstall.sh --remove-script  # 连脚本一起删
source ~/.zshrc

卸载脚本不会删 ~/.codex/account_backup/，账号目录需要时手动清理。

免责声明

本项目专注 OpenAI Codex CLI 多账号管理，不是 OpenAI 官方项目，也不复用其商标 / Logo / 发布身份。

所有账号凭据 / OAuth token 仅保存在本机 ~/.codex/account_backup/（Unix 0600 + atomic write）；plan / quota 通过 HTTPS 直连 chatgpt.com / api.openai.com，不经任何第三方中转。

ChatGPT OAuth id_token / access_token 仅用于读取计划与 rate-limit 元数据，不会向模型发起任何对话请求，因此不会消耗用户额度。

许可证

MIT License。完整文本见 LICENSE.

Name		Name	Last commit message	Last commit date
Latest commit History 63 Commits
.codex/environments		.codex/environments
.github/workflows		.github/workflows
docs		docs
examples/account_backup/demo		examples/account_backup/demo
macOS-backup		macOS-backup
scripts		scripts
src-tauri		src-tauri
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
README.zh-CN.md		README.zh-CN.md
package-lock.json		package-lock.json
package.json		package.json
plan-active-profile-plan-detection.md		plan-active-profile-plan-detection.md
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Codex 账号切换工具

能做什么

下载

快速开始

仓库结构

本地开发

桌面端打包

版本与发布

常见问题

没有 Codex CLI 怎么办

切换账号会丢失原账号的 sessions / 历史吗

「刷新」按钮和「切换」之后会不会消耗 quota

per-card「登录」按钮为什么有时变成「取消」

Custom Base URL 配置后能继续用 ChatGPT OAuth 吗

macOS 提示「无法打开，因为无法验证开发者」

Windows SmartScreen 提示「Windows 已保护你的电脑」

日志和账号数据存在哪里

技术栈

平台支持

macOS 兼容脚本

免责声明

许可证

About

Uh oh!

Releases 18

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Codex 账号切换工具

能做什么

下载

快速开始

仓库结构

本地开发

桌面端打包

版本与发布

常见问题

没有 Codex CLI 怎么办

切换账号会丢失原账号的 sessions / 历史吗

「刷新」按钮和「切换」之后会不会消耗 quota

per-card「登录」按钮为什么有时变成「取消」

Custom Base URL 配置后能继续用 ChatGPT OAuth 吗

macOS 提示「无法打开，因为无法验证开发者」

Windows SmartScreen 提示「Windows 已保护你的电脑」

日志和账号数据存在哪里

技术栈

平台支持

macOS 兼容脚本

免责声明

许可证

About

Resources

License

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 18

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages