M1 · Instalar o Claude Code sem medo

Em palavras simples

Instalar o Claude Code é copiar uma linha, colá-la no terminal e carregar em Enter. É tudo. Este módulo existe para que o faças com calma, percebendo o que está a acontecer em cada passo — e saibas o que fazer se algo correr diferente do esperado.

Bloco 1 — O que precisas antes de começar

A checklist de partida

Um Mac razoavelmente actual (macOS 13 ou mais recente é o seguro)
Um plano pago do Claude — Pro, Max, Team ou Enterprise. É a conta que já usas em claude.ai; o Claude Code vem incluído
15 minutos sem pressa — a instalação em si demora 2; o resto é conheceres a ferramenta

Não precisas: de saber programar, de instalar "Node" ou outras ferramentas de programadores, nem de hardware especial. O instalador trata de tudo.

Bloco 2 — O terminal, explicado a quem nunca o abriu

A janela que assusta (mas não devia)

O Terminal é uma aplicação que já vem no teu Mac. Em vez de clicares em botões, escreves ordens em texto. Só isso.

Para o abrir: Cmd + Espaço (abre o Spotlight), escreve Terminal, Enter
Aparece uma janela com texto e um cursor a piscar — está à espera que escrevas algo
Escreves uma ordem, carregas em Enter, o Mac executa e responde

Na prática: neste curso, o terminal serve quase só para uma coisa — escrever claude e carregar em Enter. A partir daí falas com o Claude em português normal, como no chat.

Bloco 3 — Os modelos, em linguagem simples

Haiku, Sonnet, Opus — qual é qual?

O Claude existe em vários "tamanhos de cérebro". No Claude Code podes escolher qual usar:

Haiku — o estagiário rápido: óptimo para tarefas simples e repetitivas, quase instantâneo, gasta pouco
Sonnet — o profissional de confiança: o equilíbrio certo para o trabalho do dia-a-dia. É a escolha por omissão para a maioria das pessoas
Opus — o consultor sénior: para problemas difíceis, planeamento e raciocínio complexo. Mais lento e gasta mais

Regra de bolso: começa sempre com o que vier por omissão. Muda para um modelo mais forte quando a tarefa for mesmo difícil — aprenderás a alternar com o comando /model já neste módulo.

How-to 1 · Instalar

How-to 1 de 3 ~5 min

Instalar o Claude Code no Mac

Vais colar uma linha no terminal. Essa linha descarrega o instalador oficial e configura tudo sozinha.

1
Abre o Terminal (Cmd + Espaço → escreve "Terminal" → Enter).
2
Copia e cola esta linha exactamente como está, e carrega em Enter:
```
curl -fsSL https://claude.ai/install.sh | bash
```
3
Espera que o texto pare de correr (menos de um minuto). No fim deve dizer que a instalação terminou com sucesso.
4
Fecha o Terminal e abre-o de novo (para ele "conhecer" o comando novo).
5
Confirma que está instalado:
```
claude --version
```
Se aparecer um número de versão, está feito. 🎉

How-to 2 · Primeira sessão

How-to 2 de 3 ~10 min

A tua primeira sessão — confiança e permissões

O Claude Code trabalha sempre dentro de uma pasta — só vê e mexe no que está lá dentro. Vamos criar uma pasta de treino para a primeira experiência.

1
No Terminal, cria uma pasta de treino e entra nela:
```
mkdir ~/treino-claude
cd ~/treino-claude
```
2
Arranca o Claude Code:
```
claude
```
Na primeira vez pede-te para entrares com a tua conta Claude — segue as instruções no ecrã.
3
Se aparecer uma pergunta sobre confiar nesta pasta, responde que sim — és tu que acabaste de a criar.
4
Escreve, em português normal: "Cria um ficheiro chamado ideias.md com 5 ideias de coisas que posso automatizar no meu trabalho."
5
O Claude vai pedir permissão antes de criar o ficheiro — mostra-te o que quer fazer e espera pelo teu OK. Lê e aprova. Esta é a regra de ouro: nada acontece sem aprovares.
6
Abre a pasta no Finder e confirma que o ficheiro lá está:
```
open .
```
(escreve isto no Terminal depois de saíres do Claude, ou pede ao próprio Claude para o fazer)

How-to 3 · Comandos essenciais

How-to 3 de 3 ~10 min

Os comandos que resolvem 90% do dia-a-dia

Dentro de uma sessão do Claude Code, tudo o que começa por / é um comando da ferramenta (não é conversa com a IA). Experimenta cada um destes agora.

1
/help — mostra todos os comandos disponíveis. É o teu salva-vidas.
2
/clear — limpa a conversa e começa do zero. Usa quando mudas de assunto por completo.
3
/compact — resume a conversa para libertar "memória de trabalho" sem perder o fio. Usa em sessões longas.
4
/model — mostra o modelo actual e deixa-te trocar (Haiku / Sonnet / Opus).
5
/resume — recupera uma sessão anterior. Fechaste o terminal sem querer? Isto traz a conversa de volta.
6
/exit — sai do Claude Code e volta ao terminal normal (ou carrega duas vezes em Ctrl+D).

Erros comuns — e como resolver

Se algo correr mal

"command not found: claude" — fecha o Terminal e abre-o de novo. Se persistir, corre outra vez a linha de instalação do How-to 1.
Pede login outra vez / diz que não tens acesso — confirma que entras com a conta que tem o plano pago (Pro ou superior), não com uma conta gratuita.
O Claude não vê os teus ficheiros — provavelmente arrancaste o claude na pasta errada. Sai com /exit, faz cd para a pasta certa e arranca de novo.
Está a pedir permissão para tudo e é cansativo — é o comportamento certo no início. No Módulo 6 aprendes a afinar as permissões com segurança.
Bloqueou ou ficou estranho — Esc interrompe a resposta; /clear recomeça a conversa; em último caso /exit e arranca de novo.

Leva isto contigo

Cheat-sheet imprimível deste módulo — comandos essenciais + SOS de instalação, para colar ao lado do teclado.

🖨️ Cheat-sheet M1

← Módulo 0 Módulo 2 · O método que muda tudo →