Claude Code integra-se perfeitamente com Ambientes de Desenvolvimento Integrados (IDEs) populares para aprimorar seu fluxo de trabalho de codificação. Esta integração permite que você aproveite as capacidades do Claude diretamente dentro do seu ambiente de desenvolvimento preferido.

IDEs Suportados

Claude Code atualmente suporta duas principais famílias de IDE:

  • Visual Studio Code (incluindo forks populares como Cursor e Windsurf)
  • JetBrains IDEs (incluindo PyCharm, WebStorm, IntelliJ e 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 UI
  • Visualização de diff: Alterações de código podem ser exibidas diretamente no visualizador de diff do IDE em vez do terminal. Você pode configurar isso em /config
  • 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

VS Code

  1. Abra o VSCode
  2. Abra o terminal integrado
  3. Execute claude - a extensão será auto-instalada

Daqui em diante você também pode usar o comando /ide em qualquer terminal externo para conectar ao IDE.

Essas instruções de instalação também se aplicam a forks do VS Code como Cursor e Windsurf.

JetBrains IDEs

Instale o plugin Claude Code do marketplace e reinicie seu IDE.

O plugin também pode ser auto-instalado quando você executa claude no terminal integrado. O IDE deve ser reiniciado completamente para fazer efeito.

Limitações de Desenvolvimento Remoto: Ao usar JetBrains Remote Development, você deve instalar o plugin no host remoto via Settings > Plugin (Host).

Configuração

Ambas as integrações funcionam com o sistema de configuração do Claude Code. Para habilitar recursos específicos do IDE:

  1. Conecte Claude Code ao seu IDE executando claude no terminal integrado
  2. Execute o comando /config
  3. Defina a ferramenta de diff como auto para detecção automática do IDE
  4. Claude Code usará automaticamente o visualizador apropriado baseado no seu IDE

Se você estiver usando um terminal externo (não o terminal integrado do IDE), você ainda pode conectar ao seu IDE usando o comando /ide após lançar Claude Code. Isso permite que você se beneficie dos recursos de integração do IDE mesmo quando executando Claude de uma aplicação de terminal separada. Isso funciona tanto para VS Code quanto JetBrains IDEs.

Ao usar um terminal externo, para garantir que Claude tenha acesso padrão aos mesmos arquivos que seu IDE, inicie Claude do mesmo diretório que a raiz do projeto do seu IDE.

Solução de Problemas

Extensão do VS Code não está instalando

  • Certifique-se de que você está executando Claude Code do terminal integrado do VS Code
  • Certifique-se de que o CLI correspondente ao seu IDE está instalado:
    • Para VS Code: comando code deve estar disponível
    • Para Cursor: comando cursor deve estar disponível
    • Para Windsurf: comando windsurf deve estar disponível
    • Se não estiver instalado, use Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux) e procure por “Shell Command: Install ‘code’ command in PATH” (ou o equivalente para seu IDE)
  • Verifique se o VS Code tem permissão para instalar extensões

Plugin JetBrains não está funcionando

  • Certifique-se de que você 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 várias vezes
  • Para JetBrains Remote Development, certifique-se de que o plugin Claude Code está instalado no host remoto e não localmente no cliente

Para ajuda adicional, consulte nosso guia de solução de problemas ou entre em contato com o suporte.