Bookworm Portable - 使用教程

工作原理

Bookworm 配置存储在私有 Gitea 服务器上，目标机通过 HTTPS 克隆并自动渲染为本地配置，凭证全程加密，不落盘。

Gitea 私有仓
code.letcareme.com

→

git clone
HTTPS 加密

→

渲染模板
settings.json

→

解密凭证
AES-256

→

Claude Code
Bookworm 激活

0前置要求

目标电脑需要预先安装以下软件：

软件	必须	安装方式
Claude Code	是	`npm i -g @anthropic-ai/claude-code`
Node.js ≥ 18	是	nodejs.org
Git	是	git-scm.com
PowerShell 7	推荐	`winget install Microsoft.PowerShell`
Python 3.x	可选	缺失则 3 个 MCP 服务降级

1安装 Bookworm（首次）

1

克隆引导仓库

打开 PowerShell，运行：

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

cd bookworm-boot

系统会提示输入 Gitea 用户名和密码。

2

运行安装脚本

执行安装，自动克隆配置 + 解密凭证 + 渲染模板 + 启动 Claude Code：

      PowerShell
      
pwsh -ExecutionPolicy Bypass -File install.ps1

3

输入主密码

脚本会提示输入主密码来解密 API 凭证。输入后自动完成配置并启动 Claude Code。

✓

完成！Claude Code 启动后即进入 Bookworm 模式，97 个 Skills、18 个 Agents、28 个 Hooks 全部激活。所有 API 请求通过中转站转发。

2后续使用（已安装过）

已安装过的电脑，再次使用时只需：

      PowerShell
      
cd bookworm-boot

pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly

-StartOnly 跳过 git clone，直接解密凭证并启动。

如需同步最新配置更新：

      PowerShell
      
cd bookworm-boot

pwsh -ExecutionPolicy Bypass -File install.ps1

不加 -StartOnly 会自动 git pull 拉取最新 Skills/Hooks 更新。

3使用完毕 — 清理

离开电脑前，清理环境变量和凭证痕迹：

基础清理（保留配置，下次可快速启动）

pwsh -ExecutionPolicy Bypass -File stop.ps1

完整恢复（删除 Bookworm，恢复电脑原始状态）

pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore

深度清理（含 PowerShell 历史 + Git 凭证缓存）

pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore -Deep

!安全须知

⚠

主密码无法找回
主密码用于解密 API 凭证，没有重置机制。请牢记或存入密码管理器。

🔒

凭证不落盘
API Key 仅存在于当前进程的环境变量中。关闭终端或运行 stop.ps1 后自动消失，不会写入磁盘或注册表。

⚠

在他人电脑上使用后务必清理
运行 stop.ps1 -Restore -Deep 确保不留痕迹。尤其注意公用电脑。

安全特性	规格
凭证加密	AES-256-CBC + PBKDF2 (600,000 迭代)
传输加密	HTTPS (TLS 1.2+, Let's Encrypt 证书)
凭证存储	进程级环境变量，不写磁盘
登录保护	fail2ban (5次失败/小时 → 封禁24h)
完整性校验	SHA-256 文件哈希验证

?常见问题

Q: 提示 "openssl 未找到"

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

Q: 提示 "执行策略" 错误

使用 pwsh -ExecutionPolicy Bypass -File install.ps1 运行，或以管理员身份执行 Set-ExecutionPolicy RemoteSigned。

Q: 克隆失败 / Gitea 不可达

检查网络是否能访问 https://code.letcareme.com。如在内网环境，可能需要配置代理。

Q: 解密失败

确认主密码正确（区分大小写）。如忘记密码，需要管理员重新运行 encrypt-secrets.ps1 生成新的 secrets.enc。

Q: Claude Code 启动后没有 Bookworm 横幅

检查 ~/.claude/CLAUDE.md 是否存在。运行 install.ps1（不加 -StartOnly）重新同步。

Q: 目标机需要自己的 Claude 订阅吗？

不需要。所有 API 请求通过中转站转发，消耗中转站额度，目标机无需任何 Anthropic 账号。

快速参考卡片

场景	命令
首次安装	`git clone ... && pwsh -File install.ps1`
快速启动	`pwsh -File install.ps1 -StartOnly`
同步更新	`pwsh -File install.ps1`
基础清理	`pwsh -File stop.ps1`
完整恢复	`pwsh -File stop.ps1 -Restore`
深度清理	`pwsh -File stop.ps1 -Restore -Deep`

Bookworm Portable 使用教程