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

Antes de começar a configurar o Claude Code

Confira estes cinco pontos primeiro. A maioria das instalações que falham esbarra em um deles:

O seu trabalho no terminal e os seus chats no Claude dividem uma única cota, então dê uma olhada nos limites de uso do Claude Code antes de sessões longas.

É seguro instalar o Claude Code?

Sim, desde que o comando venha da Anthropic. Os instaladores oficiais só baixam de claude.ai e downloads.claude.ai, o programa para Mac é assinado pela Anthropic e notarizado pela Apple, o programa para Windows é assinado pela Anthropic, e tudo fica na sua própria pasta de usuário, sem permissão de administrador.

Dois hábitos mantêm isso seguro: só cole linhas de instalação que comecem com https://claude.ai/install, nunca uma variação tirada da descrição de um vídeo, e inicie o Claude Code numa pasta feita para ele, porque ele consegue ler tudo dentro da pasta em que você o abre.

Qual método de instalação escolher?

O caminho sem terminal: o app do Claude Code para desktop

O app para desktop é o app normal do Claude com uma aba Code que roda o Claude Code nos arquivos do seu computador. O guia de início rápido do app para desktop da Anthropic traz o download para cada sistema.

1. Baixe o app para o seu sistema. A versão para Mac é um único download para Intel e Apple silicon, o Windows em ARM tem um instalador próprio, e a versão para Linux é uma beta que instala com apt no Ubuntu e no Debian.
2. Instale e faça login. Abra o Claude pela pasta Aplicativos ou pelo menu Iniciar e entre com a conta que tem o seu plano pago.
3. Abra a aba Code no topo da janela. Se ele pedir para você fazer upgrade, essa conta está no plano gratuito.
4. Escolha uma pasta. Abaixo da caixa do prompt, ajuste o seletor de ambiente para a primeira opção em Local e depois use o controle de pasta ao lado dele para abrir uma pasta de teste vazia.
5. Peça alguma coisa. Digite um pedido e aperte Enter. No modo Manual, o Claude mostra cada mudança e espera você aceitar ou recusar.

O app carrega a própria cópia do Claude Code. Atualize com 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ê.

Instalar o Claude Code no Mac ou no Linux

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: cole o instalador oficial

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

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

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

O terminal no topo deste guia é uma execução real, do começo ao fim, num Mac que preparamos para isso. O aviso amarelo de configuração que aparece nele é o tropeço mais comum: se você vir esse aviso, rode a linha que ele indica ou use a correção do PATH mais abaixo.

Passo 3: confira se o Claude Code foi instalado

Feche a janela e abra uma nova janela do Terminal, porque só uma janela nova reconhece o programa novo. Depois rode:

$ claude --version
$ 

Um número de versão seguido de (Claude Code) quer dizer que está tudo pronto:

Se em vez disso aparecer zsh: command not found: claude, vá direto para a correção do PATH mais abaixo.

Instalar o Claude Code no Windows

O Claude Code roda de forma nativa no Windows 10 e 11, então você não precisa do WSL (o Subsistema do Windows para Linux) e nunca precisa rodar nada como administrador.

Passo 1: abra o PowerShell, não o Prompt de Comando

Aperte Win + X e escolha Windows PowerShell ou Terminal. Cada linha deve começar com PS C:\. Se começar com C:\ sem o PS, você está no Prompt de Comando (CMD), que precisa de outro comando.

Passo 2: cole 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 o executa. Você terminou quando aparecer Claude Code successfully installed! Se você estiver no Prompt de Comando, use esta linha:

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

Passo 3: confira se funcionou

Feche o PowerShell, abra uma nova janela e rode claude --version. Um número de versão quer dizer que está tudo pronto; 'claude' is not recognized quer dizer que você precisa da correção do PATH no Windows.

Preciso de Git para o Claude Code?

Não para começar. O Git for Windows, um download gratuito em git-scm.com, dá ao Claude Code um shell Bash (o Git Bash) para rodar comandos; sem ele, o Claude Code usa o PowerShell, que dá conta da maioria das tarefas de iniciante. Você nunca precisa aprender Git, e o Mac não precisa de nada a mais. Se instalar depois, clique em Next em todas as telas e mantenha a opção recomendada na tela Adjusting your PATH environment.

Instalar o Claude Code no VS Code ou no JetBrains

Se você já trabalha no Visual Studio Code, a extensão da Anthropic coloca o Claude Code num painel lateral:

1. Confira a sua versão. A extensão precisa do VS Code 1.94 ou mais recente.
2. Instale a extensão. Aperte Cmd + Shift + X no Mac ou Ctrl + Shift + X no Windows, procure Claude Code e clique em Install na extensão da Anthropic.
3. Abra o painel. Clique no ícone Spark no canto superior direito de um arquivo aberto, ou em ✻ Claude Code na barra de status, no canto inferior direito.
4. Faça login. Clique em Sign in e conclua o login no navegador.

A extensão traz uma cópia própria do Claude Code para o painel. Para digitar claude no terminal embutido do VS Code, você ainda precisa da instalação para Mac ou Windows acima.

As IDEs da JetBrains, como IntelliJ IDEA, PyCharm e WebStorm, funcionam de outro jeito: o plugin do Claude Code delas roda o comando claude no terminal da IDE, então faça primeiro a instalação pelo terminal, depois adicione o plugin pelo JetBrains Marketplace e reinicie a IDE.

Inicie o Claude Code e faça login pela primeira vez

Crie uma pasta de teste e inicie o Claude Code dentro dela. 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 pede para você escolher um tema de cores com as setas, depois um jeito de fazer login, e abre o seu navegador.
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.

Estas são as duas telas que você responde, capturadas numa primeira abertura real. Primeiro, como fazer login: escolha a opção 1 para usar o seu plano Pro ou Max.

Depois, a checagem da pasta. Vá até "Yes, I trust this folder" com as setas e aperte Enter:

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.

Rodamos os dois prompts numa pasta nova para este guia. No modo manual, o Claude Code mostrou o arquivo inteiro antes de criá-lo:

Nove segundos depois estava pronto, e ele respondeu também a segunda metade do prompt, com três jeitos de abrir o arquivo:

first-test/hello.html

Atualizar ou desinstalar o Claude Code

• 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 sem iniciar uma sessão; dentro de uma sessão, o /doctor faz uma checagem mais completa que também consegue corrigir problemas.
• Instalações pelo Homebrew e pelo WinGet não se atualizam sozinhas. Use os comandos de upgrade da tabela de métodos.

Para desinstalar uma instalação nativa no Mac, rode:

$ rm -f ~/.local/bin/claude
$ rm -rf ~/.local/share/claude
$ 

No Windows, no PowerShell:

PS> Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
PS> Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
PS> 

Instalações pelo Homebrew e pelo WinGet saem com brew uninstall --cask claude-code ou winget uninstall Anthropic.ClaudeCode. As suas configurações e o histórico de sessões ficam na pasta .claude e no arquivo .claude.json da sua pasta pessoal; apague esses só se quiser começar totalmente do zero.

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

Encontre a mensagem que você está vendo e aplique a correção. Todos 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".

Comando do Claude Code não encontrado ou não reconhecido

O programa foi instalado, mas o seu terminal não sabe onde procurar. Uma janela que já estava aberta continua com a lista antiga de pastas de programas (o PATH), então abra uma nova primeiro. Se não resolver, adicione a pasta você mesmo.

No Mac, que usa o shell Zsh por padrão, rode estas duas linhas. A primeira salva a configuração para toda janela nova, e a segunda aplica na janela em que você está:

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

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> 

Por que a instalação do Claude Code parece travada

O instalador não mostra nada enquanto baixa, então alguns minutos de silêncio são normais numa conexão lenta. Se ficar parado muito mais tempo, aperte Ctrl + C e teste se a sua rede alcança o servidor de download da Anthropic:

$ curl -sI https://downloads.claude.ai/claude-code-releases/latest
$ 

No PowerShell, digite curl.exe em vez de curl. Uma primeira linha com 200 quer dizer que o servidor está acessível, então rode o instalador de novo; um 403, um tempo esgotado ou nenhuma saída quer dizer que um firewall, um proxy ou um bloqueio por região está no caminho. Pouca memória? Feche os apps pesados antes de tentar de novo, já que a Anthropic diz que a instalação precisa de cerca de 512 MB livres.

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 de Claude Code 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.