Lição 1 de 3 · 12 min · Verificado em 6 de Outubro de 2026

O terminal sem medo

No fim desta lição vais conseguir:

Abrir o terminal no Windows, no Mac ou no Linux
Usar seis comandos para ver onde estás, listar, mudar de pasta, criar uma pasta, ver um ficheiro e limpar o ecrã
Colar um comando com calma e reconhecer os comandos que nunca se escrevem sem perceber

A Dona Graça tem uma padaria e quer pôr o horário de Inverno no site. O sobrinho, ao telefone, diz-lhe: «Abre o terminal e escreve isto.» Ela olha para uma janela escura com um cursor a piscar e tem a certeza de que vai estragar o computador.

Não vai. Nesta lição ficas a saber o que é aquela janela, como se abre e os seis comandos de que precisas.

O que é o terminal

O terminal é uma conversa com o computador por escrito. Em vez de clicares numa pasta, escreves o nome dela. Em vez de arrastares um ficheiro, escreves uma ordem curta. O computador responde com texto.

É aqui que vivem os agentes de código, como o Claude Code e o Codex (Nível 1). Também falam com o computador por escrito: abrem ficheiros, correm comandos e mostram-te o resultado. Se perceberes o básico do terminal, percebes o que o agente está a fazer.

Duas coisas para ficares descansado: o terminal só faz o que lhe mandas, e quase todos os comandos desta lição só olham, não mexem.

Como abrir

Isto é como está a 6 de Outubro de 2026; se o ecrã for diferente, procura o botão com o mesmo nome.

Windows: carrega em Win + X e escolhe Terminal ou Windows PowerShell. Também podes escrever «PowerShell» no menu Iniciar.
Mac: carrega em Cmd + Espaço, escreve Terminal e carrega em Enter.
Linux: na maioria dos sistemas, Ctrl + Alt + T. Se não der, procura «Terminal» no menu de aplicações.

Aparece uma janela com uma linha de texto e um cursor a piscar. Essa linha costuma mostrar a pasta onde estás, por exemplo PS C:\Users\Graca> no Windows.

Dica

No Windows há dois programas parecidos: o PowerShell e a antiga Linha de Comandos (CMD). Neste curso usamos o PowerShell. Sabes que estás nele porque a linha começa por PS.

Os seis comandos

Escreve o comando e carrega em Enter. Mais nada.

O que queres fazer	Windows (PowerShell)	Mac e Linux
1. Ver onde estou	`pwd`	`pwd`
2. Listar o que há aqui	`dir`	`ls`
3. Entrar numa pasta	`cd Documents`	`cd Documents`
3. Voltar à pasta de cima	`cd ..`	`cd ..`
4. Criar uma pasta	`mkdir experiencias`	`mkdir experiencias`
5. Ver o que tem um ficheiro	`type nota.txt`	`cat nota.txt`
6. Limpar o ecrã	`cls`	`clear`

Entrar e voltar são o mesmo comando, cd, que quer dizer «mudar de pasta». Os dois pontos .. querem dizer «a pasta de cima».

No terminal, as pastas do sistema aparecem muitas vezes com o nome verdadeiro, em inglês (Documents, Downloads, Desktop); o explorador de ficheiros é que as traduz. E uma boa notícia: o PowerShell também aceita ls, cat e clear, por isso a versão do Mac quase sempre funciona no Windows.

Exemplo

Uma sessão no Mac, comando a comando:

pwd
ls
mkdir experiencias
cd experiencias
pwd

O primeiro pwd mostra algo como /Users/graca. O ls lista o que lá está. O mkdir cria a pasta, o cd entra nela e o último pwd confirma: /Users/graca/experiencias.

Colar no terminal

Vais copiar muitos comandos. Para colar:

Windows: Ctrl + V ou clique com o botão direito do rato.
Mac: Cmd + V.
Linux: Ctrl + Shift + V (o Ctrl + V sozinho normalmente não funciona).

Um comando que escreves só corre quando carregas em Enter. Mas, se colares várias linhas de uma vez, algumas podem correr logo. Por isso, cola primeiro num editor de texto (como o Bloco de Notas), lê, e copia dali uma linha de cada vez. Antes do Enter, lê a linha: esse segundo de pausa é o teu cinto de segurança.

Dica

Ctrl + C, no terminal, quer dizer «pára». Se um comando ficar a correr sem fim, ou se te enganaste, carrega em Ctrl + C e voltas à linha de comandos. Para copiar texto do terminal, selecciona com o rato e usa o menu do botão direito.

O que pode correr mal

Com estes comandos, quase nada. Os erros comuns são inofensivos:

«não é reconhecido» ou «command not found»: escreveste mal o comando, ou ele não existe nesse sistema. Confirma as letras.
«não existe» ou «No such file or directory»: o nome da pasta ou do ficheiro está errado. Faz ls (ou dir) para ver os nomes certos.
Nomes com espaços: cd Os meus documentos falha. Põe aspas: cd "Os meus documentos". Melhor ainda: dá às tuas pastas nomes sem espaços nem acentos.
Maiúsculas: no Linux, Documents e documents são pastas diferentes. Copia o nome tal como aparece.

Dica

A tecla Tab completa nomes. Escreve cd Doc e carrega em Tab: o terminal acaba a palavra por ti. A seta para cima repete o comando anterior.

O que nunca escreves sem perceber

Há comandos que apagam sem perguntar e sem passar pelo lixo. O mais conhecido é o apagar recursivo: rm -rf no Mac e no Linux, Remove-Item -Recurse -Force no Windows. «Recursivo» quer dizer: esta pasta, tudo o que está lá dentro, e tudo o que está dentro do que está lá dentro.

Outra palavra que pede atenção é sudo, no Mac e no Linux: quer dizer «faz isto como administrador», sem as travas normais.

Cuidado

Nunca coles um comando com rm -rf, Remove-Item -Recurse ou sudo se não percebes exactamente o que faz e em que pasta. Um espaço a mais pode mudar o alvo de uma pasta para o disco inteiro. Se um site, um vídeo ou uma mensagem te mandar colar algo assim «para resolver um problema», pára e pergunta a alguém de confiança. Este é também um truque usado em burlas.

Os comandos desta lição só olham ou criam uma pasta vazia. Nenhum apaga nada. Quando um agente de código te pedir licença para correr um comando, faz a mesma pergunta: este comando olha, cria ou apaga?

Exercício

Vais criar a pasta onde fazes todas as experiências deste curso.

Abre o terminal (começa na tua pasta pessoal).
Escreve pwd e repara onde estás.
Escreve mkdir experiencias.
Entra nela com cd experiencias e escreve pwd outra vez.
Lista o que lá está com ls (ou dir no Windows).
Limpa o ecrã com clear (ou cls).

Como sei que ficou bem o segundo pwd termina em experiencias, a listagem aparece vazia (a pasta é nova) e no fim o ecrã fica limpo.

Se não deu

A pasta já existe: óptimo, já a tinhas. Salta para o passo 4.
O cd experiencias dá erro: faz ls (ou dir) e confirma se a pasta aparece e se o nome está escrito igual, sem acento.
Escreveste e nada aconteceu: carregaste em Enter? O que escreves à mão só corre com Enter.
No Windows, o pwd dá erro: provavelmente abriste o CMD e não o PowerShell. Fecha e abre o PowerShell (a linha começa por PS).
Ficou tudo parado: carrega em Ctrl + C.

Vídeos

**Como Navegar no Terminal do Windows #02 — PWD, LS, CD e Mais**
Usando Python · 10 min · PT · legendas · Ver no YouTube
Mostra no terminal do Windows (PowerShell) os comandos pwd, ls ou dir e cd, incluindo cd .. para subir de pasta, com calma e sem apagar nada. Não mostra o mkdir; esse está no texto da lição. O autor fala português de Angola.

**Learn the Terminal in 10 Minutes (Before You Touch Claude Code)**
Chris · 9 min · EN · legendas · Ver no YouTube
Demonstração em Windows PowerShell, com os equivalentes de Mac e Linux: pwd, ls, cd, a tecla Tab para completar, mkdir, criar um ficheiro e lê-lo com cat. O troço indicado pára antes da parte em que o vídeo passa a apagar ficheiros.

Testa o que aprendeste

1. Abriste o terminal e não sabes em que pasta estás. Qual é a melhor primeira coisa a escrever? cd .. mkdir experiencias pwd

2. Um vídeo diz para colares «sudo rm -rf» seguido de um caminho, «para libertar espaço no disco». Qual é a melhor reacção? Não colar e perguntar a alguém de confiança o que aquilo apaga Colar, porque o vídeo tem muitas visualizações Colar, mas só depois de fechar os outros programas

3. Queres criar uma pasta chamada experiencias na pasta onde estás e entrar nela. Qual é a sequência certa? cd experiencias e depois mkdir experiencias mkdir experiencias e depois cd experiencias ls experiencias e depois clear

Correcções a esta lição (1)

6 de Outubro de 2026: Depois de uma revisão externa: carregar em Enter deixou de ser apresentado como garantia de que o comando só corre quando quiseres; quem cola várias linhas de uma vez pode vê-las correr logo, por isso a lição manda colar primeiro num editor de texto e copiar daí uma linha de cada vez. As opções do quiz foram reordenadas.