AI导哈

Claude代码配置同步工具

用于在多项目和计算机间同步Claude代码配置的工具，提供Git和Symlink同步方法，避免使用Dropbox。

  • by Yoel-Klein
  • PowerShell
  • 本地部署
  • 更新于
在 GitHub 查看 Yoel-Klein/MCP-Config

使用说明

Claude代码配置

用于跨平台同步的集中式Claude代码配置 所有项目 和 所有计算机.

⛔ 警告：请勿使用DROPOX进行~/.claude同步

我们尝试了Dropbox符号链接同步，但不起作用。原因如下：

  1. Claude Code不断写入小文件 - statsig/, telemetry/, todos/, file-history/ 每隔几秒钟更新一次
  2. Dropbox在同步时锁定文件 -这会导致写入失败和“设备繁忙”错误
  3. Dropbox反击 -即使在删除后，Dropbox也会在同步冲突期间重新创建文件夹
  4. 数千个小文件 -Claude生成2500多个小文件，淹没了Dropbox的同步
  5. 文件冲突无处不在 -您将不断看到“冲突副本”文件

清理脚本 cleanup-dropbox-sync.ps1 存在这个错误。

什么有效：

  • 基于Git的同步 -切换电脑时手动推/拉
  • 同步 -P2P同步，更好地处理频繁的小文件
  • 只需同步 settings.json 手动地 -这是唯一真正重要的文件

两种配置类型

类型 位置 目的 同步方法
项目级别 .claude/ 在项目中 代理、技能、MCP服务器 Git+Symlink✅
用户级别 ~/.claude/ 设置、凭据、历史记录 ~~ Dropbox ~~❌ 使用Git

🖥️ 多计算机同步（用户级）

使用Dropbox在多台计算机上同步您的Claude Code用户设置、凭据、对话历史记录和插件。

沮丧：Dropbox同步不起作用。请参阅上面的警告。

什么被同步

~/.claude/
├── settings.json        # Model, permissions, enabled plugins
├── credentials.json     # OAuth credentials
├── history.jsonl        # Command history
├── plans/               # Planning scratch files
├── todos/               # Todo lists
├── projects/            # Conversation history per project
└── plugins/             # Installed plugins

设置

在你的第一台电脑上（真相来源）：

# Run as Administrator after closing VS Code
.\setup-dropbox-sync.ps1 -SourceOfTruth

在第二台和第三台计算机上（Dropbox同步后）：

# Run as Administrator after closing VS Code
.\setup-dropbox-sync.ps1 -LinkOnly

需求

  • Windows开发人员模式：打开（设置→ 开发者）
  • Dropbox已安装并同步
  • 运行前关闭VS代码

工作流程

  1. 计算机A
  2. 关闭VS代码
  3. 等待Dropbox同步（秒）
  4. 在计算机B上打开VS代码
  5. 一切都在那里——设置、历史、对话

📁 多项目同步（项目级）

分享相同 .claude 使用符号链接在所有项目中创建文件夹（代理、技能、MCP服务器）。

目录结构

C:\MCP-Config\
├── .claude\
│   ├── agents\              # Custom agents
│   ├── skills\              # Custom skills
│   ├── settings.json        # Project settings
│   └── settings.local.json  # Machine-specific overrides
├── setup-symlink.bat        # Windows setup
├── setup-symlink.sh         # Unix/Mac setup
└── setup-dropbox-sync.ps1   # Multi-computer sync

在每个项目中设置

Windows（作为管理员）：

cd C:\Projects\YourProject
C:\MCP-Config\setup-symlink.bat

Unix/Mac/Git Bash：

cd ~/Projects/YourProject
bash /c/MCP-Config/setup-symlink.sh

添加到项目中的.gitignore

.claude/

⚙️ 当前配置

用户设置(~/.claude/settings.json)

{
  "model": "opus",
  "alwaysThinkingEnabled": true,
  "permissions": { "defaultMode": "bypassPermissions" },
  "includeCoAuthoredBy": false,
  "enabledPlugins": {
    "pyright-lsp@claude-plugins-official": true,
    "typescript-lsp@claude-plugins-official": true,
    "frontend-design@claude-plugins-official": true,
    "feature-dev@claude-plugins-official": true
  }
}

MCP服务器(.mcp.json)

  • context7 -文档查找
  • chrome-devtools -浏览器自动化

原生插件（LSP）

  • pyright-lsp -Python/FastAPI
  • typescript-lsp -Types/React

🔧 脚本参考

脚本 目的 何时使用
setup-dropbox-sync.ps1 -SourceOfTruth 将~/.claude移至Dropbox 仅限第一台计算机
setup-dropbox-sync.ps1 -LinkOnly Dropbox配置链接 其他计算机
setup-symlink.bat 将project.claude链接到中心 每个项目（Windows）
setup-symlink.sh 将project.claude链接到中心 每个项目（Unix）

🛠️ 故障排除

Windows上的“拒绝访问”

以管理员身份运行PowerShell/CMD，或启用开发人员模式。

Symlink不工作

# Check if it's a symlink
Get-Item "$env:USERPROFILE\.claude" | Select-Object LinkType, Target

Dropbox冲突

如果您看到“冲突副本”文件，则表示您在多台计算机上打开了VS代码。原始文件将被保留，只需删除冲突的副本即可。

📝 变更日志

日期 更改
2026-01-11 添加了用于多台计算机设置的Dropbox同步脚本
2026-01-11 将存储库从MCP配置重命名为Claude代码配置
2025-10-XX 使用项目符号链接脚本进行初始设置

计算机： 工作电脑、笔记本电脑、家用电脑 Dropbox路径： ~/Dropbox/STT/claude-config github： Yoel Klein/Claude代码配置

相关 MCP