Claude Code新手教程之跨设备迁移指南

一、同一设备切换中转站

先说个核心结论：不管怎么切换中转站，你本地的聊天记录都不会受影响。这一点可以放心。

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

你只需要四个步骤就能验证：

1. 先用中转站A进行对话，留点痕迹
2. 然后通过 CC Switch 切换到中转站B
3. 运行 claude --resume 或者在会话中输入 /resume
4. 看看能不能看到之前跟中转站A对话的聊天记录

结果一目了然。

二、不同设备间迁移会话

情形一：不合并（覆盖）

如果新设备是台全新的机器，上面没什么重要的会话数据，或者你只想保留旧设备的会话，那直接覆盖就完事了。

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

这里推荐一个叫

的工具，用法跟git差不多：

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

简单直接。

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

但新设备上已经有一些重要会话了，不能简单覆盖，需要把两边的数据都保留下来，这就得合并了。

先分别备份旧设备和新设备上的 ~/.claude/ 目录，然后手动把旧设备 ~/.claude/projects/ 目录下的内容复制到新设备上。如果遇到同名目录，别急着覆盖，先进去看看会话文件的时间戳，保留较新的那个，或者重命名一下，两个版本都留着。不同设备的项目路径可能不一样，路径编码问题也得注意。

最后同样运行 claude --resume 检查一下，看看两边会话是不是都在。手动操作虽然繁琐，但胜在可控。

如果觉得手动合并太麻烦，还有

这个工具可选：

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

它自带智能合并功能，能省不少事。

三、工具对比与安装

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

这个工具的核心特点，就是操作方式类似git，用 push 和 pull 命令就能搞定同步。它支持实时增量同步，速度很快，还能用 --force 强制覆盖，或者增量合并。跨平台路径差异也能自动处理，在macOS、Linux、Windows上都能用。

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

：需要网络连接，而且得稍微熟悉一下git-like的命令。

：

# 安装
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	可以离线导出导入