Claude Code se integra com IDEs JetBrains através de um plugin dedicado, fornecendo recursos como visualização interativa de diff, compartilhamento de contexto de seleção e mais.

IDEs Suportados

O plugin Claude Code funciona com a maioria dos IDEs JetBrains, incluindo:
  • IntelliJ IDEA
  • PyCharm
  • Android Studio
  • WebStorm
  • PhpStorm
  • GoLand

Recursos

  • Inicialização rápida: Use Cmd+Esc (Mac) ou Ctrl+Esc (Windows/Linux) para abrir Claude Code diretamente do seu editor, ou clique no botão Claude Code na interface
  • Visualização de diff: Mudanças de código podem ser exibidas diretamente no visualizador de diff do IDE em vez do terminal
  • Contexto de seleção: A seleção/aba atual no IDE é automaticamente compartilhada com Claude Code
  • Atalhos de referência de arquivo: Use Cmd+Option+K (Mac) ou Alt+Ctrl+K (Linux/Windows) para inserir referências de arquivo (ex: @File#L1-99)
  • Compartilhamento de diagnósticos: Erros de diagnóstico (lint, sintaxe, etc.) do IDE são automaticamente compartilhados com Claude enquanto você trabalha

Instalação

Instalação via Marketplace

Encontre e instale o plugin Claude Code do marketplace JetBrains e reinicie seu IDE.

Auto-Instalação

O plugin também pode ser auto-instalado quando você executa claude no terminal integrado. O IDE deve ser reiniciado completamente para fazer efeito.
Após instalar o plugin, você deve reiniciar seu IDE completamente para que ele faça efeito. Você pode precisar reiniciar múltiplas vezes.

Uso

Do Seu IDE

Execute claude do terminal integrado do seu IDE, e todos os recursos de integração estarão ativos.

De Terminais Externos

Use o comando /ide em qualquer terminal externo para conectar Claude Code ao seu IDE JetBrains e ativar todos os recursos:
claude
> /ide
Se você quiser que Claude tenha acesso aos mesmos arquivos que seu IDE, inicie Claude Code do mesmo diretório que a raiz do projeto do seu IDE.

Configuração

Configurações do Claude Code

Configure a integração do IDE através das configurações do Claude Code:
  1. Execute claude
  2. Digite o comando /config
  3. Defina a ferramenta diff para auto para detecção automática do IDE

Configurações do Plugin

Configure o plugin Claude Code indo para Settings → Tools → Claude Code [Beta]:

Configurações Gerais

  • Comando Claude: Especifique um comando personalizado para executar Claude (ex: claude, /usr/local/bin/claude, ou npx @anthropic/claude)
  • Suprimir notificação para comando Claude não encontrado: Pular notificações sobre não encontrar o comando Claude
  • Habilitar uso de Option+Enter para prompts multi-linha (somente macOS): Quando habilitado, Option+Enter insere novas linhas em prompts do Claude Code. Desabilite se estiver enfrentando problemas com a tecla Option sendo capturada inesperadamente (requer reinicialização do terminal)
  • Habilitar atualizações automáticas: Verificar automaticamente e instalar atualizações do plugin (aplicadas na reinicialização)
Para usuários WSL: Defina wsl -d Ubuntu -- bash -lic "claude" como seu comando Claude (substitua Ubuntu pelo nome da sua distribuição WSL)

Configuração da Tecla ESC

Se a tecla ESC não interrompe operações do Claude Code em terminais JetBrains:
  1. Vá para Settings → Tools → Terminal
  2. Ou:
    • Desmarque “Move focus to the editor with Escape”, ou
    • Clique em “Configure terminal keybindings” e delete o atalho “Switch focus to Editor”
  3. Aplique as mudanças
Isso permite que a tecla ESC interrompa adequadamente as operações do Claude Code.

Configurações Especiais

Desenvolvimento Remoto

Ao usar JetBrains Remote Development, você deve instalar o plugin no host remoto via Settings → Plugin (Host).
O plugin deve ser instalado no host remoto, não na sua máquina cliente local.

Configuração WSL

Usuários WSL podem precisar de configuração adicional para que a detecção do IDE funcione adequadamente. Veja nosso guia de solução de problemas WSL para instruções detalhadas de configuração.
A configuração WSL pode requerer:
  • Configuração adequada do terminal
  • Ajustes do modo de rede
  • Atualizações das configurações de firewall

Solução de Problemas

Plugin Não Funcionando

  • Certifique-se de que está executando Claude Code do diretório raiz do projeto
  • Verifique se o plugin JetBrains está habilitado nas configurações do IDE
  • Reinicie completamente o IDE (você pode precisar fazer isso múltiplas vezes)
  • Para Desenvolvimento Remoto, certifique-se de que o plugin está instalado no host remoto

IDE Não Detectado

  • Verifique se o plugin está instalado e habilitado
  • Reinicie o IDE completamente
  • Verifique se você está executando Claude Code do terminal integrado
  • Para usuários WSL, veja o guia de solução de problemas WSL

Comando Não Encontrado

Se clicar no ícone Claude mostra “command not found”:
  1. Verifique se Claude Code está instalado: npm list -g @anthropic-ai/claude-code
  2. Configure o caminho do comando Claude nas configurações do plugin
  3. Para usuários WSL, use o formato de comando WSL mencionado na seção de configuração

Considerações de Segurança

Quando Claude Code executa em um IDE JetBrains com permissões de auto-edição habilitadas, ele pode ser capaz de modificar arquivos de configuração do IDE que podem ser automaticamente executados pelo seu IDE. Isso pode aumentar o risco de executar Claude Code no modo auto-edição e permitir contornar os prompts de permissão do Claude Code para execução bash. Ao executar em IDEs JetBrains, considere:
  • Usar modo de aprovação manual para edições
  • Ter cuidado extra para garantir que Claude seja usado apenas com prompts confiáveis
  • Estar ciente de quais arquivos Claude Code tem acesso para modificar
Para ajuda adicional, veja nosso guia de solução de problemas.