Developers: one-command migrat…

# Claude Code 配置迁移指南（旧机器 → 新 MacBook）

一、迁移前准备（旧机器）

• 定位配置目录（核心位置）：
• ~/.claude/：全局配置、CLAUDE.md、settings.json
• ~/.claude/skills/：12 个 skills 文件
• ~/.claude/settings.json 或项目内 .claude/settings.json：hooks 与 MCP 配置
• ~/.claude.json：MCP server 全局注册信息（部分版本）
• 备份：整个 ~/.claude 目录打包：

```bash

tar -czvf claude-backup.tar.gz ~/.claude ~/.claude.json

```

二、迁移 MCP Server 配置

• MCP 通常记录在 ~/.claude.json 的 mcpServers 字段，或项目级 .mcp.json
• 两种方式：

1. 直接复制：把备份的 ~/.claude.json 恢复到新机器

2. 手动重装（更干净）：

```bash

claude mcp add github -s user -- npx -y @modelcontextprotocol/server-github

claude mcp add postgres -s user -- npx -y @modelcontextprotocol/server-postgres postgresql://...

claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer

```

• 注意：github server 需要重新配置 token（环境变量 GITHUB_PERSONAL_ACCESS_TOKEN）；postgres 连接串若指向本机数据库需确认新机器可达。

三、迁移 Skills

• 将备份的 ~/.claude/skills/ 整个目录复制到新机器同路径
• 检查每个 skill 内是否有绝对路径引用（如指向旧机器目录），需改为相对路径或新机器路径

四、迁移 Hooks

• Hooks 保存在 ~/.claude/settings.json 的 hooks 字段（项目级在项目 .claude/settings.json）
• 直接复制 settings.json 即可，但需检查：
• hook 命令里的绝对路径要改成新机器路径
• hook 依赖的工具（如 jq、shell 脚本）需在新机器安装：brew install jq 等
• 脚本文件本身的执行权限：chmod +x

五、新机器环境搭建

• 安装 Node.js（建议 LTS 版本）与 Claude Code：npm install -g @anthropic-ai/claude-code
• 登录认证：claude 首次启动时重新登录
• 安装 npx 依赖环境（MCP server 依赖）

六、验证清单

• claude mcp list：确认 3 个 server 全部连接正常（显示 ✓）
• 会话中触发一个 skill，确认加载
• 执行一个会触发 hook 的操作（如文件编辑后），确认 hook 正常执行
• 检查权限确认弹窗是否正常

常见坑

• 环境变量不随文件迁移，API ke