Bookworm Portable - 保姆式安装手册

整体流程概览

安装依赖
Node.js + Git

➔

安装 Claude Code
npm 全局安装

➔

克隆引导仓库
3 个文件

➔

运行安装脚本
输入密码

➔

开始使用
Bookworm 激活

全程约 10-15 分钟（含下载时间），之后每次启动只需 30 秒

1安装依赖软件

⚠

国内必须：代理/VPN 软件
Claude Code 启动时会检查 api.anthropic.com，国内无法直连。
请先安装并启动代理软件（Clash / V2Ray / 快柠檬 / 任意 VPN），安装脚本会自动检测系统代理。
无代理 = Claude Code 无法启动。

需要安装以下软件。如果已装过可跳到下一步。

A

安装 Node.js（必须）

去官网下载 LTS 版本安装包，双击安装，一路 Next 即可。

方式一：官网下载（推荐）

打开浏览器访问 https://nodejs.org，点击绿色的 "LTS 推荐" 按钮下载，双击 .msi 文件安装，全部默认 Next。

方式二：PowerShell 命令安装

右键开始菜单 → 选择 "PowerShell (管理员)" 或 "终端 (管理员)"，然后执行：

      PowerShell (管理员)
      # 下载 Node.js 安装包
Invoke-WebRequest -Uri "https://nodejs.org/dist/v22.15.0/node-v22.15.0-x64.msi" -OutFile "$env:TEMP\node-install.msi"

# 运行安装（会弹出安装向导，一路 Next）
Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait
    

⚠

安装完成后必须重开 PowerShell！
关闭当前 PowerShell 窗口，重新打开一个新的，否则 node 和 npm 命令找不到。

验证安装成功：

      node -v    # 应显示 v22.x.x
npm -v     # 应显示 10.x.x
    

如果 npm 报 "执行策略" 错误？ 执行以下命令后重试：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
提示确认时输入 Y 回车。

B

安装 Git（必须）

去官网下载安装，全部默认设置即可。

打开 https://git-scm.com/download/win，下载 "64-bit Git for Windows Setup"，双击安装，全部 Next。

验证：

git --version # 应显示 git version 2.x.x

C

安装 PowerShell 7（推荐）

Windows 自带的 PowerShell 5.1 有中文兼容问题，建议升级到 7。

      PowerShell (管理员)
      winget install Microsoft.PowerShell
    

如果没有 winget，去 GitHub Releases 下载 .msi 安装包。安装后用 pwsh 命令启动新版 PowerShell。

2安装 Claude Code

1

全局安装

在 PowerShell 中执行（不需要管理员权限）：

npm i -g @anthropic-ai/claude-code

安装过程需要几分钟，等待完成即可。

2

验证安装

claude --version # 应显示版本号

💡

不需要登录 Claude 账号！
Bookworm 使用中转站 API，安装 Claude Code 后直接进入下一步，不用执行 claude login。

3安装 Bookworm（核心步骤）

1

克隆引导仓库

在 PowerShell 中执行以下命令。系统会提示输入用户名和密码。

      git clone https://code.letcareme.com/bookworm/bookworm-boot.git
cd bookworm-boot
    

弹出用户名密码？ 输入管理员提供给你的 Gitea 账号密码。

2

运行安装脚本

这条命令会自动完成所有配置：克隆 97 个 Skills、渲染配置文件、解密 API 凭证、启动 Claude Code。

pwsh -ExecutionPolicy Bypass -File install.ps1

3

输入主密码

脚本会提示 "输入主密码解密凭证"，输入管理员提供的主密码，按回车。密码输入时不显示字符，这是正常的。

4

等待完成

脚本会显示步骤进度 [1/6] 到 [6/6]，全部显示 [OK] 后自动启动 Claude Code。

✓

看到 Bookworm 横幅就说明成功了！
Claude Code 启动后会显示 ASCII 艺术字 "Bookworm" 横幅，表示 97 个 Skills 全部激活。
现在可以直接开始使用，所有 API 请求通过中转站转发，不需要自己的 Claude 账号。

4日常使用

场景一：快速启动（已安装过，不更新配置）

适合每天打开电脑后快速进入工作状态。

      cd bookworm-boot
pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly
    

-StartOnly 跳过 git 同步，直接解密凭证并启动，约 10 秒完成。

场景二：同步最新配置后启动

管理员更新了 Skills 或 Hooks 后，用这个命令拉取最新版本。

      cd bookworm-boot
pwsh -ExecutionPolicy Bypass -File install.ps1
    

不加 -StartOnly 会自动 git pull 拉取更新。

5使用完毕 — 清理

场景	命令	说明
基础清理	`pwsh -File stop.ps1`	清除环境变量，保留配置下次快速启动
完整恢复	`pwsh -File stop.ps1 -Restore`	删除 Bookworm，恢复电脑原始状态
深度清理	`pwsh -File stop.ps1 -Restore -Deep`	完整恢复 + 清除历史记录 + 清除 Git 缓存

⚠

在他人电脑/公用电脑上务必执行深度清理：
pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore -Deep

!常见问题排查

❌ 输入 node -v 或 npm -v 提示 "无法识别"

原因：安装 Node.js 后没有重开 PowerShell 窗口，PATH 没刷新。

解决：关闭当前 PowerShell，重新打开一个新的窗口再试。

如果还不行，手动刷新 PATH：

      $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
node -v
    

❌ npm 报 "执行策略" / "Execution Policy" 错误

原因：Windows 默认禁止运行脚本。

解决：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

提示确认时输入 Y 回车。之后 npm 和 pwsh 脚本都能正常运行。

❌ 提示 "openssl 未找到"

原因：解密凭证需要 openssl，它随 Git for Windows 一起安装。

解决：确认 Git 已安装。脚本会自动搜索 C:\Program Files\Git 和 D:\Git 下的 openssl。

❌ git clone 失败 / 认证失败

解决步骤：

浏览器打开 https://code.letcareme.com 确认网站可访问
确认用户名密码正确（区分大小写）
如果开了 2FA，需要用 Access Token 替代密码
检查网络是否需要代理

❌ 解密凭证失败 / 主密码错误

原因：主密码区分大小写，且无法找回。

解决：仔细检查密码是否正确。如确认忘记，联系管理员重新生成 secrets.enc。

❌ Claude Code 启动后没有 Bookworm 横幅

原因：配置文件未正确同步。

解决：不加 -StartOnly 重新运行安装脚本，让它重新 clone：