Como instalar o Claude Code no Mac e no Windows (2026)

Para instalar o Claude Code, abra o Terminal no Mac ou o PowerShell no Windows, cole o instalador de uma linha da Anthropic, digite claude e faça login no navegador com uma conta paga do Claude. Leva poucos minutos e você não precisa saber programar. Se preferir nunca mexer no terminal, instale o app do Claude para desktop: o Claude Code já vem dentro da aba Code.

Este passo a passo segue a documentação oficial de instalação da Anthropic em outubro de 2026. Se você ainda está decidindo se precisa mesmo do Claude Code, comece por o que é o Claude Code.

Antes de começar

Passe por este checklist primeiro. A maioria das instalações que falham esbarra em um destes cinco pontos:

Depois escolha o seu método:

Opção 1: o app para desktop, sem terminal

1. Baixe o app. Pegue na página de início rápido do app para desktop da Anthropic. A versão para Mac roda em Intel e Apple silicon, o Windows tem versões x64 e ARM64, e uma versão beta para Ubuntu e Debian instala com apt.
2. Instale e faça login. Abra o Claude e entre com a conta que tem o seu plano pago.
3. Abra a aba Code. Se ele pedir para você fazer upgrade, a conta que você usou está no plano gratuito.
4. Escolha uma pasta. Escolha Local, clique em Select folder e selecione uma pasta vazia que você criou para testes.
5. Peça alguma coisa. Digite um pedido na caixa e aperte Enter.

O app mantém a própria cópia do Claude Code atualizada pelo menu Claude > Check for Updates no Mac ou Help > Check for Updates no Windows. Se você lê hebraico, a ai school também oferece um instalador gratuito de um clique para Mac e Windows que configura o app para desktop para você.

Opção 2: instale o Claude Code no Mac

Passo 1: abra o Terminal

Aperte Cmd + Espaço, digite Terminal e aperte Enter. Aparece uma janela com um cursor piscando, e é ali que você digita os comandos.

Passo 2: rode o instalador oficial

Copie esta linha, cole com Cmd + V e aperte Enter:

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

Ela baixa e roda o instalador da Anthropic a partir do claude.ai. Por um tempo parece que nada acontece, porque ele não mostra o progresso, então não mexa na janela até aparecer Claude Code successfully installed!

Passo 3: confira se funcionou

Feche a janela, abra uma nova janela do Terminal para que ela reconheça o programa novo e rode:

$ claude --version
$ 

Um número de versão seguido de (Claude Code) quer dizer que está tudo pronto. Se em vez disso aparecer command not found: claude, vá direto para a tabela de solução de problemas mais abaixo.

Opção 3: instale o Claude Code no Windows

Passo 1 (opcional): instale o Git for Windows

O Git for Windows dá ao Claude Code um shell Bash para rodar comandos. Sem ele, o Claude Code usa o PowerShell, o que serve bem para a maioria dos iniciantes. Se for instalar, clique em Next em todas as telas: as opções padrão, incluindo a opção de PATH recomendada, são exatamente o que você precisa.

Passo 2: abra o PowerShell

Aperte Win + X e escolha Windows PowerShell ou Terminal. Confira se cada linha começa com PS C:\; se começar com C:\ sem o PS, você está no Prompt de Comando, que precisa de outro comando.

Passo 3: rode o instalador oficial

Cole isto com Ctrl + V ou com o botão direito do mouse e aperte Enter:

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

O irm baixa o instalador e o iex executa o instalador. Você não precisa abrir o PowerShell como administrador, e terminou quando aparecer Claude Code successfully installed!

Se você estiver no Prompt de Comando, use esta versão:

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

Passo 4: confira se funcionou

Abra uma nova janela do PowerShell e rode claude --version. Um número de versão quer dizer que está tudo pronto.

Faça login pela primeira vez

Crie uma pasta de teste e inicie o Claude Code dentro dela. Uma pasta dedicada faz diferença, porque o Claude Code consegue ler tudo na pasta em que você o inicia.

No Mac:

$ mkdir -p ~/claude-projects/first-test
$ cd ~/claude-projects/first-test
$ claude
$ 

No Windows, no PowerShell:

PS> mkdir -Force "$HOME\claude-projects\first-test"
PS> cd "$HOME\claude-projects\first-test"
PS> claude
PS> 

Veja o que acontece em seguida:

1. Configuração e navegador. O Claude Code faz uma configuração rápida de primeiro uso e abre o seu navegador para o login.
2. Login. Use a conta que tem o seu plano pago. Se o navegador não abrir, aperte c para copiar o link de login e cole no navegador você mesmo.
3. Confirmação. Quando o terminal mostrar Login successful, aperte Enter.
4. Confiança na pasta. O Claude Code pergunta se você confia nesta pasta; você acabou de criá-la, então aceite.
5. Mãos à obra. O prompt do Claude Code aparece, com a versão, o modelo e a pasta mostrados logo acima. Digite /help para ver os comandos.

Rode uma primeira tarefa segura

Comece com uma pergunta que não muda nada:

Quais arquivos existem nesta pasta e com que tipo de tarefa você poderia me ajudar aqui? Não crie nem altere nada ainda.

Depois, uma mudança pequena que você consegue ver:

Crie um arquivo chamado hello.html: uma página simples com um título que diga "Minha primeira página com o Claude Code" e um parágrafo curto explicando o que você acabou de fazer. Depois me diga como abrir o arquivo.

As versões atuais começam as sessões do terminal no modo automático, em que uma checagem de segurança em segundo plano revisa cada ação em vez de perguntar a você. Enquanto estiver aprendendo, aperte Shift+Tab até a linha embaixo do prompt mostrar manual mode on, para que o Claude Code pergunte antes de cada arquivo que cria e de cada comando que roda.

Leia cada pedido e escolha Yes se ele bater com o que você pediu. Quando terminar, dê um clique duplo no hello.html no Finder ou no Explorador de Arquivos para abrir no navegador.

Mantenha o Claude Code atualizado

• Instalações nativas se atualizam sozinhas em segundo plano, e a versão nova passa a valer na próxima vez que você iniciar o Claude Code.
• claude update instala a versão mais nova na hora.
• claude doctor faz uma checagem de saúde só de leitura da sua instalação e das suas configurações, sem iniciar uma sessão.
• Instalações pelo Homebrew e pelo WinGet não se atualizam sozinhas. Use os comandos de upgrade da tabela de métodos.

Solução de problemas: os erros que as pessoas realmente encontram

Encontre a mensagem que você está vendo e aplique a correção. Estes casos vêm da página de solução de problemas de instalação da Anthropic, que também lista situações mais raras. No Windows em português, algumas mensagens aparecem traduzidas, como "não é reconhecido" no lugar de "is not recognized".

Para corrigir o PATH no Mac, que usa o shell Zsh por padrão, rode estas duas linhas e depois abra uma nova janela:

$ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
$ source ~/.zshrc
$ 

Para corrigir o PATH no Windows, rode estas duas linhas no PowerShell e depois feche e abra o PowerShell de novo:

PS> $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
PS> [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
PS> 

Se o claude --version funciona, mas outra coisa se comporta de um jeito estranho, rode claude doctor e leia os avisos, porque cada um vem com uma sugestão de correção.

O que fazer agora

Use a sua primeira hora em tarefas pequenas e seguras, para aprender os controles antes de apontar o Claude Code para qualquer coisa importante. O tutorial para iniciantes leva você por um primeiro projeto completo, e o guia do arquivo CLAUDE.md mostra como salvar as suas preferências para você parar de repeti-las. Deixe o guia rápido de comandos do Claude Code aberto em uma aba para consultar comandos e atalhos e, se quiser o caminho inteiro em um só lugar, o curso de Claude Code começa pela instalação e termina com projetos que você pode usar no seu negócio.