Productividad y documentos Guía paso a paso

Sincronizar tu configuración de Claude Code entre ordenadores con Syncthing

Cómo usar Syncthing, un sincronizador libre que conecta tus equipos directamente, para tener los mismos skills, agentes, comandos e instrucciones de Claude Code en el ordenador de la oficina y en el portátil, dejando fuera credenciales, historiales y cachés que no deben viajar.

Nivel
Principiante
Qué necesitas
Dos o más ordenadores con Claude Code (macOS, Windows o Linux) y conexión a internet o a la misma red.
Cuánto lleva
Unos 20 minutos para el primer par de equipos.

Herramientas que usa esta guía

01 El problema: cada equipo tiene su propio Claude

Todo lo que personaliza Claude Code a nivel de usuario vive en la carpeta ~/.claude de cada ordenador: tus instrucciones globales en CLAUDE.md, los skills, los subagentes, los comandos y los estilos de salida. Si creas un skill estupendo en el equipo de la oficina, en el portátil no existe.

Syncthing resuelve esto sin pasar por la nube de nadie. Es un programa libre que se ejecuta en segundo plano en cada equipo y copia los cambios de una carpeta directamente entre tus máquinas, cifrados y sin cuentas ni cuotas. Si un equipo está apagado, se pone al día cuando vuelve a encenderse.

01

Sin servidor intermedio

Los archivos viajan de un equipo a otro. Útil si trabajas con material de clientes que no quieres en servicios de terceros.

02

Gratis y de código abierto

Licencia MPL 2.0, sin límite de espacio ni suscripción.

03

Control fino

Con un archivo .stignore decides exactamente qué se sincroniza y qué se queda en cada máquina.

02 Qué sincronizar y qué no

Sincronizar ~/.claude entero es mala idea. Además de tu configuración, esa carpeta guarda transcripciones de sesiones, instantáneas de archivos, cachés de plugins, tareas y, en Linux y Windows, el archivo .credentials.json con tu sesión iniciada. Mover eso entre equipos provoca conflictos constantes y puede exponer tu acceso.

Elemento ¿Sincronizar? Motivo
CLAUDE.md Sí Tus instrucciones globales, iguales en todos los equipos.
skills/, agents/, commands/, output-styles/ Sí Son archivos de texto que defines tú.
settings.json Con cuidado Puede contener rutas o hooks que solo existen en un equipo.
plugins/ No Mejor reinstalar los plugins en cada máquina con /plugin.
projects/, file-history/, sessions/, tasks/ No Historiales y datos de sesión ligados a rutas locales.
.credentials.json Nunca Es tu sesión iniciada. Inicia sesión con /login en cada equipo.

03 Instalar Syncthing

bash · macOS con Homebrew (queda arrancado como servicio)
brew install syncthing
brew services start syncthing
bash · Debian o Ubuntu (servicio de usuario con systemd)
sudo apt install syncthing
systemctl --user enable syncthing.service
systemctl --user start syncthing.service

En Windows no hay instalador oficial: descarga el zip para Windows desde la web oficial de Syncthing, descomprímelo y ejecuta syncthing.exe. La documentación oficial explica cómo arrancarlo al iniciar sesión con el Programador de tareas y enumera envoltorios gráficos de terceros si prefieres algo más cómodo.

Una vez en marcha, el panel de control se abre en el navegador en http://127.0.0.1:8384. Solo es accesible desde tu propio equipo.

04 Conectar los equipos y compartir la carpeta

  1. 1

    Elige el equipo de referencia

    Empieza por el ordenador que tiene la configuración de Claude Code que quieres conservar.

  2. 2

    Crea el filtro antes de compartir

    Crea el archivo ~/.claude/.stignore con el contenido del bloque siguiente. Así nada sensible se envía ni en la primera sincronización.

  3. 3

    Añade la carpeta

    En el panel, pulsa Add Folder, ponle una etiqueta como «Claude config» y como ruta la carpeta .claude de tu usuario.

  4. 4

    Copia el ID del dispositivo

    En Actions → Show ID verás un código largo. Es el identificador de este equipo.

  5. 5

    Instala en el segundo equipo

    Repite la instalación y, en su panel, pulsa Add Remote Device y pega el ID del primero.

  6. 6

    Acepta en ambos lados

    El primer equipo te pedirá aprobar el nuevo dispositivo. Después comparte con él la carpeta y, en el segundo, acéptala apuntando a su propia carpeta .claude.

  7. 7

    Copia el .stignore también en el segundo

    El archivo .stignore no se sincroniza nunca. Crea el mismo en el segundo equipo para que tampoco envíe de vuelta lo que no debe.

text · ~/.claude/.stignore (lista blanca: solo tu configuración)
// Se sincroniza solo lo que defines tú
!/CLAUDE.md
!/skills
!/agents
!/commands
!/output-styles
// Todo lo demás se queda en cada equipo
*

En Syncthing gana el primer patrón que coincide. Las líneas con ! incluyen esas rutas y el * final ignora todo lo demás, incluidas las credenciales, los historiales y las cachés. Si más adelante quieres añadir settings.json, revisa antes que no tenga rutas absolutas de un solo equipo.

05 Comprobar que funciona y resolver conflictos

  • ✓Ambos equipos muestran la carpeta como «Up to Date» en el panel.
  • ✓Creas un skill de prueba en ~/.claude/skills/ en un equipo y aparece en el otro en unos segundos.
  • ✓En el segundo equipo, Claude Code lista ese skill al escribir / en una sesión nueva.
  • ✓No aparece ningún archivo .credentials.json ni carpeta projects/ entre los archivos sincronizados.
Prompt · Prompt para revisar la sincronización con Claude Code
Revisa mi carpeta ~/.claude y dime: 1) qué skills, agentes y comandos tengo; 2) si hay archivos con «sync-conflict» en el nombre y en qué se diferencian de su original; 3) si mi .stignore deja fuera credenciales, historiales y cachés. No borres nada sin preguntarme.

06 Alternativas y otros usos

Si prefieres historial de cambios, un repositorio Git privado con tus skills y agentes es una alternativa sólida: cada cambio queda registrado y puedes volver atrás. Syncthing gana en comodidad, porque no tienes que acordarte de hacer commit ni pull.

Para un equipo de trabajo, lo más ordenado es otra cosa: guardar skills y agentes dentro de la carpeta .claude del propio proyecto y versionarlos en su repositorio, o empaquetarlos como plugin. Syncthing es ideal para tu configuración personal, no para la de toda la empresa.

La misma técnica sirve para mantener iguales tu bóveda de notas de Obsidian, plantillas de propuestas o carpetas de documentación que uses como contexto con Claude.

Preguntas frecuentes

Solo para que se transmitan los cambios. Si uno está apagado, Syncthing envía lo pendiente en cuanto ambos coinciden conectados.

No es recomendable. Inicia sesión con /login en cada equipo: compartir el archivo de credenciales multiplica el riesgo si uno de los equipos se ve comprometido.

Sí. Syncthing localiza tus dispositivos por internet y, si no pueden conectarse directamente, usa servidores de retransmisión que solo ven datos cifrados.

Con la lista blanca propuesta, no. Es mejor instalarlos en cada equipo con /plugin, porque guardan cachés y versiones que dependen de la máquina.

Funciona igual. Los skills y agentes son archivos de texto, así que solo debes vigilar que no contengan rutas absolutas propias de un sistema.

Sobre el autor

Equipo editorial de appyweb

Marketing, SEO y desarrollo con IA

Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.

Sigue con estas guías

Guía paso a paso · Intermedio

Memoria persistente para Claude Code: Claude-Mem y MemPalace comparados

Claude Code ya trae CLAUDE.md y memoria automática, pero no recuerda el detalle de lo que hiciste hace tres semanas. Te explicamos dos herramientas de código abierto que lo resuelven de formas opuestas: Claude-Mem, que captura y resume todo sola, y MemPalace, que guarda tus conversaciones literales en local y las busca cuando hace falta.

Entre 10 y 20 minutos por herramienta, más el tiempo de indexar tus sesiones antiguas Leer la guía →
Guía paso a paso · Principiante

Skills de Claude Code: globales o por proyecto, y cómo decidir

Instalar todas las skills en tu carpeta personal parece cómodo, pero cada una ocupa espacio en el contexto de todas tus sesiones y compite con las demás. Aprenderás qué ubicaciones existen, una regla sencilla para decidir dónde va cada skill, cómo controlar cuándo se activa y cómo auditar y limpiar las que ya tienes instaladas.

Unos 15 minutos, más la auditoría de tus skills actuales Leer la guía →
Guía paso a paso · Principiante

claude-code-setup: el plugin oficial que analiza tu proyecto y te dice qué automatizar

claude-code-setup es un plugin oficial de Anthropic que revisa tu proyecto y propone las una o dos automatizaciones más útiles en cinco categorías: servidores MCP, skills, hooks, subagentes y comandos. Solo lee, no modifica nada, así que tú decides qué aplicar. Aquí verás cómo instalarlo, cómo pedirle el análisis y cómo poner en marcha sus recomendaciones.

Unos 10 minutos para instalarlo y obtener las primeras recomendaciones Leer la guía →
Guía paso a paso · Principiante

Obsidian y Claude Code: una memoria permanente en Markdown con las obsidian-skills

Claude Code empieza cada sesión sin recordar la anterior. Si trabajas dentro de un vault de Obsidian y le das las obsidian-skills de kepano, Claude lee tus notas, escribe en formato nativo de Obsidian y deja constancia de decisiones y pendientes. Para consultores, equipos pequeños y cualquiera que repita contexto a diario.

Unos 20 minutos para instalar, configurar el CLAUDE.md y hacer la primera sesión. Leer la guía →
Guía paso a paso · Avanzado

Configuración avanzada de Claude Code: skills, subagentes, hooks, MCP y seguridad

Guía para pasar de usar Claude Code tal como viene a un entorno de trabajo serio: instalar la colección de código abierto ECC sin duplicar nada, combinar skills, subagentes y hooks, mantener pocos MCP activos para no saturar el contexto y blindar el agente con reglas de permisos, contenedores y auditorías.

Una tarde para instalar, configurar y probar las piezas principales Leer la guía →

¿Quieres llevar la IA a tu empresa sin pelearte con todo esto?

Diseñamos e implantamos agentes, automatizaciones y asistentes con IA a medida de tu negocio.

Ver nuestros servicios de IA

Cuéntanos tu proyecto. Te respondemos en 48 h.

Auditoría gratuita de IA, campañas, web y SEO, con prioridades y cifras reales de tu negocio.

✓ Sin compromiso ✓ Respuesta en 48 h laborables ✓ Un consultor senior, no un bot
WA WhatsApp