Questo articolo riunisce tre temi che diventano rilevanti una volta acquisito il ciclo di base di Git: creare un repository (con git init o dall'IDE), capire la differenza tra rebase e merge e rimuovere correttamente un segreto finito per errore nella cronologia. Tutti e tre tornano utili anche nel lavoro con Claude Code: è lui a eseguire queste operazioni tramite comandi, ed è importante che Lei capisca che cosa c'è dietro.
Gli esempi e le schermate si riferiscono all'IDE JetBrains; i nomi e la posizione delle azioni possono variare a seconda della versione. Per gli esercizi usi un repository di prova separato. Nel progetto di lavoro, segua le regole previste per i branch, i commit e l'invio delle modifiche.
Creare un repository con git init o dall'IDE
Se il progetto è già su GitHub, può clonarlo. Altro caso: ha una cartella locale con del codice. git init crea al suo interno i dati di servizio di Git, ma non il primo commit. L'esempio seguente presuppone che README.md e .gitignore siano già stati creati e controllati; gli altri file necessari si aggiungono separatamente.
git init
git status
# dopo aver controllato README e le regole di ignore
git add README.md .gitignore
git diff --cached
git commit -m "Initial commit"Per un repository locale nell'IDE, usi l'azione che crea un repository Git o abilita il controllo di versione. Share Project on GitHub è un flusso distinto: crea anche un repository remoto e propone di inviare le modifiche. Prima di farlo, controlli i file selezionati, la cronologia e la visibilità.
Public o private
Quando crea un repository, ne sceglie la visibilità:
- public - il repository è visibile a chiunque su Internet e tutti possono consultare il codice. È adatto a un portfolio e ai progetti open source;
- private - l'accesso è riservato a Lei e alle persone invitate. È l'impostazione predefinita per il codice di lavoro o di esercitazione che non deve essere pubblico.
La visibilità non è scolpita nella pietra: può modificarla in seguito nelle impostazioni del repository su GitHub.
Claude Code può eseguire git init e preparare il primo commit per Lei. Se il repository non esiste ancora su GitHub, può crearlo tramite GitHub CLI (gh repo create): a quel punto sceglie Lei se renderlo public o private.
rebase e merge: qual è la differenza
Sia merge sia rebase servono a trasferire il lavoro da un branch a un altro. Lo fanno in modi diversi, e da questo dipende l'aspetto della cronologia del progetto.
merge unisce le cronologie. Se si sono separate, di solito viene creato un merge commit con due genitori. Se il branch corrente è un antenato dell'altro, Git può fare un fast-forward senza creare un nuovo commit. Il diagramma qui sotto mostra proprio due branch divergenti.
merge conserva entrambe le linee e aggiunge un merge commit: dalla cronologia si vede chiaramente che c'era un branch feature separato.
rebase riapplica i Suoi commit come se avesse iniziato a lavorare dall'ultimo commit del branch di destinazione. La cronologia diventa lineare, un'unica sequenza. C'è però un prezzo: rebase riscrive i commit, sostituendo quelli vecchi con altri nuovi e con hash diversi.
Dopo il rebase, i commit C e D sembrano creati sopra E: la cronologia è lineare, ma si tratta di nuovi commit (C2, D2) con hash diversi.
Quale scegliere? In breve:
- merge - quando è importante conservare la cronologia effettiva e il branch è condiviso. È la scelta predefinita più sicura;
- rebase - per riordinare il proprio branch prima di un pull request: una cronologia lineare è più facile da leggere.
Finché prende confidenza con rebase, lo usi sui branch personali non pubblicati. Riscrivere un branch già usato da altre persone è possibile solo seguendo una procedura concordata: altrimenti i colleghi si ritroveranno con la vecchia cronologia. Se non è sicuro delle conseguenze, si fermi e verifichi le regole del progetto.
Il modo di integrare i branch dipende dall'attività e dalle regole del progetto. Non dia per scontato quale opzione sceglierà l'agente: prima dell'esecuzione, gli chieda di indicare il branch di destinazione, l'operazione e le conseguenze sulla cronologia.
Rimuovere i segreti da un repository
Eliminare un file in un nuovo commit non rimuove il segreto dai commit precedenti. Se una password o un token è diventato accessibile ad altri, revochi o sostituisca prima le credenziali presso il servizio che le ha emesse. Ripulire la cronologia non annulla le copie già create.
Non tratti la pulizia della cronologia condivisa come una normale correzione di un file. Cambia gli identificatori dei commit e richiede coordinamento: interrompere l'invio dei branch vecchi, individuare tutti i percorsi interessati, controllare il risultato in una copia separata e concordare con i colleghi come aggiornare le loro copie.
Per questa operazione, GitHub descrive una procedura con git-filter-repo. I comandi precisi dipendono dal fatto che si elimini un intero file o si sostituisca una stringa segreta, dai punti in cui compariva e da dove è stata inviata la cronologia. Segua la guida ufficiale alla rimozione dei dati sensibili, compresi la creazione di una copia nuova, il controllo del risultato, l'aggiornamento dei riferimenti remoti e le operazioni richieste ai colleghi.
La pulizia della copia locale, da sola, non modifica il server. Il push forzato della cronologia riscritta è un'azione separata, da concordare: qui non serve eseguire un comando universale per tutti i branch. Le copie nei cloni e nei fork altrui restano fuori dal Suo controllo; per i riferimenti e le cache ancora accessibili su GitHub valgono le condizioni per contattare GitHub Support indicate nella stessa guida.
Per ridurre il rischio che ricapiti:
- conservi i valori dei segreti fuori dal codice, per esempio nelle variabili d'ambiente;
- aggiunga file locali come
.enva.gitignoreprima che vengano tracciati; - controlli i file selezionati e
git diff --cachedprima del commit; - se per il repository sono disponibili secret scanning e push protection, li attivi come controllo aggiuntivo: non rilevano tutti i segreti possibili.
L'agente può aiutarLa a individuare i percorsi interessati e preparare un piano di pulizia. Non incolli nella chat un segreto ancora valido per farlo cercare. Revochi prima l'accesso, poi concordi come intervenire sulla cronologia.
Come si integra con Claude Code
Tutti e tre i temi tornano quando Claude Code lavora con il repository. Ecco a che cosa fare attenzione:
- può inizializzare un repository (
git init) e preparare il primo commit; su GitHub, al momento della creazione, è Lei a scegliere tra public e private; - propone come integrare i branch seguendo le regole del progetto; prima dell'esecuzione, verifichi le conseguenze di merge e rebase;
- vede quali file entrano nel commit, ma la responsabilità finale di evitare che vi finisca un segreto resta Sua.
Prima del commit, controlli sia l'elenco dei file sia il loro contenuto nel diff. Un segreto può trovarsi in un normale file sorgente, non solo in .env. Se è già finito nella cronologia, sostituisca prima il segreto compromesso e poi valuti se sia necessario ripulirla.
Articolo precedente: Annullare e recuperare le modifiche in Git
GO TO FULL VERSION