@ghackk/multi-claude

中文文档
1.0.35发布于 2026/10/11MIT零依赖近 30 天下载 7840

使用共享设置、插件、市场同步和备份/备份运行多个 Claude CLI 账户

中文使用文档
文档目录29 节
  1. 为什么?
  2. 自动应用程序更新(v1.0.29工作分支)
  3. 10秒后开始
  4. 特征
  5. 安装
  6. 单行道(建议)
  7. 无
  8. 管道
  9. 主机( macOS / Linux)
  10. Scoop (窗户)
  11. AUR (Arch Linux) (阿尔克语)
  12. 手动( git 克隆)
  13. 菜单概览
  14. 主菜单
  15. 共享设置(备选8)
  16. 插件和市场(备选9)
  17. 导出/ 导入配置文件( 选项 E & I)
  18. 云备份并恢复( 可选 C & R)
  19. 直接配置启动
  20. 如何运作
  21. 合并策略
  22. 文件夹结构
  23. 文档
  24. 平台支持
  25. 所需资源
  26. 捐款
  27. 贷项
  28. 许可证
  29. 使用历史(v1.0.26)

多账户

运行多个 Claude CLI 账户,其共享设置,插件,市场同步,以及备份/备份.

npm PyPI License: MIT Platform GitHub Stars

multi-claude demo

为什么?

自动应用程序更新(v1.0.29工作分支)

每次菜单发布时都会开始检查 https://pair.ghackk.com/updates/stable.json。如果服务器不可用,更新器将检查签名 stable.json 资产在最新的 GitHub 发布。 检查时应用程序会继续运行 。 检查失败后退15分钟;离线操作使用最后一个工作安装.

货单上签有被钉住的Ed25519密钥并包含一个版本,过期,节点要求,准确的存档大小和SHA-256散列. 下载尝试服务器托管的存档,然后是 GitHub 发布存档. 在Windows上,传送回落为节点HTTPS,卷曲后再为PowerShell;macOS/Linux使用节点HTTPS后为卷曲. 所有路径都需要HTTPS. 无效的签名,过期的运单,腐败的档案和降级被否决.

将应用程序文件安装到 ~/.multi-claude-updates/versions/,然后在验证后在原子上切换所选版本。 接下来的菜单发布会使用该版本. 如果缓存释放不完整,则保留先前安装的软件包和缓存版本。 账户配置文件,证书,备份和使用历史从不属于更新目录. 不需要管理员访问,软件包管理器切换或生命周期脚本.

此更新 运行中的程序,而不是npm/pp/Homebrew/Scoop的安装版本记录. multi-claude --version 报告选定的应用程序版本. multi-claude --update-status 显示基准版本、所选版本和最后结果; multi-claude --update-now 等待检查。 设定 MULTI_CLAUDE_AUTO_UPDATE=0 以禁用背景检查。 仍然有明确的检查.

1.0.29前的版本需要一次性升级才能得到这个更新器. 来源 Git 检查退出不再被 pip 发射装置默默地拉出;应用程序更新跟随已签名的放行种子.

维护者发布一个普通 npm pack --ignore-scripts 存档为 GitHub 释放资产 。 释放帮助 local-usage/publish-channels.py VERSION 还有电话 local-usage/publish-update-feed.py VERSION,将归档上传到服务器,远程检查其散列,解剖激活了清单,并镜像了在GitHub上签名的清单. 签字证书留在公共存放处之外。 现有版本档案不可改变. 如无新发布,在清单到期89天前续签;到期后客户仍可上网使用.

Before vs After

Claude CLI 将所有配置存储在单个中 ~/.claude/ 目录 - 所以你被锁定到 一次一个账户。切换意味着退出、登录和丢失您的设置.

多账户 修正此选项 :

  • 孤立配置图 ——每个账户都有自己的配置目录,没有冲突
  • 共享设置 ——定义 MCP 服务器, env vars, 插件, 和 CLAUDE. md 有一次—— 自动在任何地方应用
  • 插件和市场管理 ——启用全球或每个账户的插件,浏览市场指数
  • 直接发射 - 运行 claude-work 或者说 claude-personal 从任何终端直接发送,不需要菜单
  • 云备份恢复( R) ——安全地将所有剖面与云同步,并恢复任何机器
  • 一个命令 ——立即从交互式菜单中启动任何账户

10秒后开始

Quick Start

特征

多账户管理
创建、启动、重命名和删除独立的 Claude CLI 配置文件

共享 MCP 设置( S)
定义一次 MCP 服务器、 env vars 和首选项—— 同步到所有账户

插件和市场
全局或每个账户启用/失效插件,浏览和管理市场指数

全球团结组织
编写适用于每个账户的说明和技能

备份恢复( R)
用一击就给所有账户和配置的本地档案贴上时间戳

导出/ 导入配置
将机器之间的配置文件复制为单一的基数64符号——包括证书、设置和发射器

云备份恢复( R)
将所有配置文件安全同步到云中 —— 在任何带有单一命令的机器上恢复

直接配置启动
每个配置文件在 PATH 上自动注册——运行 claude-work 直接从任何终端

自动依赖检测
检测和提议在第一运行时安装缺失的依赖(曲线、jq等)

从 Repo 运行
在您的路径中添加 repo -- git pull 立即更新菜单, 不手工复制


安装

Install methods

选择任何方法 他们都给你 claude-menu (或 multi-claude)指挥.

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/ghackk/claude-multi-account/master/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/ghackk/claude-multi-account/master/install.ps1 | iex

无

npm install -g @ghackk/multi-claude

管道

pip install multi-claude

主机( macOS / Linux)

brew install ghackk/tap/multi-claude

Scoop (窗户)

scoop bucket add multi-claude https://github.com/ghackk/scoop-multi-claude
scoop install multi-claude

AUR (Arch Linux) (阿尔克语)

yay -S multi-claude

手动( git 克隆)

# Linux / macOS
git clone https://github.com/ghackk/claude-multi-account.git ~/claude-multi-account
bash unix/install.sh
# Windows
git clone https://github.com/ghackk/claude-multi-account.git $HOME\claude-multi-account
[Environment]::SetEnvironmentVariable("PATH", "$HOME\claude-multi-account;" + [Environment]::GetEnvironmentVariable("PATH", "User"), "User")

然后打开一个新的终端运行 claude-menu。 。 。 .


菜单概览

主菜单

Main Menu
======================================
       Claude Account Manager
======================================
  Current Accounts:

  1. claude-work     [logged in]   (last used: 02 Mar 2026 10:30 AM)
  2. claude-personal [logged in]   (last used: 01 Mar 2026 08:15 PM)

======================================
  1. List Accounts
  2. Create New Account
  3. Launch Account
  4. Rename Account
  5. Delete Account
  6. Backup Sessions (Local)
  7. Restore Sessions (Local)
  8. Shared Settings (MCP/Skills)
  9. Plugins & Marketplace
  E. Export Profile (Token)
  I. Import Profile (Token)
  C. Cloud Backup
  R. Cloud Restore
  0. Exit
======================================

共享设置(备选8)

Shared Settings

管理适用于发射时所有账户的通用设置:

选项行动
1个编辑 MCP + 设置( 在编辑器中打开)
2个编辑技能/指示(CLAUDE.md)
3个查看当前共享设置
页:1将共享设置同步到所有账户
页:1显示 MCP 服务器列表
6个重置共享设置

插件和市场(备选9)

浏览市场索引并管理账户插件:

选项行动
1个启用所有账户的插件
2个启用一个账户的插件
3个禁用插件( 共享)
页:1禁用插件( 一个账户)
页:1浏览市场插件
6个采购网管理(添加/搬迁/同步)

导出/ 导入配置文件( 选项 E & I)

Export Profile

使用可复制的 Base64 令牌在机器间传输配置文件 :

选项行动
页:1导出一个配置文件 - 生成一个包含证书、设置和启动器的紧凑符号(~5 KB)
一、导 言导入一个 profile - 粘贴任何机器上恢复账户的符号

令牌捆绑只包含基本内容(证书,设置,CLAUDE.md,发射装置)——不是缓存或对话历史.

云备份并恢复( 可选 C & R)

Cloud Backup

将所有配置文件同步到云中并恢复到任何机器上 :

选项行动
C级云备份 — 选择配置和可选文件夹( 共享设置、 插件等) 安全上传
区域Cloud Recover- 输入您的路由密钥以下载并恢复新机器上的所有配置文件

配置文件在恢复后会在 PATH 上自动注册, 这样您就可以运行 claude-work 马上.

直接配置启动

Direct Launch

您创建的每个配置文件都作为命令自动可用 :

# No need to open the menu — just run the profile name directly
claude-work
claude-personal

打开 Linux/ macOS/ Termux 软件,在 ~/.local/bin/打开 窗口,账户目录将添加到您的用户 PATH 中。 创建、导入或恢复的配置文件都自动注册.


如何运作

How it works
┌─────────────┐      ┌──────────────────┐      ┌─────────────────┐
│  You pick    │ ───> │  Shared settings │ ───> │  Claude CLI     │
│  an account  │      │  + plugins are   │      │  launches with  │
│  from menu   │      │  merged in       │      │  isolated config│
└─────────────┘      └──────────────────┘      └─────────────────┘

每个账户都获得自己的配置目录(~/.claude-<name>) (中文(简体) ). 每次发射时,共享设置来自 ~/claude-shared/ 被深入到账户中 – MCP 服务器, env vars, 首选项, 插件, 市场索引, 以及 CLAUDE. md 指令都保持同步 .

合并策略

设置为 深渊 共享设置在冲突中获胜:

假设结果
密钥仅在账户中存在固定状态
密钥仅存在于共享已添加
键同时存在( 简单值)共享赢家
键存在于两个( 已记名对象)递归合并

对于 CLAUDE.md,共享内容在顶端自动管理的标记之间插入。 标记下方的账户专用指令被保留.


文件夹结构

Folder Structure
~/
├── claude-multi-account/      # Git repo (can be added to PATH directly)
│   ├── claude-menu.ps1        # Windows menu script
│   ├── claude-menu.bat        # Windows launcher
│   ├── windows/               # Windows-specific scripts
│   └── unix/                  # Linux/macOS scripts
│
├── claude-accounts/           # Account launchers (auto-created)
│   ├── claude-work.bat/.sh    # Account launcher
│   └── claude-personal.bat/.sh
│
├── claude-shared/             # Shared config (applied to all accounts)
│   ├── settings.json          # MCP servers, env vars, preferences, enabledPlugins, extraKnownMarketplaces
│   ├── CLAUDE.md              # Global instructions & skills
│   └── plugins/               # Shared plugin & marketplace data
│       └── marketplaces/      # Cached marketplace indexes
│
├── claude-backups/            # Timestamped backup archives
│
├── .claude-work/              # Account: work (auto-created)
├── .claude-personal/          # Account: personal (auto-created)
└── .claude-<name>/            # Account: <name>

文档


平台支持

Platform Support

所需资源

  • 克劳德·CLI 安装和可用于 PATH
  • 窗口: PowerShell 5.1+(通过winget/scoop自动探测的依赖性)
  • Linux/ 马可操作系统: Bash 3.2+ (macOS系统 Bash工作). 依赖性包括: curl, (中文(简体) ), jqPython 3和Node.js在第一次运行时被检查.
  • 泰尔默克: 支持的——通过 pkg

捐款

欢迎捐款! 可以随意打开一个问题或提交拉动请求.


贷项

由 贾内什·库马尔


许可证

麻省理工学院

使用历史(v1.0.26)

使用率报告总是在。 要合并另一个 PC 的历史,运行 node ~/claude-accounts/usage/report.js merge /path/to/usage.db。用法通过正常的电子邮件和回复ID键入:重命名 claude-zf 改为 claude-zafff,为同一个电子邮件创建另一个配置文件,或者从一个有空历史的笔记本上报告,从不重报服务器的全时总计. 复本被去相去.

菜单会安装背景会话钩子,启动器触发,以及一个15分钟的Windows预定任务,macOS LaunchAgent,或Linux cron条目. 需要节点.js 22.13+. 仪表板显示UTC期间,模型/月/设备总计,账户限制,以及克洛德代码的STAS-cache比较. 使用情况跟踪细节。 。 。 .

macOS同时支持苹果硅和英特尔,包括用于账户传输和使用限制的配置特定密钥链证书. 账户更名保留了键链登录. npm安装不需要生命周期脚本,包括npm 12的默认. 运行 multi-claude 在安装后设置了发射器和使用历史.

版本与发布记录

@ghackk/multi-claude 共发布 32 个版本,首次发布于 2026/03/13;过去 12 个月发布了 32 个版本。

版本发布日期距今
1.0.35latest2026/10/111 个月前
1.0.342026/10/041 个月前
1.0.332026/10/031 个月前
1.0.322026/10/031 个月前
1.0.312026/10/021 个月前
1.0.302026/10/021 个月前

关于 @ghackk/multi-claude 的常见问题

@ghackk/multi-claude 是什么?

使用共享设置、插件、市场同步和备份/备份运行多个 Claude CLI 账户

如何安装 @ghackk/multi-claude?

在项目目录运行 npm install @ghackk/multi-claude,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 multi-claude,可以用 npx multi-claude 直接运行。

@ghackk/multi-claude 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ghackk__multi-claude 是否存在。

@ghackk/multi-claude 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.13。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ghackk/multi-claude 可以商用吗?

@ghackk/multi-claude 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ghackk/multi-claude 的下载量有多少?

根据 npm 官方下载统计,@ghackk/multi-claude 在 2026/10/17 – 2026/11/15 这 30 天内被下载 7,840 次,日均约 261 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ghackk/multi-claude 还在维护吗?

最新版本 1.0.35 发布于 2026/10/11(1 个月前);至今共发布 32 个版本,其中过去 12 个月发布了 32 个;首次发布于 2026/03/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。