AI 编程账号管理神器 WorkBuddy Switch 全解析:一键切换 WorkBuddy / CodeBuddy 多账号的完整指南
AI 编程账号管理神器 WorkBuddy Switch 全解析:一键切换 WorkBuddy / CodeBuddy 多账号的完整指南
WorkBuddy Switch 是一款免费开源的 AI 编程账号管理工具,帮你一键切换 WorkBuddy、CodeBuddy IDE、CodeBuddy CLI 与 VS Code CodeBuddy 插件的多个登录账号,同时提供积分到期监控、积分统计、Token 用量统计和 Agent 会话悬浮窗。本文带你从零上手,快速掌握这套多账号切换与积分管理方案。
多账号管理的痛点,它都替你解决了
如果你同时持有多个 WorkBuddy / CodeBuddy 账号,日常大概率会碰到这些问题:
- 手动改配置文件切账号,繁琐还容易改坏登录态;
- 不知道哪个账号的积分快到期,白白浪费额度;
- 切号后想沿用原来的会话,只能重新开始;
- 多个 AI Agent 同时在跑,不知道谁在运行、谁在等你确认。
WorkBuddy Switch 用一套桌面 App(基于 Tauri 构建)把这些事一次打包:共享登录态、一键切换、临期提醒、会话跨账号复制,而且国内版 / 国际版全支持。
安装 WorkBuddy Switch:三种方式任选
| 平台 | 安装包 | 说明 |
|---|---|---|
| macOS Apple Silicon | workbuddy-switch_xxx_aarch64.dmg |
拖入「应用程序」即可 |
| macOS Intel | workbuddy-switch_xxx_x86_64.dmg |
同上 |
| Windows x64 | workbuddy-switch_xxx_x64-setup.exe |
运行安装程序 |
| Linux x64 | .deb / .AppImage |
Debian/Ubuntu 装 .deb,其他发行版直接跑 AppImage |
📌 从项目 Releases 页面下载对应平台的安装包即可;也可以走 npm 在浏览器里用:
npm i -g workbuddy-switch
workbuddy-switch # 启动本地服务并自动打开浏览器
workbuddy-switch status # 终端查看当前账号
💡 macOS 首次启动若提示「无法验证开发者」,在 Finder 中按住 Control 点击应用选择「打开」即可;切换账号报「无权限」时,按应用内引导授予「App 管理」或「完全磁盘访问」权限。
账号管理页:集中查看所有账号的积分与状态
打开应用进入「账号管理」,所有账号以卡片形式集中展示:登录状态、积分余额、各积分包的到期时间一目了然,临期积分直接标注在卡片内,并按紧迫程度排序。
核心操作都在卡片上:
- 添加账号:「OAuth 扫码登录」扫码即加,也支持「导入本机账号」「导入备份」「手动添加」;
- 切换账号:点卡片上的「切换 WorkBuddy」或「切换 CodeBuddy CLI」,过程实时显示进度,切换过程可勾选复制当前会话;
- 备份迁移:「导出」可把勾选账号备份为 JSON,换机不丢号。
WorkBuddy 与 CodeBuddy CLI 共用同一份账号库,但两侧当前账号互不影响,可分别独立切换;CodeBuddy CLI 切换后立即生效,无需重启。
积分到期监控与自动轮换:额度不再白白浪费
这是 WorkBuddy Switch 最实用的能力之一。应用会自动查询每个账号的积分剩余量与到期时间,7 天内到期的账号会高亮显示,并标注「建议优先使用」,帮你总是先用最快过期的积分。
针对 CodeBuddy CLI,还可以开启自动轮换:后台定期检查,把积分最紧迫(最早到期)的账号设为 CLI 后续启动账号,防止积分过期浪费。检查间隔、切换冷却、紧迫阈值、活跃保护等参数都可以自定义,并且检测到 CLI 会话正在运行时会自动跳过,不打断你的任务。
切换之外,「积分统计」页汇总官方请求用量:总览、近 30 天趋势、模型分类、账号消耗与请求明细,数据来源和更新时间都会明确标注。
Token 统计:AI 用量花在哪,一屏看清
「Token 统计」页按来源展示 Token 总览与趋势,还包括构成占比、活跃热力图、项目/模型 Top 10 与会话排行,帮你搞清楚哪些项目、哪些模型在消耗你的额度。
会话复制与关联会话:多账号协作不丢进度
换号后原来的对话记录怎么办?WorkBuddy Switch 提供两层能力:
- 会话复制:把当前账号勾选的会话以新 id 复制给目标账号,源账号数据不受影响,云端归属目标账号;
- 关联会话:复制过的会话自动建立跨账号关联,可以按客户端集中查看同一会话在各账号中的副本状态,把新增内容增量同步过去;出现内容分歧时,用分支图选出要保留的一份,统一到其他账号。
会话悬浮窗:所有 AI Agent 的状态一眼掌握
桌面版内置 Agent Companion 悬浮栏,把 Codex、WorkBuddy、CodeBuddy IDE、CodeBuddy VS Code 插件、Codeg 等来源的会话状态集中显示在桌面上:运行中 / 待确认 / 已完成一目了然,悬停查看详情,点击即可跳转回原会话。悬浮栏可拖拽定位,托盘可临时隐藏。
支持的工具一览
| 工具 | 账号切换 | 会话复制 | 自动关闭重开 | 自动轮换 | 悬浮窗监听 |
|---|---|---|---|---|---|
| WorkBuddy | ✅ | ✅ | ✅ | — | ✅ |
| CodeBuddy IDE | ✅ | ✅ | ✅ | — | ✅ |
| CodeBuddy CLI | ✅ | — | — | ✅ | — |
| VS Code CodeBuddy 插件 | ✅ | ✅ | ✅ | — | ✅ |
| JetBrains IDE 插件(IDEA / PyCharm) | ✅ | — | ✅ | — | — |
各端入口可在「设置 → 支持工具」中逐个开关,互不影响。JetBrains 端一次切换会写入所有装了插件的 IDE;VS Code 运行时还能自动关闭并在写入后重新打开。
常见问题
- macOS 提示「无法验证开发者」? 在 Finder 中 Control 点击应用选择「打开」,或在「系统设置 → 隐私与安全性」中选择「仍要打开」。
- 切换时报「无权限」? 按引导授予「App 管理」(或「完全磁盘访问」)权限,授权后重启应用即可。
- 切换 CodeBuddy CLI 会中断会话吗? 会。CLI 切换时会先关闭正在运行的 CLI,当前会话中断且不会自动重开,切换前请留意任务状态。
- 只想管理部分客户端? 在「设置 → 支持工具」关闭对应入口即可,不影响账号库与其他端。
源码结构速览
如果想深入了解实现,可以从以下入口看起:
- 项目说明:README.md
- 核心逻辑(账号 / 切换 / 轮换 / 会话):crates/wb-switch-core/src/modules/,其中自动轮换见 rotate.rs、会话关联见 session_link.rs
- 前端页面:src/pages/(账号管理、积分统计、Token 统计等)
- 悬浮窗集成:src-tauri/src/companion.rs
- 开发指南:docs/DEVELOPMENT.md
总结
WorkBuddy Switch 把 AI 编程工具的多账号管理做成了「开箱即用」:一键切换 WorkBuddy 与 CodeBuddy 全家桶账号、积分到期自动提醒与轮换、会话跨账号复制同步,外加用量统计和 Agent 悬浮窗。如果你正在同时使用多个 WorkBuddy / CodeBuddy 账号,值得装一个试试看。






