风叶：Claude Sync：让你的 Claude Code 配置在多台设备间无缝同步

风叶：Claude Sync：让你的 Claude Code 配置在多台设备间无缝同步 风叶：Claude Sync：让你的 Claude Code 配置在多台设备间无缝同步 Modified February 24 代码块 Plain Text Copy claude config sync watch stop 💾 备份管理 创建备份 代码块 Plain Text Copy claude config sync backup create 查看备份列表 代码块 Plain Text Copy claude config sync backup list 输出： Code block Plain Text Copy Available Backups: [1] backup 2024 01 15T10:30:00.000Z • Date: 2024 01 15 10:30:00 • Files: 42 [2] backup 2024 01 14T15:20:00.000Z • Date: 2024 01 14 15:20:00 • Files: 38 恢复备份 代码块 Plain Text Copy 使用索引号恢复 claude config sync backup restore 1 或使用备份路径 claude config sync backup restore /path/to/backup 清理旧备份 代码块 Plain Text Copy 只保留最近 5 个备份 claude config sync backup clean keep 5 常见问题 Q1：推送时提示 "Permission denied"？ A：这是 SSH 密钥未配置导致。解决方法： Code block Plain Text Copy 1. 生成 SSH 密钥 ssh keygen t ed25519 C "your email@example.com" 2. 添加到 ssh agent eval "$(ssh agent s)" ssh add /.ssh/id ed25519 3. 复制公钥 cat /.ssh/id ed25519.pub 4. 添加到 GitHub 访问：https://github.com/settings/keys 点击 "New SSH key"，粘贴公钥 Q2：如何确保敏感信息不被同步？ A：默认已排除常见敏感文件，你可以自定义： 代码块 Plain Text Copy 查看当前排除规则 claude config sync config get sync.excludePatterns 添加新的排除规则 claude config sync config exclude " .pem" claude config sync config exclude "credentials/ " Q3：多台设备同时修改会冲突吗？ A：提供了 4 种冲突解决策略： 代码块 Plain Text Copy 交互式询问（推荐，默认） claude config sync config set sync.conflictStrategy ask 总是保留本地 claude config sync config set sync.conflictStrategy local 总是使用远程 claude config sync config set sync.conflictStrategy remote 使用最新的（按修改时间） claude config sync config set sync.conflictStrategy newest Q4：如何迁移到另一台设备？ A：三个步骤搞定！ 代码块 Plain Text Copy 1. 安装工具 npm install g claude config sync 2. 初始化（指向你的配置仓库） claude config sync init repo git@github.com:你的用户名/claude config.git 3. 拉取配置 claude config sync pull Q5：支持哪些类型的文件？ A：支持以下文件类型： Code block Plain Text Copy ✅ JSON 配置文件 ✅ JS/TS 脚本文件 ✅ MD 文档文件（技能文档等） ✅ 其他 可通过自定义模式添加 配置文件说明 配置文件位置： /.claude config sync/config.json Code block Plain Text Copy { "version": "1.0.0", "sync": { "repository": "git@github.com:user/claude config.git", "branch": "main", "autoSync": false, "syncIntervalMinutes": 30, "include": { "skills": true, "plugins": true, "settings": true, "projects": false, "history": false, "customPatterns": [] }, "excludePatterns": [ ".env", " .key", "secrets/", " .secret" ], "conflictStrategy": "ask" } } 目录结构 代码块 Plain Text Copy /.claude/ Claude 配置目录 ├── skills/ 技能文件 ├── plugins/ 插件配置 ├── settings.json 用户设置 └── projects/ 项目配置 /.claude config sync/ 同步工具目录 ├── config.json 同步配置 ├── repo/ Git 仓库克隆 └── backups/ 配置备份 ├── backup 2024 01 15T10:30:00.000Z/ └── backup 2024 01 14T15:20:00.000Z/ 实战案例 案例 1：家中 → 公司 代码块 Plain Text Copy 家中电脑： 1. 安装了新的 AI 写作技能 2. 运行：claude config sync push 3. 配置已同步到 GitHub 公司电脑： 1. 运行：claude config sync pull 2. 新技能自动出现！ 案例 2：换新电脑 代码块 Plain Text Copy 旧电脑： 1. claude config sync push 最后一次推送 新电脑： 1. npm install g claude config sync 2. claude config sync init repo git@github.com:user/claude config.git 3. claude config sync pull 4. 完成！所有配置恢复 案例 3：团队协作 Code block Plain Text Copy 个人仓库：claude config（私有） 团队仓库：team claude config（组织私有） 个人配置推送到个人仓库 团队共享配置推送到团队仓库 使用技巧 💡 技巧 1：定期自动同步 结合 cron（Linux/Mac）或任务计划程序（Windows）实现定时同步： 代码块 Plain Text Copy Mac/Linux：每小时同步一次 crontab e 添加： 0 claude config sync sync 💡 技巧 2：不同环境使用不同仓库 代码块 Plain Text Copy 工作环境 claude config sync init repo git@github.com:user/work claude config.git 个人环境 claude config sync init repo git@github.com:user/personal claude config.git 💡 技巧 3：使用 .syncignore 自定义忽略 创建 /.claude sync/.syncignore 文件： 💾 备份管理 创建备份 查看备份列表 输出： 恢复备份 清理旧备份 常见问题 Q1：推送时提示 "Permission denied"？ A：这是 SSH 密钥未配置导致。解决方法： Q2：如何确保敏感信息不被同步？ A：默认已排除常见敏感文件，你可以自定义： Q3：多台设备同时修改会冲突吗？ A：提供了 4 种冲突解决策略： Q4：如何迁移到另一台设备？ A：三个步骤搞定！ Q5：支持哪些类型的文件？ A：支持以下文件类型： 配置文件说明 配置文件位置： /.claude config sync/config.json 目录结构 实战案例 案例 1：家中 → 公司 案例 2：换新电脑 案例 3：团队协作 使用技巧 💡 技巧 1：定期自动同步 结合 cron（Linux/Mac）或任务计划程序（Windows）实现定时同步： 💡 技巧 2：不同环境使用不同仓库 💡 技巧 3：使用 .syncignore 自定义忽略 创建 /.claude sync/.syncignore 文件： 安全建议 ✅ 推荐做法 1. 使用私有仓库：配置可能包含敏感信息 2. 定期审查排除规则：确保没有敏感文件被同步 3. 启用备份：每次操作前自动备份 4. 使用 SSH：比 HTTPS 更安全 ❌ 避免事项 1. ❌ 不要将 API Token 同步到公共仓库 2. ❌ 不要在配置中保存密码 3. ❌ 不要忽略 .env 文件（默认已排除） 更新日志 v0.1.0 (2024 01 15) • ✨ 初始版本发布 • ✅ 支持 Git 同步 • ✅ 选择性文件同步 • ✅ 冲突解决机制 • ✅ 自动备份功能 • ✅ Watch 模式 • ✅ 中英文文档 贡献指南 欢迎贡献代码！ 开源地址 ⭐ GitHub: https://github.com/balingsisi/claude config sync tool https://github.com/balingsisi/claude config sync tool 如果这个工具对你有帮助，请给个 Star ⭐ 总结 claude config sync 是一个简单而强大的工具，让 Claude Code 的配置管理变得轻而易举： ✅ 5 分钟上手 简单的初始化流程 ✅ 自动同步 告别手动复制配置 ✅ 安全可靠 基于 Git，私有仓库 ✅ 全平台支持 Windows、Mac、Linux ✅ 开源免费 MIT 许可证 现在就试试吧！ 原文链接：点击这里 点击这里 Claude Sync：让你的 Claude Code 配置在多台设备间无缝同步 作为一个 Claude Code 的重度用户，你是否也有这样的烦恼： 家里的电脑配置好了完美的技能（Skills），到了公司又要重新安装？ 换了新机器，所有的插件、设置都要从头开始？ 多台设备之间配置不同步，经常忘记哪台才是最新的？ 作为一个 Claude Code 的重度用户，你是否也有这样的烦恼： 家里的电脑配置好了完美的技能（Skills），到了公司又要重新安装？ 换了新机器，所有的插件、设置都要从头开始？ 多台设备之间配置不同步，经常忘记哪台才是最新的？ 今天，我开源了一个名为 claude config sync 的工具，完美解决了这个问题！ 📖 目录 1. 什么是 claude config sync？ 2. 核心功能 3. 适用场景 4. 安装指南 5. 快速上手 6. 详细使用教程 7. 高级功能 8. 常见问题 9. 开源地址 什么是 claude config sync？ claude config sync 是一个基于 Git 的配置同步工具，专门为 Claude Code 用户设计。它可以将你的配置（技能、插件、设置等）自动同步到 GitHub 私有仓库，让你在任何设备上都能快速恢复完美的工作环境。 🌟 核心特性 核心功能 1️⃣ 选择性同步 你可以精确选择要同步的内容： 2️⃣ 智能冲突解决 当同一文件在多台设备上都被修改时，提供 4 种解决策略： • ask 交互式询问（推荐） • local 保留本地版本 • remote 使用远程版本 • newest 选择最新修改的版本 3️⃣ 安全保护 默认排除敏感文件： 适用场景 🏠 场景一：家庭办公两不误 效果：在家安装的新技能，到了公司自动同步可用！ 💻 场景二：换机无忧 效果：5 分钟完成新电脑环境配置！ 🔄 场景三：多机协作 效果：多台设备配置始终保持一致！ 安装指南 前置要求 • Node.js = 18.0.0 • Git • GitHub 账号（用于存储配置） 方式一：npm 全局安装（推荐） 安装完成后，直接在命令行使用： 方式二：从源码安装 验证安装 快速上手 第一步：创建配置仓库 1. 访问 GitHub 创建新仓库 GitHub 2. 命名为 claude config（或其他名称） 3. 选择 Private（私有仓库） 4. 勾选 "Add a README file" 5. 点击 "Create repository" https://docs.github.com/assets/cb 47661/more options repo create.png 第二步：初始化同步 交互式配置： 第三步：完成！🎉 现在你的配置已经安全地存储在 GitHub 上了！ 详细使用教程 📤 推送本地更改 当你在本地安装了新技能或修改了配置后： 输出示例： 📥 拉取远程更改 在其他设备上获取最新配置： 输出示例： 🔄 双向同步 同时拉取远程更改并推送本地更改： 这是最常用的命令，确保两边的配置都是最新的！ 📊 查看同步状态 输出示例： 高级功能 🔧 配置管理 查看所有配置 修改配置项 添加排除规则 👀 自动监听模式 让工具自动监听配置文件的变化并同步： 输出： 停止监听：