Claude Code跨设备迁移新手指南

一、同一设备切换中转站

先说一个核心结论：无论您如何切换中转站，本地的聊天记录都不会受到影响。这一点可以放心。

从技术原理来看，Claude Code的聊天记录实际存储在本地文件系统中，路径为 ~/.claude/projects/ 目录。中转站本质上只是API请求的转发通道，本身不存储任何会话数据。切换中转站，本质上是修改API请求的目标地址和密钥，不会影响本地的会话文件。

您只需通过以下四个步骤即可验证：

1. 先用中转站A进行对话，留下一些记录
2. 通过CC Switch切换到中转站B
3. 运行 claude --resume 或在会话中输入 /resume
4. 查看是否能看到之前与中转站A对话的聊天记录

结果一目了然。

二、不同设备间迁移会话

情形一：不合并（覆盖）

如果新设备是一台全新的机器，上面没有重要的会话数据，或者您只想保留旧设备的会话，直接覆盖即可。

方法1：手动覆盖

操作前，建议先将新设备上的 ~/.claude/ 目录备份，以防万一。然后将旧设备上同样的目录完整复制过来，覆盖新设备上的对应位置。最后运行 claude --resume 查看会话列表，数据即可迁移完成。

方法2：使用同步工具

推荐使用 claude-sync 工具，用法与Git类似：

# 旧设备上推送会话
claude-sync push
# 新设备上拉取并覆盖
claude-sync pull --force

操作简单直接。

情形二：合并（保留两边数据）

如果新设备上已有重要会话，无法简单覆盖，需要将两边的数据都保留下来，此时需要进行合并操作。

方法1：手动合并

首先分别备份旧设备和新设备上的 ~/.claude/ 目录，然后手动将旧设备 ~/.claude/projects/ 目录下的内容复制到新设备上。如果遇到同名目录，不要直接覆盖，建议先查看会话文件的时间戳，保留较新的版本，或进行重命名，使两个版本同时保留。不同设备的项目路径可能不同，路径编码问题也需要注意。

最后运行 claude --resume 检查，确认两边会话是否都在。手动操作虽然繁琐，但可控性更强。

方法2：使用合并工具

如果觉得手动合并比较麻烦，可以选择 Claude Context Sync 工具：

# 旧设备导出会话
claude-context-sync export
# 新设备导入并合并
claude-context-sync import --merge

该工具自带智能合并功能，可以节省不少操作时间。

三、工具对比与安装

1. claude-sync（适合频繁同步）

该工具的核心特点在于操作方式类似Git，使用 push 和 pull 命令即可完成同步。它支持实时增量同步，速度快，还可使用 --force 强制覆盖或增量合并。跨平台路径差异能够自动处理，在macOS、Linux、Windows上均可使用。

优点

操作简单直观，跨平台支持，增量同步速度快，能够完整同步所有会话数据。

缺点

需要网络连接，且需要稍微熟悉Git风格的操作命令。

安装方法

# 安装
curl -fsSL https://claude-sync.com/install.sh | bash
# 验证安装
claude-sync --version

2. Claude Context Sync（适合合并会话）

该工具采用导出/导入路线，支持批量数据传输。它可以直接导入覆盖，也支持 --merge 智能合并。智能路径转换系统能够处理跨平台差异，同时支持gzip压缩，减少传输数据量。

优点

智能路径转换，支持压缩，完整的会话传输功能，且可以离线操作。

缺点

操作相对复杂一些，批量传输速度不如增量同步快。

安装方法

# 安装
npm install -g claude-context-sync
# 验证安装
claude-context-sync --version

3. 其他工具

目前市面上主流的工具就是以上两种，各有侧重。简单总结：

• claude-sync：操作类似Git，适合频繁同步，追求速度
• Claude Context Sync：适合合并不同设备会话，需要离线操作

四、选择建议

如何选择适合您的工具？参考下表即可：

需求场景	推荐工具	原因
频繁在多设备间同步	claude-sync	实时增量同步，操作简单
需要合并不同设备会话	Claude Context Sync	智能合并功能，处理路径差异
偶尔迁移，设备数量少	手动方法	不需要安装额外工具
网络条件好，追求速度	claude-sync	增量同步速度快
网络条件差，需要离线	Claude Context Sync	可以离线导出导入