Quando si cambia computer, la prima cosa che si nota con Claude Code è che le conversazioni precedenti non ci sono più.
Non è un bug: le chat di Claude Code non sono salvate nel cloud, ma in file locali dentro il profilo utente.
La buona notizia è che per spostarle basta copiare una cartella.
Quella meno buona è che c’è un dettaglio sui percorsi che, se ignorato, rende le chat invisibili sul nuovo PC.
In questa guida vediamo dove si trovano i file, cosa copiare, come gestire il cambio di percorso e, alla fine, uno script PowerShell che fa tutto in automatico.
DOVE SI TROVANO I FILE DI CLAUDE
Claude Code salva tutto in una cartella nascosta nel profilo utente:
Windows: %USERPROFILE%\.claude\
macOS/Linux: ~/.claude/
Al suo interno c’è la cartella projects\, che contiene una sottocartella per ogni progetto.
Ogni chat è un file .jsonl dentro la sottocartella del progetto a cui appartiene.
Il nome della sottocartella non è casuale: è il percorso assoluto del progetto, con i separatori (e in generale tutti i caratteri non alfanumerici) sostituiti da trattini.
Ad esempio:
C:\Users\raf\Progetti\piva-manager
diventa:
C–Users-raf-Progetti-piva-manager
COSA COPIARE SUL NUOVO PC
Per una migrazione completa servono due elementi.
1. La cartella .claude\, che contiene:
projects\: le chat
settings.json: permessi e impostazioni
CLAUDE.md: le istruzioni globali
commands\, agents\ e skills\: se ne hai creati
2. Il file .claude.json, che si trova nella cartella utente accanto a .claude\, non dentro. Contiene la configurazione dei server MCP e le impostazioni dei singoli progetti. È facile dimenticarlo.
ATTENZIONE: non copiare le credenziali. Sul nuovo PC avvia claude e rifai l’accesso con /login.
IL PUNTO CRITICO: I PERCORSI
Claude Code associa le chat a un progetto tramite il suo percorso assoluto. Quando lanci claude –resume dentro una cartella, Claude Code calcola il nome codificato di quella cartella e cerca le chat nella sottocartella corrispondente di projects\.
Ci sono quindi due scenari.
Il percorso resta uguale
Stesso nome utente, stessa struttura di cartelle: copi .claude\ e .claude.json e funziona tutto senza fare altro.
Il percorso cambia
È il caso tipico quando sul nuovo PC il nome utente è diverso, ad esempio da C:\Users\raf\… a C:\Users\rchiatto\…, oppure quando sposti i progetti su un altro disco.
In questo caso devi rinominare ogni sottocartella dentro projects\ in base al nuovo percorso:
C–Users-raf-Progetti-app-manager -> C–Users-rchiatto-Progetti-app-manager
Se non lo fai, claude –resume non trova le chat di quel progetto, anche se i file sono lì.
Inoltre i percorsi assoluti compaiono anche dentro i file: nelle chat .jsonl, in .claude.json (dove le impostazioni sono indicizzate per percorso di progetto) e a volte nei permessi di settings.json. Per una migrazione pulita conviene aggiornarli tutti.
CONSIGLIO: il modo più semplice per evitare problemi è usare sul nuovo PC lo stesso nome utente e la stessa struttura di cartelle per i progetti.
Prima di copiare: la pulizia automatica delle sessioni
Di default Claude Code cancella le sessioni più vecchie di 30 giorni. Se vuoi conservarle più a lungo, aggiungi questa riga in settings.json:
|
0
1
|
json
{ "cleanupPeriodDays": 365 }
|
Conviene farlo subito sul vecchio PC, prima della migrazione, così nel frattempo non perdi altre chat.
Riaprire le chat sul nuovo PC
Dopo aver copiato i file, entra nella cartella del progetto e lancia:
claude –resume: per scegliere una chat dall’elenco
claude –continue: per riprendere l’ultima chat
SCRIPT POWERSHELL
Fare tutto a mano va bene con due o tre progetti.
Con molti progetti, o con un cambio di nome utente, rinominare le cartelle e correggere i percorsi nei file diventa lungo e facile da sbagliare.
Per questo ho preparato uno script PowerShell che lavora in due fasi.
Cosa fa in modalità Esporta (vecchio PC)
- Imposta cleanupPeriodDays a 365 in settings.json (configurabile).
- Copia .claude\ escludendo il file delle credenziali e copia .claude.json.
- Salva in un manifest.json il percorso del profilo utente di origine.
- Crea un archivio .zip pronto da trasferire.
Cosa fa in modalità Importa (nuovo PC)
- Estrae l’archivio in una cartella temporanea.
- Rinomina le sottocartelle di projects\ dal vecchio al nuovo percorso.
- Aggiorna i percorsi dentro le chat .jsonl, .claude.json e settings.json.
- Fa un backup della configurazione già presente (.claude.backup-<data> e .claude.json.backup-<data>).
- Unisce i file nel profilo utente: se hai già fatto il login sul nuovo PC, resta valido.
- Imposta cleanupPeriodDays anche sul nuovo PC.
Come si usa
Sul vecchio PC:
Da una powershell con diritti amministrativi eseguire il comando:
|
0 |
.\Migra-ClaudeCode.ps1 -Modalita Esporta -Archivio D:\claude-backup.zip
|
Copia lo zip sul nuovo PC e lancia:
|
0 |
.\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip
|
Il cambio di profilo utente (ad esempio da C:\Users\raf a C:\Users\rchiatto) viene rilevato in automatico.
Se alcuni progetti stavano fuori dal profilo, o li hai spostati, aggiungi una mappatura vecchio → nuovo percorso con il comando:
|
0 |
.\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip -MappaPercorsi @{ 'D:\Progetti' = 'C:\Dev' }
|
Parametri Disponibili
- Modalita: Esporta oppure Importa
- Archivio: Percorso dello zip da creare o da leggere
- MappaPercorsi: Mappature aggiuntive vecchio → nuovo percorso (solo Importa)
- VecchioProfilo: Forza il profilo di origine invece di leggerlo dal manifest (solo Importa)
- NonAggiornareContenuti: Rinomina solo le cartelle, senza modificare i percorsi nei file (solo Importa)
- GiorniConservazione: Valore di cleanupPeriodDays (default 365, 0 per non modificarlo)
Note Pratiche
Chiudi tutte le sessioni di Claude Code prima di lanciare lo script. Se ne trova una aperta, ti chiede conferma.
Se Windows blocca l’esecuzione degli script, avvialo così:
|
0 |
powershell -ExecutionPolicy Bypass -File .\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip
|
Al termine, avvia claude e fai /login, poi entra nella cartella del progetto e lancia claude –resume.
Lo script è compatibile con Windows PowerShell 5.1 e con PowerShell 7.
CONCLUSIONI
Spostare le chat di Claude Code su un nuovo PC è semplice se si ricordano tre cose: copiare sia .claude\ sia .claude.json, rifare il login invece di copiare le credenziali e, se il percorso dei progetti cambia, rinominare le cartelle in projects\.
Lo script qui sotto si occupa di tutti e tre i punti e fa un backup prima di toccare qualsiasi cosa.
SCRIPT
Salva il codice seguente come Migra-ClaudeCode.ps1.
|
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
|
<#
.SYNOPSIS
Migra chat, impostazioni e configurazione di Claude Code da un PC Windows a un altro.
.DESCRIPTION
Modalita Esporta (vecchio PC):
- copia %USERPROFILE%\.claude\ (escluse le credenziali) e %USERPROFILE%\.claude.json
- salva il percorso del profilo di origine in un manifest
- crea un archivio .zip
Modalita Importa (nuovo PC):
- estrae l'archivio in una cartella temporanea
- rinomina le sottocartelle di projects\ in base al nuovo percorso
- aggiorna i percorsi dentro i file .jsonl, .claude.json e settings.json
- fa un backup di quanto gia presente e poi unisce i file in %USERPROFILE%
- imposta cleanupPeriodDays in settings.json
.PARAMETER Modalita
Esporta oppure Importa.
.PARAMETER Archivio
Percorso del file .zip da creare (Esporta) o da leggere (Importa).
.PARAMETER MappaPercorsi
Solo Importa. Mappature aggiuntive vecchio -> nuovo percorso, per progetti che stavano
fuori dal profilo utente o che hai spostato. Es: @{ 'D:\Progetti' = 'C:\Dev' }
Il cambio del profilo utente (C:\Users\vecchio -> C:\Users\nuovo) e' gia gestito in automatico.
.PARAMETER VecchioProfilo
Solo Importa. Forza il percorso del profilo di origine (di default lo legge dal manifest).
.PARAMETER NonAggiornareContenuti
Solo Importa. Rinomina solo le cartelle, senza modificare i percorsi dentro i file.
.PARAMETER GiorniConservazione
Valore di cleanupPeriodDays da scrivere in settings.json (0 = non toccare). Default 365.
In Esporta viene applicato anche sul vecchio PC, cosi le chat non vengono cancellate nel frattempo.
.EXAMPLE
# Sul vecchio PC
.\Migra-ClaudeCode.ps1 -Modalita Esporta -Archivio D:\claude-backup.zip
.EXAMPLE
# Sul nuovo PC
.\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip
.EXAMPLE
# Sul nuovo PC, con progetti spostati da D:\Progetti a C:\Dev
.\Migra-ClaudeCode.ps1 -Modalita Importa -Archivio D:\claude-backup.zip -MappaPercorsi @{ 'D:\Progetti' = 'C:\Dev' }
#>
[CmdletBinding()]
param(
[Parameter(Mandatory)][ValidateSet('Esporta', 'Importa')][string]$Modalita,
[Parameter(Mandatory)][string]$Archivio,
[hashtable]$MappaPercorsi = @{},
[string]$VecchioProfilo,
[switch]$NonAggiornareContenuti,
[int]$GiorniConservazione = 365
)
$ErrorActionPreference = 'Stop'
Add-Type -AssemblyName System.IO.Compression.FileSystem
$Utf8NoBom = New-Object System.Text.UTF8Encoding($false)
$Profilo = $env:USERPROFILE
$DirClaude = Join-Path $Profilo '.claude'
$FileClaudeJs = Join-Path $Profilo '.claude.json'
$Archivio = [IO.Path]::GetFullPath($Archivio)
# --- Funzioni ---------------------------------------------------------------
function Get-NomeCartellaProgetto([string]$Percorso) {
# Claude Code sostituisce ogni carattere non alfanumerico con '-'
return ($Percorso.TrimEnd('\', '/') -replace '[^a-zA-Z0-9]', '-')
}
function Invoke-Robocopy([string]$Da, [string]$A, [string[]]$Extra = @()) {
$arg = @($Da, $A, '/E', '/R:1', '/W:1', '/NFL', '/NDL', '/NJH', '/NJS', '/NP') + $Extra
& robocopy @arg | Out-Null
if ($LASTEXITCODE -ge 8) { throw "robocopy fallito ($LASTEXITCODE): $Da -> $A" }
}
function Set-Conservazione([string]$Cartella, [int]$Giorni) {
if ($Giorni -le 0) { return }
if (-not (Test-Path $Cartella)) { New-Item -ItemType Directory -Path $Cartella | Out-Null }
$file = Join-Path $Cartella 'settings.json'
if (Test-Path $file) {
$cfg = Get-Content $file -Raw -Encoding UTF8 | ConvertFrom-Json
if ($null -eq $cfg) { $cfg = New-Object PSObject }
} else {
$cfg = New-Object PSObject
}
$attuale = $cfg.cleanupPeriodDays
if ($null -eq $attuale -or [int]$attuale -lt $Giorni) {
$cfg | Add-Member -NotePropertyName cleanupPeriodDays -NotePropertyValue $Giorni -Force
[IO.File]::WriteAllText($file, ($cfg | ConvertTo-Json -Depth 50), $Utf8NoBom)
Write-Host " cleanupPeriodDays impostato a $Giorni in $file"
} else {
Write-Host " cleanupPeriodDays gia a $attuale, non modificato"
}
}
function Update-PercorsiNelTesto([string]$File, $Mappe) {
$testo = [IO.File]::ReadAllText($File, [Text.Encoding]::UTF8)
$orig = $testo
foreach ($m in $Mappe) {
# Forma JSON con backslash raddoppiati (C:\\Users\\raf) e forma con slash (C:/Users/raf)
$forme = @(
@{ Da = $m.Vecchio.Replace('\', '\\'); A = $m.Nuovo.Replace('\', '\\') },
@{ Da = $m.Vecchio.Replace('\', '/'); A = $m.Nuovo.Replace('\', '/') }
)
foreach ($f in $forme) {
$pattern = [regex]::Escape($f.Da) + '(?![A-Za-z0-9_.\-])'
$testo = [regex]::Replace($testo, $pattern, $f.A.Replace('$', '$$'), 'IgnoreCase')
}
}
if ($testo -cne $orig) {
[IO.File]::WriteAllText($File, $testo, $Utf8NoBom)
return $true
}
return $false
}
# --- Controllo preliminare --------------------------------------------------
if (Get-Process -Name 'claude' -ErrorAction SilentlyContinue) {
Write-Warning 'Claude Code risulta in esecuzione. Chiudi tutte le sessioni prima di continuare.'
if ((Read-Host 'Continuare comunque? (s/N)') -ne 's') { return }
}
$Temp = Join-Path $env:TEMP ('claude-migrazione-' + [guid]::NewGuid().ToString('N').Substring(0, 8))
New-Item -ItemType Directory -Path $Temp | Out-Null
try {
# =======================================================================
if ($Modalita -eq 'Esporta') {
# =======================================================================
if (-not (Test-Path $DirClaude)) { throw "Cartella non trovata: $DirClaude" }
Write-Host '1/4 Impostazione conservazione chat sul PC attuale...'
Set-Conservazione -Cartella $DirClaude -Giorni $GiorniConservazione
Write-Host '2/4 Copia di .claude (senza credenziali)...'
Invoke-Robocopy $DirClaude (Join-Path $Temp '.claude') @('/XF', '.credentials.json')
if (Test-Path $FileClaudeJs) { Copy-Item $FileClaudeJs (Join-Path $Temp '.claude.json') }
else { Write-Warning ".claude.json non trovato in $Profilo" }
Write-Host '3/4 Scrittura manifest...'
@{
ProfiloOrigine = $Profilo
Computer = $env:COMPUTERNAME
Utente = $env:USERNAME
Data = (Get-Date).ToString('s')
} | ConvertTo-Json | Set-Content (Join-Path $Temp 'manifest.json') -Encoding UTF8
Write-Host '4/4 Creazione archivio...'
if (Test-Path $Archivio) { Remove-Item $Archivio -Force }
$dirArchivio = Split-Path $Archivio -Parent
if (-not (Test-Path $dirArchivio)) { New-Item -ItemType Directory -Path $dirArchivio | Out-Null }
[IO.Compression.ZipFile]::CreateFromDirectory($Temp, $Archivio)
$nChat = @(Get-ChildItem (Join-Path $Temp '.claude\projects') -Recurse -Filter *.jsonl -ErrorAction SilentlyContinue).Count
$mb = [math]::Round((Get-Item $Archivio).Length / 1MB, 1)
Write-Host ''
Write-Host "Fatto. Archivio: $Archivio ($mb MB, $nChat chat)." -ForegroundColor Green
Write-Host 'Copialo sul nuovo PC e lancia lo script in modalita Importa.'
}
# =======================================================================
else {
# =======================================================================
if (-not (Test-Path $Archivio)) { throw "Archivio non trovato: $Archivio" }
Write-Host '1/6 Estrazione archivio...'
[IO.Compression.ZipFile]::ExtractToDirectory($Archivio, $Temp)
$TmpClaude = Join-Path $Temp '.claude'
$TmpClaudeJs = Join-Path $Temp '.claude.json'
$TmpProjects = Join-Path $TmpClaude 'projects'
if (-not $VecchioProfilo) {
$man = Join-Path $Temp 'manifest.json'
if (-not (Test-Path $man)) { throw 'manifest.json mancante: specifica -VecchioProfilo' }
$VecchioProfilo = (Get-Content $man -Raw | ConvertFrom-Json).ProfiloOrigine
}
Write-Host " Profilo origine: $VecchioProfilo"
Write-Host " Profilo destinazione: $Profilo"
# Mappature, dalla piu specifica alla piu generica
$Mappe = @()
foreach ($k in $MappaPercorsi.Keys) {
$Mappe += [pscustomobject]@{ Vecchio = $k.TrimEnd('\'); Nuovo = ([string]$MappaPercorsi[$k]).TrimEnd('\') }
}
if ($VecchioProfilo.TrimEnd('\') -ne $Profilo.TrimEnd('\')) {
$Mappe += [pscustomobject]@{ Vecchio = $VecchioProfilo.TrimEnd('\'); Nuovo = $Profilo.TrimEnd('\') }
}
$Mappe = @($Mappe | Sort-Object { $_.Vecchio.Length } -Descending)
foreach ($m in $Mappe) { Write-Host " Mappa: $($m.Vecchio) -> $($m.Nuovo)" }
Write-Host '2/6 Rinomina cartelle dei progetti...'
$rinominate = 0
if ($Mappe.Count -gt 0 -and (Test-Path $TmpProjects)) {
foreach ($dir in Get-ChildItem $TmpProjects -Directory) {
$nome = $dir.Name
$nuovoNome = $null
foreach ($m in $Mappe) {
$prefOld = Get-NomeCartellaProgetto $m.Vecchio
if ($nome.StartsWith($prefOld, [StringComparison]::OrdinalIgnoreCase) -and
($nome.Length -eq $prefOld.Length -or $nome[$prefOld.Length] -eq '-')) {
$nuovoNome = (Get-NomeCartellaProgetto $m.Nuovo) + $nome.Substring($prefOld.Length)
break
}
}
if (-not $nuovoNome -or $nuovoNome -ceq $nome) { continue }
$dest = Join-Path $TmpProjects $nuovoNome
if ($nuovoNome -eq $nome) {
# Cambia solo maiuscole/minuscole: passaggio tramite nome temporaneo
$tmpName = $nome + '__tmp'
Rename-Item $dir.FullName $tmpName
Rename-Item (Join-Path $TmpProjects $tmpName) $nuovoNome
} elseif (Test-Path $dest) {
Invoke-Robocopy $dir.FullName $dest @('/MOVE')
if (Test-Path $dir.FullName) { Remove-Item $dir.FullName -Recurse -Force }
} else {
Rename-Item $dir.FullName $nuovoNome
}
Write-Host " $nome -> $nuovoNome"
$rinominate++
}
}
Write-Host " Cartelle rinominate: $rinominate"
Write-Host '3/6 Aggiornamento percorsi nei file...'
$aggiornati = 0
if ($Mappe.Count -gt 0 -and -not $NonAggiornareContenuti) {
$file = @()
if (Test-Path $TmpProjects) { $file += Get-ChildItem $TmpProjects -Recurse -File -Filter *.jsonl }
if (Test-Path $TmpClaudeJs) { $file += Get-Item $TmpClaudeJs }
$settings = Join-Path $TmpClaude 'settings.json'
if (Test-Path $settings) { $file += Get-Item $settings }
$i = 0
foreach ($f in $file) {
$i++
Write-Progress -Activity 'Aggiornamento percorsi' -Status $f.Name -PercentComplete (100 * $i / $file.Count)
if (Update-PercorsiNelTesto $f.FullName $Mappe) { $aggiornati++ }
}
Write-Progress -Activity 'Aggiornamento percorsi' -Completed
}
Write-Host " File modificati: $aggiornati"
Write-Host '4/6 Backup della configurazione esistente...'
$stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
if (Test-Path $DirClaude) {
$bk = "$DirClaude.backup-$stamp"
Invoke-Robocopy $DirClaude $bk
Write-Host " $bk"
}
if (Test-Path $FileClaudeJs) {
Copy-Item $FileClaudeJs "$FileClaudeJs.backup-$stamp"
Write-Host " $FileClaudeJs.backup-$stamp"
}
Write-Host '5/6 Copia nel profilo utente...'
Invoke-Robocopy $TmpClaude $DirClaude # unione: le credenziali gia presenti restano
if (Test-Path $TmpClaudeJs) { Copy-Item $TmpClaudeJs $FileClaudeJs -Force }
Write-Host '6/6 Impostazione conservazione chat...'
Set-Conservazione -Cartella $DirClaude -Giorni $GiorniConservazione
Write-Host ''
Write-Host 'Importazione completata.' -ForegroundColor Green
Write-Host 'Prossimi passi:'
Write-Host ' 1. claude e poi /login (le credenziali non vengono migrate)'
Write-Host ' 2. cd nella cartella del progetto, poi claude --resume'
Write-Host ''
Write-Host 'Cartelle progetto presenti ora:'
Get-ChildItem (Join-Path $DirClaude 'projects') -Directory -ErrorAction SilentlyContinue |
ForEach-Object { Write-Host " $($_.Name)" }
}
}
finally {
Remove-Item $Temp -Recurse -Force -ErrorAction SilentlyContinue
}
|
0 Commenti