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

一、同一设备切换中转站

核心结论

切换中转站不会影响本地聊天记录

技术原理

• 存储机制：Claude Code 的聊天记录存储在本地文件系统中（~/.claude/projects/ 目录）
• 中转站作用：中转站只是API请求的转发通道，不存储任何会话数据
• 配置独立：切换中转站只是修改API调用的目标地址和密钥，不会触及本地存储的会话文件

验证方法

1. 使用中转站A进行对话
2. 通过 CC Switch 切换到中转站B
3. 运行 claude --resume 或在会话中输入 /resume
4. 确认可以看到之前与中转站A的聊天记录

二、不同设备间迁移会话

情形一：不合并（覆盖）

适用场景：新设备是全新的，没有重要的会话数据，或只想保留旧设备的会话。

方法1：手动覆盖

备份新设备数据（可选）：复制 ~/.claude/ 目录到备份位置

复制旧设备数据：

• 将旧设备的 ~/.claude/ 目录完整复制到新设备
• 覆盖新设备的对应目录

验证：运行 claude --resume 查看会话列表

方法2：使用同步工具

推荐工具：claude-sync

使用方法：

# 旧设备：推送会话
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 强制覆盖
• 合并功能：支持增量合并
• 路径处理：自动处理跨平台路径差异
• 适用场景：频繁在多设备间同步，需要实时保持一致

优点：

• 操作简单直观，类似git
• 跨平台支持（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	可以离线导出导入