Vai al contenuto principale

​
Problemi di installazione

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:
export https_proxy=http://your-proxy:port
curl -fsSL https://cli.devin.ai/install.sh | bash
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: 
    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:
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
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
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:
irm https://static.devin.ai/cli/setup.ps1 | iex
In alternativa, da Git Bash o CMD puoi invocare PowerShell esplicitamente:
powershell -Command "irm https://cli.devin.ai/install.ps1 | iex"
Dopo l’installazione, puoi usare Devin CLI da PowerShell, Windows Terminal o Git Bash.

​
Problemi di autenticazione

Se il login tramite browser non funziona:
  1. Provi il flusso token manuale per sessioni remote/SSH: 
    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
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 o Legacy Windsurf Auth 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
I token di autenticazione scadono periodicamente. Esegua semplicemente:
devin auth login
per aggiornare le sue credenziali.

​
Problemi di rete e proxy

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:
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:
{
  "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 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).
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:
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
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.
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:
# 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à.

​
Problemi di runtime

Se vedi errori che indicano che un modello non è disponibile:
  1. Verifica se la tua Enterprise limita i modelli disponibili in 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
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
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

​
Problemi con il server MCP

Se un server MCP non riesce ad avviarsi:
  1. Verifica che il comando funzioni al di fuori della Devin CLI: 
    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
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
Per impostazione predefinita, gli strumenti MCP richiedono l’approvazione. Per approvare automaticamente strumenti specifici, aggiungili alla configurazione delle autorizzazioni:
{
  "permissions": {
    "allow": ["mcp__github__list_issues"]
  }
}

​
Ottenere aiuto

Se continui a riscontrare problemi:
  • Supporto via email: 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