Claude Code: Integração com VS Code e JetBrains
Última atualização: 2026-08-31
O Claude Code é fundamentalmente uma ferramenta CLI, mas pode rodar nos terminais do VS Code e JetBrains, e extensões proporcionam melhor integração.
📋 Pré-requisitos: Capítulo 4 - Primeiro Uso
1. O Que Você Vai Aprender
- Instalando a extensão do Claude Code no VS Code
- Usando o Claude Code em IDEs JetBrains
- Comparação modo integração IDE vs modo CLI
- Otimização de configuração do terminal
- Fluxos de trabalho multi-IDE
2. Integração com VS Code
(1) Instalar Extensão
# Método 1: Buscar no Marketplace de Extensões do VS Code
# Buscar "Claude Code" → Install
# Método 2: Instalar via linha de comando
code --install-extension anthropic.claude-code
# Método 3: No VS Code, Ctrl+Shift+X → Buscar Claude Code → Install
(2) Configuração da Extensão
// settings.json
{
"claude-code.apiKey": "sk-ant-api03-xxxxx",
"claude-code.model": "claude-sonnet-4-20250514",
"claude-code.autoApprove": "read-only",
"claude-code.terminalProfile": "claude"
}
(3) Métodos de Uso
| Método | Operação | Caso de Uso |
|---|---|---|
| Painel lateral | Clicar no ícone Claude | Interação visual |
| Terminal integrado | Digitar claude no terminal do VS Code |
Mesmo que CLI |
| Atalho de teclado | Ctrl+Shift+C |
Abrir painel rapidamente |
| Menu de contexto | Selecionar código → Ask Claude | Perguntas direcionadas |
▶ Exemplo 1: Fluxo de Trabalho no VS Code
# Alice usa Claude Code no VS Code
1. Abrir projeto
2. Pressionar Ctrl+` para abrir terminal
3. Digitar claude para iniciar
Ou
1. Clicar no ícone Claude na barra lateral
2. Digitar instruções no painel
3. Clicar nas alterações de arquivo para ver diff
4. Aceitar/Rejeitar alterações com um clique
3. Integração com JetBrains
(1) Instalar Plugin
# IDEs suportadas: IntelliJ IDEA, WebStorm, PyCharm, GoLand, etc.
Passos de instalação:
1. File → Settings → Plugins
2. Buscar "Claude Code"
3. Clicar Install
4. Reiniciar IDE
(2) Usando no Terminal do JetBrains
# O terminal integrado do JetBrains pode rodar Claude Code diretamente
# Barra inferior → Terminal → digitar claude
# Configurar terminal
# Settings → Tools → Terminal → Shell path
# Garantir que o terminal encontra o comando claude
which claude # Confirmar caminho
(3) Funcionalidades Específicas do JetBrains
| Funcionalidade | Descrição |
|---|---|
| Perguntas sobre código selecionado | Selecionar código → Clique direito → Ask Claude |
| Intentions | Alt+Enter → Ações sugeridas pelo Claude |
| Preview de diff | Visualizador de diff integrado para preview de alterações |
| Run Configuration | Configurar item de lançamento do Claude Code |
▶ Exemplo 2: Fluxo de Trabalho no JetBrains
# Bob usa Claude Code no IntelliJ IDEA
1. Abrir projeto Spring Boot
2. Painel Terminal inferior → claude
3. Digitar: "Add paginated query endpoint to UserController"
Claude Code:
→ Reading UserController.java
→ Reading UserRepository.java
→ Modifying UserController.java (adding pageable endpoint)
→ Modifying UserRepository.java (adding query method)
→ Running: mvn test
✅ All tests passed
4. Ver diff na IDE:
Clique duplo no arquivo alterado → Visualização diff integrada
Verde destaca código novo, vermelho destaca código deletado
4. Integração IDE vs CLI Puro
(1) Comparação de Funcionalidades
| Dimensão | CLI Puro | Extensão VS Code | Plugin JetBrains |
|---|---|---|---|
| Método de instalação | npm install global | Marketplace de extensões | Marketplace de plugins |
| Interface | Texto no terminal | Painel lateral | Terminal + Intentions |
| Visualização diff | git diff | Visualizador diff integrado | Visualizador diff integrado |
| Operações de arquivo | Modificação automática | Confirmação com um clique | Confirmação com um clique |
| Consciência de contexto | Especificação manual | Seleção de código | Seleção de código + Intentions |
| Desenvolvimento remoto | SSH direto | Remote SSH | Remote SSH |
| Gerenciamento de config | Variáveis de ambiente | settings.json | Configurações da IDE |
(2) Recomendações de Escolha
| Cenário | Recomendado | Motivo |
|---|---|---|
| Servidor remoto | CLI Puro | Sem necessidade de GUI, SSH direto |
| Desenvolvimento diário | Extensão IDE | Experiência integrada melhor |
| CI/CD | CLI Puro | Scripts de automação |
| Alternância multi-projeto | CLI Puro | Troca de diretório flexível |
| Colaboração em equipe | Extensão IDE | Curva de aprendizado menor |
5. Otimização de Configuração do Terminal
▶ Exemplo 3: Otimizando a Experiência do Terminal com Claude Code
# 1. Configurar aliases do shell
echo 'alias cc="claude"' >> ~/.zshrc
echo 'alias ccr="claude --resume"' >> ~/.zshrc
# 2. Configurar suporte a cores no terminal
export TERM=xterm-256color
# 3. Config do terminal VS Code (settings.json)
{
"terminal.integrated.shell.linux": "/bin/zsh",
"terminal.integrated.env.linux": {
"ANTHROPIC_API_KEY": "sk-ant-api03-xxxxx"
}
}
# 4. Config do terminal JetBrains
# Settings → Tools → Terminal → Add environment variable
# ANTHROPIC_API_KEY=sk-ant-api03-xxxxx
6. Exemplo Completo: Colaboração Multi-IDE
# A equipe da Alice usa colaboração multi-IDE
Membro A (VS Code + projeto frontend):
→ Iniciar Claude Code pela barra lateral do VS Code
→ Pedir ao Claude Code para refatorar componentes React
→ Usar diff integrado para confirmar alterações
Membro B (IntelliJ + projeto backend):
→ Iniciar Claude Code pelo terminal da IDE
→ Pedir ao Claude Code para adicionar REST API
→ Usar Intentions para operações rápidas
Pipeline CI/CD:
→ Modo CLI puro
→ claude --headless "Run code review"
→ Verificações e correções automatizadas
❓ Perguntas Frequentes
P: Posso usar a extensão VS Code e o CLI simultaneamente? R: Sim, mas não é recomendado operar os mesmos arquivos simultaneamente. Ambos compartilham a mesma API Key e configuração de modelo.
P: Quais IDEs JetBrains o plugin suporta? R: Todas as IDEs JetBrains: IntelliJ IDEA, WebStorm, PyCharm, GoLand, RubyMine, PhpStorm, etc.
P: Qual a diferença se eu usar apenas o terminal sem a extensão? R: A funcionalidade central é idêntica. Extensões apenas proporcionam melhor experiência de UI (visualização diff, confirmação com um clique, etc.), não afetando as capacidades do Claude Code.
P: Como usar para desenvolvimento remoto? R: Após VS Code Remote SSH conectar ao servidor, instale o Claude Code no terminal remoto. O mesmo para JetBrains.
P: Extensões atualizam automaticamente? R: Sim. Tanto VS Code quanto JetBrains têm mecanismos de atualização automática. CLI requer
npm update -gmanual.
P: Qual integração de IDE é melhor? R: A extensão VS Code tem a maior integração (painel lateral, atalhos, visualização diff), JetBrains em segundo, CLI puro mais flexível.
📖 Resumo
- Tanto VS Code quanto JetBrains têm extensões/plugins do Claude Code
- Extensões proporcionam melhor experiência de UI, mas funcionalidade central é igual ao CLI
- CLI puro se adequa a cenários de servidor e CI/CD
- Seleção de código para perguntas diretas é a maior vantagem da integração IDE
- Otimização de configuração do terminal melhora a experiência diária
📝 Exercícios
- Básico (⭐): Instale a extensão do Claude Code no seu VS Code ou IDE JetBrains, confirme que inicia normalmente.
- Intermediário (⭐⭐): Complete a mesma tarefa usando CLI puro e extensão IDE, compare diferenças de experiência.
- Avançado (⭐⭐⭐): Configure VS Code Remote SSH + Claude Code para programação assistida por IA em servidor remoto.