Claude Code 备份与恢复

换新电脑后，打开 Claude Code，直接说： 「帮我恢复新电脑的 Claude Code 完整环境，按 README 来」 Claude 会自动执行下面所有步骤，你只需要在几个地方提供 token。

---

一键恢复（告诉 Claude 执行这个流程）

第 1 步：SSH Key + GitHub 访问

ssh-keygen -t ed25519 -C "ywhvibe@gmail.com" -f ~/.ssh/id_ed25519 -N ""
cat ~/.ssh/id_ed25519.pub

把公钥添加到 GitHub：https://github.com/settings/ssh/new 然后：

ssh-keyscan github.com >> ~/.ssh/known_hosts 2>/dev/null

第 2 步：克隆 claude_history 到 ~/.claude

git clone git@github.com:awenstudio/claude_history.git ~/.claude

⚠️ 如果 ~/.claude 已存在，先备份再删除。

第 3 步：安装 GitHub CLI (gh)

去 https://cli.github.com 下载安装包，装完后：

gh auth login
# 选 GitHub.com → SSH → 按提示登录

第 4 步：安装 Node.js（无需 Homebrew）

# 查当前 Mac 架构（arm64 = M系列，x86_64 = Intel）
uname -m

# arm64（M系列）：
curl -fsSL "https://nodejs.org/dist/v22.16.0/node-v22.16.0-darwin-arm64.tar.gz" -o /tmp/node.tar.gz

# x86_64（Intel）：
# curl -fsSL "https://nodejs.org/dist/v22.16.0/node-v22.16.0-darwin-x64.tar.gz" -o /tmp/node.tar.gz

mkdir -p ~/.local
tar -xzf /tmp/node.tar.gz -C ~/.local --strip-components=1
~/.local/bin/node --version  # 验证：应显示 v22.16.0

第 5 步：安装 MCP 服务器

~/.local/bin/npm install -g \
  @modelcontextprotocol/server-github \
  @cloudflare/mcp-server-cloudflare \
  vercel-platform-mcp-server

验证：

ls ~/.local/bin/mcp-server-github       # ✅
ls ~/.local/bin/mcp-server-cloudflare   # ✅
ls ~/.local/bin/vercel-platform-mcp-server  # ✅

第 6 步：获取 API Tokens（你来操作）

需要创建三个 token，告诉 Claude 后它帮你填进配置：

服务	创建地址	权限	有效期
GitHub	自动从 gh auth token 获取，不需要手动创建	—	—
Vercel	https://vercel.com/account/tokens	默认全权限	No Expiration
Cloudflare	https://dash.cloudflare.com/profile/api-tokens → Edit Cloudflare Workers 模板 → 选账号 → No Expiration	Workers Edit	No Expiration

第 7 步：配置 settings.json

Claude 会自动把 ~/.claude/settings.json 更新为以下格式（token 由 Claude 从 gh 和你提供的值填入）：

{
  "permissions": {
    "allow": ["Bash(*)", "Read(*)", "Edit(*)", "Write(*)", "WebFetch(*)", "WebSearch(*)", "mcp__pencil"],
    "deny": []
  },
  "mcpServers": {
    "github": {
      "command": "/Users/awen/.local/bin/mcp-server-github",
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<从 gh auth token 自动获取>"
      }
    },
    "vercel": {
      "command": "/Users/awen/.local/bin/vercel-platform-mcp-server",
      "env": {
        "VERCEL_TOKEN": "<你创建的 Vercel token>",
        "VERCEL_TEAM_SLUG": "awenstudio"
      }
    },
    "cloudflare": {
      "command": "/Users/awen/.local/bin/mcp-server-cloudflare",
      "env": {
        "CLOUDFLARE_API_TOKEN": "<你创建的 Cloudflare token>"
      }
    }
  }
}

第 8 步：恢复定时备份

(crontab -l 2>/dev/null; echo "0 22 * * * ~/.claude/auto-backup.sh") | crontab -
crontab -l  # 验证

第 9 步：重启 Claude Code

关掉重开，MCP 服务器会自动连接。验证：

/mcp   # 应该看到 github / vercel / cloudflare 三个服务器

---

MCP 服务器能力说明

MCP	能做什么
GitHub (mcp-server-github)	读写仓库、管理 PR/Issues、查 commit、操作分支
Vercel (vercel-platform-mcp-server)	查看/触发/回滚部署、查 build 日志、监控部署状态
Cloudflare (mcp-server-cloudflare)	管理 Workers、KV、R2、查看 DNS、监控流量

---

备份了什么

文件	说明
CLAUDE.md	全局规则（所有项目通用的行为规则）
settings.json	Claude Code 设置、权限、MCP 配置
README.md	本文件，换电脑恢复指南
WORKLOG.md	跨项目工作日志
INSPIRATIONS.md	灵感收集
projects/*/memory/*.md	各项目记忆文件
auto-backup.sh	每日 22:00 自动备份脚本

自动备份机制

• 每天 22:00 通过 cron 定时任务自动运行
• 只有文件有变化时才会提交（不会产生空 commit）
• GitHub：https://github.com/awenstudio/claude_history

---

Node.js v22.16.0 · GitHub MCP 2025.4.8 · Cloudflare MCP 0.2.0 · Vercel MCP 0.1.3