Configurazione del proxy per Devin Desktop negli IDE JetBrains

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.

In alcune reti aziendali e enterprise, il traffico passa attraverso proxy HTTP/HTTPS. Il plugin Devin Desktop per gli IDE JetBrains deve poter raggiungere i servizi esterni di Devin Desktop (per l’accesso e le funzionalità di IA), quindi potrebbe essere necessario configurare un proxy prima che tutto funzioni in modo affidabile. La configurazione di un proxy può essere necessaria se:

• In Devin Desktop viene visualizzato il messaggio “Impossibile connettersi” o errori di rete simili
• Il pannello di Devin Desktop nell’IDE rimane vuoto e non viene mai caricato
• Cascade o altre funzionalità di Devin Desktop non riescono a connettersi o vanno in timeout

Questa guida spiega come:

• verificare se la rete utilizza un proxy
• configurare il proxy dell’IDE
• abilitare il rilevamento del proxy in Devin Desktop
• configurare le impostazioni del proxy per JetBrains Remote

Prima di modificare qualsiasi cosa: Chiedi al tuo team IT / infrastruttura / rete:

• Usiamo un proxy HTTP/HTTPS per il traffico in uscita?
• Se sì, è configurato automaticamente (impostazioni di sistema / file PAC / gestione del dispositivo), oppure devo configurarlo manualmente nelle applicazioni?

Se la tua organizzazione non usa un proxy, in genere non è necessario modificare queste impostazioni. Se la tua organizzazione ne usa uno, raccogli i dettagli del proxy (indirizzo, porta ed eventuali credenziali). Puoi condividere con loro screenshot delle impostazioni di JetBrains HTTP Proxy e di Devin Desktop, così potranno dirti esattamente cosa inserire. Per prima cosa, assicurati che l’IDE possa accedere a Internet tramite il proxy — in particolare, che riesca a raggiungere windsurf.com.

1. Apri Settings / Preferences nel tuo IDE JetBrains. Ad esempio: File → Settings… (Windows/Linux) oppure ⌘, → Settings… (macOS).
2. Vai a Appearance & Behavior → System Settings → HTTP Proxy.

3. Scegli l’opzione appropriata in base alle indicazioni del team IT:
   • No proxy – se la tua rete non usa un proxy.
   • Auto-detect proxy settings o Use system proxy settings – se il proxy è configurato a livello di sistema sul computer.
   • Manual proxy configuration – se l’IT ti ha fornito un host/porta del proxy specifico (ed eventualmente username/password) da inserire qui.
4. Usa Check connection… (se disponibile) per verificare la configurazione — idealmente, prova a raggiungere https://windsurf.com da questa finestra di dialogo.
5. Applica le modifiche e riavvia l’IDE, se richiesto.

Se l’IDE non riesce a raggiungere la rete (ad esempio, se il marketplace dei plugin, gli aggiornamenti o le funzionalità web integrate non funzionano, oppure se non riesci a raggiungere https://windsurf.com dall’interno dell’IDE), risolvi prima questo problema. Devin Desktop dipende da questa connettività. Una volta impostato il proxy a livello di IDE (o verificato che non sia necessario), configura il modo in cui Devin Desktop utilizza queste impostazioni. Il plugin Devin Desktop ha una propria opzione Detect proxy nelle sue impostazioni:

1. Nel tuo IDE JetBrains, apri Settings / Preferences.
2. Vai a Tools → Windsurf Settings.
3. Individua il toggle Detect proxy.

4. Attiva Detect proxy se:
   • Il proxy è configurato a livello di sistema operativo o di IDE, e
   • Il reparto IT si aspetta che le applicazioni “rilevino automaticamente” queste impostazioni.
5. Fai clic su Apply e OK, se necessario, quindi riavvia l’IDE.
6. Prova a usare di nuovo Devin Desktop:
   • Apri il pannello di Devin Desktop dalla barra laterale dell’IDE
   • Esegui Cascade o riprova l’operazione che non riusciva e mostrava “Failed to connect” oppure una schermata vuota

Se noti nuovi problemi di connessione dopo aver abilitato Detect proxy, puoi:

• Disattivare di nuovo Detect proxy,
• Verificare nuovamente la configurazione del proxy HTTP del tuo IDE (incluso il fatto che riesca a raggiungere https://windsurf.com), e
• Confermare con il reparto IT se è necessaria un’ulteriore configurazione manuale.

Se usi JetBrains Remote Development (ad esempio tramite JetBrains Gateway, un backend remoto o un ambiente di sviluppo nel cloud), in pratica ci sono due punti in cui le impostazioni del proxy sono rilevanti:

• Il tuo computer locale, su cui viene eseguito il client leggero.
• Il computer remoto, su cui vengono eseguiti il backend effettivo dell’IDE (e Devin Desktop).

Quando ti connetti con JetBrains Remote, le richieste di rete di Devin Desktop partono dal computer remoto, non dal tuo laptop locale. Questo significa che:

• La configurazione del proxy sull’IDE remoto influisce sul modo in cui Devin Desktop si connette ai servizi di Devin Desktop.
• Il computer remoto potrebbe richiedere una propria configurazione del proxy, anche se il tuo computer locale è già configurato correttamente.

1. Connettiti al backend remoto usando JetBrains Remote / Gateway.
2. Apri Settings / Preferences nella sessione IDE remota (si apriranno le impostazioni dell’IDE in esecuzione sulla macchina remota).
3. Configura il proxy per l’IDE remoto:
   • Vai a Appearance & Behavior → System Settings → HTTP Proxy nell’IDE remoto.
   • Imposta il proxy in base alle istruzioni del team IT (No proxy / Auto-detect / Use system proxy / Manual).
   • Se l’IDE mette a disposizione il pulsante Check connection…, usalo per verificare la connettività a https://windsurf.com dalla macchina remota.
4. Configura Devin Desktop nell’IDE remoto:
   • Vai a Tools → Windsurf Settings (sempre nella sessione remota).
   • Abilita Detect proxy se il team IT prevede che le applicazioni sull’host remoto usino le impostazioni proxy del sistema o dell’IDE.
5. Applica le modifiche, quindi riavvia il backend dell’IDE remoto oppure disconnetti e riconnetti la sessione remota.
6. Apri di nuovo il pannello Devin Desktop nell’IDE remoto e riprova l’azione che in precedenza non era riuscita.

Se:

• non stai usando JetBrains Remote,
• le altre funzionalità di JetBrains funzionano già dopo averlo configurato,
• Devin Desktop funziona senza modificare le proprie impostazioni, e
• l’IDE riesce a raggiungere https://windsurf.com.

(In locale o da remoto) se:

• il proxy è già configurato a livello di sistema operativo o dell’IDE su quella macchina e
• Devin Desktop è l’unica applicazione che non riesce a connettersi oppure mostra un pannello vuoto di Devin Desktop.

Se:

• usi JetBrains Remote,
• hai installato il plugin Windsurf (Remote Development) per quell’ambiente, e
• gli errori si verificano solo quando sei connesso a un backend remoto, oppure
• il team IT ti ha comunicato che anche il server remoto deve passare attraverso un proxy per accedere a internet (incluso https://windsurf.com).

Se:

• Non sei sicuro se il tuo ambiente utilizzi un proxy, oppure
• Hai configurato HTTP Proxy + Devin Desktop Detect proxy (in locale e/o da remoto) e hai verificato la connessione a https://windsurf.com, ma continui a vedere pannelli vuoti in Devin Desktop o errori di connessione.

Il tuo team IT / infra è il punto di riferimento definitivo: può confermare se ti serve un proxy sulla tua macchina locale, sulla tua macchina remota o su entrambe, come deve essere configurato in JetBrains e se l’impostazione Devin Desktop Detect proxy deve essere abilitata nel tuo ambiente.