Claude Code Account Switcher Plus

项目简介

这是一个面向 Windows 的 Claude Code 多账号切换工具。它只切换本机保存的认证信息，项目目录、设置、插件和本地对话历史保持不变。切换后可继续使用 claude --continue 或 claude --resume 恢复同一段编码工作。

适合由同一位用户合法持有并使用多个 Claude 订阅账号的场景。请自行遵守 Anthropic 当时有效的服务条款、账号规则和使用限制。

为什么开发这个工具

我的实际使用方式是维护多个本人付费的 Claude 账号。当当前账号额度不足时，先退出正在运行的 Claude Code，切换到另一个账号，再回到同一个项目继续 coding。项目文件和对话历史都保存在本地，没有必要因为切换账号而复制整个开发环境。

ccswitch 将这个过程收敛成一个可审计的本地命令：它只备份和替换认证相关数据，不接管项目目录，也不修改 Claude Code 的主题、插件和普通设置。

功能亮点

Windows 按用户安装，不需要管理员权限
使用 ccswitch add 保存账号，并支持容易记忆的别名
使用 ccswitch use 或 ccswitch next 快速切换
切换前检查 Claude Code 进程，避免运行中替换凭据
事务式写入；验证失败或中断时恢复原认证状态
ccswitch doctor 检查环境、路径、凭据位置和 Claude CLI
ccswitch update 从本站获取版本化更新并校验 SHA-256
ccswitch uninstall 默认只删除程序，保留账号备份

一条命令安装

在 Windows PowerShell 中运行以下命令。安装器固定到 v0.4.2，先下载到临时目录，再执行安装；程序会安装到当前用户的 %LOCALAPPDATA%\Programs\ccswitch，不需要管理员权限。

$v='0.4.2'; $f="$env:TEMP\install-ccswitch-$v.ps1"; irm "https://www.stardustx.cloud/projects/ccswitch/downloads/releases/v$v/install.ps1" -OutFile $f; Unblock-File $f; & $f -Version $v

安装后请打开一个新的终端，再运行：

ccswitch help
ccswitch doctor
ccswitch version

常用命令

ccswitch add work          # 保存当前登录账号，可指定别名
ccswitch add personal
ccswitch list              # 列出已保存账号
ccswitch use work          # 按别名、序号或邮箱切换
ccswitch next              # 切换到下一个账号
ccswitch status            # 查看当前账号和认证状态
ccswitch update --check    # 只检查更新
ccswitch update            # 安装最新的已验证版本
ccswitch uninstall         # 卸载程序，默认保留账号备份

切换前请先退出正在运行的 Claude Code。工具会检测相关进程，并在切换失败或中断时尽量恢复原来的认证状态。

下载与校验

安装器和 ccswitch update 都会根据发布清单校验脚本的 SHA-256，并检查脚本内嵌版本。更新时先读取 latest 清单，再从不可变的版本目录获取代码。

数据边界

程序文件：%LOCALAPPDATA%\Programs\ccswitch
账号备份：%USERPROFILE%\.claude-switch-backup
普通卸载不会删除账号备份
只有 ccswitch uninstall --purge-data 会在确认后删除备份

当前版本重点支持 Windows 原生命令体验。macOS、Linux、WSL 和 Git Bash 的脚本仍在内部持续测试，待后续整理公开分发方式。

开发进度

版本历史