Claude Code funciona muito bem com qualquer Ambiente de Desenvolvimento Integrado (IDE) que tenha um terminal. Apenas execute claude, e você estará pronto para começar.

Além disso, Claude Code fornece integrações dedicadas para IDEs populares, que oferecem recursos como visualização interativa de diff, compartilhamento de contexto de seleção e muito mais. Essas integrações atualmente existem para:

  • Visual Studio Code (incluindo forks populares como Cursor, Windsurf e VSCodium)
  • JetBrains IDEs (incluindo IntelliJ, PyCharm, Android Studio, WebStorm, PhpStorm 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 interface
  • Visualização de diff: Mudanças 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

Para instalar Claude Code no VS Code e forks populares como Cursor, Windsurf e VSCodium:

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

​
Uso

​
Do seu IDE

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

​
De terminais externos

Use o comando /ide em qualquer terminal externo para conectar Claude Code ao seu IDE e ativar todos os recursos.

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

Integrações de IDE funcionam com o sistema de configuração do Claude Code:

  1. Execute claude
  2. Digite o comando /config
  3. Ajuste suas preferências. Definir a ferramenta de diff como auto habilitará a detecção automática do IDE

​
Configurações do plugin JetBrains

Você pode configurar as configurações do plugin Claude Code indo para Settings → Tools → Claude Code [Beta]. Aqui estão as configurações disponíveis:

​
Configurações Gerais

  • Comando Claude: Especifique um comando personalizado para executar Claude (ex., claude, /usr/local/bin/claude, ou npx @anthropic/claude) ao clicar no ícone 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 (apenas macOS): Quando habilitado, Option+Enter insere novas linhas em prompts Claude Code. Desabilite isso se você 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: Você pode achar útil definir 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 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 Claude Code.

​
Solução de Problemas

​
Extensão VS Code não 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
    • Para VSCodium: comando codium deve estar disponível
    • Se não 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 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

Se você está usando WSL ou WSL2 e o IDE não é detectado, veja nosso guia de solução de problemas WSL2 para configuração de rede e configurações de firewall.

Para ajuda adicional, consulte nosso guia de solução de problemas.

​
Segurança

Quando Claude Code executa em um IDE 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 um IDE, considere habilitar recursos de segurança do IDE (como VS Code Restricted Mode), usar modo de aprovação manual para edições, ou ter cuidado extra para garantir que Claude seja usado apenas com prompts confiáveis.