Vai al contenuto principale
Claude Code si integra con JetBrains IDEs attraverso un plugin dedicato, fornendo funzionalità come la visualizzazione interattiva dei diff, la condivisione del contesto di selezione e altro ancora.

IDE Supportati

Il plugin Claude Code funziona con la maggior parte dei JetBrains IDEs, inclusi:
  • IntelliJ IDEA
  • PyCharm
  • Android Studio
  • WebStorm
  • PhpStorm
  • GoLand

Funzionalità

  • Avvio rapido: Usa Cmd+Esc (Mac) o Ctrl+Esc (Windows/Linux) per aprire Claude Code direttamente dal tuo editor, oppure fai clic sul pulsante Claude Code nell’interfaccia utente
  • Visualizzazione dei diff: Le modifiche al codice possono essere visualizzate direttamente nel visualizzatore diff dell’IDE invece del terminale
  • Contesto di selezione: La selezione/scheda corrente nell’IDE viene automaticamente condivisa con Claude Code
  • Scorciatoie di riferimento file: Usa Cmd+Option+K (Mac) o Alt+Ctrl+K (Linux/Windows) per inserire riferimenti ai file (ad esempio, @File#L1-99)
  • Condivisione diagnostica: Gli errori diagnostici (lint, sintassi, ecc.) dall’IDE vengono automaticamente condivisi con Claude mentre lavori

Installazione

Installazione da Marketplace

Trova e installa il plugin Claude Code dal marketplace di JetBrains e riavvia il tuo IDE. Se non hai ancora installato Claude Code, consulta la nostra guida di avvio rapido per le istruzioni di installazione.
Dopo aver installato il plugin, potrebbe essere necessario riavviare completamente il tuo IDE affinché abbia effetto.

Utilizzo

Dal Tuo IDE

Esegui claude dal terminale integrato del tuo IDE e tutte le funzionalità di integrazione saranno attive.

Da Terminali Esterni

Usa il comando /ide in qualsiasi terminale esterno per connettere Claude Code al tuo JetBrains IDE e attivare tutte le funzionalità:
claude
> /ide
Se desideri che Claude abbia accesso agli stessi file del tuo IDE, avvia Claude Code dalla stessa directory della radice del progetto del tuo IDE.

Configurazione

Impostazioni di Claude Code

Configura l’integrazione dell’IDE attraverso le impostazioni di Claude Code:
  1. Esegui claude
  2. Inserisci il comando /config
  3. Imposta lo strumento diff su auto per il rilevamento automatico dell’IDE

Impostazioni del Plugin

Configura il plugin Claude Code andando a Impostazioni → Strumenti → Claude Code [Beta]:

Impostazioni Generali

  • Comando Claude: Specifica un comando personalizzato per eseguire Claude (ad esempio, claude, /usr/local/bin/claude, o npx @anthropic/claude)
  • Sopprimere la notifica per il comando Claude non trovato: Salta le notifiche sulla mancata ricerca del comando Claude
  • Abilita l’uso di Option+Invio per prompt multi-riga (solo macOS): Quando abilitato, Option+Invio inserisce nuove righe nei prompt di Claude Code. Disabilita se riscontri problemi con il tasto Option catturato inaspettatamente (richiede il riavvio del terminale)
  • Abilita aggiornamenti automatici: Controlla automaticamente e installa gli aggiornamenti del plugin (applicati al riavvio)
Per gli utenti WSL: Imposta wsl -d Ubuntu -- bash -lic "claude" come comando Claude (sostituisci Ubuntu con il nome della tua distribuzione WSL)

Configurazione del Tasto ESC

Se il tasto ESC non interrompe le operazioni di Claude Code nei terminali JetBrains:
  1. Vai a Impostazioni → Strumenti → Terminale
  2. Oppure:
    • Deseleziona “Sposta il focus sull’editor con Escape”, oppure
    • Fai clic su “Configura i tasti di scelta rapida del terminale” e elimina il collegamento “Passa il focus all’Editor”
  3. Applica le modifiche
Questo consente al tasto ESC di interrompere correttamente le operazioni di Claude Code.

Configurazioni Speciali

Sviluppo Remoto

Quando usi JetBrains Remote Development, devi installare il plugin nell’host remoto tramite Impostazioni → Plugin (Host).
Il plugin deve essere installato sull’host remoto, non sulla tua macchina client locale.

Configurazione WSL

Gli utenti WSL potrebbero aver bisogno di configurazione aggiuntiva affinché il rilevamento dell’IDE funzioni correttamente. Consulta la nostra guida alla risoluzione dei problemi WSL per istruzioni di configurazione dettagliate.
La configurazione WSL potrebbe richiedere:
  • Configurazione corretta del terminale
  • Regolazioni della modalità di rete
  • Aggiornamenti delle impostazioni del firewall

Risoluzione dei Problemi

Plugin Non Funzionante

  • Assicurati di eseguire Claude Code dalla directory radice del progetto
  • Verifica che il plugin JetBrains sia abilitato nelle impostazioni dell’IDE
  • Riavvia completamente l’IDE (potrebbe essere necessario farlo più volte)
  • Per Remote Development, assicurati che il plugin sia installato nell’host remoto

IDE Non Rilevato

  • Verifica che il plugin sia installato e abilitato
  • Riavvia completamente l’IDE
  • Controlla che tu stia eseguendo Claude Code dal terminale integrato
  • Per gli utenti WSL, consulta la guida alla risoluzione dei problemi WSL

Comando Non Trovato

Se facendo clic sull’icona Claude viene visualizzato “comando non trovato”:
  1. Verifica che Claude Code sia installato: npm list -g @anthropic-ai/claude-code
  2. Configura il percorso del comando Claude nelle impostazioni del plugin
  3. Per gli utenti WSL, usa il formato del comando WSL menzionato nella sezione di configurazione

Considerazioni sulla Sicurezza

Quando Claude Code viene eseguito in un JetBrains IDE con le autorizzazioni di modifica automatica abilitate, potrebbe essere in grado di modificare i file di configurazione dell’IDE che possono essere eseguiti automaticamente dal tuo IDE. Questo potrebbe aumentare il rischio di eseguire Claude Code in modalità di modifica automatica e consentire di aggirare i prompt di autorizzazione di Claude Code per l’esecuzione bash. Quando si esegue in JetBrains IDEs, considera:
  • Utilizzare la modalità di approvazione manuale per le modifiche
  • Prestare particolare attenzione per assicurarsi che Claude sia utilizzato solo con prompt attendibili
  • Essere consapevole di quali file Claude Code ha accesso per modificare
Per ulteriore aiuto, consulta la nostra guida alla risoluzione dei problemi.