# Como instalar o Claude Code a partir do site oficial

> Endereços oficiais, requisitos, instalação em macOS, Windows e Linux, primeiro arranque, resolução de problemas e configuração do PATH.

Source: https://ailoot.ai/blog/pt-pt/install-claude-code/
Canonical: https://ailoot.ai/blog/pt-pt/install-claude-code/
Language: pt-PT
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-150
Revision: sha256-9a64f1e398e82d34de5a6acf80a15d8a01cf35de5f5324e0e5b5fd2411851fb9


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

O Claude Code instala-se no terminal com um único comando. Abaixo: onde encontrar o site oficial do Claude Code, o que transferir exatamente, como instalá-lo em macOS, Windows e Linux, como o iniciar pela primeira vez e iniciar sessão na sua conta. E ainda o que fazer se não for possível encontrar o comando `claude`.

</div>



<div class="aside" data-semantic="ailoot-docs-link" role="note" aria-label="Documentação Ailoot">

A [documentação da Ailoot](https://ailoot.ai/docs/) descreve como ligar modelos e trabalhar com a API.

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

O Claude Code é uma ferramenta da Anthropic que funciona diretamente no terminal do computador. Pode ver todo o projeto, editar ficheiros, executar comandos e tratar de tarefas completas, enquanto lhe diz o que fazer em linguagem corrente e no seu idioma preferido. Ao contrário do chat em claude.ai, que está limitado ao navegador, o Claude Code tem acesso aos seus ficheiros e ao seu código.

</div>

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.

<figure>
<blockquote>
<p>O Claude Code é uma ferramenta de programação agêntica que funciona diretamente no seu terminal, compreende o seu código e acelera o seu trabalho: trata de tarefas rotineiras, explica áreas complexas e gere processos do git — tudo com comandos correntes em linguagem humana.</p>
</blockquote>
<figcaption>— Anthropic, https://github.com/anthropics/claude-code</figcaption>
</figure>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

A página oficial do produto é `claude.com/product/claude-code`. O site do produto, com preços e demonstrações, é `code.claude.com`; a documentação também está disponível em `code.claude.com/docs`. Mas não existe aqui a opção habitual de «transferir um ficheiro do site»: o Claude Code instala-se com um comando no terminal que transfere o programa de que precisa. O único pacote oficial npm chama-se `@anthropic-ai/claude-code`.

</div>

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.

| Endereço | O que é |
|----|----|
| `claude.com/product/claude-code` | Página do produto: descrição e ligações de instalação |
| `code.claude.com` | Site do produto: demonstrações, preços e detalhes |
| `code.claude.com/docs` | Documentação oficial: instalação, primeiro arranque e erros |
| `claude.ai/code` | Versão Web do Claude Code diretamente no navegador |
| `github.com/anthropics/claude-code` | Repositório oficial |
| `@anthropic-ai/claude-code` | Pacote npm oficial |

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

O Claude Code funciona em macOS 13 e posteriores, Windows 10 e posteriores (diretamente ou através do WSL) e na maioria das distribuições Linux. Precisa de 4 GB de RAM, ligação à Internet e qualquer terminal. O Node.js só é necessário para um dos vários métodos de instalação — o instalador nativo não precisa dele.

</div>

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.

| O quê | Requisito |
|-----------|---------------------------------------------------------------|
| macOS | 13.0 e posteriores |
| Windows | 10 (build 1809) e posteriores, diretamente ou através do WSL |
| Linux | Ubuntu 20.04+, Debian 10+, Alpine 3.19+ |
| Memória | 4 GB ou mais (cerca de 512 MB de espaço livre são suficientes para a instalação propriamente dita) |
| Processador | x64 ou ARM64 |
| Rede | Acesso permanente à Internet |
| Shell | Bash, Zsh, PowerShell ou CMD |

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

Num Mac, a forma mais fácil de instalar o Claude Code é com o instalador nativo: basta um comando no terminal e, a partir daí, o programa atualiza-se em segundo plano. Não precisa de Node.js. Se usa o Homebrew, também pode instalá-lo dessa forma. Ambos os métodos instalam o mesmo programa; a única diferença é quem trata das atualizações.

</div>

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

```bash
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.

<figure>
<blockquote>
<p>A instalação nativa atualiza-se em segundo plano e mantém-no na versão mais recente.</p>
</blockquote>
<figcaption>— Anthropic, documentação do Claude Code, https://code.claude.com/docs/en/setup</figcaption>
</figure>

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

```bash
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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

No Windows 10 e posteriores, o Claude Code instala-se nativamente, sem Node.js. O comando depende do shell: o PowerShell usa um e a Linha de Comandos usa outro — é fácil confundi-los e os principiantes cometem muitas vezes esse erro. Também pode instalá-lo através do WinGet. É aconselhável instalar previamente o Git for Windows para usufruir da experiência completa.

</div>

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»):

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

Para a Linha de Comandos (CMD):

```batch
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:

```powershell
winget install Anthropic.ClaudeCode
```

<div class="aside" data-semantic="callout" role="note" aria-label="Dica">

Dica

A Anthropic recomenda instalar previamente o Git for Windows. Assim, o Claude Code pode usar o Bash para os seus comandos. Sem ele, o Claude Code funciona através do PowerShell, mas muitas operações decorrem de forma mais fluida com o Git.

</div>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

O mesmo instalador nativo funciona em Ubuntu, Debian, Fedora e Alpine, tal como no Mac: basta um comando e trata do resto. Se preferir manter tudo no gestor de pacotes do sistema, a Anthropic disponibiliza repositórios assinados para apt, dnf e apk. A instalação pode falhar num servidor com pouca memória; se isso acontecer, precisará de swap.

</div>

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

```bash
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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

Aceda à pasta do projeto, escreva `claude` e prima Enter — a sessão interativa abre-se diretamente no terminal. No primeiro arranque, o Claude Code abre um navegador para iniciar sessão na sua conta. Depois, pode fazer a sua primeira pergunta sobre o projeto em linguagem corrente e receber uma resposta útil.

</div>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

O Claude Code não funciona com o plano gratuito do Claude.ai. Precisa de uma conta com uma subscrição paga (Pro, Max, Team ou Enterprise), com um preço mensal fixo, ou de uma chave de API da Claude Console, onde paga pelo uso efetivo. Para a maioria dos empresários, uma subscrição é mais simples e previsível: paga uma vez por mês sem ter de contar tokens.

</div>

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

<figure>
<blockquote>
<p>Precisa de uma conta Pro, Max, Team, Enterprise ou Console. O plano gratuito do Claude.ai não dá acesso ao Claude Code.</p>
</blockquote>
<figcaption>— Anthropic, documentação do Claude Code, https://code.claude.com/docs/en/setup</figcaption>
</figure>

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

| Método de início de sessão | Como paga | Para quem se destina |
|----|----|----|
| Subscrição Claude.ai (Pro / Max / Team / Enterprise) | Valor mensal fixo | Para a maioria das pessoas: custos previsíveis, sessão iniciada com a conta Claude.ai |
| Claude Console (chave de API) | Pagamento pelo uso efetivo | Para quem quer pagar estritamente pelo uso e controlar as despesas |

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](https://ailoot.ai/blog/pt-pt/claude-registration-email/): não poderá alterá-lo mais tarde.

## Como verificar se tudo foi instalado corretamente?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

A forma mais rápida de verificar é com o comando `claude --version`: uma instalação funcional apresenta um número como «2.1.211 (Claude Code)». Se algo correu mal, `claude doctor` diagnostica a instalação e as definições sem iniciar uma sessão e sugere o que corrigir. Dentro de uma sessão, `/status` mostra com que conta iniciou sessão e se o acesso está ativo.

</div>

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

O primeiro verifica a versão:

```bash
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.

<figure>
<blockquote>
<p>claude doctor apresenta diagnósticos da instalação e das definições sem iniciar uma sessão: verifica o estado da instalação, procura erros nos ficheiros de definições e apresenta avisos com sugestões sobre o que corrigir.</p>
</blockquote>
<figcaption>— Anthropic, documentação do Claude Code, https://code.claude.com/docs/en/setup</figcaption>
</figure>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

Se, após a instalação, o terminal disser «command not found: claude» ou «'claude' is not recognized», significa que a instalação foi concluída, mas a pasta que contém o programa não foi adicionada ao PATH — a lista de locais onde o terminal procura comandos. O programa está em `~/.local/bin`. Para resolver, basta adicionar uma linha às definições do shell e reiniciar o terminal.

</div>

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:

```bash
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.

<div class="aside" data-semantic="callout" role="note" aria-label="Aviso">

Aviso

Há outra armadilha: a extensão Claude Code para VS Code coloca a sua própria cópia do programa na pasta da extensão e não a adiciona ao PATH. Por isso, se instalar apenas a extensão, o comando `claude` não funcionará no terminal — tem de instalar o Claude Code separadamente para o terminal, usando o comando deste artigo.

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

Além de uma entrada em falta no PATH, há cinco coisas que costumam causar problemas aos principiantes: uma versão antiga do Node numa instalação npm, o instalador errado para o shell, uma chave de API ainda definida no ambiente, memória insuficiente num servidor fraco e indisponibilidade do serviço na região do utilizador. A primeira coisa a tentar em qualquer problema é `claude doctor` — consegue diagnosticar a maioria dos casos por si.

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

O Claude Code está instalado — e, ainda assim, cada nova conversa começa do zero, sem se lembrar de si nem do projeto. O primeiro passo após a instalação é colocar um ficheiro `CLAUDE.md` com regras e contexto no projeto, para não ter de explicar sempre as mesmas coisas. Explico separadamente como personalizar o Claude.

</div>

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](https://ailoot.ai/blog/pt-pt/claude-personalization-profile-memory/). Também preparei [um mapa geral de ferramentas de vibe coding para 2026](https://ailoot.ai/blog/pt-pt/ai-coding-tools/).

## O que mais perguntam?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ideia principal">

Ideia principal

Há seis perguntas que surgem com mais frequência: é preciso saber programar, é necessário o Node.js, em que difere o Claude Code de um chat normal em claude.ai, é possível usá-lo sem terminal, quanto custa e como se atualiza o programa? Respondo a cada uma delas de forma breve e direta abaixo.

</div>

<div class="section">

### Perguntas frequentes

É preciso saber programar para instalar o Claude Code?

Não. A instalação exige alguns comandos que copia das instruções e cola no terminal. Não precisa de saber programar para o instalar nem para, depois, dar tarefas ao Claude em linguagem corrente.

O Claude Code precisa de Node.js?

Só para uma instalação npm — nesse caso, precisa de Node.js 22 ou posterior. O instalador nativo (o comando com install.sh ou install.ps1), o Homebrew e o WinGet instalam o programa pronto a usar como um único ficheiro e não precisam de Node.js.

Em que difere o Claude Code do chat em claude.ai?

Tem acesso ao seu computador. O chat no navegador responde com texto e é você que transfere o código manualmente. O Claude Code funciona no terminal, lê e edita os ficheiros do projeto, executa comandos e mostra-lhe o que alterou.

É possível usá-lo sem terminal?

Sim. 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 no navegador. A versão para terminal continua a ter todas as funcionalidades.

Quanto custa o Claude Code?

Não há acesso gratuito: precisa de uma subscrição Claude.ai (Pro, Max, Team ou Enterprise) com um preço mensal fixo, ou de uma chave de API Claude Console com faturação conforme o uso. 

Como atualizar o Claude Code?

A instalação nativa atualiza-se em segundo plano, e o comando `claude update` aplica uma atualização imediatamente. Homebrew, WinGet e npm têm de ser atualizados manualmente: use `brew upgrade claude-code`, `winget upgrade Anthropic.ClaudeCode` ou volte a instalar o pacote com o sufixo @latest.

</div>

<div class="section" role="doc-bibliography" aria-label="Fontes">

### Fontes

- [Claude Code Docs - Visão geral](https://code.claude.com/docs/en/overview)
- [Claude Code Docs - Início rápido](https://code.claude.com/docs/en/quickstart)
- [Claude Code Docs - Configuração avançada (instalação, requisitos, atualizações, verificação)](https://code.claude.com/docs/en/setup)
- [Claude Code Docs - Autenticação (início de sessão, subscrição ou Console)](https://code.claude.com/docs/en/authentication)
- [Claude Code Docs - Resolução de problemas de instalação (guia de resolução de problemas)](https://code.claude.com/docs/en/troubleshoot-install)
- [Claude Code Docs - Guia do terminal (para quem nunca usou o terminal)](https://code.claude.com/docs/en/terminal-guide)
- [Anthropic - página oficial do produto Claude Code](https://claude.com/product/claude-code)
- [Anthropic - repositório oficial do Claude Code no GitHub](https://github.com/anthropics/claude-code)
- [npm - pacote @anthropic-ai/claude-code](https://www.npmjs.com/package/@anthropic-ai/claude-code)
- [Anthropic - lista de países suportados](https://www.anthropic.com/supported-countries)
- [Claude Console (faturação da API)](https://platform.claude.com/)
- [Claude Code no navegador](https://claude.ai/code)
- [Claude Code Docs - instalação no VS Code](https://code.claude.com/docs/en/vs-code)
- [Claude Code Docs - plugin JetBrains](https://code.claude.com/docs/en/jetbrains)

</div>

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



<div class="aside" data-semantic="ailoot-link" role="note" aria-label="Ailoot">

Continue a trabalhar com IA na [Ailoot](https://ailoot.ai/).

</div>

## Perguntas frequentes

### Preciso de Node.js para o instalador nativo do Claude Code?

Não. O instalador nativo instala o programa autónomo. Node.js é necessário no método npm; escolha as instruções correspondentes ao sistema operativo e à shell.

### Como distingo uma instalação bem-sucedida de um problema de início de sessão?

Execute `claude --version` para verificar que o terminal encontra o programa. Consulte depois `/status` numa sessão para verificar o acesso à conta e use `claude doctor` para investigar erros de instalação ou configuração.


## Ailoot · A empresa e a sua carteira de projetos

A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.
