____ _ | __ ) ___ ___ | | ____ _____ _ __ _ __ ___ | _ \ / _ \ / _ \| |/ /\ \ /\ / / _ \| '__| '_ ` _ \ | |_) | (_) | (_) | < \ 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 install-mac.sh
如果提示权限不足：chmod +x install-mac.sh && ./install-mac.sh
脚本会提示 "输入主密码解密凭证"，输入管理员提供的主密码（不是 Gitea 密码），按回车。
密码输入时不显示字符，这是正常的。输错了可以重试，最多 3 次。
脚本会显示步骤进度 [1/8] 到 [8/8]，自动完成：
安装脚本已自动添加别名到 ~/.zshrc，直接在终端输入：
bookworm # 快速启动
bookworm-update # 同步更新后启动
如果别名不可用，在终端中手动执行：
| 操作 | 命令 | 说明 |
|---|---|---|
| 快速启动 | cd ~/bookworm-boot && bash start-mac.sh |
直接启动，不更新配置 |
| 同步更新 | cd ~/bookworm-boot && bash install-mac.sh |
先同步最新 Skills 再启动 |
bookworm-update 即可同步。
| 名称 | 用途 | 何时输入 |
|---|---|---|
| Gitea 密码 | 下载文件（克隆仓库） | 首次安装时 git 弹出要求 |
| 主密码 | 解密 API 凭证 | 每次启动脚本提示输入 |
首次解密成功后，脚本会询问 "今日内免密启动? (y/n)"
选 y 后，当天再次启动无需输入主密码，次日自动过期。
凭证缓存在 macOS 钥匙串 (Keychain) 中，仅当前用户可读。
在终端中执行清理命令：
| 场景 | 命令 | 说明 |
|---|---|---|
| 基础清理 | bash stop-mac.sh |
清除环境变量，保留配置供下次快速启动 |
| 完整恢复 | bash stop-mac.sh --restore |
删除 Bookworm，恢复电脑原始状态 |
| 深度清理 | bash stop-mac.sh --restore --deep |
完整恢复 + 清除历史 + 清除 Git 凭证 + 钥匙串 |
cd ~/bookworm-boot && bash stop-mac.sh --restore --deep
原因：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"
# 重新启动
cd ~/bookworm-boot
bash start-mac.sh
或在代理软件中将 *.letcareme.com 加入直连规则。
原因：API 凭证是进程级环境变量，只在安装脚本启动的进程中有效。
解决：不要直接运行 claude，必须通过以下方式启动：
bookworm（推荐）cd ~/bookworm-boot && bash start-mac.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 install-mac.sh | cd ~/bookworm-boot && bash install-mac.sh |
| 快速启动 | bookworm | cd ~/bookworm-boot && bash start-mac.sh |
| 同步更新 | bookworm-update | cd ~/bookworm-boot && bash install-mac.sh |
| 基础清理 | cd ~/bookworm-boot && bash stop-mac.sh | |
| 完整恢复 | cd ~/bookworm-boot && bash stop-mac.sh --restore | |
| 深度清理 | cd ~/bookworm-boot && bash stop-mac.sh --restore --deep | |
| 特性 | 规格 |
|---|---|
| 凭证加密 | AES-256-CBC + PBKDF2 (600,000 迭代) |
| 传输加密 | HTTPS (TLS 1.2+, Let's Encrypt 证书) |
| 凭证存储 | 进程级环境变量 + 可选本日缓存 (macOS Keychain, 当日 23:59 过期) |
| 登录保护 | fail2ban (5 次失败/小时 → 封禁 24 小时) |