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

​
IDEs suportados

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

  • Visual Studio Code (incluindo forks populares como Cursor e Windsurf)
  • IDEs JetBrains (incluindo PyCharm, WebStorm, IntelliJ e GoLand)

​
Recursos

  • Inicialização rápida: Use Cmd+Esc (Mac) ou Ctrl+Esc (Windows/Linux) para abrir o Claude Code diretamente do seu editor, ou clique no botão Claude Code na interface
  • 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 o Claude Code
  • Compartilhamento de diagnósticos: Erros de diagnóstico (lint, sintaxe, etc.) do IDE são automaticamente compartilhados com o Claude enquanto você trabalha
  • Atalhos para referência de arquivos: Use Cmd+Option+K (Mac) ou Alt+Ctrl+K (Linux/Windows) para inserir referências de arquivos (por exemplo, @File#L1-99)

​
Instalação

​
VS Code

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

A partir de agora, você também pode usar o comando /ide em qualquer terminal externo para se conectar ao IDE.

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

​
IDEs JetBrains

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

O plugin também pode ser instalado automaticamente quando você executa claude no terminal integrado. O IDE deve ser completamente reiniciado para que as alterações entrem em vigor.

Limitações de Desenvolvimento Remoto: Ao usar o Desenvolvimento Remoto JetBrains, você deve instalar o plugin e executar claude no host remoto.

​
Configuração

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

  1. Execute /config no Claude Code
  2. Defina a ferramenta de diff como auto para detecção automática do IDE
  3. O Claude Code usará automaticamente o visualizador apropriado com base no seu IDE

Se você estiver usando um terminal externo (não o terminal integrado do IDE), ainda poderá se conectar ao seu IDE usando o comando /ide após iniciar o Claude Code. Isso permite que você se beneficie dos recursos de integração do IDE mesmo ao executar o Claude a partir de um aplicativo de terminal separado. Isso funciona tanto para o VS Code quanto para os IDEs JetBrains.

Ao usar um terminal externo, para garantir que o Claude tenha acesso padrão aos mesmos arquivos que seu IDE, inicie o Claude a partir 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 estar executando o Claude Code a partir do terminal integrado do VS Code
  • Certifique-se de que a CLI correspondente ao seu IDE esteja instalada:
    • Para VS Code: o comando code deve estar disponível
    • Para Cursor: o comando cursor deve estar disponível
    • Para Windsurf: o 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 estar executando o Claude Code a partir do diretório raiz do projeto
  • Verifique se o plugin JetBrains está habilitado nas configurações do IDE
  • Reinicie completamente o IDE. Pode ser necessário fazer isso várias vezes
  • Para Desenvolvimento Remoto JetBrains, certifique-se de que o plugin Claude Code esteja 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.