Por onde eu começo? O que preciso instalar?

Escrito por

em

Você não precisa saber programar. Basta um computador com Windows 10 (1809+), macOS 13+ ou Linux, 4 GB de RAM e internet. A instalação é um único comando colado no terminal, sem instalador separado, seguido de login com uma conta paga da Anthropic — Pro, Max, Team ou Console. Dando certo de primeira, leva menos de 5 minutos.

Se você chegou até aqui já decidiu tentar, e a trava não é falta de vontade — é não saber o que abrir primeiro. Terminal, PowerShell, Node.js, WSL: são nomes que assustam quem nunca programou, mas nenhum deles exige curso prévio. O caminho abaixo é o que existe hoje, testado por quem instalou pela primeira vez.

Que sistema operacional e requisitos mínimos eu preciso ter?

Claude Code roda em Windows 10 1809+ (ou Windows Server 2019+), macOS 13.0+, Ubuntu 20.04+, Debian 10+ e Alpine Linux 3.19+. O hardware mínimo é modesto: 4 GB de RAM e processador x64 ou ARM64 — qualquer notebook comprado nos últimos anos serve.

RequisitoMínimo
Windows10, versão 1809, ou Windows Server 2019+
macOS13.0+
LinuxUbuntu 20.04+, Debian 10+, Alpine 3.19+
RAM4 GB ou mais
Processadorx64 ou ARM64
InternetObrigatória, conexão ativa
ShellBash, Zsh, PowerShell ou CMD

Não precisa de placa de vídeo, servidor dedicado nem plano de internet especial — é o mesmo computador que já roda um navegador com várias abas abertas.

Qual é o comando exato pra instalar no Windows, Mac ou Linux?

O método recomendado hoje é o instalador nativo: um único comando, sem precisar de Node.js. Ele muda conforme o terminal que você tem aberto — o erro mais comum é colar o comando errado no lugar errado.

  • macOS, Linux ou WSL (abra o Terminal):

`curl -fsSL https://claude.ai/install.sh | bash`

  • Windows, no PowerShell (o prompt mostra `PS C:\`):

`irm https://claude.ai/install.ps1 | iex`

  • Windows, no CMD (o prompt mostra só `C:\`, sem “PS”):

`curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`

Também dá para instalar via Homebrew (`brew install –cask claude-code`) no Mac ou WinGet (`winget install Anthropic.ClaudeCode`) no Windows. Depois de instalar, abra uma pasta de projeto e digite `claude` para começar.

Preciso instalar Node.js ou o Git for Windows antes de começar?

Não, se usar o instalador nativo — ele baixa um binário pronto e não depende do Node.js. Node.js só entra se você preferir instalar via `npm install -g @anthropic-ai/claude-code`, e nesse caminho a versão exigida é 22 ou superior.

O Git for Windows é diferente: ele é opcional, mas recomendado em Windows nativo. Sem ele, o Claude Code roda os comandos de terminal usando o PowerShell. Com ele instalado, passa a usar o Git Bash. Quem já usa WSL não precisa do Git for Windows — o Linux dentro do WSL já resolve isso sozinho.

Preciso saber programar pra usar o terminal?

Não. O terminal aqui funciona como uma caixa de conversa: você digita `claude`, descreve o que quer em português e ele executa. Não existe sintaxe de programação pra decorar nem comando de terminal pra memorizar além dos da instalação.

A curva real não é técnica, é de hábito: gente que nunca abriu um terminal de propósito estranha a tela preta nos primeiros minutos. Depois disso a interação vira conversa comum, do mesmo jeito que digitar num aplicativo de mensagem.

Que tipo de conta eu preciso ter pra fazer login?

Claude Code pede uma conta paga: Pro, Max, Team, Enterprise ou Console da Anthropic. O plano gratuito do Claude.ai não dá acesso. Depois de instalar, rodar `claude` abre o navegador pra você logar — ou, se a chave de API já estiver configurada, ele pede aprovação dela direto no terminal.

Brasil está na lista de países onde a Anthropic opera, então não existe bloqueio regional pra fazer essa conta. O valor de cada plano e o que cabe no bolso de quem está começando é assunto separado — vale a leitura completa antes de escolher o plano.

Onde a maioria trava na primeira instalação?

Cruzando a documentação oficial de erros com relatos de quem instalou pela primeira vez, os mesmos três tropeços se repetem, nessa ordem de frequência. Nenhum deles é falha do computador — são detalhes que ninguém avisa antes.

1. `comando não reconhecido` depois de instalar. O binário foi parar em `~/.local/bin` (ou `%USERPROFILE%\.local\bin` no Windows) e essa pasta não está no PATH do terminal, ou o terminal antigo continua aberto. Fechar e abrir um terminal novo resolve na maioria dos casos. 2. PowerShell bloqueia o script de instalação. A política de execução padrão do Windows recusa rodar scripts baixados da internet. É preciso liberar a execução pro usuário atual antes de tentar de novo. 3. Confusão entre PowerShell e CMD. Colar o comando do PowerShell dentro do CMD (ou o contrário) devolve um erro de sintaxe que não diz o que está errado — a pista é olhar se o prompt mostra `PS C:\` ou só `C:\`.

Como eu confirmo que a instalação deu certo?

Rode `claude –version` num terminal novo. Se aparecer um número de versão — algo como `2.1.211 (Claude Code)` — a instalação funcionou. Se aparecer erro de comando não encontrado, o problema quase sempre é o PATH descrito acima.

Pra um diagnóstico mais completo, rode `claude doctor`. Ele lê a instalação, as configurações e o resultado da última atualização, e aponta o que corrigir sem precisar abrir uma sessão de verdade.

Resumo: o caminho em 5 passos

1. Confira se seu Windows, Mac ou Linux bate com os requisitos mínimos da tabela acima. 2. Abra o terminal certo — PowerShell, CMD ou o terminal do Mac/Linux — e cole o comando correspondente. 3. Feche e abra um terminal novo antes de testar, mesmo se parecer que travou. 4. Rode `claude –version` pra confirmar, e `claude doctor` se algo parecer errado. 5. Entre com uma conta Pro, Max, Team ou Console — o login abre sozinho no navegador.

O que muda depois desse passo a passo: você deixa de ler sobre Claude Code e passa a ter ele aberto, esperando um pedido em português dentro de uma pasta de projeto sua.

Leia também: dá pra usar Claude Code sem saber programar?, é seguro usar IA com dado de cliente no meu negócio? e Claude Code ou n8n/Make: qual resolve automação de negócio?.

Fontes oficiais consultadas: requisitos de sistema e instalação, guia de solução de problemas de instalação e o guia de terminal pra quem nunca usou um.

Comentários

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *