claude-config：Claude Code配置同步器

通过一个Git仓库集中管理Claude Code配置，再用安装脚本和符号链接自动同步，多台电脑瞬间拥有一致技能状态，配置管理进入稳定高效节奏。案例配置点击标题

在多台电脑之间来回切换时，Claude Code的技能和偏好配置经常散落各处，像零散零件一样到处找。每一次重新配置都消耗专注力，节奏被打断，生产力像被拔掉电源。这个方案的目标非常直接：让所有电脑看见同一套配置，启动即用，状态一眼可查，流程像自动挡一样顺。

这个项目的解决方案：

建一个 Git 仓库当“中央服务器”：把你精心调教好的 Claude Code 设置和技能都保存在 GitHub 上。
写一个安装/同步脚本：在新电脑上，运行这个脚本，它会自动把仓库里的配置“链接”到你电脑上 Claude Code 该放配置的地方（~/.claude/）。
智能处理本地配置：它很聪明，不是粗暴覆盖。比如：
- 有的技能你想全局同步：它就创建软链接，跟着仓库走。
- 有的技能你想只在某台电脑用：可以标记为“本地专用”，脚本不会动它。
- 如果本地和仓库有冲突：它会提示你“有冲突”，让你决定保留哪个。

命令行里一目了然：运行同步命令后，它会用不同颜色或状态告诉你每个技能的情况：

打个比方：就像用 Git 管理你的代码一样，现在你用 Git 来管理你的 AI 助手配置。git pull 一下，就把你最顺手的 Claude 环境同步到新电脑了；git commit & push 一下，就把你在新电脑上训练的好技能备份到云端了。

核心思路：Git仓库作为唯一可信源

方案的中枢是一个Git仓库，承担“唯一真相来源”的角色。所有Claude Code的配置文件与技能定义统一存放在仓库中，版本记录清晰，变更可追溯。任何电脑只需要拉取仓库，就能获得最新、完整的一套配置基础。这种集中式管理让配置不再分散，秩序自然形成。

安装脚本：把复杂流程变成一次动作

安装脚本是整个系统的执行引擎。运行脚本时，会完成拉取仓库、扫描技能、判断状态、创建符号链接等动作。

最终效果是：仓库中的文件被“挂载”到主目录下的 ~/.claude/ 位置，Claude Code读取到的始终是仓库版本。脚本在命令行中持续输出状态信息，让进度和结果清晰可见。

符号链接：同步而不复制的关键技术

符号链接/软链接像一张指向真实文件的路标。通过链接而非复制，配置文件始终保持与仓库一致。仓库更新后，所有链接立即生效，不需要再次分发文件。这种方式减少重复数据，避免版本漂移，让多设备同步变得轻量而可靠。

技能的四种状态：一眼看懂住在哪

系统为每个技能定义了四种状态，并在CLI中直接展示。
同步状态表示技能与仓库完全一致，处于理想运行区。
本地专属状态表示技能仅存在于当前电脑，用于个性化或临时调整。
冲突状态表示本地修改与仓库版本产生分歧，需要人工决策。
外部符号链接状态表示技能链接到仓库之外的位置，用于高级扩展。

这种状态可视化让配置分布一目了然，管理感受接近仪表盘。

本地专属技能：统一之外的弹性空间

即使统一管理，也需要留出个性化余地。本地专属状态允许某些技能只在特定机器存在，安装脚本在识别到这种状态时保持尊重，不做覆盖。这种设计让系统既有纪律，也有弹性，适应不同设备的现实差异。

冲突状态：配置升级的检查点

当冲突出现，意味着本地与仓库同时发生了演化。脚本会明确标出冲突技能，提示当前存在多个版本选择。这一刻成为配置升级的检查点，帮助梳理哪些修改值得进入主线，哪些适合保留在本地。

外部符号链接：为进阶玩法预留接口

外部符号链接状态让技能来源可以跳出仓库边界，例如指向其他项目或共享目录。系统依然对这种状态进行标记和展示，既保持灵活，又维持整体可控。配置网络因此具备扩展能力，而不是封闭盒子。

每台电脑的体验：启动即满配

完成一次安装后，每台电脑都像复制了同一套工作台。打开Claude Code时，技能齐全、偏好一致，进入状态的速度明显提升。切换设备不再需要心理缓冲，注意力自然回到代码本身。

与传统手动配置的差别

手动复制配置依赖记忆与耐心，结果常常是遗漏与不一致。这个方案引入版本控制、自动化安装和状态展示，让配置管理变成可重复、可验证的流程。稳定性和效率同时提升。

技术组合的整体价值

Git仓库、安装脚本、符号链接、状态分类这几项技术单独存在时很普通，组合在一起却形成了高效闭环。配置管理从体力活升级为系统工程，投入一次，长期受益。

总结一下，这个工具让你：

结尾：让配置管理退出舞台中央

这个方案的真正价值在于“隐身”。当配置同步稳定运行时，注意力自然回到创造本身。技能在哪里、版本是否一致，这些问题自动得到答案，工作流恢复连贯节奏。