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 das JetBrains IDEs, incluindo:
  • IntelliJ IDEA
  • PyCharm
  • Android Studio
  • WebStorm
  • PhpStorm
  • GoLand

Recursos

  • Lançamento rápido: 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/aba atual no IDE é compartilhada automaticamente 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 (por exemplo, @File#L1-99)
  • Compartilhamento de diagnóstico: Erros de diagnóstico (lint, sintaxe, etc.) do IDE são compartilhados automaticamente com Claude conforme você trabalha

Instalação

Instalação do Marketplace

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

Instalação Automática

O plugin também pode ser instalado automaticamente quando você executa claude no terminal integrado. O IDE deve ser reiniciado completamente para que tenha efeito.
Após instalar o plugin, você deve reiniciar seu IDE completamente para que tenha efeito. Você pode precisar reiniciar várias 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 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 detecção automática do IDE

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/claude)
  • 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 macOS): Quando ativado, Option+Enter insere novas linhas nos prompts do Claude Code. Desative se estiver tendo problemas com a tecla Option 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

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

Solução de Problemas

Plugin Não Funcionando

  • 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 Desenvolvimento Remoto, certifique-se de que o plugin está instalado no host remoto

IDE Não Detectado

  • 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 o guia de solução de problemas WSL

Comando Não Encontrado

Se clicar no ícone Claude mostrar “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 é executado em um JetBrains IDE com permissões de edição automática ativadas, 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 de edição automática 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 ajuda adicional, consulte nosso guia de solução de problemas.