____ _ | __ ) ___ ___ | | ____ _____ _ __ _ __ ___ | _ \ / _ \ / _ \| |/ /\ \ /\ / / _ \| '__| '_ ` _ \ | |_) | (_) | (_) | < \ V V / (_) | | | | | | | | |____/ \___/ \___/|_|\_\ \_/\_/ \___/|_| |_| |_| |_|
从零开始，一步步教你在任意 Windows 电脑上激活 Bookworm
全程约 10-15 分钟（含下载时间），之后每次启动只需 30 秒
api.anthropic.com，国内无法直连。需要安装以下软件。如果已装过可跳到下一步。
去官网下载 LTS 版本安装包，双击安装，一路 Next 即可。
打开浏览器访问 https://nodejs.org，点击绿色的 "LTS 推荐" 按钮下载，双击 .msi 文件安装，全部默认 Next。
右键开始菜单 → 选择 "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
node 和 npm 命令找不到。
验证安装成功：
node -v # 应显示 v22.x.x
npm -v # 应显示 10.x.x
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned去官网下载安装，全部默认设置即可。
打开 https://git-scm.com/download/win，下载 "64-bit Git for Windows Setup"，双击安装，全部 Next。
验证：
git --version # 应显示 git version 2.x.x
Windows 自带的 PowerShell 5.1 有中文兼容问题，建议升级到 7。
winget install Microsoft.PowerShell
如果没有 winget，去 GitHub Releases 下载 .msi 安装包。安装后用 pwsh 命令启动新版 PowerShell。
在 PowerShell 中执行（不需要管理员权限）：
npm i -g @anthropic-ai/claude-code
安装过程需要几分钟，等待完成即可。
claude --version # 应显示版本号
claude login。
在 PowerShell 中执行以下命令。系统会提示输入用户名和密码。
git clone https://code.letcareme.com/bookworm/bookworm-boot.git
cd bookworm-boot
双击文件夹里的 更新并启动Bookworm.bat，脚本会自动完成所有配置。
如果双击 .bat 不起作用，在 PowerShell 中手动执行：
pwsh -ExecutionPolicy Bypass -File install.ps1
没有 pwsh 可用 powershell 替代。
脚本会提示 "输入主密码解密凭证"，输入管理员提供的主密码（不是 Gitea 密码），按回车。
密码输入时不显示字符，这是正常的。输错了可以重试，最多 3 次。
脚本会显示步骤进度 [1/6] 到 [6/6]，自动完成：
bookworm-boot 文件夹里有两个 .bat 文件：
| 文件 | 作用 | 适用场景 |
|---|---|---|
| 启动Bookworm.bat | 快速启动，不更新配置 | 每天日常使用 |
| 更新并启动Bookworm.bat | 先同步最新 Skills 再启动 | 管理员通知有更新时 |
双击即可，无需打开 PowerShell，无需记命令。脚本会自动检测 PowerShell 7/5.1。
如果 .bat 文件无法运行，在 PowerShell 中手动执行：
# 快速启动
cd bookworm-boot
pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly
# 同步更新后启动
cd bookworm-boot
pwsh -ExecutionPolicy Bypass -File install.ps1
| 场景 | 命令 | 说明 |
|---|---|---|
| 基础清理 | 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.js 后没有重开 PowerShell 窗口，PATH 没刷新。
解决：关闭当前 PowerShell，重新打开一个新的窗口再试。
如果还不行，手动刷新 PATH：
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
node -v
原因：Windows 默认禁止运行脚本。
解决：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
提示确认时输入 Y 回车。之后 npm 和 pwsh 脚本都能正常运行。
原因：解密凭证需要 openssl，它随 Git for Windows 一起安装。
解决：确认 Git 已安装。脚本会自动搜索 C:\Program Files\Git 和 D:\Git 下的 openssl。
解决步骤：
https://code.letcareme.com 确认网站可访问原因：主密码区分大小写，且无法找回。
解决：仔细检查密码是否正确。如确认忘记，联系管理员重新生成 secrets.enc。
原因：配置文件未正确同步。
解决：不加 -StartOnly 重新运行安装脚本，让它重新 clone：
pwsh -ExecutionPolicy Bypass -File install.ps1
解决：Node.js 官网在国内可能较慢，可以用淘宝镜像：
# 设置 npm 淘宝镜像（加速下载）
npm config set registry https://registry.npmmirror.com
# 然后重新安装 Claude Code
npm i -g @anthropic-ai/claude-code
不需要。所有 API 请求通过中转站转发，消耗中转站额度。目标机不需要任何 Anthropic 账号或订阅。
逐项确认，全部打勾即可开始使用：
node -v 显示版本号git --version 显示版本号npm -v 显示版本号（如报错先设 ExecutionPolicy）claude --version 显示版本号pwsh --version 显示 7.x（推荐但非必须）| 操作 | 最简方式 | 命令行方式 |
|---|---|---|
| 首次安装 | git clone + 双击 更新并启动Bookworm.bat | pwsh -ExecutionPolicy Bypass -File install.ps1 |
| 快速启动 | 双击 启动Bookworm.bat | pwsh -File install.ps1 -StartOnly |
| 同步更新 | 双击 更新并启动Bookworm.bat | pwsh -File install.ps1 |
| 基础清理 | pwsh -ExecutionPolicy Bypass -File stop.ps1 | |
| 完整恢复 | pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore | |
| 深度清理 | pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore -Deep | |
| 特性 | 规格 |
|---|---|
| 凭证加密 | AES-256-CBC + PBKDF2 (600,000 迭代) |
| 传输加密 | HTTPS (TLS 1.2+, Let's Encrypt 证书) |
| 凭证存储 | 仅进程级环境变量，不写磁盘，不写注册表 |
| 登录保护 | fail2ban (5 次失败/小时 → 封禁 24 小时) |