claude-nomad
跨机器同步Claude Code的完整工作环境与对话历史。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:claude-nomad。 它的用途是:跨机器同步Claude Code的完整工作环境与对话历史。 完整的 Skill 内容见:https://321skill.com/skills/claude-nomad/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在笔记本上继续昨天在办公室电脑上关于项目架构的讨论。” 得益于 claude-nomad,Claude Code 会加载完整的对话历史,包括当时打开的文件和上下文,让你无缝衔接工作。当你完成一天的工作后,只需运行 `nomad sync`,所有新的对话和设置变更就会被安全地推送到同步仓库。
介绍
claude-nomad 解决了开发者在多台机器上使用 Claude Code 时,技能、设置和对话历史无法同步的痛点。它通过一个私有的 Git 仓库来管理你的 Claude Code 配置,运行 nomad sync 命令即可在任意机器上拉取最新配置并推送本地变更,实现无缝切换。
使用方式非常简单:初始化一个 Git 仓库作为同步源,然后在每台机器上安装 claude-nomad 并连接到该仓库。之后,只需执行 nomad sync 命令,它就会自动处理拉取、合并和推送,确保你的技能库、自定义设置以及完整的对话历史(包括跨机器的路径重映射)在所有设备上保持一致。
这个工具非常适合需要在不同电脑(如办公室台式机、家用笔记本)间切换工作的开发者、研究员或任何重度依赖 Claude Code 进行编程和对话的用户。它能让你在任何地方都拥有一个熟悉且连续的工作环境。
需要注意的是,为了安全,务必使用 nomad push 而非手动 git push 来发布更改,因为前者会进行密钥扫描。此外,某些由系统管理的组件(如通过npm安装的特定钩子和代理)不会被同步,以避免版本冲突。
核心特点
与简单的 dotfiles 同步或 rsync 方案不同,claude-nomad 深度理解 Claude Code 的数据结构,能够智能重写会话历史中机器特定的文件路径,确保对话上下文在不同路径的机器间依然可用;同时,每次推送都强制进行密钥扫描,从源头防止敏感信息泄露。
注意事项
不适合仅在一台固定机器上使用 Claude Code,且不愿维护 Git 仓库同步流程的用户。
常见问题
claude-nomad 会同步我的 API 密钥吗?
不会。每次推送都会用 gitleaks 进行密钥扫描,检测到潜在密钥时会中止推送并提示处理,有效防止密钥泄露。
在不同操作系统(如 Windows 和 macOS)之间同步有效吗?
有效。claude-nomad 的核心功能之一是路径重映射,可以处理不同操作系统间的文件路径差异,确保会话历史可移植。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/claude-nomad/raw/index.md 读取 claude-nomad 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/claude-nomad/raw/index.md(查看排版版本)