Resumo rápido: Instalar o Claude Code no Windows requer a configuração do WSL2 (Subsistema do Windows para Linux), a instalação do Ubuntu e a execução de um script de instalação simples. O processo permite que usuários do Windows acessem o assistente de codificação de IA da Anthropic através de seu terminal. Binários nativos para Windows estão disponíveis, no entanto, o WSL2 ainda é a melhor prática para instalação no Windows.
O Claude Code é um assistente de codificação com IA que opera diretamente no terminal, ajudando desenvolvedores a criar funcionalidades, corrigir bugs e automatizar tarefas de desenvolvimento. Mas há um porém para usuários do Windows.
O Claude Code está disponível como um executável nativo para Windows e pode ser instalado via npm ou download direto de binário sem WSL2. No entanto, ele requer o Subsistema do Windows para Linux (WSL2), e o método de instalação oficial ainda depende do WSL2.
Veja como fazê-lo funcionar no Windows 11 ou Windows 10.
Requisitos do Sistema
Antes de iniciar a instalação, verifique se a máquina Windows atende a estes requisitos:
- Windows 10 1809+ ou Windows Server 2019+
- Windows 11 (qualquer versão)
- Pelo menos 4 GB de RAM disponível
- Privilégios administrativos no sistema
- Conexão com a Internet para download do WSL2 e Ubuntu
A instalação requer espaço em disco para o WSL2, Ubuntu e Claude Code.
Etapa 1: Habilitar o Subsistema do Windows para Linux
O WSL2 fornece um ambiente Linux diretamente no Windows. É a base que permite que o Claude Code funcione.
Abra o PowerShell como Administrador. Clique com o botão direito do mouse no botão Iniciar e selecione "Windows PowerShell (Admin)" ou "Terminal (Admin)" no Windows 11.
Execute este comando:
wsl --install
Este comando ativa os recursos necessários do Windows e instala o Ubuntu como a distribuição Linux padrão. O sistema provavelmente solicitará uma reinicialização.
Após a reinicialização, o WSL2 conclui a configuração automaticamente. O Ubuntu é iniciado e solicita um nome de usuário e senha. Essas credenciais são apenas para o ambiente Linux — elas não precisam corresponder às credenciais do Windows.
Etapa 2: Verificar a Instalação do WSL2
Depois que o sistema reiniciar e o Ubuntu concluir sua configuração inicial, verifique se o WSL2 está funcionando corretamente.
Abra o terminal do Ubuntu (pesquise por "Ubuntu" no menu Iniciar) e execute:
wsl --version
Isso exibe as informações da versão do WSL. Procure por "WSL version: 2.x.x" na saída.
Se o comando mostrar WSL1 em vez disso, atualize para WSL2 com:
wsl --set-default-version 2
Etapa 3: Instalar o Claude Code
Agora para a instalação real do Claude Code. A documentação oficial fornece um script de instalação de linha única.
No terminal do Ubuntu, execute:
curl -fsSL claude.ai/install.sh | bash
O script baixa o binário do Claude Code, configura as permissões necessárias e o adiciona ao PATH do sistema. A duração da instalação varia dependendo da velocidade da Internet e das especificações do sistema.
De acordo com a documentação oficial do Claude Code, o instalador detecta automaticamente a arquitetura do sistema e baixa a versão binária apropriada.
Problemas Comuns de Instalação
Alguns usuários do Windows relatam ver "command not found: claude" após a instalação. Isso geralmente acontece porque a variável PATH não foi atualizada.
Feche e reabra o terminal do Ubuntu, depois tente novamente. Se o problema persistir, esta configuração de caminho pode ajudar como uma solução alternativa não oficial:
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Etapa 4: Autenticar o Claude Code
O Claude Code requer autenticação com uma conta Anthropic antes do uso.
Execute este comando:
claude
O terminal exibe uma URL e solicita autenticação. O processo varia ligeiramente para usuários individuais em comparação com contas de equipe:
| Tipo de Conta | Método de Autenticação | O que é Necessário |
|---|---|---|
| Individual | Chave de API pessoal | Conta Anthropic com acesso à API |
| Equipe/Organização | Token da Organização | Token de autenticação fornecido pelo administrador |
Abra a URL fornecida em um navegador, faça login na conta Anthropic e autorize o Claude Code. O terminal confirma a autenticação bem-sucedida.
Trabalhando com Projetos Windows no WSL2
É aqui que as coisas ficam complicadas. Os sistemas de arquivos do Windows e do WSL2 são separados.
Os arquivos do Windows são acessíveis a partir do WSL2 em /mnt/c/ (para a unidade C:), /mnt/d/ (para a unidade D:), e assim por diante. Mas há um custo de desempenho. Discussões da comunidade indicam diferenças de desempenho entre diretórios montados no Windows e diretórios nativos do WSL2.
Para melhor desempenho, copie os arquivos do projeto para o diretório inicial do WSL2:
cp -r /mnt/c/Users/SeuNome/Projetos/seu-projeto ~/projetos/seu-projeto
A contrapartida? A integração com IDE se torna mais complexa. O Visual Studio Code lida bem com isso com sua extensão Remote-WSL, mas outros IDEs podem ter dificuldades.
Testando a Instalação
Verifique se o Claude Code funciona corretamente com um teste simples.
Navegue até um diretório de projeto (ou crie uma pasta de teste):
mkdir ~/claude-test
cd ~/claude-test
claude "crie um script Python simples de hello world"
O Claude Code deve responder, criar o arquivo e exibir o código. Isso confirma que a instalação foi bem-sucedida.
Pare de Pagar Mais, Reivindique os Créditos de IA Disponíveis Primeiro
Instalar o Claude Code no Windows geralmente é rápido. O custo real aparece depois, quando os desenvolvedores começam a testar prompts, executar scripts e integrar o modelo em aplicativos. Essa fase de experimentação pode gerar muitas chamadas de API, e muitas equipes só percebem o custo depois que começam a construir.
Antes de gastar dinheiro com uso, vale a pena verificar se você se qualifica para créditos de IA ou programas de parceria. Get AI Perks coleta essas oportunidades em um só lugar, listando créditos e descontos de provedores de IA, plataformas de nuvem e ferramentas para desenvolvedores, juntamente com instruções simples sobre como reivindicá-los.
Antes de executar seu primeiro projeto Claude Code, verifique Get AI Perks e reivindique os créditos de IA que podem cobrir seus custos de desenvolvimento.
Perguntas Frequentes
O Claude Code pode ser executado nativamente no Windows sem WSL2?
Sim, mas o WSL2 ainda permanece o melhor método de instalação para Windows.
O Claude Code funciona com o Windows Terminal?
Sim. O Windows Terminal pode abrir abas do Ubuntu, permitindo o acesso ao Claude Code sem alternar para uma janela separada do Ubuntu. No Windows Terminal, clique na seta suspensa e selecione Ubuntu na lista de perfis.
Minhas ferramentas de desenvolvimento Windows existentes funcionarão com o Claude Code?
Depende da ferramenta. O Visual Studio Code se integra bem através da extensão Remote-WSL. IDEs JetBrains e outras ferramentas podem exigir configuração adicional. A documentação oficial menciona VS Code e JetBrains como plataformas suportadas.
Como atualizo o Claude Code no Windows?
O Claude Code atualiza automaticamente por padrão. Para atualizar manualmente, execute `claude update` no terminal do Ubuntu. O recurso de atualização automática pode ser desabilitado através de arquivos de configuração, se necessário para ambientes corporativos.
Qual é a diferença entre Claude Code e a API Claude?
O Claude Code é um assistente de codificação baseado em terminal que executa comandos e edita arquivos. A API Claude fornece acesso programático ao modelo de linguagem do Claude para construir aplicações personalizadas. Eles atendem a propósitos diferentes e requerem processos de configuração diferentes.
Posso usar o Claude Code com projetos .NET no Windows?
Sim, mas com ressalvas. Discussões da comunidade indicam que o suporte ao SDK .NET no WSL2 funciona, mas requer a instalação da versão Linux do SDK .NET dentro do Ubuntu. O .NET instalado no Windows não será acessível a partir do WSL2.
Quanto custa o Claude Code?
O preço depende do uso e do tipo de conta. Verifique o site oficial da Anthropic para os níveis de preços atuais e planos de equipe, pois os custos variam com base no consumo da API e nos requisitos da organização.
Próximos Passos Após a Instalação
Com o Claude Code instalado, comece a explorar suas capacidades. A documentação de início rápido recomenda começar com tarefas simples, como explicações de código, antes de passar para operações mais complexas.
Tente estes comandos para se familiarizar:
- claude "explique esta função" -- Obtenha explicações de código
- claude commit -- Gere mensagens de commit do Git
- claude -c -- Continue a conversa mais recente
A documentação oficial fornece guias detalhados para integração com IDEs, instalação de plugins e opções de configuração avançada. Para equipes, configurações gerenciadas por servidor e rastreamento de análises oferecem controle adicional sobre as implantações do Claude Code.
A configuração do WSL2 pode parecer etapas extras em comparação com aplicações nativas do Windows, mas é atualmente o único caminho para executar o Claude Code no Windows. A boa notícia? Uma vez configurado, ele funciona sem problemas e se integra à maioria dos fluxos de trabalho de desenvolvimento.
