Como instalar o Claude Code a partir do site oficial

O que é o Claude Code e porque funciona no terminal?#

O terminal assusta quase toda a gente que começa a fazer vibe coding sem experiência em desenvolvimento de software. Parece uma janela preta de um filme de hackers, mas, na realidade, é apenas uma linha onde escreve comandos. O Claude Code precisa dele precisamente para poder abrir e alterar os seus ficheiros e executar verificações por si, enquanto descreve a tarefa por palavras.

A Anthropic descreve o produto desta forma.

A diferença em relação a um chat habitual é simples. Num navegador, copia o código manualmente, de um lado para o outro entre a janela e o editor. O Claude Code entra diretamente na pasta do projeto, lê os ficheiros de que precisa, faz a alteração e mostra-lhe o que mudou. Continua a ser você quem decide e aprova; a ferramenta trata do trabalho mecânico.

Se não quiser mesmo usar o terminal, a Anthropic disponibiliza uma aplicação de ambiente de trabalho com uma janela normal e uma versão Web em claude.ai/code, que funciona diretamente no navegador. Mas a opção mais poderosa e flexível é a versão para terminal, que é o tema de todo este artigo.

Onde fica o site oficial do Claude Code e o que deve transferir?#

A primeira dúvida dos principiantes é onde fica o site oficial do Claude Code e onde clicar para o transferir. Eis uma tabela com todos os endereços oficiais da Anthropic, para não ter de adivinhar.

Não se transfere um instalador do site como se faria com um programa normal, o que contraria as expectativas das pessoas. Instala-se com um comando no terminal, que depois transfere a versão adequada ao seu sistema. Este artigo inclui os comandos exatos para Mac, Windows e Linux.

Uma armadilha comum é o nome: muitas pessoas escrevem-no incorretamente como clode code, clade code, слод код ou clode design. O produto chama-se Claude Code, com au. Tenha isto em conta ao procurar o site oficial: os domínios com grafias semelhantes pertencem a terceiros.

Também convém saber o nome exato do pacote npm. O pacote canónico é @anthropic-ai/claude-code, com o prefixo @anthropic-ai/. A própria Anthropic detém o nome curto claude-code, sem o prefixo — é a ligação oficial da empresa para o mesmo pacote. A regra é simples: o publicador deve ser a Anthropic e o nome a usar na instalação inclui o prefixo.

O que é necessário para instalar: requisitos do computador#

Os requisitos do Claude Code são modestos: os servidores da Anthropic fazem o trabalho pesado; o seu computador apenas envia pedidos e recebe respostas.

Uma nota à parte sobre o Node.js, já que é o tema de muitos mitos. O instalador nativo — aquele que a própria Anthropic recomenda — não precisa de Node.js: instala-se como um único ficheiro autónomo. O Node.js só é necessário se instalar o Claude Code através do npm; nesse caso, precisa da versão 22 ou posterior. Os artigos mais antigos dizem «Node 18 ou superior» — essa informação está desatualizada; use a versão 22+ como referência.

Precisa de um terminal para usar a versão principal. Se não quiser usar um, instale a aplicação de ambiente de trabalho com uma janela normal ou use a versão Web em claude.ai/code. A versão para terminal continua a oferecer mais funcionalidades, por isso o resto deste artigo explica como instalá-la.

Instalar o Claude Code é como ter uma ferramenta nas mãos. Mas, por si só, muitas vezes alucina: esquece-se do seu projeto, inventa coisas e perde o fio à meada a meio de uma tarefa. A combinação de três elementos torna-o fiável: um clone de IA, um Segundo Cérebro e engenharia de contexto. Estes são os três pilares que impedem a IA de alucinar.

Como instalar o Claude Code em macOS?#

Abra o Terminal (vem instalado em todos os Mac: prima Cmd+Space no Spotlight e escreva «Terminal») e cole esta linha:

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

O comando transfere o instalador do endereço oficial da Anthropic e instala o Claude Code. Não precisa de Node.js. O método nativo também é prático por causa das atualizações.

Se já usa o Homebrew, tem uma segunda opção:

brew install --cask claude-code

A diferença entre os métodos está na forma como funcionam as atualizações: o instalador nativo atualiza-se sozinho, mas o Homebrew não — terá de o atualizar manualmente com o comando brew upgrade claude-code. O programa é o mesmo, por isso escolha o método a que está habituado. Se não tiver a certeza, use o primeiro.

Como instalar o Claude Code em Windows?#

Primeiro, descubra onde está. O Windows tem dois shells e cada um usa o seu próprio comando. Abra uma janela e veja o início da linha de comandos: PS C:\> significa PowerShell, enquanto C:\> sem PS significa Linha de Comandos (CMD).

Para PowerShell (a forma mais fácil de o abrir é clicar com o botão direito do rato no botão Iniciar e escolher «Terminal»):

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

Para a Linha de Comandos (CMD):

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

Há uma terceira opção: usar o gestor de pacotes WinGet integrado:

winget install Anthropic.ClaudeCode

Se já tem um ambiente funcional no WSL (Linux dentro do Windows), instale o Claude Code diretamente no WSL com o mesmo comando usado no Linux. O WSL tem uma particularidade relacionada com o Node, que explicarei abaixo, na secção sobre erros comuns.

Como instalar o Claude Code em Linux?#

O método básico é igual em qualquer distribuição popular: usar o mesmo instalador autónomo:

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

Não é necessário o Node.js; o programa é distribuído como um único ficheiro e, a partir daí, atualiza-se sozinho.

Se está habituado a instalar programas apenas através do gestor de pacotes do sistema, pode adicionar os repositórios oficiais da Anthropic: apt para Debian e Ubuntu, dnf para Fedora e RHEL, e apk para Alpine. São assinados com uma chave e têm canais stable e latest. Isto é excessivo para um principiante, por isso deixo os detalhes para a documentação na secção de fontes e recomendo, por predefinição, o comando acima.

Pode haver um problema em servidores económicos. Se o computador tiver pouca memória livre, a instalação pode parar com a palavra Killed (código 137) — o sistema terminou o processo por falta de memória. A solução é adicionar um ficheiro de swap: o Claude Code precisa de cerca de 512 MB de memória livre para instalar.

Como iniciar o Claude Code pela primeira vez?#

O primeiro arranque demora alguns minutos. Eis o processo.

1. Aceda à pasta do projeto

   No terminal, use o comando cd path-to-project para aceder à pasta com que pretende trabalhar e, em seguida, escreva claude.

2. Inicie sessão na sua conta

   Abre-se um navegador com uma janela de início de sessão. Se não abrir automaticamente, prima c para copiar a ligação e cole-a manualmente no navegador. Se o navegador apresentar um código (pode acontecer no WSL e em servidores remotos), cole esse código novamente no terminal.

3. Aguarde a confirmação

   Depois de iniciar sessão, o terminal apresenta Login successful e pede-lhe que prima Enter.

4. Faça a sua primeira pergunta

   Pergunte algo simples sobre o projeto, por exemplo, «o que faz este projeto?». O Claude lê os ficheiros e responde.

5. Aprove a primeira alteração

   Quando lhe pedir para alterar algo, o Claude mostra as alterações propostas e pede confirmação. Pode alternar entre modos de acesso com Shift+Tab.

Vale a pena aprender logo alguns comandos básicos para usar na sessão: /help apresenta os comandos, /clear limpa o histórico da conversa e /exit termina a sessão (premir Ctrl+D duas vezes faz o mesmo). O Claude mostra-lhe tudo isto se escrever /help.

Iniciar sessão com uma subscrição ou uma chave de API: o que deve escolher?#

Esta é a primeira pergunta que surge ao iniciar sessão.

Há duas formas de iniciar sessão e diferem na maneira de pagar.

Para iniciar sessão com uma subscrição, basta usar a sua conta Claude.ai. Para iniciar sessão com uma chave de API, obtenha uma na Claude Console (platform.claude.com); os custos são descontados do saldo pré-pago à medida que trabalha. Defina a chave na variável de ambiente ANTHROPIC_API_KEY e o Claude Code não abrirá o navegador de cada vez.

Pode alternar entre contas durante uma sessão com /login e terminar sessão com /logout.

Mas o Claude Code não inicia sem acesso pago. Se ainda não tem uma conta, descubra primeiro que endereço de e-mail deve usar para se registar: não poderá alterá-lo mais tarde.

Como verificar se tudo foi instalado corretamente?#

Há três comandos que convém conhecer desde o início.

O primeiro verifica a versão:

claude --version

Uma instalação funcional responde com um número no formato X.Y.Z (Claude Code). Os algarismos específicos mudam de versão para versão; o importante é que o comando devolva um número de versão. Uma resposta «command not found» significa outra coisa — explico-a na secção seguinte.

O segundo serve para diagnosticar problemas.

O terceiro é /status, dentro de uma sessão: mostra como iniciou sessão, que endereço de e-mail ou organização está associado e se o acesso expirou. E claude update aplica a atualização mais recente imediatamente, em vez de esperar pela atualização em segundo plano.

Porque não é possível encontrar o comando claude após a instalação?#

Esta é a queixa mais comum entre principiantes e parece mais assustadora do que realmente é. O terminal não procura comandos no computador inteiro; verifica apenas as pastas incluídas no PATH. O Claude Code coloca-se em ~/.local/bin/claude (em Mac e Linux) ou %USERPROFILE%\\.local\\bin\\claude.exe (em Windows) e, se essa pasta não estiver no PATH, o terminal simplesmente não consegue encontrar o programa.

Em Mac e Linux, adicione a pasta à lista. Abra o ficheiro de definições do seu shell (~/.zshrc para Zsh, ~/.bashrc para Bash) e acrescente esta linha no fim:

export PATH="$HOME/.local/bin:$PATH"

Depois, feche e volte a abrir o terminal (ou execute source ~/.zshrc). A partir daí, o comando claude será encontrado.

Erros comuns na instalação e no primeiro arranque#

Vamos analisá-los por ordem; todos constam do guia oficial de resolução de problemas da Anthropic.

1. Node antigo numa instalação através do npm. O pacote @anthropic-ai/claude-code requer Node.js 22 ou posterior. Em Windows, o npm pode falhar com uma mensagem sobre scripts desativados — a política do PowerShell está a bloquear a sua execução. No WSL, um erro comum é exec: node: not found: o WSL está a usar o Node do Windows em vez do Node do Linux. Se o npm lhe estiver a causar problemas, mude para o instalador nativo; não precisa de Node.
2. Instalador errado para o shell. A mensagem 'irm' is not recognized significa que colou um comando do PowerShell na Linha de Comandos. The token '&&' is not a valid statement separator significa o contrário: executou um comando CMD no PowerShell. A parameter cannot be found that matches parameter name 'fsSL' significa que executou o comando para Mac/Linux no PowerShell. Verifique o início da linha de comandos: PS C:\ indica PowerShell e C:\ indica CMD.
3. Uma chave de API antiga sobrepõe-se à subscrição. Se a sua subscrição estiver ativa, mas ainda houver uma chave antiga definida no ambiente, verá API Error: 400 ... This organization has been disabled. A chave tem prioridade sobre o início de sessão da subscrição. Remova-a com unset ANTHROPIC_API_KEY (no PowerShell, use Remove-Item Env:ANTHROPIC_API_KEY), verifique ~/.zshrc e ~/.bashrc e, em seguida, escreva /status.
4. Memória insuficiente num servidor fraco. A instalação para com a palavra Killed e o código 137 — isso significa que não há RAM suficiente. Precisa de cerca de 512 MB livres; adicionar swap resolve o problema.
5. O instalador devolveu outra coisa. O erro syntax error near unexpected token '<' ou uma referência a <!DOCTYPE html> significa que o URL de instalação devolveu uma página Web em vez do script de instalação — geralmente devido à região, a uma firewall empresarial ou a uma interrupção temporária do serviço. Experimente outro método (Homebrew, WinGet) ou tente novamente dentro de alguns minutos.

Para qualquer um destes erros, o primeiro passo é o mesmo: execute claude doctor. A ferramenta mostrará o que está avariado e sugerirá onde procurar.

Há ainda uma particularidade de diagnóstico: um 403 isolado durante a instalação também pode ser causado por uma firewall ou proxy empresarial. Por isso, se estiver numa rede do trabalho, verifique primeiro se está a bloquear o acesso.

O que fazer após a instalação: primeiros passos#

A instalação é apenas o começo. O verdadeiro trabalho começa a seguir, e o primeiro obstáculo com que as pessoas se deparam é a memória. Um modelo de linguagem não se lembra de si entre conversas: num novo chat, só sabe o que incluiu no contexto.

Por isso, o primeiro passo a sério após a instalação é criar um ficheiro CLAUDE.md na raiz do projeto. É um ficheiro de texto com regras e contexto do projeto que o Claude Code lê sempre que é iniciado. Descreva uma vez o que faz, como o projeto está organizado e o que é importante — e não terá de repetir tudo em cada conversa.

Num guia separado, explico como criar esse ficheiro e personalizar o Claude: como personalizar o Claude. Também preparei um mapa geral de ferramentas de vibe coding para 2026.

O que mais perguntam?#

O enquadramento completo do vibe coding: clone de IA + Segundo Cérebro + engenharia de contexto.