FAQ

Risposte rapide alle domande più comuni su KoNiMa Claude Sync. Ogni voce si espande 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), opzionalmente i plugin e i server MCP, e — nelle edizioni che lo includono — la memoria di progetto, tra tutte le tue macchine e tra i membri di un team. L’obiettivo è avere un’unica configurazione coerente e una memoria che non resta intrappolata su un singolo 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 (Windows, macOS o Linux). Il plugin gira nativamente: niente WSL, niente componenti esterni.
• Claude Code installato (la sincronizzazione agisce sulla cartella ~/.claude).
• Un repository git privato e vuoto che fornisci tu (GitHub, GitLab, Gitea, Azure DevOps o qualsiasi remote git) con un token di accesso personale in lettura e scrittura. Nessun remote è preconfigurato.
• Una licenza KoNiMa Claude Sync valida. Senza un codice licenza valido l’estensione è inerte.

Esiste una versione gratuita?

No: non c’è un piano gratuito permanente. È però disponibile una prova self-service per ogni edizione, direttamente dall’estensione, senza carta di credito. La prova si attiva da sola e include un identificativo anonimo della macchina al solo scopo di prevenire abusi.

Edizioni e licenze

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

Tutte le edizioni condividono lo stesso VSIX; è la licenza a sbloccare i domini aggiuntivi, e può essere cambiata senza reinstallare nulla.

• Starter — sincronizzazione di configurazione e plugin. Ideale per chi vuole una copia versionata della propria configurazione di Claude Code.
• Pro — aggiunge le memorie (claude-mem + file .md), i server MCP, gli hook e la scelta della cadenza di sincronizzazione.
• Team — aggiunge la governance a doppio repository CORE/MEMORIES, i ruoli derivati dai permessi git, i posti gestiti, i codici invito e il registro di audit.

Per la tabella completa vedi Edizioni.

Quante macchine posso usare?

Dipende dall’edizione e dalla licenza. Il numero di posti disponibili e quanti ne hai già occupati sono sempre indicati nella dashboard, nella scheda Macchine e nella scheda statistica Macchine della Panoramica ({usate}/{max}). Puoi liberare un posto disattivando una macchina che non usi più.

Devo ridistribuire il VSIX a ogni aggiornamento?

No. L’estensione rileva e installa gli aggiornamenti autonomamente — non serve alcuna azione manuale, né tua né del team.

Come attivo una licenza o entro in un team?

Al primo avvio, senza licenza, la dashboard mostra la vetrina. Incolla il codice nel campo Incolla il codice licenza e premi Attiva. Se il codice inizia con KNMI- è un invito a un team: si apre il modale Entra nel team, dove inserisci nome, email e le credenziali git del tuo account personale per attivare licenza e repository in un solo passaggio.

Macchine e posti

Cos'è esattamente una "macchina" o "posto" (seat)?

Una macchina è un’installazione di VS Code registrata nel tuo repository di sincronizzazione. Ogni macchina attiva occupa un posto rispetto al limite dell’edizione. Le macchine registrate si vedono nella scheda Macchine della dashboard, con stato, sistema operativo e ultimo sync.

Posso liberare una macchina se non la uso più?

Sì. Apri la dashboard, scheda Macchine, e premi Disattiva sulla macchina da rilasciare: il posto viene liberato immediatamente. La dashboard segnala anche le macchine ferme da 30+ giorni, di cui puoi liberare il posto. Il recupero è manuale e deliberato: se reinstalli l’estensione su quella macchina in futuro, occuperà un nuovo posto. Nell’edizione Team questa operazione richiede il ruolo Maintainer. Se la tua macchina viene disattivata, alla sincronizzazione successiva si riattiva da sola.

Sicurezza, privacy e dati

I miei dati passano dai server KoNiMa?

No. La configurazione, le memorie e l’inventario dei plugin viaggiano esclusivamente tra le tue macchine e il tuo repository git. L’unico endpoint KoNiMa che l’estensione contatta è l’API di licenza, e solo per validarla (più, durante la richiesta di una prova, un hash anonimo e monodirezionale della macchina per prevenire abusi).

Le credenziali dei miei server MCP finiscono nel repository?

No. Prima dell’export, tutte le chiavi che corrispondono ai pattern token, secret, key, password, auth, bearer e credential vengono azzerate automaticamente (scrubbing). Nel repository viaggia la struttura del server MCP — URL, nome, argomenti — ma mai i suoi segreti. Dopo il pull su una nuova macchina reinserisci le credenziali una sola volta: finiscono nel secret store di VS Code, mai in chiaro su disco.

Dove vengono custodite le credenziali del repository e la licenza?

Nel secret store di VS Code (il keychain del sistema operativo). Non vengono mai scritte su file né nel canale di log. La licenza validata è inoltre memorizzata cifrata a riposo.

L'estensione funziona offline?

Sì. La sincronizzazione vera e propria richiede l’accesso al tuo repository git, ma la licenza funziona offline entro un periodo di tolleranza dall’ultima validazione riuscita. I push falliti per assenza di rete vengono accodati localmente e ritentati automaticamente. Durante il normale utilizzo l’estensione non contatta i server KoNiMa.

Comportamento e sincronizzazione

Due macchine possono sovrascriversi a vicenda?

No. Non esiste force-push. Un pull non cancella mai il lavoro locale: viene fatta una riconciliazione a 3 vie rispetto a una baseline per-macchina, e prima di applicare qualsiasi cosa viene salvato uno snapshot di backup. Quando le macchine divergono, lo strumento unisce in modo additivo ciò che può (memorie e file accumulativi) e segnala il resto nella dashboard per una decisione umana. Nulla viene sovrascritto in silenzio.

Cosa succede se due macchine modificano le stesse memorie in contemporanea?

Le memorie vengono fuse e deduplicate al momento del push. Quando le modifiche sono incompatibili, il conflitto viene mostrato nella dashboard per una decisione umana. I progetti sono identificati dal loro remote git, non dal percorso locale: lo stesso progetto clonato in cartelle diverse su macchine diverse viene comunque riconosciuto e le memorie vengono rimappate sulla cartella corretta.

Come funzionano i ruoli in un team?

Il ruolo non si configura nell’app: coincide con i permessi del tuo account sul repository git.

• Maintainer — scrive il CORE: gestisce la baseline aziendale, i plugin, gli inviti e la manutenzione dei repository, può disattivare le macchine e unire i progetti.
• Membro — sola lettura sul CORE, scrive sul repository MEMORIES: riceve la configurazione e contribuisce alle memorie. Nelle viste roster i dati altrui sono mascherati.
• Visualizzatore — vista in sola lettura.

Cosa serve perché le memorie si sincronizzino?

Le memorie sono incluse dalle edizioni Pro e Team. Serve inoltre che claude-mem sia installato (per il database) e che gli interruttori delle sorgenti — Sincronizza le memorie claude-mem e Sincronizza le memorie .md dei progetti — siano attivi nella scheda Memoria. Se la scheda non è presente, la tua edizione non include le memorie.