Adicionar Claude Code ao seu IDE
Aprenda como adicionar Claude Code ao seu IDE favorito
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) ouCtrl+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) ouAlt+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
- Abra o VSCode
- Abra o terminal integrado
- 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:
- Conecte Claude Code ao seu IDE executando
claude
no terminal integrado - Execute o comando
/config
- Defina a ferramenta de diff como
auto
para detecção automática do IDE - 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) ouCtrl+Shift+P
(Windows/Linux) e procure por “Shell Command: Install ‘code’ command in PATH” (ou o equivalente para seu IDE)
- Para VS Code: comando
- 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.