Sincronize a Configuração do Claude Code Entre Máquinas com claude-config-sync
Se você usa Claude Code em várias máquinas, provavelmente já percebeu que não existe uma forma nativa de sincronizar sua configuração. Enfrentei esse problema e criei uma solução: claude-config-sync.
O Problema
O Claude Code armazena toda a configuração em ~/.claude/:
- settings.json
- keybindings.json
- CLAUDE.md (suas instruções customizadas)
- Agentes e skills personalizados
- Regras de permissão
Quando você trabalha em múltiplas máquinas, manter isso sincronizado manualmente é tedioso e propenso a erros.
A Solução
O claude-config-sync usa GitHub Gists como backend para sincronizar sua configuração, similar ao VS Code Settings Sync.
Principais Recursos
- 🔄 Sincronização automática via GitHub Gists
- 🔐 Segurança: nunca sincroniza tokens OAuth
- 💾 Backups automáticos antes de sobrescrever
- 🎯 Importação seletiva de configs compartilhadas
- 🚀 Zero configuração com GitHub CLI
Instalação
npm install -g claude-config-sync
Uso Básico
# Primeira máquina
ccs init
ccs push
# Segunda máquina
ccs link <gist-id>
ccs pull
Compartilhando Configurações
Você também pode compartilhar sua configuração publicamente:
ccs share # cria gist público
Outros podem importar seletivamente:
ccs import <gist-url>
Detalhes Técnicos
Construído com:
- Node.js + TypeScript
- API nativa do GitHub Gist (sem dependências pesadas)
- Commander.js para CLI
- Cobertura completa de testes com Vitest
Links
- npm: https://www.npmjs.com/package/claude-config-sync
- GitHub: https://github.com/mariopaglia/claude-config-sync
- Licença: MIT
Contribuindo
O projeto é open-source e contribuições são bem-vindas! Confira o Guia de Contribuição.
Já experimentou? Que funcionalidades você gostaria de ver? Deixe um comentário abaixo! 👇