用途
claude-snapshot 用于导出和恢复 Claude Code 的配置环境。官方描述为“可移植的 Claude Code 配置快照——导出、对比并在多台机器间应用你的配置”。典型用途包括：
- 多台机器之间同步个人与工作配置：在家导出快照，放到网盘，到公司应用。
- Mac 格式化或重装系统前保存快照，重装后恢复整个 Claude Code 配置。
- 安全回滚：在尝试新插件或高风险配置修改前先做快照，出问题时应用快照回到已知良好状态。
- 团队 onboarding：分享团队快照，新成员即可获得相同的插件、hooks 和约定。
主要能力
- 导出：读取 ~/.claude/，写出 .tar.gz 快照，其中包含 manifest.json 索引。
- 应用：解压快照，为目标机器解析 $HOME，将冲突文件备份为 .bak，并安装缺失的插件。
- 快照内容：settings、CLAUDE.md、hooks、插件清单（plugin manifests）、MCP servers。MCP servers 从 ~/.claude.json 中的 mcpServers 键采集并放入 tar 包；应用时仅报告目标机器上需要安装哪些 MCP，不会自动写入 ~/.claude.json（因为该文件还包含 OAuth token 和项目状态）。
- 便携性：绝对路径（如 /Users/you/）在导出时被规范化为 $HOME。
- 可审查：无需解压即可通过 /snapshot:inspect 检查快照内容。
- 输出格式：在交互式终端打印人类可读摘要；在管道中输出单行 JSON；可传 --json 在终端强制 JSON。
设计原则
- [P1] 最小影响面：一次性命令，无守护进程、无后台监听、无网络。每个副作用都由明确的用户命令触发，范围限定在 ~/.claude/ 和输出 tar 包路径。
- [P2] 白名单优于黑名单：快照只包含显式列出的产物；Claude Code 未来版本新增的文件不会自动捕获，由插件更新决定包含哪些内容。这以手动维护换取可预测、可审计的快照内容。
- [P3] 永不联网：export 和 apply 均为本地操作。应用时的插件重装委托给 Claude Code 自身的 /plugin install 机制，由其管理网络访问；claude-snapshot 自身不发起任何出站请求。
- [P4] 先 diff 后覆盖：每次 apply 前都会显示 diff 摘要供用户确认。每个被覆盖的文件先复制为 <file>.bak。
- [P5] 跨平台优先：插件使用 Node.js 而非 bash，在 macOS 和 Linux 上无需 polyfill 或不同代码路径即可运行；通过 WSL 支持 Windows，原生 Windows 为尽力支持。
使用方式
前置要求：支持插件的 Claude Code；Node.js 18+（插件使用 tar npm 包进行归档 I/O）。
作为 Claude Code 插件（推荐）：
免安装试用（通过 npx）： 无需注册 marketplace、无需安装、无需重载，直接从 npm registry 运行。命令会写出快照到 ~/claude-snapshot-YYYY-MM-DD.tar.gz 并打印路径；其他命令以该路径为唯一参数。适合一次性备份、CI，或在将插件加入 Claude Code 前试用。
快照的读写范围
读取：export 时读取 ~/.claude/。 写入：apply 时写入 ~/.claude/，并对任何冲突文件自动备份 .bak；输出 tar 包写入你指定的路径（默认 ~/）。 不触碰：不在 ~/.claude/ 和指定输出路径之外写入；无网络请求；无遥测、无分析，数据不离开本机；不需要 --dangerously-skip-permissions。
回滚与删除
apply 过程中每个被覆盖的文件都会先复制为 <file>.bak，出问题时可从 .bak 恢复或重新应用上一个快照。你创建的快照（*.tar.gz）是普通文件，可像其他文件一样删除。
限制与当前状态
当前版本 v0.2 以 Claude Code 作为一等环境。架构在 collector 层面刻意保持与工具无关——collect() 读取配置目录并生成结构化快照，因此扩展到同类 agent 工具是自然的下一步。 计划中的支持：目标是“一个工具、一条命令（npx claude-snapshot export --target codex）、多种后端”，让跨机器迁移或在不同 agent 间迁移无需重建整套配置。欢迎为新工具添加 collector/applier 的贡献，门槛是符合 tests/snapshot.test.mjs 中现有模式的 hermetic 测试夹具和往返测试。 较短期（非工具扩展）事项：--with-mcp 标志，在 apply 时写入 ~/.claude.json（可选开启，并对整个文件做 .bak）；加密快照选项用于团队分享；选择性应用（选取快照内容的子集）。 问题与 PR 提交至 github.com/adhenawer/claude-snapshot/issues，较大改动请先开 issue 讨论方案。
暂未提供的信息
官方文本未提供具体收费、价格、平台可用性、处理效果数据、性能指标、使用步骤截图或用户评价等内容，故未在此展开。
