MÓDULO 1.4

⌨️ Terminal e CLI para iniciantes

Do zero ao terminal em 40 minutos: o que é, como navegar, os comandos que você vai usar todo dia com o Claude Code, e como não se meter em apuros.

6
Tópicos
40
Minutos
Básico
Nível
Prático
Tipo
1

🖥️ O que é o terminal

O terminal é um programa que recebe comandos de texto e os executa no sistema operacional. É a interface mais direta e poderosa de um computador — anterior às interfaces gráficas e muito mais eficiente para automação.

Terminal — bash — ~/meu-projeto user@mac ~/meu-projeto $ claude Claude Code v1.x.x — pronto para usar user@mac ~/meu-projeto $ ls src/ auth/ components/ pages/ utils/ recriação ilustrativa — não é screenshot real

🖥️ Onde encontrar o terminal

🍎 macOS

Spotlight (⌘+Space) → "Terminal" ou instale o iTerm2 para uma experiência melhor.

🐧 Linux

Já vem com terminais (gnome-terminal, konsole, xterm). Atalho: Ctrl+Alt+T na maioria das distros.

🪟 Windows

Use WSL2 (Windows Subsystem for Linux) para um ambiente Unix real. PowerShell funciona mas tem diferenças.

💡 Dica: O prompt te diz onde você está

O prompt user@mac ~/projetos/meu-app $ tem três partes: usuário@máquina, diretório atual (~ = home), e $ indicando que você pode digitar. Leia o prompt antes de digitar qualquer comando.

Shell
bash/zsh — intérprete de comandos
Prompt
Onde você digita (termina em $)
stdout
Saída padrão do comando
Exit code
0 = sucesso, ≠0 = erro
2

📂 Pastas e caminhos

O sistema de arquivos é uma árvore: uma raiz, com pastas dentro de pastas, dentro de pastas. Saber onde você está e como referenciar arquivos é a habilidade básica #1 do terminal.

🌳 Estrutura de diretórios típica

/ ← raiz (root) — absoluto
├── home/
│ └── user/ ← ~ (home do usuário)
│ ├── projetos/
│ │ └── meu-app/ ← você está aqui
│ │ ├── src/
│ │ └── package.json
│ └── Downloads/
# Caminho absoluto: /home/user/projetos/meu-app
# Caminho relativo (de ~/projetos): ./meu-app
# Subir um nível: ../ (vai para ~/projetos)

✓ Caminho absoluto

  • /home/user/projetos/app
  • /etc/nginx/nginx.conf
  • /usr/local/bin/node

Começa em / — funciona de qualquer lugar

→ Caminho relativo

  • ./src/index.ts
  • ../config/env.json
  • ../../outro-projeto/

Relativo ao diretório atual — mais curto

/
Raiz do sistema
~
Home do usuário
.
Diretório atual
..
Diretório pai
3

⚡ Comandos essenciais

Você não precisa memorizar 200 comandos Unix. Com 10 comandos você consegue navegar, criar, mover e inspecionar qualquer projeto com o Claude Code.

📖 Referência rápida — 10 comandos essenciais

pwd # print working directory — onde estou?
→ /home/user/projetos/meu-app
ls # list — o que tem aqui?
ls -la # com detalhes e arquivos ocultos
→ src/ package.json .gitignore node_modules/
cd pasta # change directory — navegar
cd .. # subir um nível
cd ~ # voltar para home
mkdir nome # make directory — criar pasta
mkdir -p a/b/c # cria hierarquia completa
cat arquivo # ver conteúdo do arquivo
cp orig dest # copiar arquivo
mv orig dest # mover/renomear arquivo

Como o Claude Code usa esses comandos no dia a dia

→

ls — explorar a estrutura

O agente usa ls para entender o projeto antes de agir. É a primeira coisa que ele faz em sessões novas.

→

mkdir -p — criar estrutura

Para criar features, o agente cria as pastas necessárias antes de escrever os arquivos.

→

mv — refatoração

Mover arquivos para nova estrutura de pastas durante refatorações é uso diário.

cd/pwd/ls
Navegação básica
mkdir/cp/mv
Gestão de arquivos
cat/grep
Inspecionar conteúdo
man cmd
Ajuda de qualquer comando
4

🔌 O que é uma CLI

Uma CLI (Command-Line Interface) é um programa que você controla digitando comandos de texto. Git, npm, Python, Docker, e o Claude Code — todos são CLIs. Entender a anatomia de um comando de CLI é uma habilidade que transfere para todas elas.

🔍 Anatomia de um comando CLI

# Estrutura geral:
programa [subcomando] [--flags] [argumentos]
# Exemplos reais:
git commit -m "mensagem"
npm install --save-dev typescript
claude --dangerously-skip-permissions -p "tarefa"
# Ajuda sempre disponível:
claude --help
git --help
npm help install

✓ Boas práticas CLI

  • ✓Sempre use --help antes de adivinhar
  • ✓Tab completion — pressione Tab para autocompletar
  • ✓Setas ↑↓ navegam o histórico de comandos
  • ✓Ctrl+C cancela o comando atual

✗ Armadilhas CLI

  • ✗Copiar comando da internet sem ler
  • ✗Ignorar mensagens de erro
  • ✗Usar sudo sem necessidade
  • ✗Digitar comandos em pasta errada
Flags
--flag ou -f (forma curta)
Subcomando
git commit, npm install
--help
Ajuda inline sempre disponível
Tab
Autocompletar — use sempre
5

📦 Instalar ferramentas

Para usar o Claude Code, você precisa instalar o Node.js e o pacote npm. Entender gerenciadores de pacotes é essencial — eles são a forma padrão de instalar CLIs em qualquer sistema.

Instalando o Claude Code — passo a passo

1

Instalar Node.js

# macOS (Homebrew)
brew install node
# Linux (Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
2

Verificar instalação

node --version # deve mostrar v18+
npm --version # deve mostrar 9+
3

Instalar o Claude Code

npm install -g @anthropic-ai/claude-code
# verificar:
which claude # deve mostrar o caminho
claude --version

💡 O que é o PATH

Quando você digita claude, o shell procura o executável nas pastas listadas na variável PATH. Se der "command not found", é porque a pasta do npm global não está no PATH. Solução: export PATH="$PATH:$(npm root -g)/../.bin".

npm
Node Package Manager
-g flag
Instala globalmente no sistema
PATH
Onde o shell procura executáveis
which
Mostra onde está um executável
6

🔒 Segurança no terminal

O terminal tem poder real sobre o sistema. Um comando errado pode apagar arquivos irrecuperáveis, expor credenciais ou instalar software malicioso. Estas regras simples evitam 99% dos problemas.

⚠️ Comandos que NUNCA copie sem entender

rm -rf / ← apaga TODO o sistema
rm -rf ~ ← apaga todos os seus arquivos
curl URL | bash ← executa código desconhecido
sudo chmod -R 777 / ← remove segurança do sistema
> arquivo.conf ← apaga o conteúdo do arquivo!

Regra: se você não consegue explicar o que um comando faz, não execute.

✓ Boas práticas de segurança

  • ✓Use .env para segredos e nunca commite esse arquivo
  • ✓Verifique o que vai deletar antes com ls
  • ✓Prefira mv para a Lixeira em vez de rm
  • ✓Leia mensagens de confirmação (y/n) com atenção

✗ Erros de segurança comuns

  • ✗Commitar chaves de API ou senhas no git
  • ✗Usar sudo indiscriminadamente
  • ✗Rodar scripts de terceiros sem revisar
  • ✗Deixar variáveis de ambiente no histórico

💡 Segurança com o Claude Code

O Claude Code pode executar qualquer comando Bash. Configure o settings.json com uma denylist para comandos destrutivos que você nunca quer que ele execute automaticamente. Assim você tem autonomia com segurança.

"deny": ["Bash(rm -rf:*)", "Bash(git push --force:*)"]

.env
Arquivo para variáveis secretas
.gitignore
Lista arquivos a não commitar
sudo
Super-usuário — use com cuidado
denylist
Bloqueie comandos perigosos no Claude

✅ Resumo do Módulo 1.4

✓
Terminal = interface de texto — onde o Claude Code vive
✓
Árvore de diretórios — /, ~, ., .. e caminhos absolutos/relativos
✓
10 comandos essenciais — cd, ls, mkdir, pwd, cat, cp, mv, rm, grep, man
✓
CLI: programa + subcomando + flags + args — padrão universal
✓
npm instala o Claude Code — npm install -g @anthropic-ai/claude-code
✓
Segurança: leia antes de executar — nunca copie comandos sem entender

🎉 Trilha 1 concluída!

Você tem a base completa: o que é Claude Code, como ele pensa, como gerencia contexto e como usar o terminal. Próximo passo: instalar o Claude Code de verdade na Trilha 2 — Instalação.

← Módulo 1.3 Trilha 2: Instalação →