> ## 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.

# Guida al terminale per i nuovi utenti

> Una guida passo dopo passo per installare Claude Code per i nuovi utenti del terminale su macOS e Windows.

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.

* [macOS e Linux](#macos-and-linux)
* [Windows](#windows)

<Note>
  Non volete usare il terminale? L'app desktop Claude Code vi permette di saltare completamente il terminale. Scaricatela per [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs), o [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs), quindi consultate la [Guida rapida per desktop](/it/desktop-quickstart) per iniziare.
</Note>

<h2 id="macos-and-linux">
  macOS e Linux
</h2>

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](/it/setup#system-requirements) per le distribuzioni Linux supportate.

<Steps>
  <Step title="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.
  </Step>

  <Step title="Installare Claude Code">
    Copiate questa riga, incollatela nel vostro terminale (`Cmd + V` su macOS, `Ctrl + Shift + V` su Linux) e premete `Enter`:

    ```bash theme={null}
    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](#macos-and-linux-troubleshooting) qui sotto.
  </Step>

  <Step title="Avviare Claude Code">
    Digitate `claude` e premete `Enter`:

    ```bash theme={null}
    claude
    ```

    Vi verrà chiesto di [accedere](/it/authentication) con il vostro account Claude. Seguite le istruzioni sullo schermo. Una finestra del browser si aprirà per farvi accedere.
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

<h2 id="windows">
  Windows
</h2>

Seguite questi passaggi per installare facoltativamente Git per Windows, configurare PowerShell e avviare Claude Code su Windows. Claude Code richiede Windows 10 versione 1809 o successiva. Consultate i [requisiti di sistema](/it/setup#system-requirements) per i dettagli completi.

<Steps>
  <Step title="Installare Git per Windows (facoltativo)">
    Git per Windows fornisce Git Bash, che abilita lo strumento Bash. Senza di esso, Claude Code utilizza PowerShell. Non avrete bisogno di imparare Git da soli.

    Se non lo avete già:

    1. Andate su [git-scm.com/downloads/win](https://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.

    <Note>
      Avete già Git? Potete saltare questo passaggio. Se non siete sicuri, installatelo comunque. La reinstallazione non causerà problemi.
    </Note>
  </Step>

  <Step title="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.

    <Note>
      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`
    </Note>
  </Step>

  <Step title="Installare Claude Code">
    Copiate questa riga, incollatela in PowerShell con `Ctrl + V` o fate clic con il pulsante destro del mouse, e premete `Enter`:

    ```powershell theme={null}
    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](#windows-troubleshooting) qui sotto.

    <Note>
      Se siete in CMD invece di PowerShell, usate questo comando:

      ```batch theme={null}
      curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
      ```
    </Note>
  </Step>

  <Step title="Avviare Claude Code">
    Eseguite `claude`. Se PowerShell dice `'claude' is not recognized`, la directory di installazione non è ancora nel vostro PATH. Seguite la correzione ['claude is not recognized'](#windows-troubleshooting) qui sotto, quindi aprite una nuova finestra PowerShell e riprovate.

    ```powershell theme={null}
    claude
    ```

    Vi verrà chiesto di [accedere](/it/authentication) con il vostro account Claude. Seguite le istruzioni sullo schermo. Una finestra del browser si aprirà per farvi accedere.
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

<h2 id="what’s-next">
  Cosa fare dopo?
</h2>

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.

<h3 id="build-something">
  Costruire qualcosa
</h3>

Claude può creare progetti da una descrizione:

```text theme={null}
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.

<h3 id="work-with-files-on-your-computer">
  Lavorare con file sul vostro computer
</h3>

Claude può leggere e organizzare file che avete già:

```text theme={null}
look at the screenshots on my Desktop and rename them based on what's in each image
```

<h3 id="ask-questions">
  Fare domande
</h3>

Claude può spiegare cose, aiutarvi a imparare o pianificare un progetto:

```text theme={null}
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.

<h3 id="other-ways-to-use-claude-code">
  Altri modi per usare Claude Code
</h3>

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

* [VS Code](/it/vs-code) e [JetBrains IDEs](/it/jetbrains) come estensioni dell'editor
* L'[app desktop](/it/desktop-quickstart), senza terminale richiesto
* Il [web](/it/claude-code-on-the-web) su claude.ai/code per sessioni remote
* [GitHub Actions](/it/github-actions) e [GitLab CI/CD](/it/gitlab-ci-cd) per l'automazione

<h3 id="learn-more">
  Scopri di più
</h3>

* [Guida rapida](/it/quickstart): una procedura guidata del vostro primo progetto con Claude Code
* [Come funziona Claude Code](/it/how-claude-code-works): capire come Claude legge i vostri file, esegue comandi e fa modifiche
* [Best practices](/it/best-practices): ottenere risultati migliori con prompt efficaci e configurazione del progetto
* [Flussi di lavoro comuni](/it/common-workflows): guide passo dopo passo per il debug, i test, il refactoring e altro
* [Configurazione del terminale](/it/terminal-config): personalizzate il vostro terminale per la migliore esperienza di Claude Code

***

<h2 id="troubleshooting">
  Troubleshooting
</h2>

<h3 id="macos-and-linux-troubleshooting">
  Troubleshooting per macOS e Linux
</h3>

Se riscontrate problemi durante l'installazione su macOS o Linux, controllate questi problemi comuni:

<Accordion title="'command not found: claude'">
  Se vedete `command not found: claude` dopo l'installazione, la cartella in cui il programma di installazione ha messo `claude` non è nel vostro PATH. Il programma di installazione stampa la correzione esatta sotto `Setup notes` alla fine dell'installazione, quindi eseguite quel comando, oppure usate quello per la vostra shell qui sotto.

  Per Zsh, la shell predefinita di macOS:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```

  Per Bash, la shell predefinita di Linux:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  source ~/.bashrc
  ```

  Quindi aprite un nuovo terminale e provate di nuovo `claude`. Se ancora non viene trovato, controllate che il file `~/.local/bin/claude` esista. Se non esiste, l'installazione non è stata completata. Per ulteriori dettagli, consultate [fix your PATH](/it/troubleshoot-install#verify-your-path).
</Accordion>

<Accordion title="Errore con codice HTML o 'syntax error near unexpected token'">
  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](https://www.anthropic.com/supported-countries).

  Altrimenti, provate a eseguire di nuovo il comando. Se continua a succedere, installate con [Homebrew](https://brew.sh) invece:

  ```bash theme={null}
  brew install --cask claude-code
  ```
</Accordion>

<Accordion title="Errore 'dyld' o 'built for Mac OS X 13.0'">
  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](/it/troubleshoot-install#dyld-cannot-load-on-macos) per ulteriori dettagli.
</Accordion>

Per altri errori, consultate la [guida completa al troubleshooting dell'installazione](/it/troubleshoot-install).

<h3 id="windows-troubleshooting">
  Troubleshooting per Windows
</h3>

Se riscontrate problemi durante l'installazione su Windows, controllate questi problemi comuni:

<Accordion title="'irm is not recognized'">
  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:

  ```batch theme={null}
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```
</Accordion>

<Accordion title="Errore SSL/TLS o 'Could not create SSL/TLS secure channel'">
  Questo di solito accade su sistemi Windows 10 più vecchi. Eseguite prima questa riga, quindi riprovate l'installazione:

  ```powershell theme={null}
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  irm https://claude.ai/install.ps1 | iex
  ```
</Accordion>

<Accordion title="'Claude Code on Windows requires either Git for Windows (for bash) or PowerShell'">
  Né PowerShell né Git Bash è stato trovato. Claude Code ha bisogno di almeno una shell.

  1. Assicuratevi che `powershell.exe` sia nel vostro `PATH`. La sua posizione predefinita è `C:\Windows\System32\WindowsPowerShell\v1.0\`. In alternativa, installate [PowerShell 7](https://aka.ms/powershell), che fornisce `pwsh`.
  2. Se preferite usare Git Bash, installate [Git for Windows](https://git-scm.com/downloads/win) secondo il [primo passaggio nella sezione Windows](#windows).
  3. Se Git è installato ma Claude Code non riesce a trovarlo, ditegli dove cercare:
     ```powershell theme={null}
     $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:
     ```powershell theme={null}
     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](/it/troubleshoot-install#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell).
</Accordion>

<Accordion title="'claude is not recognized'">
  Questo errore significa che la directory di installazione non è nel vostro PATH. Eseguite questi comandi in PowerShell per aggiungerla:

  ```powershell theme={null}
  $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](/it/troubleshoot-install#verify-your-path) per ulteriori dettagli.
</Accordion>

Per altri errori, consultate la [guida completa al troubleshooting dell'installazione](/it/troubleshoot-install).