Pular para o conteúdo principal
Claude Code integra-se com JetBrains IDEs através de um plugin dedicado, fornecendo recursos como visualização de diff interativa, compartilhamento de contexto de seleção e muito mais.

​
IDEs Suportadas

O plugin Claude Code funciona com a maioria dos JetBrains IDEs, 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: As alterações de código podem ser exibidas diretamente no visualizador de diff do IDE em vez do terminal
  • Contexto de seleção: A seleção ou aba atual no IDE é compartilhada automaticamente com Claude Code. As regras de negação Read bloqueiam esse compartilhamento para arquivos correspondentes
  • Atalhos de referência de arquivo: Use Cmd+Option+K (Mac) ou Alt+Ctrl+K (Linux/Windows) para inserir referências de arquivo como @src/auth.ts#L1-99
  • Compartilhamento de diagnóstico: Erros de diagnóstico do IDE, como erros de lint e sintaxe, são compartilhados automaticamente com Claude conforme você trabalha

​
Instalação

O plugin executa o comando claude no terminal integrado do seu IDE e se conecta a ele. Ele não agrupa sua própria cópia da CLI, portanto instale ambas as partes:
1

Instale o Claude Code CLI

Siga o guia de início rápido para instalar a CLI se você ainda não o fez. O plugin mostra uma notificação “Cannot launch Claude Code” quando claude não está no seu PATH.
2

Instale o plugin JetBrains

Instale o plugin Claude Code do JetBrains Marketplace e reinicie seu IDE.
Se claude estiver instalado em algum lugar que seu IDE não consiga encontrar, defina o caminho completo na configuração do comando Claude do plugin. Claude Code funciona com qualquer assinatura Claude paga (Pro, Max, Team ou Enterprise) ou uma conta Claude Console, e nenhuma chave de API é necessária. Você será solicitado a fazer login na primeira vez que executar claude.
Após instalar o plugin, você pode precisar reiniciar completamente seu IDE para que ele entre em vigor.

​
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 JetBrains IDE e ativar todos os recursos: 
claude

/ide
Se você deseja que Claude tenha acesso aos mesmos arquivos do seu IDE, inicie Claude Code no 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 de diff como auto para mostrar diffs no IDE, ou terminal para mantê-los no terminal

​
Configurações do Plugin

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

​
Configurações Gerais

  • Claude command: Especifique um comando personalizado para executar Claude, por exemplo claude, /usr/local/bin/claude, ou npx @anthropic-ai/claude-code
  • Suppress notification for Claude command not found: Pule notificações sobre não encontrar o comando Claude
  • Enable using Option+Enter for multi-line prompts: apenas no macOS. Quando ativado, Option+Enter insere novas linhas em prompts do Claude Code. Desative se a tecla Option estiver sendo capturada inesperadamente. Requer reinicialização do terminal.
  • Enable automatic updates: Verifique e instale automaticamente 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 interromper as operações do Claude Code nos terminais JetBrains:
  1. Vá para Settings → Tools → Terminal
  2. Faça um dos seguintes:
    • 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 alterações
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

Se você estiver usando Claude Code no WSL2 com um JetBrains IDE e vir “No available IDEs detected”, a causa geralmente é a rede NAT do WSL2 ou o Windows Firewall bloqueando a conexão entre WSL2 e o IDE em execução no host Windows. WSL1 usa a rede do host diretamente e não é afetado.

​
Permitir tráfego WSL2 através do Windows Firewall

Esta é a correção recomendada porque mantém seu modo de rede WSL2 existente.
1

Encontre seu endereço IP do WSL2

De dentro do seu shell WSL, execute:
hostname -I
Anote a sub-rede, por exemplo 172.21.123.45 está em 172.21.0.0/16.
2

Crie uma regra de firewall

Abra PowerShell como Administrador e execute o seguinte, ajustando o intervalo de IP para corresponder à sua sub-rede:
New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16
3

Reinicie seu IDE e Claude Code

Feche e reabra ambos para que a nova regra entre em vigor.

​
Mude WSL2 para rede espelhada

A rede espelhada requer Windows 11 22H2 ou posterior. Se você estiver no Windows 10, use a regra de firewall acima. Adicione isto ao .wslconfig no seu diretório de usuário Windows: 
[wsl2]
networkingMode=mirrored
Em seguida, reinicie WSL com wsl --shutdown do PowerShell.

​
Solução de Problemas

​
Plugin não funcionando

Se o plugin estiver instalado mas os recursos do Claude Code não aparecerem no seu IDE:
  • Certifique-se de que você está executando Claude Code no diretório raiz do projeto
  • Verifique se o plugin JetBrains está ativado nas configurações do IDE
  • Reinicie completamente o IDE (você pode precisar fazer isso várias vezes)
  • Para Remote Development, certifique-se de que o plugin está instalado no host remoto

​
IDE não detectado

Se executar claude mostrar “No available IDEs detected”:
  • Verifique se o plugin está instalado e ativado
  • Reinicie o IDE completamente
  • Verifique se você está executando Claude Code no terminal integrado
  • Para usuários WSL, consulte Configuração WSL acima

​
Comando não encontrado

Se clicar no ícone Claude mostrar “command not found”:
  1. Verifique se Claude Code está instalado executando claude --version em um terminal
  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 é executado em um JetBrains IDE no modo de permissão acceptEdits, ele pode ser capaz de modificar arquivos de configuração do IDE que podem ser executados automaticamente pelo seu IDE. Isso pode aumentar o risco de executar Claude Code no modo acceptEdits e permitir contornar os prompts de permissão do Claude Code para execução de bash. Ao executar em JetBrains IDEs, considere:
  • Usar modo de aprovação manual para edições
  • Tomar 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 problemas de instalação ou login do Claude Code fora do IDE, consulte Solucionar problemas de instalação e login.