Primo avvio e setup

Hai installato l’estensione: ora la metti in funzione. In pochi minuti attivi la licenza, colleghi il tuo repository git e fai convergere la prima macchina. Tutto avviene dalla dashboard, che al primo avvio si apre da sola.

La vetrina al primo avvio, prima di attivare la licenza: da qui attivi un codice o avvii una prova.

I passi

1. Attiva la licenza (o avvia una prova).

   Senza licenza la dashboard mostra la vetrina delle edizioni. Hai due strade:

   Ho già una licenza

   Nel riquadro Hai già una licenza? incolla il codice nel campo Incolla il codice licenza e premi Attiva. La licenza viene verificata online e attivata.

   Un codice che inizia con KNMI- è invece un invito a un team: apre il flusso Entra nel team (vedi sotto).

   Voglio una prova

   Nella sezione Scegli la tua edizione, dalle card Starter / Pro / Team, avvia la prova self-service. Non serve carta di credito. Per prevenire abusi viene generato un identificativo anonimo della macchina — l’identificativo grezzo non lascia mai il tuo computer.

2. Prepara il repository.

   La sincronizzazione passa dal tuo repository git — nessun remote è preconfigurato. Prima di collegarlo, tieni a portata:

   • un repository privato e vuoto sul tuo host git (GitHub, GitLab, Gitea, Azure DevOps o qualsiasi remote raggiungibile via HTTPS);
   • un token di accesso personale (PAT) con permessi di lettura e scrittura;
   • l’URL del repository.

3. Collega il repository.

   Nel form Collega il tuo repository inserisci l’URL e, per i repository privati, nome utente e token. Premi Connetti: l’estensione verifica che il repository sia raggiungibile e salva le credenziali nel secret store di VS Code — mai in chiaro su disco. A conferma avvenuta compare Connesso e l’invito a ricaricare.

4. Ricarica e sincronizza.

   Premi Ricarica ora (o ricarica la finestra di VS Code): l’engine di sincronizzazione si avvia e la dashboard passa alla modalità operativa. Scegli quali domini sincronizzare e premi Sincronizza ora.

5. Ripeti sulla macchina successiva.

   Installa l’estensione, attiva la stessa licenza, collega lo stesso repository: la seconda macchina converge sulla configurazione della prima.

Entrare in un team con un codice invito

Se hai ricevuto un codice KNMI-…, incollalo nella vetrina e premi Attiva: il modale Entra nel team attiva la licenza del team e configura i repository con le tue credenziali git in un solo passaggio. Inserisci nome, email (per l’attribuzione dei commit), nome utente e token del tuo account git personale.

Edizione Team: due repository

Con l’edizione Team il setup chiede due repository, perché la governance separa la configurazione gestita dalle memorie:

• CORE — la baseline aziendale (regole, skill, comandi, agenti): i maintainer la scrivono, i membri la ricevono in sola lettura;
• MEMORIES — memorie del team, registro dei posti e audit: vi contribuiscono tutti.

Un unico wizard configura entrambi. Dettagli in Edizioni.

Dopo il setup

A engine avviato, la dashboard mostra le schede operative — Panoramica, Sistema Claude, Macchine, Progetti e le altre incluse dalla tua edizione. Lo stato di sincronizzazione è sempre visibile nella barra di stato in basso (Claude Sync) e in cima alla dashboard.

• Cosa sincronizza — i domini e cosa viaggia in ognuno.
• Edizioni — cosa sblocca ciascuna edizione.
• Risoluzione dei problemi — se qualcosa non torna.