将 AI 编程助手的技能、MCP、hooks、全局指令等配置…

# Claude Code MCP 服务与全局指令迁移方案（Mac → Windows）

一、明确要迁移的内容清单

• MCP 服务配置：通常在 ~/.claude.json（用户级）和各项目目录的 .mcp.json（项目级）
• 全局指令：~/.claude/CLAUDE.md（全局记忆）+ 各项目根目录的 CLAUDE.md
• 其他配置：~/.claude/settings.json（权限、快捷设置）、自定义 slash commands（~/.claude/commands/）、可选的输出样式配置

二、Mac 端导出步骤

• 建立备份目录，如 ~/claude-backup/
• 复制核心文件：
• ~/.claude.json（注意：含历史会话，体积可能较大，可只保留 mcpServers 字段）
• ~/.claude/ 整个目录（含 settings.json、CLAUDE.md、commands/）
• 逐个项目复制 .mcp.json 和项目级 CLAUDE.md（先 ls 列出所有项目核对数量）

三、迁移前“预演”（Dry Run）

• 清点核对：用命令统计 Mac 端 MCP 数量，例如用 jq 提取 .mcpServers | keys 列出全部服务名，生成清单文件
• 逐项打勾：对照清单确认 30+ 个服务每个都已进入备份
• 敏感信息检查：MCP 配置中通常含 API Key、环境变量，确认备份文件是否加密存储（建议压缩时加密码，或迁移后立即删除中转文件）
• 记录依赖版本：node -v、python --version、npx/uvx 等命令版本，Windows 端需对应安装

四、Windows 端恢复步骤

• 安装 Node.js、Git、Claude Code（npm install -g @anthropic-ai/claude-code）
• 将备份放到 %USERPROFILE%\.claude\ 和 %USERPROFILE%\.claude.json
• 路径改写（关键坑）：Mac 路径 /Users/xxx/... 需改为 C:\Users\xxx\...；含 npx/uvx 的命令在 Windows 上可能需调整为 npx.cmd 或补全路径
• 环境变量通过系统设置或 .env 重新配置 API Key

五、迁移后验证

• 运行 claude mcp list，逐一确认 30+ 服务状态为已连接
• 抽查 3-5 个高频 MCP 实际调用一次
• 打开 Claude Code 确认全局指令（CLAUDE.md）已生效（询问其行为规范）
• 全部通过后，删除两端的中转/备份明文文件

提示：如部分 MCP 是本地脚本实现，还需把脚本本身一并迁移并在 Windows 重装其依赖。