Como usar o Claude Code com o VS Code?

Nicolas, Apr 10, 2026

---

O Claude Code é o assistente de IA da Anthropic concebido para programadores. Disponível diretamente no VS Code através de uma extensão oficial, permite gerar, modificar, analisar e depurar código sem sair do editor. Desde 2025, a extensão nativa é o método recomendado para utilizar o Claude Code no VS Code — eis como instalá-la e tirar o máximo partido dela.

Pré-requisitos antes da instalação

Antes de instalar a extensão Claude Code, verifique os seguintes pontos:

• VS Code 1.98.0 ou superior — as versões anteriores não são compatíveis com a extensão
• Uma conta Anthropic — irá iniciar sessão quando abrir a extensão pela primeira vez. O Claude Code requer uma subscrição Claude Pro, Max, Team ou Enterprise
• Se utilizar o Amazon Bedrock ou o Google Vertex AI como fornecedor, é necessária uma configuração específica em settings.json

Instalar a extensão Claude Code

A instalação é feita diretamente no VS Code em apenas alguns segundos:

• Abra o VS Code e prima Ctrl+Shift+X (Windows/Linux) ou Cmd+Shift+X (Mac) para abrir o painel Extensões
• Procure "Claude Code" na barra de pesquisa
• Instale a extensão publicada pela Anthropic — verifique bem o editor para evitar extensões de terceiros não oficiais
• Se o ícone Spark não aparecer após a instalação, reinicie o VS Code ou execute "Developer: Reload Window" a partir da paleta de comandos

Bom saber: a extensão inclui automaticamente a CLI (interface de linha de comandos) do Claude Code. Não é necessário instalar a CLI separadamente — está acessível diretamente a partir do terminal integrado do VS Code para as funcionalidades avançadas.

Abrir o Claude Code no VS Code

Uma vez instalada a extensão, o ícone Spark (⚡) identifica o Claude Code em toda a interface do VS Code. Várias formas de aceder:

• Barra de ferramentas do editor: clique no ícone Spark no canto superior direito do editor — apenas visível quando um ficheiro está aberto
• Barra de atividade: clique no ícone Spark na barra lateral esquerda para abrir a lista de sessões. Sempre visível mesmo sem ficheiro aberto
• Paleta de comandos: Cmd+Shift+P / Ctrl+Shift+P, escreva "Claude Code" e escolha "Open in New Tab"
• Barra de estado: clique em ✱ Claude Code no canto inferior direito da janela

Ao abrir o painel pela primeira vez, aparece uma lista de verificação de integração guiada. Percorra cada etapa clicando em "Show me" ou ignore-a com o X.

Enviar o primeiro pedido

O Claude Code vê automaticamente o ficheiro atualmente aberto no editor. Para interagir:

• Selecione código no ficheiro — o Claude Code inclui automaticamente essa seleção no contexto do pedido
• Prima Option+K (Mac) / Alt+K (Windows/Linux) para inserir uma referência @ficheiro.ts#5-10 à sua seleção no prompt
• Escreva o seu pedido em linguagem natural: "Explica esta função", "Corrige este erro", "Adiciona testes unitários para esta classe"…

Quando o Claude Code propõe modificar um ficheiro, apresenta uma comparação diff lado a lado das alterações propostas antes de as aplicar. Pode aceitar, rejeitar ou solicitar ajustes.

Modos de permissão

O Claude Code oferece três modos de permissão acessíveis a partir da parte inferior da caixa de prompt:

O modo Plan é particularmente útil para alterações significativas: o Claude abre o plano como um documento Markdown onde pode adicionar comentários inline antes de começar a modificar o código.

Referenciar ficheiros com @-menções

Para fornecer contexto adicional ao Claude Code, utilize as @-menções no prompt:

• Escreva @ seguido do nome do ficheiro para o mencionar: @auth.ts
• Adicione um intervalo de linhas para apontar para uma secção específica: @auth.ts#10-25
• Mencione uma pasta inteira: @src/components/
• Utilize Option+K / Alt+K a partir de uma seleção para inserir automaticamente a referência

Gerir várias conversas

O VS Code permite abrir múltiplas sessões Claude Code simultaneamente — útil para trabalhar em paralelo em várias funcionalidades ou pastas de workspace:

• Cada sessão mantém o seu próprio contexto independente
• Abra uma nova conversa com Cmd+N (Mac) / Ctrl+N (Windows/Linux) a partir do painel Claude
• Aceda ao histórico de conversas a partir do ícone Spark na barra de atividade
• As sessões podem ser abertas como separadores ou janelas separadas conforme as suas preferências

Bom saber: se trabalha num projeto monorepo ou de microsserviços, cada pasta de workspace pode ter a sua própria sessão Claude Code com o seu próprio contexto. Para personalizar o comportamento do Claude no seu projeto, crie um ficheiro CLAUDE.md na raiz do repositório — o Claude Code irá lê-lo automaticamente para adaptar as respostas ao projeto, às convenções e às instruções específicas.

Utilizar a CLI a partir do terminal integrado

A extensão VS Code inclui a CLI do Claude Code, acessível a partir do terminal integrado do VS Code. A CLI oferece funcionalidades avançadas não disponíveis na interface gráfica:

• Execute claude no terminal integrado para iniciar uma sessão CLI
• Use claude -p "o seu prompt" para pedidos não interativos (modo print)
• O comando /terminal-setup numa sessão configura automaticamente o atalho Shift+Enter para prompts de múltiplas linhas
• Alterne entre a interface gráfica e a CLI através do menu de definições da extensão

Atalhos de teclado essenciais

Bom saber: o Claude Code para VS Code também funciona com Cursor, Windsurf e VSCodium — o procedimento de instalação é idêntico. Para equipas que utilizam o Amazon Bedrock ou o Google Vertex AI, adicione as variáveis de ambiente correspondentes no ficheiro settings.json do VS Code para configurar o fornecedor alternativo.