Configurare il collegamento FTP del sito parlando con l'AI

Questa pagina documenta come ho collegato la cartella del sito in locale al server tramite FTP, per poter caricare i file modificati senza passare da un client FTP separato ogni volta. La configurazione è stata fatta interamente in conversazione con Claude Code, dentro Visual Studio Code.

Gli strumenti

Sistema operativo: Windows.
Editor: Visual Studio Code, con l'estensione Claude Code come hub di editing e per l'esecuzione dei comandi.
Connessione FTP: l'estensione SFTP per Visual Studio Code, installata direttamente da riga di comando.
Hosting: hosting condiviso con accesso FTP.

Cosa abbiamo configurato

Installazione dell'estensione. L'estensione SFTP è stata scaricata e installata su Visual Studio Code.
Creazione del file di configurazione. Ho fornito le credenziali dell'account FTP (host, utente, password, protocollo, percorso remoto), ed è stato creato il file .vscode/sftp.json con questi dati.
Verifica con un caricamento di prova. Prima di fidarsi della configurazione, abbiamo creato un piccolo file di test, caricato sul server, controllato che fosse arrivato correttamente e poi rimosso.

Un dettaglio importante: l'upload automatico al salvataggio non è stato attivato. La configurazione lo prevede come opzione, ma è stata lasciata disattivata di proposito: ogni caricamento sul server resta quindi un passaggio scelto di volta in volta, non qualcosa che parte da solo appena si salva un file.

Due errori reali, diagnosticati in conversazione

Il primo tentativo di caricamento è fallito con un errore di accesso negato: la password fornita inizialmente non era quella corretta. Corretta la credenziale, il caricamento è ripartito, ma si è fermato su un secondo errore: il percorso remoto indicato non esisteva.

Invece di procedere per tentativi, la causa è stata trovata elencando il contenuto della cartella principale del server: l'hosting ospita più siti sotto la stessa utenza FTP, ognuno nella propria sottocartella, e il percorso corretto per questo sito non era quello inizialmente indicato. Una volta corretto il percorso nella configurazione, il caricamento di prova è andato a buon fine.

Perché vale la pena segnalarlo

Diagnosticare un errore di connessione FTP, o capire come un hosting condiviso organizza più siti sotto lo stesso accesso, richiede una conoscenza specifica del protocollo e delle convenzioni dei pannelli di hosting: un ambito distinto dalle competenze di sviluppo front-end in senso stretto. In questo caso quella parte è stata gestita descrivendo in linguaggio naturale cosa succedeva ("il caricamento fallisce con questo errore"), lasciando che fosse l'AI a controllare direttamente lo stato del server e a proporre la correzione, invece di dover studiare la documentazione del protocollo FTP o del pannello di hosting.

Il risultato è una configurazione funzionante e verificata, con il caricamento sul server che resta comunque un'azione deliberata: quando servirà attivare un flusso più automatico, la base per farlo è già pronta.