用 Git 三步同步 Claude Code 配置多台设备共用同一套设置【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code是否经常在公司电脑、家里笔记本和开发服务器之间切换每次都要重新配一遍 Claude Code设置、命令、钩子全部重来。本文教你用一个 Git 仓库做 Claude Code 配置同步3 个步骤、约 10 分钟改一次配置所有设备自动保持一致。准备工作确认 Claude Code 配置文件在哪先确认你手上有这三样已装好 Claude Code终端里执行claude能启动不行的话先按官方文档安装。配置目录~/.claude/这是 Claude Code 的用户配置目录核心文件是~/.claude/settings.json。执行ls ~/.claude/能看到settings.json就说明位置对了。一个私有 Git 仓库可以是 GitLab/Gitee 等平台上的空仓库地址形如gitgitee.com:你的用户名/claude-config.git。~/.claude/里除了settings.json可能还有你自写的钩子脚本hook即 Claude 执行某类操作前/后自动触发的脚本。它们都可以纳入同步。第一步初始化 Git 配置仓库在~/.claude/里初始化 Git并把敏感文件排除在外——避免 token、凭据被推到远程仓库。cd ~/.claude cat .gitignore EOF *.log credentials/ *auth* keychain* EOF git init git add . git commit -m init: claude settings git remote add origin gitgitee.com:你的用户名/claude-config.git git push -u origin main为什么用 Git它天然带版本记录配置改坏了可以回滚多台设备共用同一个远程仓库就是配置文件 云存储架构里的云存储。第二步让配置自动同步写一个同步脚本放到配置目录内一起被 Git 管理。脚本做三件事拉取远端最新、提交本地变更、推送。cat ~/.claude/sync.sh EOF #!/bin/bash cd ~/.claude || exit 1 git pull --rebase origin main || exit 1 git add -A git diff --cached --quiet || git commit -m sync $(hostname) $(date %F_%T) git push origin main EOF chmod x ~/.claude/sync.sh crontab -e在 crontab 编辑器最后加一行保存退出*/30 * * * * ~/.claude/sync.sh ~/.claude/sync.log 21这样每半小时自动同步一次你随时也可以手动执行~/.claude/sync.sh。第三步第二台设备拉取配置在新设备上克隆仓库到~/.claudegit clone gitgitee.com:你的用户名/claude-config.git ~/.claude如果该设备已经在用 Claude Code、目录不为空就克隆到别处只把settings.json拷进~/.claude/覆盖即可。如何验证同步生效在第二台设备上执行diff ~/.claude/settings.json /dev/null echo settings 存在 git -C ~/.claude log --oneline -3看到设备 A 上的提交时间戳是 A 的推送时间出现在日志里说明拉取成功。再回设备 A 改一处配置、等设备 B 同步后diff ~/.claude/settings.json 设备A上同一文件没有任何输出即说明两边 Claude Code 配置完全一致同步成功。加分项用钩子脚本统一命令规范想让所有设备强制遵守grep 改写成 rg这类规范可以在settings.json的hooks.PreToolUse里注册一个钩子matcher 为Bash表示作用于所有 Bash 命令{ hooks: { PreToolUse: [{ matcher: Bash, hooks: [{ type: command, command: python3 ~/.claude/hooks/validator.py }] }] } }脚本从标准输入读到工具调用的 JSON返回退出码 2 即可拦截命令并把提示回传给 Claude。项目里的 examples/hooks/ 提供了现成示例 bash_command_validator_example.py它正是把grep调用改写为rg的校验脚本——把这份脚本拷到各设备的~/.claude/hooks/下即可复用。踩坑与替代路线如果同步后仓库里出现了 token 等敏感信息就把它加进.gitignore再执行git rm --cached 文件名提交一次已推送过的敏感值建议直接作废换新。如果拉取时报 git 冲突就先在冲突设备上手动git pull --rebase origin main解决冲突同步脚本的|| exit 1会跳过失败这一次下个周期自动补上。如果你不用 Git比如 Windows 环境替代路线是云盘同步把~/.claude移动或建符号链接指向OneDrive/坚果云的同步文件夹两台设备都指向云盘省掉脚本和定时任务代价是没有版本记录。收尾三条最佳实践敏感文件凭据、token、日志永远不入库.gitignore先行。同步脚本保持带日志 sync.log出问题时先翻日志。改完配置先在本机跑一遍确认行为正常再让它被推送。延伸阅读除钩子外项目还在 examples/settings/ 提供了宽松/严格/Bash 沙箱三种 settings 示例可合并成你自己的基础配置再同步。【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考