> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Risoluzione dei problemi

> Problemi comuni e come risolverli

<div id="installation-issues">
  ## Problemi di installazione
</div>

<AccordionGroup>
  <Accordion title="Il comando di installazione non funziona (macOS / Linux / WSL)">
    Se lo script di installazione non riesce a scaricare i file:

    1. Verifica la connessione a Internet
    2. Verifica che curl sia installato: `which curl`
    3. Prova con l'output dettagliato: `curl -fsSL -v https://cli.devin.ai/install.sh | bash`

    Se utilizzi un proxy aziendale, potrebbe essere necessario configurare le impostazioni del proxy:

    ```bash theme={null}
    export https_proxy=http://your-proxy:port
    curl -fsSL https://cli.devin.ai/install.sh | bash
    ```
  </Accordion>

  <Accordion title="Il comando di installazione non funziona (Windows)">
    Se lo script di installazione di PowerShell non funziona:

    1. Verifica la connessione a Internet
    2. Assicurati di eseguire PowerShell come utente normale (non come Administrator, se non necessario)
    3. Se viene visualizzato un errore relativo ai criteri di esecuzione, prova:
       ```powershell theme={null}
       Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
       irm https://static.devin.ai/cli/setup.ps1 | iex
       ```
    4. Se utilizzi un proxy aziendale, configura le impostazioni del proxy in PowerShell prima di eseguire il comando di installazione

    In alternativa allo script di PowerShell, puoi scaricare ed eseguire direttamente il programma di installazione standalone:

    * [x86\_64](https://static.devin.ai/cli/devin-updater-x86_64-pc-windows.exe)
    * [ARM64](https://static.devin.ai/cli/devin-updater-aarch64-pc-windows.exe)
  </Accordion>

  <Accordion title="Autorizzazione negata durante l'installazione">
    Il programma di installazione richiede l'accesso in scrittura per installare il file binario. Se vengono visualizzati errori di autorizzazione:

    1. Verifica che il percorso di installazione abbia autorizzazioni di scrittura
    2. Non eseguire il programma di installazione con `sudo` — potrebbe causare problemi di proprietà
    3. Se stai installando in una directory di sistema, assicurati che il tuo utente disponga delle autorizzazioni appropriate
  </Accordion>

  <Accordion title="File binario non trovato dopo l'installazione">
    Se l'installazione viene completata ma `devin` non viene trovato:

    **macOS / Linux / WSL:**

    1. Riavvia il terminale oppure esegui `source ~/.bashrc` (o `~/.zshrc`)
    2. Controlla se il percorso del file binario è presente nel PATH: `echo $PATH`
    3. Verifica che il file binario esista: `ls -la ~/.local/bin/devin` (o nel percorso di installazione mostrato durante la configurazione)

    **Windows:**

    1. Riavvia la sessione di PowerShell
    2. Controlla se il percorso del file binario è presente nel PATH: `$env:PATH -split ';'`
    3. Verifica che il file binario esista nel percorso di installazione mostrato durante la configurazione
  </Accordion>

  <Accordion title="Comando 'irm' o 'iex' non trovato (Windows)">
    `irm` e `iex` sono alias di PowerShell. Se viene visualizzato questo errore, stai eseguendo il comando di installazione in Git Bash o CMD anziché in PowerShell.

    **Soluzione:** Apri **PowerShell** ed esegui lì il comando di installazione:

    ```powershell theme={null}
    irm https://static.devin.ai/cli/setup.ps1 | iex
    ```

    In alternativa, da Git Bash o CMD puoi invocare PowerShell esplicitamente:

    ```bash theme={null}
    powershell -Command "irm https://cli.devin.ai/install.ps1 | iex"
    ```

    Dopo l'installazione, puoi usare Devin CLI da **PowerShell**, **Windows Terminal** o **Git Bash**.
  </Accordion>
</AccordionGroup>

***

<div id="authentication-issues">
  ## Problemi di autenticazione
</div>

<AccordionGroup>
  <Accordion title="Il login non riesce o va in timeout">
    Se il login tramite browser non funziona:

    1. Provi il flusso token manuale per sessioni remote/SSH:
       ```bash theme={null}
       devin auth login --force-manual-token-flow
       ```
    2. Verifichi che il browser possa raggiungere l'URL di autenticazione
    3. Verifichi che l'accesso a Devin CLI sia abilitato per il suo account Enterprise
  </Accordion>

  <Accordion title="'Non autorizzato' o errori di autorizzazione">
    Se dopo il login vengono visualizzati errori di autorizzazione:

    1. Verifichi che il suo account disponga dell'autorizzazione corretta per accedere a Devin CLI. Potrebbe essere necessario contattare il suo amministratore. Per Enterprise, consulti [Devin Auth](/it/cli/enterprise/devin-auth#configuring-access) o [Legacy Windsurf Auth](/it/cli/enterprise/windsurf-auth#prerequisites) per informazioni su come configurare l'accesso.
    2. Provi a disconnettersi e ad accedere di nuovo: `devin auth logout && devin auth login`
    3. Verifichi lo stato dell'autenticazione: `devin auth status`
  </Accordion>

  <Accordion title="Token rifiutato o revocato">
    I token API di Devin CLI non scadono per impostazione predefinita. Se un token memorizzato è stato revocato o non è più accettato, lo rimuova prima di effettuare nuovamente il login:

    ```bash theme={null}
    devin auth logout && devin auth login
    ```

    per sostituire le sue credenziali memorizzate.
  </Accordion>
</AccordionGroup>

***

<div id="network-proxy-issues">
  ## Problemi di rete e proxy
</div>

<AccordionGroup>
  <Accordion title="Le connessioni non funzionano dietro un proxy aziendale">
    La CLI instrada il proprio traffico HTTPS in uscita (autenticazione, aggiornamenti, chiamate API al modello, server MCP) attraverso un proxy, se configurato. Puoi impostarlo in due modi:

    **Variabili di ambiente** — la modalità proxy `system`, predefinita, le rispetta:

    ```bash theme={null}
    export HTTPS_PROXY=http://proxy.corp.example.com:8080
    export HTTP_PROXY=http://proxy.corp.example.com:8080
    export ALL_PROXY=socks5://proxy.corp.example.com:1080   # facoltativo, SOCKS5
    export NO_PROXY=localhost,127.0.0.1,.internal.corp      # host da escludere
    ```

    **`config.json`** — si applica indipendentemente dall'ambiente:

    ```json theme={null}
    {
      "proxy": {
        "mode": "manual",
        "url": "http://proxy.corp.example.com:8080",
        "no_proxy": "localhost,127.0.0.1,.internal.corp"
      }
    }
    ```

    Consulta il [riferimento della configurazione `proxy`](/it/cli/reference/configuration/config-file#proxy) per tutte le opzioni. Su macOS e Windows, la modalità `system` rispetta anche le impostazioni PAC (Proxy Auto-Configuration) native della piattaforma.

    Se il proxy esegue l'ispezione TLS, la CLI usa l'archivio certificati del sistema operativo, quindi installa la Root CA del proxy a livello di sistema operativo (Portachiavi su macOS, archivio certificati di Windows oppure bundle CA della distribuzione su Linux).
  </Accordion>

  <Accordion title="Acquisire log completi delle richieste HTTP per il debug">
    Per avere visibilità completa sul ciclo di vita delle richieste (DNS, pooling delle connessioni, handshake TLS, header, reindirizzamenti e tentativi ripetuti), aumenta il livello di log con `RUST_LOG` e invia i log anche al terminale con `CHISEL_LOG_STDOUT`:

    ```bash theme={null}
    RUST_LOG="chisel=trace,windsurf_api_client=trace,connect_rpc=trace,reqwest=trace,hyper=trace,hyper_util=trace,rustls=trace" \
      CHISEL_LOG_STDOUT=1 \
      devin auth login
    ```

    Cosa aggiunge ciascun target:

    * `chisel`, `windsurf_api_client`, `connect_rpc` — logging delle richieste e dell'autenticazione della CLI
    * `reqwest=trace` — gestione di alto livello di richieste/risposte e reindirizzamenti
    * `hyper=trace` / `hyper_util=trace` — apertura della connessione, pooling e framing HTTP/1.1 e HTTP/2
    * `rustls=trace` — dettagli dell'handshake TLS (utile per problemi di proxy e certificati)

    Usa `CHISEL_LOG_STDERR=1` invece di `CHISEL_LOG_STDOUT=1` se non vuoi che i log si mescolino all'output del comando. (Il logging su stdout viene soppresso automaticamente nella REPL interattiva e nella modalità ACP per evitare di comprometterne l'output.)

    I log vengono sempre scritti anche in un file di log per ogni run nella directory dei dati della CLI, indipendentemente da queste variabili di ambiente:

    * **macOS / Linux:** `~/.local/share/devin/cli/logs/devin_<timestamp>_<pid>.log`
    * **Windows:** `%APPDATA%\devin\cli\logs\devin_<timestamp>_<pid>.log`

    <Warning>
      I log a livello trace possono includere dati sensibili come header `Authorization` e token. Rimuovi i dati sensibili dall'output dei log prima di condividerlo.
    </Warning>
  </Accordion>

  <Accordion title="Ispezionare i corpi completi di richiesta e risposta">
    `RUST_LOG` espone il ciclo di vita delle richieste ma non i payload completi. Per acquisire i corpi completi di richieste e risposte, instrada la CLI attraverso un proxy di intercettazione come [mitmproxy](https://mitmproxy.org/):

    ```bash theme={null}
    # Terminale 1 — avvia il proxy di intercettazione:
    mitmproxy --listen-port 8080

    # Terminale 2 — configura la CLI per usarlo:
    export HTTPS_PROXY=http://127.0.0.1:8080
    devin auth login
    ```

    Poiché la CLI usa l'archivio certificati del sistema operativo, installa prima il certificato CA di mitmproxy (`~/.mitmproxy/mitmproxy-ca-cert.pem`) nel tuo archivio di attendibilità di sistema; in caso contrario, la connessione TLS al proxy non riuscirà.
  </Accordion>
</AccordionGroup>

***

<div id="runtime-issues">
  ## Problemi di runtime
</div>

<AccordionGroup>
  <Accordion title="Modello non disponibile">
    Se vedi errori che indicano che un modello non è disponibile:

    1. Verifica se la tua Enterprise limita i modelli disponibili in [Team Settings](/it/cli/enterprise/team-settings)
    2. Verifica che il nome del modello sia corretto — usa `/model` per vedere le opzioni disponibili
    3. Prova un modello diverso: `devin --model sonnet -- your prompt`
  </Accordion>

  <Accordion title="Limite di frequenza o quota superata">
    Se raggiungi i limiti di utilizzo:

    1. Attendi qualche minuto prima di riprovare
    2. Controlla la dashboard di utilizzo della tua organizzazione per verificare lo stato della quota
    3. Contatta il tuo admin se hai bisogno di limiti più elevati
  </Accordion>

  <Accordion title="L'agente sembra bloccato o non risponde">
    Se l'agente smette di rispondere:

    1. Premi `Ctrl+C` per interrompere l'operazione in corso
    2. Prova `/clear` per avviare una nuova sessione
    3. Controlla la tua connessione di rete
    4. Riavvia Devin CLI
  </Accordion>
</AccordionGroup>

***

<div id="mcp-server-issues">
  ## Problemi con il server MCP
</div>

<AccordionGroup>
  <Accordion title="Il server non si avvia">
    Se un server MCP non riesce ad avviarsi:

    1. Verifica che il comando funzioni al di fuori della Devin CLI:
       ```bash theme={null}
       npx -y @modelcontextprotocol/server-github
       ```
    2. Controlla che tutte le variabili d'ambiente richieste siano impostate
    3. Cerca eventuali messaggi di errore nell'output del server
  </Accordion>

  <Accordion title="Gli strumenti non compaiono">
    Se gli strumenti MCP non compaiono:

    1. Il server potrebbe aver bisogno di un momento per inizializzarsi — attendi qualche secondo
    2. Controlla che il server sia configurato correttamente nel file di configurazione
    3. Verifica che la tua Enterprise consenta i server MCP in [Team Settings](/it/cli/enterprise/team-settings)
  </Accordion>

  <Accordion title="Autorizzazione negata per gli strumenti MCP">
    Per impostazione predefinita, gli strumenti MCP richiedono l'approvazione. Per approvare automaticamente strumenti specifici, aggiungili alla configurazione delle autorizzazioni:

    ```json theme={null}
    {
      "permissions": {
        "allow": ["mcp__github__list_issues"]
      }
    }
    ```
  </Accordion>
</AccordionGroup>

***

<div id="getting-help">
  ## Ottenere aiuto
</div>

Se continui a riscontrare problemi:

* **Supporto via email:** [support@cognition.ai](mailto:support@cognition.ai)
* **Invia una segnalazione di bug:** usa il comando `/bug` in Devin CLI per segnalare i problemi direttamente agli sviluppatori di Devin CLI
* **Verifica la presenza di aggiornamenti:** esegui `devin update` per assicurarti di utilizzare la versione più recente