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

# Configurazione del proxy per Devin Desktop negli IDE JetBrains

> Configura le impostazioni proxy HTTP/HTTPS per il plugin Devin Desktop negli IDE JetBrains, inclusi gli ambienti Gateway e di sviluppo remoto.

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.

<div id="when-proxy-configuration-may-be-required">
  ## Quando può essere necessaria la configurazione di un proxy
</div>

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

<div id="check-whether-your-network-uses-a-proxy">
  ## Verifica se la tua rete usa un proxy
</div>

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.

<div id="configure-the-jetbrains-ide-proxy">
  ## Configura il proxy dell'IDE JetBrains
</div>

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.

<img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/plugins/jetbrains/proxy-http-settings.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=1b2895dd2d43187387c3d6aabbc171f4" alt="Impostazioni HTTP Proxy di JetBrains" width="1936" height="1386" data-path="desktop/assets/plugins/jetbrains/proxy-http-settings.png" />

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

<div id="enable-devin-desktop-proxy-detection-in-jetbrains">
  ## Abilitare il rilevamento del proxy di Devin Desktop in JetBrains
</div>

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.

<img src="https://mintcdn.com/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/plugins/jetbrains/proxy-windsurf-settings.png?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=ce6712ae42f9e9687d5f2aef2b80f409" alt="Impostazioni di rilevamento del proxy di Devin Desktop" width="1928" height="1386" data-path="desktop/assets/plugins/jetbrains/proxy-windsurf-settings.png" />

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.

<div id="proxy-configuration-in-jetbrains-remote">
  ## Configurazione del proxy in JetBrains Remote
</div>

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.

<Warning>
  Per lo sviluppo remoto con JetBrains, devi usare il plugin dedicato "Windsurf (Remote Development)", non il plugin Windsurf standard. Assicurati di aver installato Windsurf (Remote Development) come descritto nella sezione Remote Development della guida introduttiva di Windsurf per JetBrains.
</Warning>

<div id="configure-the-proxy-for-the-remote-environment">
  ### Configurare il proxy per l'ambiente remoto
</div>

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.

<Note>
  Nelle configurazioni aziendali è comune che sia la macchina locale sia quella remota abbiano regole proxy proprie. Assicurati di seguire le indicazioni dell'IT per entrambi i lati; correggere solo il proxy locale non aiuterà se l'host remoto non riesce a raggiungere Internet (incluso `https://windsurf.com`) senza una propria configurazione proxy.
</Note>

<div id="when-to-change-what">
  ## Cosa cambiare e quando
</div>

<div id="change-only-the-local-ide-http-proxy">
  ### Modifica solo il proxy HTTP dell'IDE locale
</div>

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

<div id="enable-devin-desktop-detect-proxy">
  ### Attiva "Detect Proxy" in Devin Desktop
</div>

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

<div id="configure-proxy-on-the-remote-ide">
  ### Configurare il proxy nell'IDE remoto
</div>

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`).

<div id="talk-to-it-infra">
  ### Rivolgiti a IT / Infra
</div>

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.