Claude Sync：在所有设备上同步您的 Claude Code Sessions

Source: Dev.to

介绍

如果你使用 Claude Code（Anthropic 官方的 CLI），你可能会遇到以下困扰：

• 你在工作笔记本上深入进行一次编码会话。Claude 记住了你的项目上下文、偏好和对话历史。
• 然后你切换到另一台设备，所有内容都不见了——自定义代理、项目记忆和历史记录全部丢失，迫使你从头开始。

Claude Sync 是一个开源 CLI 工具，使用加密的云存储在设备之间同步你的 ~/.claude 目录。

关键特性

• 🔐 端到端加密 – 文件在上传前使用 age 加密。
• 🔑 基于口令的密钥 – 同一口令在任何设备上生成相同的密钥。
• ☁️ 多云支持 – 支持 Cloudflare R2、AWS S3 或 Google Cloud Storage。
• 🆓 免费层友好 – 在常见的免费存储配额范围内运行。
• ⚡ 简单 CLI – 只需 push 与 pull。

同步的目录结构

Claude Sync 会镜像 Claude Code 本地存储的所有内容：

~/.claude/
├── projects/          # 每个项目的会话文件、自动记忆
├── history.jsonl      # 命令历史
├── agents/            # 你创建的自定义代理
├── skills/            # 自定义技能
├── plugins/           # 已安装的插件
├── rules/             # 自定义规则
├── settings.json      # 你的偏好设置
└── CLAUDE.md          # Claude 的全局指令

安装

npm（推荐）

npm install -g @tawandotorg/claude-sync

npx（一次性使用）

npx @tawandotorg/claude-sync init

基本用法

# 上传更改
claude-sync push

# 下载更改
claude-sync pull

典型工作流：

# 工作日开始（或切换设备时）
claude-sync pull

# ... 正常使用 Claude Code ...

# 工作日结束（或切换设备前）
claude-sync push

Shell 集成（可选）

将以下内容添加到 ~/.zshrc 或 ~/.bashrc，实现自动同步：

# Shell 启动时自动 pull
if command -v claude-sync &> /dev/null; then
  claude-sync pull -q &
fi

# Shell 退出时自动 push
trap 'claude-sync push -q' EXIT

项目链接

• GitHub:
• 文档:

贡献

如果你发现 bug、有什么功能想法，或想要贡献代码，请在 GitHub 上打开 issue 或提交 pull request。