Instalar Claude Code no Mac e no Windows: passo a passo

Instalar Claude Code é simples: você abre o terminal, cola um único comando tirado da documentação oficial da Anthropic e faz login com a sua conta do Claude no navegador. No Mac leva poucos minutos; no Windows é o mesmo caminho, pelo PowerShell. Abaixo está o passo a passo para quem nunca abriu um terminal.

Para quem é este guia

Este guia é para quem já entendeu o que o Claude Code faz e quer colocar ele para rodar no próprio computador. Se você ainda está na dúvida se ele serve para o seu caso, comece pelo texto Claude Code para quem não programa, que explica o que dá para construir sem ser desenvolvedor.

Duas coisas antes de começar:

• Conta paga. A documentação oficial diz que o Claude Code pede uma assinatura paga do Claude (individual ou de equipe) ou uma conta do Console da Anthropic. O plano gratuito do chat não inclui o Claude Code. Os planos e valores mudam, então confira na página oficial antes de assinar. Se está decidindo isso agora, veja se o Claude Pro vale a pena para o seu uso.
• Sistema compatível. No momento em que escrevo (novembro de 2026), a página de instalação lista macOS 13 ou mais novo e Windows 10 versão 1809 ou mais novo, além de conexão com a internet. A lista completa de requisitos está na página de instalação do Claude Code.

O que é o terminal (e por que ele não é um bicho de sete cabeças)

O terminal nada mais é do que uma janela onde você escreve o pedido em vez de clicar num botão. Pense no atendimento por WhatsApp de uma loja: em vez de navegar pelo site, você manda uma mensagem e a resposta volta em texto. O terminal funciona igual com o seu computador.

Você não precisa decorar comando nenhum. Para instalar o Claude Code, você vai copiar e colar uma linha. Depois disso, conversa com ele em texto, do jeito que conversa com o Claude no navegador.

Como instalar o Claude Code no Mac

Qual é o primeiro passo? Abrir o terminal. O resto é colar, esperar e fazer login.

Passo 1: abra o Terminal

Aperte Cmd + Espaço para abrir a busca do Spotlight, digite Terminal e aperte Enter. Vai aparecer uma janela com um cursor piscando.

Passo 2: cole o comando de instalação

Copie a linha abaixo, cole no Terminal com Cmd + V e aperte Enter:

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

O comando baixa o instalador direto do site da Anthropic. Segundo a documentação, ele não mostra barra de progresso enquanto baixa. Deixe a janela aberta e espere até aparecer a mensagem de que o Claude Code foi instalado.

Passo 3: confira se instalou

Feche o Terminal, abra uma janela nova e digite:

claude --version

Se aparecer um número de versão, está instalado. Se aparecer command not found: claude, veja a tabela de erros mais abaixo.

Passo 4: abra o Claude Code e faça login

Digite claude e aperte Enter. O navegador abre pedindo para você entrar com a sua conta do Claude. Siga as instruções da tela e volte para o Terminal.

Quem já usa Homebrew também pode instalar por ele. A documentação avisa que, nesse caso, a atualização não é automática: você precisa atualizar por conta própria. Para quem está começando, o comando do passo 2 é o caminho mais simples.

Como instalar o Claude Code no Windows

No Windows o caminho é o mesmo, com uma diferença: existem dois programas de terminal, o PowerShell e o CMD, e cada um usa um comando diferente.

Passo 1: instale o Git para Windows (opcional)

A documentação recomenda instalar o Git para Windows. Ele dá ao Claude Code uma ferramenta extra para rodar comandos. Sem ele, o Claude Code funciona usando o próprio PowerShell. Você não precisa aprender Git para isso: no instalador, é só aceitar as opções padrão em todas as telas.

Passo 2: abra o PowerShell

Aperte Win + X e escolha Windows PowerShell ou Terminal. Para saber se você está no lugar certo, olhe o começo da linha: no PowerShell aparece PS C:\Users\SeuNome>; no CMD aparece só C:\Users\SeuNome>, sem o PS. Não precisa abrir como administrador.

Passo 3: cole o comando de instalação

No PowerShell, cole esta linha e aperte Enter:

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

Se você estiver no CMD, o comando é outro:

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

Também aqui não aparece barra de progresso. Espere a mensagem de conclusão.

Passo 4: confira e faça login

Abra uma janela nova do PowerShell, rode claude --version e depois claude. O navegador abre para o login, igual ao Mac.

Se você usa o WSL (o Linux dentro do Windows), a instalação é feita dentro do terminal do WSL com o comando do Mac e do Linux. Para a maioria das pessoas que estão começando, o PowerShell resolve.

Se der erro na instalação

A questão é que quase todo erro de instalação é um destes quatro, e a própria documentação explica cada um:

O que aparece	O que significa	O que fazer
command not found: claude (Mac) ou 'claude' is not recognized (Windows)	Instalou, mas o computador ainda não sabe onde o programa está (o chamado PATH)	Abra uma janela nova do terminal. Se continuar, siga a correção de PATH da página de solução de problemas
The token '&&' is not a valid statement separator	Você colou o comando do CMD dentro do PowerShell	Use o comando do PowerShell (irm ... | iex)
'irm' is not recognized	Você colou o comando do PowerShell dentro do CMD	Use o comando do CMD ou abra o PowerShell
Pedido de assinatura ou de upgrade no login	A conta não tem acesso ao Claude Code	Confira o plano na página oficial do Claude

Para um diagnóstico mais completo, rode claude doctor. Ele mostra a saúde da instalação e sugere correções, sem abrir uma sessão.

Prefere não usar o terminal? Existe o app

A Anthropic tem o app de desktop do Claude para Mac e Windows, com uma aba Code que roda o Claude Code com interface gráfica. Você escolhe uma pasta do computador, pede o que quer e revisa as mudanças clicando. O guia de início do app de desktop mostra onde baixar e como abrir a aba. A mesma exigência de plano pago vale ali.

Minha opinião: se você vai usar o Claude Code de vez em quando, o app é mais confortável. Se vai usar todo dia, vale perder o medo do terminal. Os dois fazem o mesmo trabalho, então teste e fique com o que você abre sem preguiça.

Primeiros minutos depois de instalar

Com tudo instalado, o próximo passo é organizar onde ele vai trabalhar. O Claude Code mexe nos arquivos da pasta em que você abre ele. Então:

1. Crie uma pasta de teste. Algo como teste-claude na área de trabalho. No terminal, entre nela antes de digitar claude.
2. Peça uma coisa pequena. Imagine uma planilha de orçamentos que você monta toda semana. Peça: "crie uma página simples com um formulário de orçamento com nome, serviço e valor". Veja o que ele faz e leia o que ele pergunta antes de aprovar.
3. Aprenda três atalhos. Segundo o guia oficial do terminal, Esc interrompe o Claude, /help mostra os comandos e exit fecha a sessão.

Quando quiser ir além, as skills ensinam o Claude Code a repetir um processo do seu jeito. Explico isso em como usar skills no Claude Code, e há uma lista organizada na página de skills para o Claude. Se você quer aprender a construir do pedido ao sistema funcionando, com ordem e sem pular etapas, a trilha Construindo com a IA da Academ.IA foi feita para isso.

Ressalvas antes de sair usando

• Só cole comando da fonte oficial. O comando de instalação baixa e roda um programa. Copie sempre da documentação da Anthropic, nunca de vídeo ou print de terceiros.
• Ele trabalha nos seus arquivos. Não abra o Claude Code na pasta de documentos do financeiro para "ver o que acontece". Comece numa pasta de teste.
• Leia antes de aprovar. O Claude Code pede permissão para várias ações. Se você aprovou sem ler, a responsabilidade é sua, não da IA.
• Atualização. Pelo instalador oficial, a documentação diz que ele se atualiza sozinho em segundo plano. Se quiser forçar, rode claude update.

Perguntas frequentes

Preciso saber programar para instalar o Claude Code?

Não. A instalação é copiar uma linha, colar no terminal e fazer login. Depois você conversa com ele em texto, descrevendo o que quer. Saber ler o que ele propõe antes de aprovar ajuda mais do que saber programar.

O Claude Code é gratuito?

Não. Segundo a documentação oficial, ele exige uma assinatura paga do Claude ou uma conta do Console da Anthropic, e o plano gratuito do chat não inclui o acesso. Confira os planos atuais na página oficial do Claude.

Como instalar o Claude Code no Windows sem o WSL?

Abra o PowerShell e rode irm https://claude.ai/install.ps1 | iex. O Claude Code roda direto no Windows. O Git para Windows é recomendado, mas opcional: sem ele, o Claude Code usa o PowerShell para executar comandos.

Instalei, mas o comando claude não funciona. E agora?

Feche o terminal e abra uma janela nova, porque o computador só reconhece o programa depois disso. Se ainda não funcionar, rode claude doctor ou siga a correção de PATH na página de solução de problemas da Anthropic.

Como desinstalar o Claude Code?

Depende de como você instalou. A página de instalação tem uma seção de desinstalação com os comandos para Mac, Windows, Homebrew e WinGet.

Próximo passo

Instalar é a parte fácil. O que separa quem usa o Claude Code de quem desiste na primeira semana é saber o que pedir, em que ordem e como conferir o resultado. Antes de abrir a ferramenta, escreva o processo que você quer resolver: o que entra, o que sai e o que não pode dar errado. Na Academ.IA, a trilha Construindo com a IA mostra esse caminho, do primeiro pedido ao sistema funcionando, com a parte de segurança e organização junto.