Guida alla configurazione iniziale dell'app desktop Claude Code

Stai inizi a usare Claude Code subito dopo l'installazione? Onestamente, è rischioso.

Claude Code è un'IA che legge e scrive file, esegue comandi, riscrive codice e può persino creare Pull Request. In altre parole, non è solo un interlocutore; è un'entità che compie azioni reali sul tuo computer.

Iniziare senza controllare le impostazioni è come dire a un nuovo assunto: "Non ci sono regole specifiche, fai pure quello che vuoi". Più il collaboratore è capace, più avanzerà in base al proprio giudizio in assenza di regole. L'IA è uguale.

Personalmente ho aperto tutte le schermate delle impostazioni dell'app desktop di Claude Code e le ho verificate una per una. C'è una netta distinzione tra le impostazioni che devi assolutamente controllare e quelle che non devi toccare all'inizio.

Leggendo questo articolo, saprai dove guardare nelle impostazioni dell'app desktop di Claude Code, quali impostazioni modificare e quali ignorare.

Il menu delle impostazioni dell'app desktop di Claude Code ha molte voci: Generali, Notifiche, Personalizzazione, App, Pianificazione, Fatturazione, Controllo dati, Archiviazione, Sicurezza, Controllo genitori e Account. Più sotto ci sono Privacy, Utilizzo, Funzionalità, Connettori, Claude Code, Cowork e Claude in Chrome. Ancora più in basso, nella sezione "App desktop", ci sono Generali, Estensioni e Sviluppatore.

Onestamente, sono tante. Ma ci sono solo quattro punti da guardare inizialmente.

1. App desktop "Generali"
2. "Privacy"
3. "Claude Code"
4. Modalità autorizzazione e CLAUDE.md all'inizio di una sessione

Il resto non devi toccarlo all'inizio.

1. App Desktop "Generali": Costruire le basi per un uso sicuro

Scorri il menu a sinistra fino alla sezione "App desktop" e apri "Generali". Questa è la base per usare Claude Code in sicurezza.

Avvio all'accensione

Determina se Claude Code si avvia automaticamente quando accedi. Tienilo spento per ora. Puoi attivarlo quando inizierai a usarlo quotidianamente.

Scorciatoia di accesso rapido

Una scorciatoia per inviare messaggi a Claude da qualsiasi punto. Il valore predefinito è "Doppio tocco su Opzione". Verifica se è in conflitto con altre app.

Scorciatoia vocale

Una scorciatoia per parlare con Claude. Il valore predefinito è "Nessuno". L'input vocale è molto utile per dare istruzioni dettagliate come:

• "Controlla questo contenuto, ma non apportare ancora modifiche."
• "Mostrami sempre il diff prima di cambiare qualsiasi cosa."
• "Trova solo la causa di questo errore. Nessuna correzione per ora." Claude Code può esagerare se le istruzioni sono vaghe. Poter dare istruzioni frequenti con la voce è più sicuro.

Barra dei menu

Se mostrare Claude nella barra dei menu. Lasciarlo attivo va bene.

Impedisci il sonno del computer

È sorprendentemente importante. Se il PC va in sospensione mentre Claude esegue un'operazione lunga, il lavoro si ferma. Se lo lasci gestire attività che richiedono tempo come revisioni multi-file o riscrittura del codice, lascialo attivo. È attivo per impostazione predefinita.

Uso del browser

Da qui in poi sono impostazioni relative ai permessi. Fai attenzione. Attivare "Consenti tutte le azioni del browser" permette a Claude di navigare e operare su qualsiasi sito web in Chrome senza conferma. La schermata delle impostazioni avverte che questo potrebbe mettere a rischio i dati. Ti consiglio di tenerlo spento inizialmente. Se lo attivi, chiudi le schede non necessarie e presta particolare attenzione alle pagine che mostrano email, pagamenti o informazioni sui clienti.

Uso del computer (Beta)

Questo è fondamentale. Quando è attivo, Claude può fare screenshot e utilizzare la tastiera e il mouse nelle app autorizzate. È spento per impostazione predefinita. Tienilo spento per ora. Se lo attivi, macOS richiede i permessi di "Accessibilità" e "Registrazione schermo".

App negate

Registra le app a cui non vuoi che Claude acceda. Se usi Uso del computer, aggiungi qui mailer, gestori di password e strumenti interni riservati.

2. Privacy: Controllo della gestione dei dati

Metadati di posizione

Consente a Claude di utilizzare dati di posizione approssimativi per migliorare l'esperienza. È facoltativo.

Aiuta a migliorare Claude

Consente di utilizzare i tuoi dati di chat e codice per addestrare i modelli di Anthropic. Se gestisci codice cliente o progetti riservati, è più sicuro disattivarlo. È disattivato per impostazione predefinita, ma ricontrolla.

3. Claude Code: Decidere il comportamento di sessione e PR

Classificazione stato sessione

Consente a Claude di classificare automaticamente le sessioni come bloccate, in attesa di revisione o completate. Tienilo attivo per tenere traccia di più sessioni parallele.

Consenti modalità di bypass permessi

Attenzione: bypassa tutti i controlli dei permessi. È ad alto rischio e può portare alla perdita di dati o danni al sistema. Tienilo spento. Non usarlo al di fuori di sandbox o macchine virtuali.

Posizione Worktree

L'app desktop isola automaticamente una copia di lavoro in un worktree Git per ogni nuova sessione. Questo impedisce che le modifiche della Sessione A influenzino la Sessione B. Il valore predefinito è "All'interno del progetto (.claude/w...)".

Fondamentalmente, ricorda .worktreeinclude. I file ignorati da git (come .env) non vengono copiati automaticamente nei worktree. Se ricevi errori su variabili d'ambiente mancanti, crea un file .worktreeinclude nella root del progetto e specifica i file da copiare.

Automazione Pull Request

Ci sono impostazioni per creare automaticamente PR e correggere automaticamente gli errori CI. Tienile spente inizialmente. È più sicuro controllare prima il contenuto della PR da soli.

Archiviazione automatica dopo unione/chiusura PR

Consiglio di attivarlo. Impedisce che le sessioni terminate ingombrino la barra laterale.

4. Modalità Autorizzazione e CLAUDE.md: Controlla ogni sessione

Modalità autorizzazione

Selezionala accanto al pulsante di invio all'inizio di una sessione. Determina quanto Claude può fare autonomamente.

• Chiedi autorizzazioni: Conferma ogni modifica di file e comando. Ideale per i principianti per capire come funziona Claude.
• Accetta automaticamente modifiche: Accetta automatiche:** Accetta automaticamente le modifiche ai file e le operazioni di base. Accelera il lavoro una volta che ti fidi del giudizio di Claude.
• Modalità pianificazione: Legge file ed esegue comandi per indagare, ma non modifica il codice. Usala per ottenere prima un piano, poi passa a "Accetta automaticamente modifiche automatiche".
• Auto: Quasi completamente automatico. Solo per piani Max/Team/Enterprise/API. Non iniziare con questa; Claude potrebbe interpretare male le istruzioni e riscrivere troppo.

CLAUDE.md

Se la Modalità autorizzazione è "quanto può fare", CLAUDE.md è "come vuoi che sia fatto". Posiziona questo file nella root del progetto. Claude lo legge all'inizio di ogni sessione. Usalo per:

1. Comandi di base del progetto (build, test, dev).
2. Regole (es. "Mostra sempre il diff prima di cambiare", "Non modificare la struttura dei file").
3. Regole di correzione (aggiungi una riga ogni volta che Claude commette un errore per evitare che si ripeta).

Mantienilo sotto 100 righe. Usa /init in una sessione per crearne uno automaticamente.

Riepilogo

Claude Code non è solo un'IA di chat; è un agente che opera sul tuo computer. Dieci minuti spesi nelle impostazioni fanno la differenza tra essere controllati dall'IA e essere noi a controllare. Non dire semplicemente "Sistemalo"; inizia con "Controlla questo e proponi un piano". La sicurezza prima di tutto.