Skip to content

chaoahyl/YSwitch

Repository files navigation

YSwitch

English | 中文

YSwitch 是一款开源的桌面工具,用于在多个 Claude 和 Codex 账号之间快速切换。基于 Wails 构建,Go 后端 + Vue 前端,当前仅支持 Windows。

截图预览

浅色模式 深色模式
浅色模式 深色模式

功能简介

  • 账号保存:将当前已登录的账号认证信息保存到本地账号库,Claude 和 Codex 分别独立管理,支持保存多个账号。
  • 一键切换:选中目标账号后点击切换,工具自动替换本地认证文件并重启对应客户端,无需手动操作。
  • 额度查看:可查看各账号的套餐类型与剩余额度(基于本地已保存凭证,令牌过期后需先切换到对应账号再刷新,详见下方说明)。
  • 本地账号库:已保存的账号文件保留在本机;刷新额度时仅调用对应官方服务接口。

关于额度查看

YSwitch 不是官方多账号并行查询工具,它的本质是本地凭证切换器:

  • 登录账号后点击「保存当前账号」,工具会把当前 ~/.claude/.credentials.json 备份到本地账号库。
  • 「切换」操作会用目标账号的备份文件替换当前凭证,并重启 VSCode/Codex,使其以新账号身份运行。
  • 「刷新额度」会读取对应账号的已保存凭证,调用官方 API 查询额度。

为什么今天两个账号都能查,明天只能查当前账号?

原因 说明
Access token 有效期短 Claude Code 凭证中包含短期令牌,只有当前正在登录的账号会被 Claude Code 自动刷新,备份的凭证不会后台续期。
备份文件是静态快照 保存时凭证是新的,第二天非当前账号的令牌可能已过期,YSwitch 无法自动为它重新获取令牌。
刷新额度基于已保存凭证 刷新时不会自动切换账号,只使用保存时的令牌,令牌一旦过期则查询失败。

正确的使用策略

要查询哪个账号的最新额度,先切换到该账号,等 VSCode/Codex 以该账号身份重新加载后,再点「刷新额度」。不要期望两个账号在未切换的情况下都能持续查到最新额度。


登录方式说明

本工具不实现任何登录逻辑,所有登录均通过官方客户端完成。

账号类型 登录方式
Claude 通过 VSCode 的 Claude Code 官方插件完成登录
Codex 通过 Codex 官方桌面客户端完成登录

登录完成后,YSwitch 会在本地读取、备份和替换对应的认证文件。刷新额度时,工具只会把 access token 发送到官方 ChatGPT 或 Anthropic 额度接口,不会上传到任何第三方服务器。


快速开始

环境要求

开发模式

wails dev

构建发布包

wails build

使用步骤

Claude 账号

  1. 在 VSCode 的 Claude Code 官方插件中完成账号 A 的登录,成功后打开 YSwitch。
  2. 切换到 Claude 标签页,点击「保存当前账号」将账号 A 存入账号库。
  3. 手动删除或移走 ~/.claude/.credentials.json,关闭并重新打开 VSCode。
  4. 在 Claude Code 插件中登录账号 B,登录成功后回到 YSwitch,再次点击「保存当前账号」。
  5. 后续切换:选中目标账号,点击「切换」,工具将自动替换认证文件并重启 VSCode。

Codex 账号

  1. 在 Codex 官方桌面客户端中完成账号 A 的登录,成功后打开 YSwitch。
  2. 切换到 Codex 标签页,点击「保存当前账号」将账号 A 存入账号库。
  3. 退出 Codex 客户端并重新登录账号 B,登录成功后回到 YSwitch,再次点击「保存当前账号」。
  4. 后续切换:选中目标账号,点击「切换」,工具将自动替换认证文件并重启 Codex。

⭐ 支持项目

如果 YSwitch 对你有帮助,欢迎点个 Star ⭐!


免责声明

  • 本项目完全开源,仅供学习与个人使用,不提供任何形式的商业服务。
  • 本工具的唯一功能是在本地管理和切换已登录的账号认证文件,不涉及任何破解、绕过或违规操作
  • 使用本工具期间如发生账号被封禁、限制或其他任何损失,本项目不承担任何责任。请在了解相关平台服务条款的前提下自行决定是否使用。

About

快速切换 Codex 桌面版和 VSCode Claude 插件账号的 Windows 工具。

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors