</> Webp Design
Guia de instalação

Instalação do Claude Code passo a passo.

Do computador limpo até o terminal funcionando de verdade, em cerca de 15 minutos. Guia genérico: serve para qualquer projeto que você vai operar com o Claude Code.

Passo 01

Baixar o Claude Code

É o aplicativo de desktop que você vai usar todo dia. Parecido com um WhatsApp: você conversa e a IA executa o trabalho no seu computador.

Download oficial (Windows)

Baixar Claude Code para Windows

Se o botão não abrir, copie o endereço direto no navegador: claude.ai/download

Como instalar (passo a passo)

Baixe o instalador

O arquivo ClaudeSetup.exe vai para sua pasta Downloads (cerca de 150 MB).

Dê duplo clique no arquivo

O Windows pode mostrar um aviso azul do SmartScreen. Clique em “Mais informações” e depois “Executar mesmo assim”. É seguro, é da Anthropic, empresa da IA Claude.

Aceite os termos e clique em Instalar

Instalação leva cerca de 1 minuto. Nada para mexer.

Abra o Claude Code

Aparece atalho no Menu Iniciar e na área de trabalho. Abra pela primeira vez.

Por que instalar isso? É a “cabine de comando” onde a IA vive na sua máquina, executa tarefas e conversa com você diretamente pelo terminal ou pelo app.

Passo 02

Criar conta Claude (Anthropic)

Se ainda não tem, crie agora, leva 2 minutos. Se já tem, pule para o passo 3.

Criar conta grátis

Endereço direto: claude.ai/signup

Clique em “Continue with Google”

É a forma mais rápida. Se preferir e-mail, também tem opção.

Confirme nome e telefone

A Anthropic pede número para confirmar via SMS. Insira e valide o código.

Aceite os termos

Marque os checkboxes e clique em “Continue”.

Ative o plano Claude Pro (recomendado)

A conta grátis funciona para testar, mas tem limite diário de mensagens. Para trabalhar o dia inteiro sem travar, ative o Claude Pro (US$ 20/mês).

Ativar plano Pro

Endereço direto: claude.ai/upgrade

Vale a pena o Pro? Sim. No plano grátis você chega a poucas mensagens longas por hora e trava. No Pro, roda o dia todo sem se preocupar.

Passo 03

Fazer login no Claude Code

Volte ao aplicativo Claude Code que você instalou no passo 1.

Clique em “Sign in with Claude”

Vai abrir uma janela do navegador pedindo autorização.

Confirme sua conta

Se já estiver logado no site claude.ai, basta clicar em “Authorize”. Se não, faça login primeiro.

Volte ao Claude Code

Aparece “You are logged in as…” e um botão para começar. Pronto.

Não precisa refazer login toda vez. Depois de logado, o app abre direto. Só refaz se você trocar de máquina ou fizer logout manual.

Passo 04

Instalar o Python

Vários fluxos de automação rodam scripts em Python. Instale caso o seu projeto use algum. Instalação padrão, 2 minutos.

Baixar Python (site oficial)

Endereço direto: python.org/downloads

No site oficial, clique no botão amarelo grande “Download Python 3.XX.X” (versão mais recente).

Instalação (etapa muito importante)

Dê duplo clique no instalador baixado

Nome parecido com python-3.12.5-amd64.exe.

Marque a caixa “Add python.exe to PATH”

A caixinha fica embaixo, na primeira tela do instalador. Se você não marcar, nada vai funcionar. Depois clique em “Install Now”.

Aguarde a barra de progresso

Leva 1 a 2 minutos. Não feche o instalador.

Clique em “Close”

Vai aparecer “Setup was successful”. Feche o instalador.

Esqueceu de marcar “Add to PATH”? Desinstale o Python (Painel de Controle, Programas, Desinstalar) e instale de novo marcando a caixa. É a única forma de corrigir.

Passo 05

Verificar se o Python instalou certo

Teste rápido para confirmar.

Abra o PowerShell

Aperte a tecla Windows, digite powershell, pressione Enter. Vai abrir uma janela preta.

Digite o comando e pressione Enter

Cole exatamente: python --version e pressione Enter.

Se apareceu isso:

PS C:\Users\voce> python –version
Python 3.12.5

Deu certo! Pode fechar o PowerShell e seguir.

Se apareceu erro do tipo “não foi encontrado” ou “não é reconhecido como comando”:

Reinstale o Python marcando a caixa “Add python.exe to PATH” na primeira tela do instalador. É a solução única para esse erro.

Passo 06

Criar a pasta do seu projeto

Um lugar organizado para guardar os arquivos que o Claude Code vai criar e usar.

Abra o Explorador de Arquivos

Clique no ícone da pastinha na barra de tarefas, ou aperte Windows + E.

Vá em Documentos

No menu lateral esquerdo, clique em “Documentos”.

Crie uma nova pasta com o nome do seu projeto

Botão direito no espaço vazio, “Novo”, “Pasta”. Dê um nome claro, por exemplo Meu Projeto.

Entre na pasta

Duplo clique nela. É aqui que você vai abrir o Claude Code daqui para frente, sempre nessa mesma pasta.

Não precisa criar mais nada manualmente. O Claude Code cria os arquivos que forem necessários sozinho, na primeira sessão dentro dessa pasta. Você só criou o “endereço” de trabalho.

Passo 07

Fazer o terminal reconhecer o Claude

Essa etapa costuma ficar de fora de outros guias. É o que faz o comando claude funcionar direto no terminal, além do app de desktop.

Instalar o Node.js

Baixar Node.js (site oficial)

Endereço direto: nodejs.org. Clique no botão verde que diz LTS (versão recomendada).

Dê duplo clique no instalador baixado

Nome parecido com node-v20.XX.X-x64.msi.

Siga clicando em “Next” em todas as telas

Pode deixar tudo no padrão, não precisa marcar nem desmarcar nada.

Clique em “Install” e depois “Finish”

Leva 1 a 2 minutos.

Instalar o comando “claude” no terminal

Abra um PowerShell NOVO

Se já tinha um terminal aberto de antes de instalar o Node, feche ele. Um terminal aberto antes não reconhece programa novo instalado.

Cole o comando abaixo e aperte Enter

Ele baixa e instala o Claude Code direto pelo terminal, usando o Node que você acabou de instalar.

PS C:\Users\voce> npm install -g @anthropic-ai/claude-code

Aguarde terminar. Vão passar várias linhas na tela, pode levar 1 a 2 minutos. Depois feche essa janela do PowerShell e abra outra nova.

Apareceu um erro falando em “execução de scripts foi desabilitada” ou “PSSecurityException”? É uma trava de segurança padrão do Windows, não é erro de instalação. Resolve assim:

Abra um PowerShell como Administrador

Botão direito no ícone do PowerShell, “Executar como administrador”.

Cole o comando abaixo e aperte Enter

Confirme digitando S se ele perguntar.

PS C:\Windows\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Feche essa janela de administrador, abra um PowerShell normal de novo e rode o comando npm install -g @anthropic-ai/claude-code outra vez.

Testar se funcionou

PS C:\Users\voce> claude –version
1.x.x (Claude Code)

Apareceu um número de versão? Funcionou. Agora digite claude sozinho e aperte Enter para abrir a primeira sessão. Vai pedir login, é só autorizar igual no app.

Deu erro “não é reconhecido como comando” com o claude? Feche TODAS as janelas de terminal abertas e abra uma nova. O PATH só atualiza em janela nova depois de instalar um programa.
Por que essa etapa importa? Vários scripts de automação conferem o próprio código antes de rodar (node --check). Sem o Node instalado e sem o comando claude reconhecido no terminal, essas checagens nunca rodam, mesmo com o Python certinho.

Passo 08

Instalação completa. E agora?

Se você chegou até aqui, está tudo pronto:

Pronto para usar

Abra o Claude Code dentro da pasta do seu projeto

Digite claude no terminal, dentro da pasta que você criou no Passo 06, e comece a primeira sessão.

Qualquer dúvida técnica sobre esse processo, fale com a Webp Design.

</> Webp Design
Guia de instalação do Claude Code · uso interno e para clientes/parceiros