Você quer usar Claude Code no seu PC Windows mas não sabe por onde começar? Este guia te mostra exatamente como instalar e configurar Claude Code no Windows 10 ou 11, mesmo que você nunca tenha aberto um terminal na vida. A instalação completa leva cerca de 10 minutos e não requer nenhum conhecimento técnico prévio. Você vai instalar Visual Studio Code, adicionar a extensão Claude Code, configurar seu acesso à API e criar seu primeiro projeto. Cada etapa é detalhada com capturas de tela e explicações simples para que você possa acompanhar sem se perder.

Quais são os pré-requisitos para instalar Claude Code no Windows?

Você precisa de três elementos antes de começar: Windows 10 ou 11 atualizado, 4 GB de RAM no mínimo e uma conexão de internet estável. Claude Code funciona em qualquer PC recente, não precisa de uma máquina super potente.

Aqui está a lista completa dos pré-requisitos:

  • Sistema operacional: Windows 10 (versão 1809 ou superior) ou Windows 11
  • Memória RAM: 4 GB no mínimo, 8 GB recomendados para conforto ideal
  • Espaço em disco: 500 MB para Visual Studio Code e a extensão
  • Conexão de internet: necessária para baixar as ferramentas e se comunicar com a API Claude
  • Direitos de administrador: necessários apenas para a instalação inicial

Não precisa de placa de vídeo potente ou processador de última geração. Claude Code funciona na nuvem via API da Anthropic, seu computador serve apenas como interface. Até um PC de mesa básico de 2018 funciona perfeitamente.

Se você usa Mac, consulte nosso guia de instalação para macOS que detalha as especificidades desse ambiente.

Como baixar e instalar Visual Studio Code?

Acesse code.visualstudio.com, baixe o instalador do Windows e execute-o aceitando as opções padrão. A instalação leva no máximo 2 a 3 minutos.

Aqui está o processo detalhado:

  1. Abra seu navegador e vá para code.visualstudio.com
  2. Clique no grande botão azul "Download for Windows"
  3. O arquivo VSCodeUserSetup-x64-1.XX.X.exe é baixado automaticamente
  4. Clique duas vezes no arquivo baixado na sua pasta Downloads
  5. Aceite os termos de uso e clique em "Próximo"
  6. Deixe o caminho de instalação padrão (C:\Users\SeuNome\AppData\Local\Programs\Microsoft VS Code)
  7. Importante: marque a caixa "Adicionar ao PATH" durante a instalação
  8. Marque também "Criar um ícone na Área de Trabalho" para acesso fácil
  9. Clique em "Instalar" e aguarde 2 minutos
  10. Desmarque "Iniciar Visual Studio Code" por enquanto e clique em "Concluir"

Visual Studio Code (VS Code em abreviado) é um editor de código gratuito desenvolvido pela Microsoft. É a ferramenta que os desenvolvedores usam para escrever código, mas você não precisa saber programar para usá-lo com Claude Code. Pense em VS Code como um Word especializado para código.

O tamanho do download é de cerca de 90 MB. Se seu antivírus pedir uma confirmação, aceite: VS Code é um software oficial e seguro, usado por mais de 20 milhões de desenvolvedores segundo as estatísticas da Microsoft.

Como instalar a extensão Claude Code no VS Code?

Abra VS Code, clique no ícone Extensões (quatro quadrados) na barra lateral esquerda, digite "Claude Code" na busca e clique em "Install". A extensão é instalada em alguns segundos.

Etapas detalhadas:

  1. Inicie Visual Studio Code pelo ícone na sua Área de Trabalho ou no menu Iniciar
  2. Localize a barra de ícones vertical no lado esquerdo da janela
  3. Clique no ícone que parece com quatro pequenos quadrados (é o gerenciador de extensões)
  4. Na barra de busca que aparece no topo, digite exatamente: Claude Code
  5. A extensão oficial aparece no primeiro resultado (verifique que é publicada pela Anthropic)
  6. Clique no botão azul "Install" à direita do nome
  7. Aguarde 10 a 15 segundos durante a instalação
  8. Uma mensagem de confirmação aparece no canto inferior direito: "Extensão instalada com sucesso"
  9. Um novo ícone Claude (um pequeno logo laranja) aparece na sua barra lateral esquerda

Se você não encontrar a extensão, verifique que digitou "Claude Code" e não apenas "Claude". Existem várias extensões relacionadas a Claude, mas a que nos interessa se chama exatamente "Claude Code" ou "Claude Dev" dependendo da versão.

A extensão pesa cerca de 15 MB e não deixa seu computador mais lento. Ela simplesmente adiciona uma interface no VS Code para se comunicar com Claude via API da Anthropic.

Como obter e configurar sua chave API Claude?

Acesse console.anthropic.com, crie uma conta gratuita, gere uma chave API nas configurações e cole-a no VS Code quando a extensão pedir. Essa chave permite que Claude Code se comunique com a inteligência artificial Claude.

Procedimento completo:

  1. Abra console.anthropic.com no seu navegador
  2. Clique em "Sign Up" no canto superior direito
  3. Crie uma conta com seu email (você recebe um email de confirmação para validar)
  4. Uma vez conectado, clique no seu nome no canto superior direito e depois em "API Keys"
  5. Clique no botão "Create Key" ou "Criar uma chave"
  6. Dê um nome à sua chave (por exemplo: "Claude Code Windows")
  7. Clique em "Create": sua chave aparece (começa com "sk-ant-")
  8. Crucial: copie imediatamente essa chave e salve-a em um arquivo de texto
  9. Você nunca mais poderá ver essa chave, se a perder terá que criar uma nova

Agora, configure a chave no VS Code:

  1. Volte para Visual Studio Code
  2. Clique no ícone Claude na barra lateral esquerda
  3. Uma janela pede sua chave API
  4. Cole a chave que você acabou de copiar (Ctrl+V)
  5. Pressione Enter para validar
  6. Uma mensagem confirma que a conexão funciona

A chave API é como uma senha que permite que seu computador converse com os servidores Claude. Anthropic oferece 5 dólares de crédito gratuito no cadastro, o que representa cerca de 200.000 palavras geradas por Claude segundo sua documentação oficial de preços. Mais que suficiente para seus primeiros projetos.

Atenção: nunca compartilhe sua chave API publicamente (no GitHub, Discord, etc.). Se alguém conseguir, pode usar seu crédito no seu lugar.

Como criar seu primeiro projeto com Claude Code?

Crie uma nova pasta na sua Área de Trabalho, abra-a no VS Code via Arquivo > Abrir pasta, depois inicie Claude Code e peça para ele criar uma página web simples. Em 30 segundos, você verá Claude escrevendo código para você.

Aqui está como fazer:

  1. Clique com o botão direito na sua Área de Trabalho do Windows
  2. Selecione "Novo > Pasta"
  3. Nomeie a pasta "meu-primeiro-projeto-claude"
  4. No VS Code, clique em "Arquivo" no menu no topo
  5. Selecione "Abrir pasta..."
  6. Navegue até sua Área de Trabalho e selecione a pasta que você acabou de criar
  7. Clique em "Selecionar Pasta"
  8. VS Code pode pedir se você confia nos autores: clique em "Sim, confio"
  9. Agora clique no ícone Claude na barra lateral esquerda
  10. Na caixa de texto na parte inferior, digite: "Crie para mim uma página web simples que exiba Olá mundo em um grande título"
  11. Pressione Enter

Claude então vai:

  • Criar automaticamente um arquivo index.html na sua pasta
  • Escrever o código HTML necessário
  • Te mostrar cada etapa do que está fazendo
  • Te oferecer uma prévia do resultado

Para ver sua página web, clique com o botão direito no arquivo index.html no explorador de arquivos à esquerda e selecione "Abrir no Explorador de Arquivos". Clique duas vezes no arquivo: ele abre no seu navegador.

Este primeiro teste mostra o poder de Claude Code: você descreve o que quer em português normal, e Claude escreve o código técnico para você. É exatamente esse princípio que ensinamos na Skilzy, onde você aprende a criar aplicações completas sem escrever uma linha de código você mesmo.

Se você quer ir além, descubra os 20 comandos essenciais que você pode dar a Claude Code para criar projetos mais complexos.

Quais são os problemas comuns e suas soluções?

Os três erros mais frequentes são: chave API inválida, problema de conexão de internet e conflito com antivírus. Cada um se resolve em alguns minutos.

Erro: "Invalid API Key"

Se você vê essa mensagem, sua chave API não está configurada corretamente. Soluções:

  • Verifique que você copiou a chave completa (deve começar com "sk-ant-")
  • Certifique-se de não ter adicionado espaço no início ou no final
  • Volte para console.anthropic.com e gere uma nova chave se necessário
  • No VS Code, clique no ícone de engrenagem no canto inferior esquerdo > Settings > Extensions > Claude Code > Edit API Key

Erro: "Connection timeout"

Claude Code não consegue alcançar os servidores da Anthropic. Verifique:

  • Sua conexão de internet funciona (abra um site para testar)
  • Seu firewall do Windows não está muito restritivo (Configurações > Atualização e segurança > Segurança do Windows > Firewall)
  • Adicione uma exceção para VS Code se necessário
  • Se você está em uma rede corporativa, ela pode bloquear o acesso à API

VS Code não inicia após a instalação

Casos raros onde VS Code se recusa a iniciar:

  • Reinicie seu computador (resolve 80% dos problemas)
  • Desinstale VS Code via Configurações > Aplicativos > Visual Studio Code > Desinstalar
  • Baixe a versão mais recente no site oficial
  • Reinstale como administrador (clique com o botão direito no instalador > Executar como administrador)

A extensão Claude Code não aparece

Se você não vê o ícone Claude após a instalação:

  • Feche completamente VS Code (Arquivo > Sair)
  • Abra VS Code novamente
  • Vá para Extensões e verifique que Claude Code está bem na lista "Instaladas"
  • Clique no pequeno ícone de recarregar ao lado da extensão se aparecer
  • Como último recurso, desinstale e reinstale a extensão

A comunidade Claude Code no Discord e os fóruns da Anthropic também são excelentes recursos se você encontrar um problema específico. Você também pode comparar com Cursor, uma alternativa que funciona de forma diferente e pode ser mais adequada para algumas configurações do Windows.

Conclusão

Você agora tem Claude Code funcionando no seu PC Windows. A instalação completa levou menos de 15 minutos: Visual Studio Code como base, a extensão Claude Code para a interface, sua chave API para acesso à inteligência artificial, e seu primeiro projeto para testar que tudo funciona. O próximo passo é explorar o que você pode criar com essa ferramenta: sites, aplicações, automações. Comece com projetos simples e aumente gradualmente a complexidade. Claude Code aprende com seus pedidos e melhora ao longo das conversas.

Na Skilzy, mostramos como transformar essa instalação em uma competência profissional. Nosso método de aprendizado te guia passo a passo para criar aplicações reais, mesmo que hoje você não saiba a diferença entre HTML e CSS. Consulte nosso tutorial completo para iniciantes para descobrir tudo que você pode realizar com Claude Code.