FAQ

Risposte rapide alle domande più comuni su KoNiMa Claude Sync. Ogni voce si apre con un click.

Prima di iniziare

Cos'è KoNiMa Claude Sync e a cosa serve?

Sincronizza la configurazione di Claude Code (regole, skill, comandi slash, agenti, CLAUDE.md, settings.json), i plugin, i server MCP e, nelle edizioni che le includono, le memorie di progetto, tra tutte le tue macchine e tra i membri di un team. Così hai la stessa configurazione ovunque e una memoria che non resta chiusa su un solo computer. La sincronizzazione passa dal tuo repository git: i dati viaggiano solo tra le tue macchine, non dai server KoNiMa.

Di cosa ho bisogno per usarlo?

• Visual Studio Code 1.90 o successivo, su Windows, macOS o Linux.
• Git e Claude Code installati.
• Un repository git privato e vuoto che fornisci tu (GitHub, GitLab, Gitea, Azure DevOps o qualsiasi server raggiungibile via HTTPS), con un token di accesso personale in lettura e scrittura.
• Una licenza KoNiMa Claude Sync. Senza licenza l’estensione non sincronizza.

I dettagli, compreso quando serve Node.js, sono in Installazione.

Esiste una versione gratuita?

No, ma puoi richiedere una prova gratuita direttamente dall’estensione, dalla card dell’edizione che ti interessa, senza carta di credito.

Edizioni e licenze

Qual è la differenza tra le edizioni Starter, Pro e Team?

Tutte le edizioni usano lo stesso pacchetto: è la licenza a sbloccare le funzioni, e la puoi cambiare senza reinstallare nulla.

• Starter: configurazione e plugin.
• Pro: aggiunge memorie, server MCP, hook, sincronizzazione a ogni sessione e plugin personalizzati.
• Team: aggiunge i due repository del team, i ruoli, i posti gestiti, i codici invito, le proposte e l’audit.

La tabella completa è in Edizioni.

Quante macchine posso usare?

Dipende dalla tua licenza. Quante macchine sono attive e qual è il limite lo vedi nella card Macchine della Panoramica (per esempio 3/10) e alla voce Postazioni delle Impostazioni utente. Per liberare un posto si disattiva una macchina che non usi più.

Devo distribuire il VSIX a ogni aggiornamento?

No. Gli aggiornamenti arrivano dallo store, come per qualsiasi altra estensione di VS Code. Se vuoi provare in anticipo le funzioni in arrivo, nella pagina dell’estensione premi Switch to Pre-Release Version; con Switch to Release Version torni alla versione stabile.

Come attivo una licenza o entro in un team?

Al primo avvio, senza licenza, la dashboard mostra il riquadro Hai una licenza o un invito del team?. Incolla il codice nel campo Incolla il codice di licenza o il codice di invito del team e premi Attiva. Lo stesso campo accetta sia un codice di licenza sia un invito del team (inizia con KNMI-): con un invito si apre la finestra Entra nel team, dove inserisci nome, email e le credenziali del tuo account git. Licenza e repository vengono configurati in un solo passaggio.

Macchine e posti

Cos'è esattamente una "macchina" o "posto"?

Una macchina è un’installazione di VS Code con Claude Sync collegata al tuo repository. Ogni macchina attiva occupa un posto del limite della licenza. Le macchine si vedono nella scheda Macchine, con stato, sistema operativo e ultimo sync.

Posso liberare una macchina se non la uso più?

Sì. Nella scheda Macchine premi Disattiva sulla macchina da liberare: il posto torna disponibile. La scheda segnala anche le macchine ferme da più di 30 giorni. Nell’edizione Team lo può fare il maintainer. Se vuoi liberare la macchina su cui stai lavorando, puoi anche togliere la licenza da lì: vedi Lasciare il team o rimuovere la licenza.

Sicurezza, privacy e dati

I miei dati passano dai server KoNiMa?

No. Configurazione, memorie, plugin e sessioni viaggiano solo tra le tue macchine e il tuo repository git. L’unico servizio KoNiMa contattato è quello delle licenze, per verificare la licenza; quando richiedi una prova viene inviato anche un identificativo anonimo della macchina, che serve solo a evitare richieste ripetute.

Le credenziali dei miei server MCP finiscono nel repository?

Le credenziali (token, chiavi, password) nelle variabili d’ambiente e nelle intestazioni dei server MCP vengono svuotate prima dell’invio: nel repository arriva la definizione del server senza i segreti. Su una nuova macchina le reinserisci una volta sola e le sincronizzazioni successive le lasciano dove sono. Non scrivere segreti nell’URL o negli argomenti di un server MCP.

Dove vengono custodite le credenziali del repository e la licenza?

Nell’archivio protetto di VS Code, cioè nel portachiavi del sistema operativo. Per sincronizzare anche a VS Code chiuso, Claude Sync ne conserva una copia cifrata, utilizzabile solo su questa macchina. Non vengono mai scritte in chiaro e non finiscono mai nel repository.

L'estensione funziona offline?

Sì. Per sincronizzare serve raggiungere il tuo repository, ma le modifiche fatte senza rete partono alla prima sincronizzazione utile e la licenza funziona offline fino a sette giorni dall’ultima verifica riuscita.

Comportamento e sincronizzazione

Due macchine possono sovrascriversi a vicenda?

No. Prima di applicare una modifica arrivata dalle altre macchine, Claude Sync salva una copia di ciò che c’era. Le memorie e le note si uniscono; quando lo stesso file cambia in due punti insieme, la dashboard te lo mostra e decidi tu.

Cosa succede se due macchine aggiornano le memorie dello stesso progetto?

Le memorie vengono unite. I progetti sono riconosciuti dal loro remote git, non dalla cartella: lo stesso progetto clonato in cartelle diverse su macchine diverse viene riconosciuto, e le memorie finiscono nella cartella giusta di ogni macchina.

Come funzionano i ruoli in un team?

Il ruolo non si imposta nell’app: dipende dai permessi del tuo account sul repository CORE.

• Maintainer: può scrivere sul CORE. Cura la configurazione condivisa e i plugin, decide sulle proposte, genera gli inviti, fa la manutenzione dei repository, disattiva le macchine e unisce i progetti.
• Membro: legge il CORE e scrive sul repository MEMORIES. Riceve la configurazione, contribuisce alle memorie e propone modifiche al maintainer. Negli elenchi del team i dati altrui sono nascosti.

Cosa serve perché le memorie si sincronizzino?

Un’edizione che includa le memorie (Pro o Team). Poi, nella scheda Memoria, attiva gli interruttori che ti servono: Sincronizza le memorie claude-mem (database), che richiede il plugin claude-mem e Node.js 23.4 o successivo, e Sincronizza le memorie .md dei progetti (~/.claude/projects). Se la scheda non c’è, la tua edizione non include le memorie.

Che differenza c'è tra i plugin e i plugin personalizzati?

Il dominio Plugin sincronizza l’elenco dei plugin installati dai marketplace: installi una volta e ogni macchina riceve lo stesso plugin. I plugin personalizzati sono invece plugin che il tuo team scrive in proprio: a viaggiare sono i file del plugin, e ogni macchina li installa e li abilita da sola. Sono inclusi in Pro e Team. Vedi Plugin personalizzati.

Sincronizza anche quando VS Code è chiuso?

Sì, con l’interruttore Hook di sessione attivo (edizioni Pro e Team). Configurazione e memorie si allineano da sole all’avvio e alla chiusura di ogni sessione di Claude Code, anche se lavori da terminale con l’editor chiuso. Serve Node.js nel PATH.

Come capisco se Claude Sync sta leggendo la cartella giusta?

Se la cartella di Claude Code manca o è quella sbagliata, Claude Sync non mostra il verde: la barra di stato diventa gialla e la dashboard mostra Da verificare con il banner Cartella Claude non trovata, che indica il percorso cercato. Segui la guida La cartella di Claude per indicare quella giusta.

Sono un membro del team: posso cambiare una skill condivisa?

Sì, sulla tua macchina. La tua versione resta lì e la ritrovi nella scheda Team, riquadro Proposte, fra gli Elementi del team che hai modificato su questa macchina: da lì puoi proporla al maintainer o tornare alla versione del team. Se nel frattempo il team pubblica una nuova versione dello stesso elemento, entra in uso quella del team e la tua resta conservata nella Panoramica, sezione In attesa di una tua decisione, dove puoi confrontarla e tenerla. Vedi Proposte al team.

Posso continuare su un'altra macchina una conversazione con Claude?

Sì, se la tua licenza include la sincronizzazione delle sessioni. Durante la sessione digita /sync-session: quando la chiudi, la conversazione viene cifrata e inviata al tuo repository, e sull’altra macchina la riprendi con claude -r. Viaggiano solo le sessioni che segni tu, e nessun collega le vede. Vedi Sessioni su più macchine.

Perché la Panoramica conta alcune skill «da Claude Code»?

Claude Code scarica alcune skill per conto suo, su ogni macchina, e le aggiorna da solo. Claude Sync le lascia dove sono e non le invia al repository; nella Panoramica le conta a parte, così il primo numero corrisponde alle skill che viaggiano con la sincronizzazione.

Come lascio il team o rimuovo la licenza da una macchina?

Qualsiasi ruolo può togliere la licenza dalla propria macchina: scheda Sistema, card Licenza, pulsante Rimuovi licenza, oppure il comando Claude Sync: Rimuovi licenza. La macchina smette di sincronizzare, il suo posto si libera e Claude Sync ti chiede se togliere dalla macchina gli elementi arrivati dal team. Se accetti, ciò che avevano sostituito torna com’era e tutto ciò che hai creato tu resta. Vedi Lasciare il team o rimuovere la licenza.