# @ghackk/multi-claude 中文文档

规范地址：https://npmcn.com/package/%40ghackk/multi-claude/

版本：1\.0\.35
npm 元数据更新时间：2026-10-11T10:41:39.666Z
中文译文更新时间：2026-11-16T07:44:21.049Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ghackk/multi-claude
原文对照：https://npmcn.com/package/%40ghackk/multi-claude/?lang=original
项目主页：https://github.com/ghackk/claude-multi-account
源码仓库：https://github.com/ghackk/claude-multi-account

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：279 kB，37 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.13
- 运行依赖：0 个
- 首次发布：2026-03-13T13:24:51.587Z
- 最新版本发布：2026-10-11T10:41:39.494Z
- 近 30 天下载量：7840（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 32 个）

## 中文简介

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

## 安装

```sh
npm install @ghackk/multi-claude
```

也可以使用：`pnpm add @ghackk/multi-claude`、`yarn add @ghackk/multi-claude`、`bun add @ghackk/multi-claude`

## README

# 多账户

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

[![npm](https://img.shields.io/npm/v/@ghackk/multi-claude?color=cb3837&label=npm)](https://www.npmjs.com/package/@ghackk/multi-claude) [![PyPI](https://img.shields.io/pypi/v/multi-claude?color=3776ab&label=pip)](https://pypi.org/project/multi-claude/) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://npmcn.com/package/%40ghackk/multi-claude/LICENSE) ![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey) [![GitHub Stars](https://img.shields.io/github/stars/ghackk/claude-multi-account?style=social)](https://github.com/ghackk/claude-multi-account/stargazers)

![multi-claude demo](https://npmcn.com/package/%40ghackk/multi-claude/images/demo.gif)

* * *

## 为什么?

### 自动应用程序更新(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](https://npmcn.com/package/%40ghackk/multi-claude/images/12-before-after.png)

  

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

**多账户** 修正此选项 :

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

* * *

## 10秒后开始

![Quick Start](https://npmcn.com/package/%40ghackk/multi-claude/images/15-quick-start.png)

* * *

## 特征

<table><tbody><tr><td><p><strong>多账户管理</strong><br>创建、启动、重命名和删除独立的 Claude CLI 配置文件</p></td><td><p><strong>共享 MCP 设置( S)</strong><br>定义一次 MCP 服务器、 env vars 和首选项—— 同步到所有账户</p></td></tr><tr><td><p><strong>插件和市场</strong><br>全局或每个账户启用/失效插件,浏览和管理市场指数</p></td><td><p><strong>全球团结组织</strong><br>编写适用于每个账户的说明和技能</p></td></tr><tr><td><p><strong>备份恢复( R)</strong><br>用一击就给所有账户和配置的本地档案贴上时间戳</p></td><td><p><strong>导出/ 导入配置</strong><br>将机器之间的配置文件复制为单一的基数64符号——包括证书、设置和发射器</p></td></tr><tr><td><p><strong>云备份恢复( R)</strong><br>将所有配置文件安全同步到云中 —— 在任何带有单一命令的机器上恢复</p></td><td><p><strong>直接配置启动</strong><br>每个配置文件在 PATH 上自动注册——运行 <code>claude-work</code> 直接从任何终端</p></td></tr><tr><td><p><strong>自动依赖检测</strong><br>检测和提议在第一运行时安装缺失的依赖(曲线、jq等)</p></td><td><p><strong>从 Repo 运行</strong><br>在您的路径中添加 repo -- <code>git pull</code> 立即更新菜单, 不手工复制</p></td></tr></tbody></table>

* * *

## 安装

![Install methods](https://npmcn.com/package/%40ghackk/multi-claude/images/06-install.png)

  

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

### 单行道(建议)

```bash
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/ghackk/claude-multi-account/master/install.sh | bash
```

```powershell
# Windows (PowerShell)
irm https://raw.githubusercontent.com/ghackk/claude-multi-account/master/install.ps1 | iex
```

### 无

```bash
npm install -g @ghackk/multi-claude
```

### 管道

```bash
pip install multi-claude
```

### 主机( macOS / Linux)

```bash
brew install ghackk/tap/multi-claude
```

### Scoop (窗户)

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

### AUR (Arch Linux) (阿尔克语)

```bash
yay -S multi-claude
```

### 手动( git 克隆)

```bash
# Linux / macOS
git clone https://github.com/ghackk/claude-multi-account.git ~/claude-multi-account
bash unix/install.sh
```

```powershell
# 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](https://npmcn.com/package/%40ghackk/multi-claude/images/01-main-menu.png)

```
======================================
       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](https://npmcn.com/package/%40ghackk/multi-claude/images/05-shared-settings.png)

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

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

### 插件和市场(备选9)

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

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

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

![Export Profile](https://npmcn.com/package/%40ghackk/multi-claude/images/07-export-profile.png)

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

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

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

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

![Cloud Backup](https://npmcn.com/package/%40ghackk/multi-claude/images/04-cloud-backup.png)

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

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

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

### 直接配置启动

![Direct Launch](https://npmcn.com/package/%40ghackk/multi-claude/images/03-direct-launch.png)

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

```bash
# 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](https://npmcn.com/package/%40ghackk/multi-claude/images/14-how-it-works.png)

```
┌─────────────┐      ┌──────────────────┐      ┌─────────────────┐
│  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](https://npmcn.com/package/%40ghackk/multi-claude/images/08-folder-structure.png)

```
~/
├── 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>
```

* * *

## 文档

-   **[安装指南](https://npmcn.com/package/%40ghackk/multi-claude/docs/installation.md)** 为所有平台设置
-   **[使用指南](https://npmcn.com/package/%40ghackk/multi-claude/docs/usage.md)** ——全面走遍每个特色

* * *

## 平台支持

![Platform Support](https://npmcn.com/package/%40ghackk/multi-claude/images/13-platforms.png)

## 所需资源

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

* * *

## 捐款

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

* * *

## 贷项

由 **[贾内什·库马尔](https://github.com/ghackk)**

* * *

## 许可证

[麻省理工学院](https://npmcn.com/package/%40ghackk/multi-claude/LICENSE)

## 使用历史(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比较. [使用情况跟踪细节](https://npmcn.com/package/%40ghackk/multi-claude/docs/usage-tracking.md)。 。 。 .

macOS同时支持苹果硅和英特尔,包括用于账户传输和使用限制的配置特定密钥链证书. 账户更名保留了键链登录. npm安装不需要生命周期脚本,包括npm 12的默认. 运行 `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 和提交记录判断。

