Extensão Claude Code para VS Code

Problema: Cada sessão de Claude Code significa mais um painel. Andas a saltar entre o editor e um terminal, a copiar caminhos de ficheiros à mão, e a perder o fio da meada sempre que mudas de janela.

Ganho Rápido: Traz tudo para dentro do editor. Carrega Ctrl+Shift+X para abrir as Extensões, escreve "Claude Code", e escolhe a build oficial da Anthropic (2M+ instalações, publicador verificado).

Toca no ícone Spark na barra lateral e uma sessão de Claude Code abre ao lado dos teus ficheiros. Prompts, diffs e o editor ficam todos no mesmo painel a partir daqui. Mais de 2 milhões de developers já trabalham assim.

Por Que Usar Claude Code no VS Code

A extensão eleva todas as funcionalidades do terminal para o layout do IDE:

• Exploração autónoma: Claude lê, escreve e explora o teu codebase de forma independente
• Diffs em tempo real: Vê as alterações como diffs inline com botões de aceitar/rejeitar
• Subagentes: Corre tarefas de IA em paralelo para operações complexas em múltiplos ficheiros
• Slash commands personalizados: Acede a comandos CLI diretamente na extensão
• Suporte MCP: Usa servidores MCP para automação de browser e pesquisa
• Extended thinking: Liga a visibilidade do raciocínio do Claude para pensar mais profundamente
• Plan mode: Revê e edita os planos do Claude antes de aceitar alterações

O primeiro projeto que apontas para ele corre mais rápido porque Claude edita diretamente dentro do workspace, em vez de te passar patches para aplicares.

Instalar a Extensão Claude Code

Via VS Code Marketplace (recomendado):

1. Abre VS Code
2. Clica em Extensions (Ctrl+Shift+X)
3. Pesquisa "Claude Code"
4. Instala a extensão oficial da Anthropic (badge de publicador verificado)

Requisitos: VS Code 1.98.0+ e um dos seguintes:

• Subscrição Claude Pro ou Max
• Plano Team ou Enterprise
• Chave de API (pay-as-you-go)

Consulta o guia de instalação se alguma coisa parecer estranha. O mesmo pacote instala no Cursor, Windsurf e VSCodium também, não só no VS Code padrão.

Configurar a Tua Primeira Sessão

Carrega no botão Spark para abrir Claude Code dentro do VS Code. Utilizadores de Mac abrem uma nova conversa com Cmd+N, utilizadores de Windows carregam Ctrl+N.

Pede ao Claude para fazer algo real:

Create a React component with useState hook for a counter

Um diff ao vivo aparece no editor. Alarga a barra lateral e vês três camadas dentro dela:

1. Alterações destacadas que mostram o que Claude quer adicionar
2. Botões Aceitar/Rejeitar ao nível do diff
3. Pré-visualização do ficheiro antes de confirmar

Clica em aceitar. O código entra no teu workspace imediatamente.

Queres um ajuste? Diz-lhe:

Add a reset button to the counter

Claude apresenta um novo diff no mesmo ficheiro. Nada é aplicado até aprovares. O guia de configuração básica cobre o que mais podes ligar a partir daqui.

Opções de Configuração

Modo Extended Thinking

Liga o Extended Thinking no canto inferior direito da caixa de prompt e o raciocínio do Claude fica visível antes de qualquer edição acontecer. Útil quando estás a rastrear um bug numa lógica difícil de seguir.

Modo Auto-Accept

Auto-accept aplica alterações sem perguntar. Usa-o quando já construíste confiança suficiente num fluxo de trabalho para veres a implementação correr sem precisares de clicar em tudo.

Anexos de Ficheiros

Arrasta ficheiros diretamente para a janela de chat, ou usa @-mentions:

@readme.md explain this project structure
@src/components/Header.tsx refactor to TypeScript generics

O contexto do workspace já está carregado. Sem configuração extra.

Múltiplas Sessões

Cada pasta de workspace pode ter a sua própria sessão de Claude, que é exatamente o que os repos de microsserviços precisam. Cada uma mantém um contexto separado. Equipas que precisam de uma configuração estruturada multi-agente dentro do VS Code podem recorrer ao Code Kit do ClaudeFast. Inclui 18 agentes especializados que planeiam primeiro e depois executam, com sessões paralelas coordenadas por ti. O documento de fluxos de trabalho de agentes tem os padrões mais aprofundados.

Configuração do Terminal no VS Code

O terminal integrado do VS Code precisa de um pequeno ajuste antes de Shift+Enter funcionar como tecla de prompt multi-linha. Corre /terminal-setup dentro de qualquer sessão de Claude Code e o keybinding é configurado automaticamente. Zero edição manual.

Preferes Option+Enter? Em Settings, abre Profiles, depois Keys, e muda a tecla Option esquerda/direita para "Esc+".

O guia de configuração do terminal cobre todos os ajustes extra que valem a pena conhecer.

Keybindings Específicos do Windows

Dois padrões do Windows diferem dos atalhos do Mac:

• Alt+V para colar imagens (em vez de Ctrl+V, que está reservado para colar do clipboard)
• Meta+M para ciclar modos de permissão em versões mais antigas de Node.js (abaixo de 24.2.0 ou 22.17.0) sem suporte a VT mode

Ambos são padrões, e qualquer um pode ser reconfigurado no ficheiro de configuração de keybindings.

Controlar a Auto-Instalação da Extensão

Quando o CLI do Claude Code deteta que está a correr dentro do VS Code, a extensão instala-se sozinha. Bloqueia isso com uma variável de ambiente:

export CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1

Útil para instalações com políticas corporativas, perfis com restrições e pipelines que nunca precisam da extensão carregada.

Quando As Coisas Correm Mal

O guia de troubleshooting cobre mais caminhos de correção.

Enterprise: Fornecedores Terceiros

A encaminhar através de Amazon Bedrock ou Google Vertex AI? Adiciona isto ao settings.json:

{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "AWS_REGION": "us-east-2"
  }
}

Os prompts de login são silenciados com "claudeCode.disableLoginPrompt": true.

Agora Podes Programar com Claude no VS Code

• Claude Code de nível terminal está integrado no IDE
• O que vem a seguir: automação de browser através de extensões MCP
• Nível superior: orquestração de tarefas multi-passo com fluxos de trabalho de agentes
• Lado a lado: como a extensão se compara ao Cursor
• Afinar: comportamento do terminal e atalhos de teclado configurados ao teu gosto
• Aprofundar: a referência completa de settings para cada opção

A extensão recebe atualizações num ritmo constante. Ainda em beta por agora, por isso os relatórios de bugs vão para o GitHub.