CLACOROO
EN IT
Scarica

Snapshot

Uno snapshot è un archivio singolo della tua configurazione Claude Code completa come la vede CLACOROO: marketplace, plugin installati, settings.json, file CLAUDE.md, registrazioni di server MCP. Puoi esportare uno snapshot sulla macchina A, copiarlo sulla macchina B, importarlo, e avere un setup identico in pochi secondi.

Gli snapshot sono utili per:

  • Backup prima di modifiche rischiose
  • Migrazione a una nuova macchina
  • Condividere un setup di partenza con un collega
  • Salvare ambienti “preset” (es. lavoro vs personale)

Panoramica

In Impostazioni → Snapshot, trovi due bottoni:

  • Esporta snapshot — salva un file clacoroo-snapshot-YYYYMMDD-HHMM.json (il nome esatto e il formato possono variare per versione)
  • Importa snapshot — apre un file picker, poi ti accompagna in quello che sta per cambiare

Il file snapshot è JSON in chiaro, leggibile e diff-abile se vuoi vedere cosa contiene. Non include segreti: la tua chiave API, i token claude.ai e qualsiasi variabile d’ambiente marcata segreta sono esclusi per design.

Cosa contiene

Uno snapshot cattura le parti dichiarative del tuo setup:

InclusoEscluso
Marketplace (sorgenti)Token OAuth claude.ai
Plugin installati (per id + versione)Chiave API Anthropic (il valore della chiave)
settings.json (modello, tema, lingua, ecc.)Log di sessione live / stats
Registrazioni server MCP (nome, transport, target)Refresh token OAuth dei server MCP
File CLAUDE.md (globale + per-progetto)Modifiche locali dentro ai file dei plugin
Timestamp di export e versione CLACOROO

In pratica, importare uno snapshot equivale a lanciare una serie di claude plugins marketplace add, claude plugins install, claude mcp add e una scrittura atomica di settings.json — ma in un’unica operazione, con feedback di progresso.

Operazioni comuni

Come esportare uno snapshot

  1. Apri Impostazioni → Snapshot
  2. Clicca Esporta snapshot
  3. Scegli una posizione e conferma il nome file
  4. CLACOROO scrive il file; un toast verde conferma il successo
  5. Copia il file dove vuoi (chiavetta USB, cloud drive, email…)

Puoi esportare anche dalla command palette: Cmd / Ctrl + K → “Esporta snapshot”.

Come importare uno snapshot

  1. Apri Impostazioni → Snapshot sulla nuova macchina
  2. Clicca Importa snapshot
  3. Scegli il file .json esportato prima
  4. CLACOROO mostra un preview di cosa verrà aggiunto/cambiato/saltato — leggilo con attenzione
  5. Clicca Applica per importare (o Annulla per uscire)
  6. CLACOROO lancia i comandi claude necessari in sequenza, con una progress bar; i plugin mancanti vengono installati, i marketplace mancanti aggiunti, settings.json aggiornato, i server MCP registrati

Dopo l’import, di solito devi:

  • Fare login a claude.ai (nessun token è stato trasferito) o ri-aggiungere la chiave API
  • Ri-autenticare ogni server MCP che lo richiede (gli snapshot non portano token OAuth)

Come fondere uno snapshot in un setup esistente

Il preview dell’import mostra tre categorie:

  • Aggiungi — elementi nello snapshot ma mancanti su questa macchina
  • Salta — elementi già presenti
  • Conflitto — elementi presenti ma con impostazioni diverse (puoi scegliere se sovrascrivere o mantenere quello corrente)

Toggla i singoli elementi prima di cliccare Applica per scegliere esattamente cosa fondere.

Come condividere uno snapshot con un collega

  1. Esporta il tuo snapshot
  2. Opzionalmente redarguisci qualsiasi cosa specifica del progetto aprendo il JSON in un editor di testo e rimuovendo le voci
  3. Condividi il file
  4. Il tuo collega lo importa con Importa snapshot

Suggerimento. Documenta cosa c’è nel tuo “snapshot di partenza” insieme al file — un breve README che elenca i marketplace inclusi e il razionale rende l’onboarding molto più liscio.

Suggerimenti e scorciatoie

  • Il file snapshot è JSON leggibile — puoi fare diff tra due snapshot per vedere esattamente cosa è cambiato nel tempo
  • Esporta prima di qualsiasi modifica rischiosa (cancellare un marketplace, aggiornare in massa i plugin) — ripristinare da uno snapshot è più veloce che rifare il lavoro
  • Il nome file include un timestamp così puoi tenere una piccola storia di snapshot senza sovrascrivere
  • L’import è non-distruttivo per default: non rimuove nulla che hai e che lo snapshot non menziona (solo aggiunge/aggiorna)
  • La command palette ha sia le voci Esporta che Importa

Casi limite ed errori

  • “Schema mismatch” all’import. Lo snapshot è stato esportato da una versione CLACOROO più nuova di quella in cui stai importando. Aggiorna CLACOROO e riprova.
  • Un plugin nello snapshot fallisce l’install. Il marketplace che lo ospita potrebbe non essere raggiungibile o il plugin potrebbe essere stato rinominato. L’import continua col resto; l’elemento fallito è elencato nel sommario di import.
  • Un server MCP è in “Auth richiesta” dopo l’import. Gli snapshot non portano token OAuth — ri-autentica via sezione Server MCP.
  • settings.json ha sovrascritto un’impostazione che mi importava. Usa i controlli Conflitto nel preview prima di applicare — puoi optare per mantenere il tuo valore corrente per qualsiasi chiave specifica.
  • “File snapshot troppo grande”. Improbabile in uso normale; se lo vedi, lo snapshot ha pescato un CLAUDE.md enorme. Riduci quel file prima di ri-esportare.

Correlati