Claude Code 配置迁移指南

V2.1.77

配置文件分布

~/.claude.json ← 全局 MCP 配置（主要）

~/.claude/
    ├── CLAUDE.md ← 全局系统提示词
    ├── settings.json ← 项目级 MCP & 设置
    ├── settings.local.json ← 本地权限设置
    └── commands/ ← 自定义 Skill 文件
            ├── *.md
            └── scripts/ ← skill 依赖脚本

迁移步骤

1. 打包配置文件（在源机器执行）

tar -czf claude-config-backup.tar.gz \
  ~/.claude.json \
  ~/.claude/CLAUDE.md \
  ~/.claude/settings.json \
  ~/.claude/settings.local.json \
  ~/.claude/commands/ \
  ~/.claude/skills/

2. 传输到目标机器

scp claude-config-backup.tar.gz user@新机器IP:~/

3. 在目标机器解压还原

tar -xzf claude-config-backup.tar.gz -C /

各 MCP 的注意事项

MCP	迁移注意
`baidu-search`	直接迁移，API key 通用
`brave-search`	需安装 Node.js + npx，API key 直接用
`tavily-search`	同上，npx 自动安装
`scraperapi`	同上
`puppeteer`	需在新机器安装 mcp-server-puppeteer，且 `PUPPETEER_EXECUTABLE_PATH` 路径要改为新机器的 chromium 路径
`tushare`	需重新安装 tushare-mcp，路径 `/home/ubuntu/.local/bin/tushare-mcp` 可能不同
`suno`	需重新安装 mcp-suno
`mysql`	新机器需有 MySQL 并安装 mcp-server-mysql，数据库连接信息按需修改
`apify`	API key 通用，直接迁移

需要重装的依赖

在新机器上执行：

# MCP 服务
npm install -g mcp-server-puppeteer
npm install -g mcp-server-mysql

# Python MCP
pip install tushare-mcp mcp-suno

# 可选工具
pip install markdown  # skill 中用到

验证迁移成功

# 检查配置是否正确加载
claude --version

# 检查 MCP 列表
claude mcp list

关键提醒：puppeteer 的 PUPPETEER_EXECUTABLE_PATH 和本地路径依赖的 MCP（tushare、suno）在新机器上路径可能不同，迁移后需根据实际安装路径调整 ~/.claude.json 中对应的 command 字段。