Guia grátis · 6 min de leitura

Como instalar o Claude Code no Windows, Mac e Linux

Por Ana Sousa · Atualizado em

Instala-se com uma linha colada no terminal: curl -fsSL https://claude.ai/install.sh | bash no macOS, Linux e WSL, e irm https://claude.ai/install.ps1 | iex no PowerShell do Windows. Depois escreves claude, inicias sessão no browser e está feito. O que o instalador não resolve é a conta: o Claude Code exige um plano pago.

Verificado a 17 de novembro de 2026 na documentação oficial da Anthropic, em inglês (code.claude.com/docs/en/setup). A instalação muda com frequência: se algo não bater certo com o que vês, a documentação oficial manda. Os comandos abaixo são os que lá estão.

O que precisas antes de começar

  • Sistema: macOS 13 ou superior; Windows 10 (1809) ou superior, ou Windows Server 2019 ou superior; Ubuntu 20.04 ou superior; Debian 10 ou superior; Alpine Linux 3.19 ou superior.
  • Máquina: 4 GB de RAM ou mais, processador x64 ou ARM64, e ligação à internet.
  • Conta paga: Pro, Max, Ultra, Team, Enterprise ou Console. O plano gratuito do Claude não inclui o Claude Code. Preços em Quanto custa o Claude Code.
  • País: um dos países suportados pela Anthropic (Portugal está na lista).

macOS (Terminal)

Abre a aplicação Terminal, cola a linha e carrega em Enter.

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

Preferes o Homebrew? brew install --cask claude-code. O Homebrew não atualiza sozinho: para atualizar usa brew upgrade claude-code.

O instalador não mostra barra de progresso enquanto descarrega. A documentação manda esperar, por isso espera.

Windows (PowerShell, CMD ou WinGet)

Primeiro vê qual é a tua janela. Se o prompt começa por PS C:\, estás no PowerShell. Se mostra só C:\, estás no CMD. Cada janela tem o seu comando, e colar o errado é a causa mais comum de erro.

PowerShell:

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

CMD:

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

WinGet: winget install Anthropic.ClaudeCode. Também não atualiza sozinho: winget upgrade Anthropic.ClaudeCode.

O Git for Windows é recomendado: sem ele, o Claude Code usa o PowerShell como shell; com ele, usa o Git Bash. Não é obrigatório.

Linux e WSL

No WSL e na maioria das distribuições serve o mesmo comando do macOS. No Alpine, instala primeiro apk add bash curl. A documentação oficial tem ainda repositórios assinados para apt, dnf e apk, na secção «Install with Linux package managers».

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

Existe também a via npm, npm install -g @anthropic-ai/claude-code@latest, que exige Node.js 22 ou superior e nunca se corre com sudo. O instalador nativo atualiza-se sozinho em segundo plano; é por isso que é o recomendado.

Confirmar que ficou instalado

claude --version

Deve aparecer um número de versão seguido de «(Claude Code)». O número muda todos os dias, por isso o que importa é que apareça alguma coisa. Se der erro, corre claude doctor para um diagnóstico.

Iniciar sessão e a primeira pergunta

  1. No terminal, entra numa pasta de trabalho com cd e escreve claude.
  2. À primeira vez abre-se o browser para iniciares sessão. Se não abrir, carrega em c para copiar o endereço de login. Se o browser mostrar um código, cola-o no terminal. No fim aparece «Login successful» e carregas em Enter.
  3. Faz uma pergunta simples sobre a pasta, por exemplo o que há lá dentro. Quando o Claude pedir permissão para alterar um ficheiro, lê o que propõe antes de aceitar.
  4. Dentro da sessão, /help lista os comandos e /exit sai.

Atenção: os limites de utilização são partilhados entre o Claude (chat) e o Claude Code. Tudo o que fizeres num conta para o outro.

Se der erro

  • «command not found» ou «not recognized»: o PATH não inclui a pasta de instalação. Fecha o terminal, abre um novo e tenta outra vez.
  • No PowerShell, «The token '&&' is not a valid statement separator»: colaste o comando do CMD. Usa o do PowerShell.
  • No CMD, «'irm' is not recognized»: colaste o do PowerShell. Usa o do CMD.
  • «syntax error near unexpected token» ou erro 403: consulta a página «Troubleshoot installation» da documentação oficial (code.claude.com/docs/en/troubleshoot-install).
  • Alpine: falta bash e curl; instala-os primeiro.

Sem terminal: a aplicação Desktop

Quem não quer abrir um terminal pode usar a aplicação Desktop, para macOS e Windows. O download está referido na documentação oficial de instalação. Exige a mesma conta paga.

Quanto custa

A ferramenta instala-se sem custo; a conta é que se paga, à Anthropic. Os valores oficiais, em dólares e sem impostos, estão em Quanto custa o Claude Code.

E depois?

Instalar é a parte fácil. O difícil é saber o que pedir, por que ordem, e como verificar o que sai. Se queres aprender isso ao vivo, em português de Portugal, vê o curso Claude Code na Prática. Se ainda não escreves bons pedidos, começa por Como escrever prompts.

Perguntas frequentes

O que me perguntam mais.

Preciso de saber programar para instalar o Claude Code? Não para instalar: copia-se uma linha para o terminal e carrega-se em Enter. A documentação da Anthropic tem até um guia para quem nunca abriu um terminal. Para tirar partido da ferramenta já é outra conversa, e é para isso que existe o curso.

O Claude Code é gratuito? A ferramenta instala-se sem custo, mas exige uma conta paga. Segundo a documentação oficial (consultada a 17 de novembro de 2026): «Claude Code requires a Pro, Max, Ultra, Team, Enterprise, or Console account. The free claude.ai plan does not include Claude Code access.» Os preços estão em /quanto-custa-claude-code.

Funciona em Windows? Sim. Pede Windows 10 (versão 1809) ou superior, ou Windows Server 2019 ou superior, e corre em PowerShell ou CMD. O Git for Windows é recomendado mas opcional. Também corre em WSL.

Que computador preciso? macOS 13 ou superior, Windows 10 (1809) ou superior, Ubuntu 20.04 ou superior, Debian 10 ou superior, ou Alpine Linux 3.19 ou superior; 4 GB de RAM ou mais; processador x64 ou ARM64; e ligação à internet.

Posso usar o Claude Code em Portugal? Portugal consta da lista de países suportados da Anthropic (anthropic.com/supported-countries, consultada a 17 de novembro de 2026). Confirma sempre na própria lista, porque muda.

Aparece «command not found: claude». O que faço? A pasta onde o Claude Code ficou instalado não está no PATH do teu sistema. Abre um terminal novo e, se continuar, segue a secção «Fix your PATH» da página de resolução de problemas da documentação oficial. Corre também claude doctor.

Quando usar a outra página. Esta página é só para instalar. Para saber o que a ferramenta é, vê O que é o Claude Code; para os preços, Quanto custa o Claude Code; para aprender a usá-la com método, o curso.

Depois do básico

Saber usar é um passo. Verificar é outro.

O curso Claude Code na Prática são quatro noites ao vivo, online, em português de Portugal. A Turma 3 realiza-se de 23 a 26 de novembro, segunda a quinta, das 21h00 às 23h30. Custa €249 por pessoa, e a conta Claude paga-se à parte, à Anthropic. É um curso livre, com certificado de participação.

Ver o curso e o preço →