AI 编程助手 — 一键安装，即刻使用
-Bookworm-Setup.bat (4 KB) — 双击即可安装
- -____ _ - | __ ) ___ ___ | | ____ _____ _ __ _ __ ___ - | _ \ / _ \ / _ \| |/ /\ \ /\ / / _ \| '__| '_ ` _ \ - | |_) | (_) | (_) | < \ V V / (_) | | | | | | | | - |____/ \___/ \___/|_|\_\ \_/\_/ \___/|_| |_| |_| |_| --
从零开始，一步步教你在任意 Mac 电脑上激活 Bookworm
-下载 Bookworm-Setup.sh → 在终端运行 → 输入密码 → 完成
-脚本自动检测依赖、安装 Homebrew/Node.js/Git、下载配置、启动 Claude Code
-手动安装流程：
-首次安装约 10 分钟（含依赖下载），之后每次启动约 5-15 秒
-api.anthropic.com，国内无法直连。bww.letcareme.com 部署在国内阿里云，不需要通过代理访问。NO_PROXY=bww.letcareme.com,code.letcareme.com，无需手动配置。*.letcareme.com 加入直连列表。
- 需要安装以下软件。如果已装过可跳到下一步。
- - -Homebrew 是 macOS 上最常用的包管理器，后续用它安装 Node.js 和 Git。
-打开 终端（按 ⌘ + 空格 搜索 "终端" 或 "Terminal"），执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"# Apple Silicon Mac 需要执行（Intel Mac 不需要）
-echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
-eval "$(/opt/homebrew/bin/brew shellenv)"
- 验证安装成功：
-brew --version # 应显示 Homebrew 4.x.x
- 用 Homebrew 一行命令安装。
-brew install node
- 也可以从 nodejs.org 下载 .pkg 安装包。
- -验证安装成功：
-node -v # 应显示 v22.x.x
-npm -v # 应显示 10.x.x
- macOS 通常自带 Git，如没有则用 Homebrew 安装。
-# 检查是否已安装
-git --version
-
-# 如果提示安装 Xcode Command Line Tools，点击"安装"即可
-# 或者用 Homebrew 安装：
-brew install git
- 在终端中执行：
-npm i -g @anthropic-ai/claude-code
- 安装过程需要几分钟，等待完成即可。如果报权限错误，在前面加 sudo。
claude --version # 应显示版本号
- claude login。
- 在终端中执行以下命令。系统会提示输入用户名和密码。
-git clone https://code.letcareme.com/bookworm/bookworm-boot.git
-cd bookworm-boot
- 在终端中执行安装脚本：
-bash Bookworm-Setup.sh
- 如果提示权限不足：chmod +x Bookworm-Setup.sh && ./Bookworm-Setup.sh
脚本会提示 "输入主密码解密凭证"，输入管理员提供的主密码（不是 Gitea 密码），按回车。
-密码输入时不显示字符，这是正常的。输错了可以重试，最多 3 次。
-脚本会显示步骤进度 [1/8] 到 [8/8]，自动完成：
-安装脚本已自动添加别名到 ~/.zshrc，直接在终端输入：
bw # 快速启动
-bw-update # 同步更新
- 如果别名不可用，在终端中手动执行：
-| 操作 | 命令 | 说明 |
|---|---|---|
| 快速启动 | -bw |
- 直接启动 Claude Code + Bookworm | -
| 同步更新 | -bw-update |
- 更新 boot + 配置仓库 | -
bw-update 即可同步。
- | 名称 | 用途 | 何时输入 |
|---|---|---|
| Gitea 密码 | 下载文件（克隆仓库） | 首次安装时 git 弹出要求 |
| 主密码 | 解密 API 凭证 | 每次启动脚本提示输入 |
首次解密成功后，脚本会询问 "今日内免密启动? (y/n)"
-选 y 后，当天再次启动无需输入主密码，次日自动过期。
-凭证缓存在 macOS 钥匙串 (Keychain) 中，仅当前用户可读。
-在终端中执行清理命令：
-| 场景 | 命令 | 说明 |
|---|---|---|
| 基础清理 | -rm -rf ~/.claude |
- 删除 Bookworm 配置，保留引导仓库供重新安装 | -
| 完整恢复 | -rm -rf ~/.claude ~/bookworm-boot |
- 删除所有 Bookworm 文件 | -
| 深度清理 | -rm -rf ~/.claude ~/bookworm-boot && sed -i '' '/Bookworm Portable/,+2d' ~/.zshrc && git credential-osxkeychain erase <<< "host=code.letcareme.com" |
- 完整恢复 + 清除别名 + 清除 Git 凭证 | -
原因：Homebrew 未添加到 PATH（Apple Silicon Mac 常见）。
-解决：
-# Apple Silicon (M1/M2/M3/M4)
-eval "$(/opt/homebrew/bin/brew shellenv)"
-
-# Intel Mac
-eval "$(/usr/local/bin/brew shellenv)"
- 原因：macOS 默认目录权限限制。
-解决方式一（推荐）：修改 npm 全局目录：
-mkdir -p ~/.npm-global
-npm config set prefix '~/.npm-global'
-echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
-source ~/.zshrc
-
-# 然后重新安装
-npm i -g @anthropic-ai/claude-code
- 解决方式二：在命令前加 sudo（简单但不推荐长期使用）。
解决步骤：
-https://code.letcareme.com 确认网站可访问原因：主密码区分大小写，且无法找回。
-解决：仔细检查密码是否正确。如确认忘记，联系管理员重新生成 secrets.enc。
原因：macOS 自带 LibreSSL，部分加密参数可能不同。
-解决：安装 OpenSSL：
-brew install openssl
-# 脚本会自动检测 Homebrew 安装的 openssl 路径
- 原因：代理软件把国内中转站 bww.letcareme.com 的流量也走了国际线路。
解决：手动设置 NO_PROXY 后重试：
-# 设置中转站直连（不走代理）
-export NO_PROXY="bww.letcareme.com,code.letcareme.com"
-
-# 重新启动
-bw
- 或在代理软件中将 *.letcareme.com 加入直连规则。
原因：API 凭证是进程级环境变量，只在安装脚本启动的进程中有效。
-解决：不要直接运行 claude，必须通过以下方式启动：
bw（推荐）cd ~/bookworm-boot && bash Bookworm-Setup.sh解决：设置淘宝镜像：
-# npm 淘宝镜像
-npm config set registry https://registry.npmmirror.com
-
-# Homebrew 清华镜像
-export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
-
-# 然后重新安装
-npm i -g @anthropic-ai/claude-code
- 不需要。所有 API 请求通过中转站转发，消耗中转站额度。目标机不需要任何 Anthropic 账号或订阅。
-逐项确认，全部打勾即可开始使用：
-brew --version 显示版本号node -v 显示版本号git --version 显示版本号npm -v 显示版本号claude --version 显示版本号| 操作 | 快捷方式 | 完整命令 |
|---|---|---|
| 首次安装 | git clone + bash Bookworm-Setup.sh | cd ~/bookworm-boot && bash Bookworm-Setup.sh |
| 快速启动 | bw | NO_PROXY="bww.letcareme.com,code.letcareme.com,localhost,127.0.0.1" claude |
| 同步更新 | bw-update | cd ~/bookworm-boot && git pull && cd ~/.claude && git pull |
| 基础清理 | rm -rf ~/.claude | |
| 完整恢复 | rm -rf ~/.claude ~/bookworm-boot | |
| 深度清理 | rm -rf ~/.claude ~/bookworm-boot && sed -i '' '/Bookworm/,+2d' ~/.zshrc | |
| 特性 | 规格 |
|---|---|
| 凭证加密 | AES-256-CBC + PBKDF2 (600,000 迭代) |
| 传输加密 | HTTPS (TLS 1.2+, Let's Encrypt 证书) |
| 凭证存储 | 进程级环境变量 + 可选本日缓存 (macOS Keychain, 当日 23:59 过期) |
| 登录保护 | fail2ban (5 次失败/小时 → 封禁 24 小时) |
- ____ _ - | __ ) ___ ___ | | ____ _____ _ __ _ __ ___ - | _ \ / _ \ / _ \| |/ /\ \ /\ / / _ \| '__| '_ ` _ \ - | |_) | (_) | (_) | < \ V V / (_) | | | | | | | | - |____/ \___/ \___/|_|\_\ \_/\_/ \___/|_| |_| |_| |_| --
从零开始，一步步教你在任意 Windows 电脑上激活 Bookworm
-获取 Bookworm-Setup.bat (4KB) → 双击运行 → 输入密码 → 完成
-安装器自动检测依赖、下载配置、创建桌面快捷方式、启动 Claude Code
-手动安装流程：
-首次安装约 10 分钟（含依赖下载），之后每次双击启动约 10-30 秒
-api.anthropic.com，国内无法直连。bww.letcareme.com 部署在国内阿里云，不需要通过代理访问。NO_PROXY=bww.letcareme.com,code.letcareme.com，无需手动配置。*.letcareme.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/9] 到 [9/9]，自动完成：
-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
- | 名称 | 用途 | 何时输入 |
|---|---|---|
| Gitea 密码 | 下载文件（克隆仓库） | 首次安装时 git 弹出要求 |
| 主密码 | 解密 API 凭证 | 每次启动脚本提示输入 |
首次解密成功后，脚本会询问 "今日内免密启动? (y/n)"
-选 y 后，当天再次启动无需输入主密码，次日自动过期。
-凭证缓存在 Windows Credential Manager 中（DPAPI 加密，仅当前用户可读）。
-bookworm-boot 文件夹里的 卸载Bookworm.bat，双击即可一键完整卸载：终止进程 + 清除凭证 + 恢复原始配置 + 删除桌面快捷方式。
-或者用命令行精细控制：
-| 场景 | 命令 | 说明 |
|---|---|---|
| 基础清理 | -pwsh -File stop.ps1 |
- 清除环境变量，保留配置供下次快速启动 | -
| 完整恢复 | -pwsh -File stop.ps1 -Restore |
- 删除 Bookworm，恢复电脑原始状态 | -
| 深度清理 | -pwsh -File stop.ps1 -Restore -Deep |
- 完整恢复 + 清除历史 + 清除 Git/凭证缓存 | -
pwsh -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
- 原因：代理软件把国内中转站 bww.letcareme.com 的流量也走了国际线路，导致连接被重置。
解决：在 PowerShell 中手动设置 NO_PROXY 后重试：
-# 设置中转站直连（不走代理）
-$env:NO_PROXY = "bww.letcareme.com,code.letcareme.com"
-
-# 重新启动
-cd bookworm-boot
-pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly
- 新版安装脚本已自动设置 NO_PROXY，git pull 更新后此问题不再出现。
原因：API 凭证是进程级环境变量，只在安装脚本启动的进程中有效。新开 PowerShell 窗口直接运行 claude 没有凭证。
解决：不要直接运行 claude，必须通过以下方式启动：
pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly原因：本地配置文件已被更新（管理员推送了新版本），但 integrity.sha256 未同步更新。
解决：选 y 继续即可，不影响使用。管理员会在下个版本同步哈希文件。
-不需要。所有 API 请求通过中转站转发，消耗中转站额度。目标机不需要任何 Anthropic 账号或订阅。
-这是正常行为。Bookworm 的技能库、路由引擎、配置架构属于技术保密范围，AI 被设定为不披露这些信息。
-解决：直接告诉 AI 你要完成的任务（写代码、分析问题、设计方案等），它会自动调用最合适的专家能力来帮你。无需了解内部机制即可获得完整服务。
-逐项确认，全部打勾即可开始使用：
-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 证书) |
| 凭证存储 | 进程级环境变量 + 可选本日缓存 (Windows Credential Manager, DPAPI 加密, 当日 23:59 过期) |
| 登录保护 | fail2ban (5 次失败/小时 → 封禁 24 小时) |