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：适合合并不同设备会话，需要离线操作

四、选择建议

到底该选哪个？看这个表格就清楚了：