Skip to main content

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Potete usare Claude Code anche se non avete mai usato un terminale prima. Questa guida vi accompagna nell’apertura di un terminale, nell’installazione di Claude Code e nelle vostre prime interazioni.
Non volete usare il terminale? L’app desktop Claude Code vi permette di saltare completamente il terminale. Scaricatela per macOS o Windows, quindi consultate la Guida rapida per desktop per iniziare.

​
macOS e Linux

Seguite questi passaggi per installare e avviare Claude Code da un terminale macOS o Linux. Claude Code richiede macOS 13.0 o versione successiva. Consultate i requisiti di sistema per le distribuzioni Linux supportate.
1

Aprire un terminale

macOS: Premete Cmd + Space per aprire Spotlight Search, digitate Terminal e premete Enter.Linux: Aprite l’app del vostro terminale. Sulla maggior parte delle distribuzioni, premete Ctrl + Alt + T o cercate “Terminal” nel vostro menu delle applicazioni.Apparirà una finestra con un cursore lampeggiante. Questo è il vostro terminale, dove digitate i comandi.
2

Installare Claude Code

Copiate questa riga, incollatela nel vostro terminale (Cmd + V su macOS, Ctrl + Shift + V su Linux) e premete Enter:
curl -fsSL https://claude.ai/install.sh | bash
Questo scarica ed esegue il programma di installazione di Claude Code da claude.ai. Vedrete del testo scorrere mentre funziona. Quando avrà finito, vedrete “Claude Code successfully installed!” Se vedete un errore invece, consultate la sezione troubleshooting qui sotto.
3

Avviare Claude Code

Digitate claude e premete Enter:
claude
Vi verrà chiesto di accedere con il vostro account Claude. Seguite le istruzioni sullo schermo. Una finestra del browser si aprirà per farvi accedere.
4

Iniziare a usare Claude Code

Una volta effettuato l’accesso, potete iniziare a fare domande a Claude sul vostro codice o su qualsiasi altra cosa. Claude Code funziona interamente in testo. Digitate i messaggi e premete Enter per inviarli. Alcune cose da sapere:
  • Non potete fare clic su cose nel terminale. Usate i tasti freccia per muovervi.
  • Premete Esc per interrompere Claude se è in esecuzione.
  • Digitate exit o premete Ctrl + D per uscire da Claude Code.
  • Digitate /help per vedere i comandi disponibili.

​
Windows

Seguite questi passaggi per installare Git, configurare PowerShell e avviare Claude Code su Windows. Claude Code richiede Windows 10 versione 1809 o successiva. Consultate i requisiti di sistema per i dettagli completi.
1

Installare Git per Windows

Git è uno strumento che Claude Code utilizza internamente per tracciare le modifiche al vostro codice. Non avrete bisogno di imparare Git da soli.Se non lo avete già:
  1. Andate su git-scm.com/downloads/win e scaricate il programma di installazione
  2. Eseguite il programma di installazione. Fate clic su Avanti su ogni schermata per accettare i valori predefiniti. Il programma di installazione ha molte schermate, ma non dovete cambiare nulla.
  3. Se vi chiede di scegliere un editor, mantenete il valore predefinito e fate clic su Avanti.
  4. Quando vedete “Adjusting your PATH environment,” mantenete l’opzione consigliata selezionata.
Avete già Git? Potete saltare questo passaggio. Se non siete sicuri, installatelo comunque. La reinstallazione non causerà problemi.
2

Aprire PowerShell

PowerShell è il terminale integrato di Windows per digitare comandi. È preinstallato su ogni computer Windows.Premete Win + X e selezionate Windows PowerShell (o Terminal) dal menu. Apparirà una finestra con un cursore lampeggiante. Qui digiterete i comandi.
Windows ha due programmi da riga di comando: PowerShell e CMD. Si assomigliano ma usano comandi diversi. Assicuratevi di essere in PowerShell per il passaggio successivo.Come capire in quale siete:
  • PowerShell: mostra PS C:\Users\YourName> all’inizio di ogni riga
  • CMD: mostra C:\Users\YourName> senza il PS
3

Installare Claude Code

Copiate questa riga, incollatela in PowerShell con Ctrl + V o fate clic con il pulsante destro del mouse, e premete Enter:
irm https://claude.ai/install.ps1 | iex
Questo scarica ed esegue il programma di installazione di Claude Code. irm recupera il file e iex lo esegue. Vedrete del testo scorrere mentre funziona. Quando avrà finito, vedrete “Claude Code successfully installed!” Se vedete un errore invece, consultate la sezione troubleshooting qui sotto.
Se siete in CMD invece di PowerShell, usate questo comando:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
4

Avviare Claude Code

Chiudete PowerShell e aprite una nuova finestra PowerShell in modo che riconosca il comando claude appena installato. Quindi digitate:
claude
Vi verrà chiesto di accedere con il vostro account Claude. Seguite le istruzioni sullo schermo. Una finestra del browser si aprirà per farvi accedere.
5

Iniziare a usare Claude Code

Una volta effettuato l’accesso, potete iniziare a fare domande a Claude sul vostro codice o su qualsiasi altra cosa. Claude Code funziona interamente in testo. Digitate i messaggi e premete Enter per inviarli. Alcune cose da sapere:
  • Non potete fare clic su cose nel terminale. Usate i tasti freccia per muovervi.
  • Premete Esc per interrompere Claude se è in esecuzione.
  • Digitate exit o premete Ctrl + D per uscire da Claude Code.
  • Digitate /help per vedere i comandi disponibili.

​
Cosa fare dopo?

Una volta che vedete la schermata di benvenuto di Claude Code, siete pronti a partire. Non avete bisogno di sapere come codificare. Descrivete quello che volete in inglese semplice, e Claude scrive il codice per voi.

​
Costruire qualcosa

Claude può creare progetti da una descrizione: 
make me a simple webpage that says hello world
Claude crea i file per voi. Fate doppio clic sul file HTML per aprirlo nel vostro browser.

​
Lavorare con file sul vostro computer

Claude può leggere e organizzare file che avete già: 
look at the screenshots on my Desktop and rename them based on what's in each image

​
Fare domande

Claude può spiegare cose, aiutarvi a imparare o pianificare un progetto: 
I want to build a personal budget tracker. What would I need?
Se non avete ancora un progetto, va bene. Claude può aiutarvi a iniziarne uno nuovo.

​
Altri modi per usare Claude Code

Non dovete usare il terminale. Claude Code è disponibile anche in:

​
Scopri di più

​
Troubleshooting

​
Troubleshooting per macOS e Linux

Se riscontrate problemi durante l’installazione su macOS o Linux, controllate questi problemi comuni:
Se vedete command not found: claude dopo l’installazione, il vostro terminale ha bisogno di ricaricare le sue impostazioni. Chiudete la finestra del Terminale e apritene una nuova, quindi provate di nuovo claude.Se ancora non funziona, aggiungete la directory di installazione al vostro PATH. Eseguite il comando per la vostra shell:
# Zsh (default di macOS)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Bash (default di Linux)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Quindi provate di nuovo claude. Per ulteriori dettagli, consultate fix your PATH.
Se vedete bash: line 1: syntax error near unexpected token '<' o codice HTML come <!DOCTYPE html> nel vostro terminale, l’URL di installazione ha restituito una pagina web invece dello script del programma di installazione.Se la pagina dice “App unavailable in region,” Claude Code non è disponibile nel vostro paese. Consultate i paesi supportati.Altrimenti, provate a eseguire di nuovo il comando. Se continua a succedere, installate con Homebrew invece:
brew install --cask claude-code
Se vedete dyld: cannot load, dyld: Symbol not found, o built for Mac OS X 13.0, la vostra versione di macOS è probabilmente più vecchia di quella supportata da Claude Code.Aprite il menu Apple e selezionate About This Mac per controllare la vostra versione. Se è più vecchia di 13.0, aggiornate macOS tramite Software Update. Consultate la guida al troubleshooting di macOS per ulteriori dettagli.
Per altri errori, consultate la guida completa al troubleshooting dell’installazione.

​
Troubleshooting per Windows

Se riscontrate problemi durante l’installazione su Windows, controllate questi problemi comuni:
Siete in CMD, non in PowerShell. Chiudete questa finestra e aprite PowerShell invece (Win + X quindi selezionate Windows PowerShell).In alternativa, usate il comando di installazione di CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Questo di solito accade su sistemi Windows 10 più vecchi. Eseguite prima questa riga, quindi riprovate l’installazione:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex
Né Git per Windows né PowerShell è stato trovato. Claude Code ha bisogno di almeno una shell. Se solo PowerShell è trovato, Claude Code utilizza lo strumento PowerShell invece di Bash.
  1. Se non avete ancora installato Git, tornate al primo passaggio nella sezione Windows. In alternativa, installate PowerShell 7.
  2. Se Git è installato ma Claude Code non riesce a trovarlo, ditegli dove cercare: 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
    Quindi eseguite di nuovo claude. Se il vostro Git è installato da qualche altra parte, trovate il percorso eseguendo: 
    Get-Command git | Select-Object Source
    Cercate la cartella Git\bin in quel percorso e usatela invece.
Per rendere questo permanente in modo da non doverlo impostare ogni volta, consultate configure Git Bash path.
Riavviate il vostro computer e provate di nuovo. Questo di solito risolve il problema.Se il riavvio non ha aiutato, eseguite questi comandi per aggiungere Claude Code al vostro PATH:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Chiudete PowerShell, aprite una nuova finestra e provate di nuovo claude. Consultate verify your PATH per ulteriori dettagli.
Per altri errori, consultate la guida completa al troubleshooting dell’installazione.