Introdução · Módulo P2 · 8h estimadas

Preparação: terminal, arquivos e Git

O Módulo 1 já pede programação e comandos de terminal. Este módulo é a ponte para quem ainda não tem essa base: abrir o terminal, andar pelas pastas, instalar as ferramentas, usar Git e GitHub e criar um primeiro projeto. Os exemplos aparecem para Windows (PowerShell) e para Mac e Linux (bash), porque os comandos não são iguais.

6 aulassem pré-requisitoWindows, Mac e Linux

Prefere que o Claude faça com você? O plugin autonomo faz esta preparação conduzindo você passo a passo, e este módulo explica o que ele está fazendo. Os dois caminhos levam ao mesmo lugar: um computador pronto para o Módulo 1.

P2.1 O terminal: o que é e como abrir

Leitura + prática · 1h

O terminal é uma janela onde você digita comandos em vez de clicar. Cada comando é uma linha: você escreve, aperta Enter, e o programa responde com texto. Os agentes de código, como o Claude Code, trabalham assim, e por isso vale entender o básico mesmo que o Claude digite a maior parte.

Sistema	Como abrir	Programa que roda os comandos
Windows 10 e 11	Menu Iniciar, digite Terminal (ou PowerShell)	Windows PowerShell 5.1, que já vem instalado. O PowerShell 7 é uma versão mais nova, instalada à parte
Mac	Spotlight (Cmd + Espaço), digite Terminal	zsh, parecido com o bash
Linux	Ctrl + Alt + T na maioria das distribuições	bash

Três ideias para não se perder:

O terminal sempre está numa pasta. Ela aparece no começo da linha, por exemplo PS C:\Users\ana> no Windows ou ana@pc:~$ no Linux. Os comandos agem sobre essa pasta.
Silêncio costuma ser sucesso. Muitos comandos não escrevem nada quando dá certo. Quando dá errado, a mensagem de erro diz o quê; leia a primeira linha vermelha antes de qualquer coisa.
Ctrl + C interrompe o comando que está rodando. Seta para cima repete o comando anterior.

Prática

Abra o terminal e descubra em que pasta você está:

Get-Location

pwd

P2.2 Pastas, arquivos e caminhos

Leitura + prática · 1h

Um caminho é o endereço de um arquivo. No Windows ele começa pela letra do disco e usa barra invertida: C:\Users\ana\projetos. No Mac e no Linux começa pela raiz e usa barra normal: /home/ana/projetos. Nos dois, ~ é a sua pasta pessoal, . é a pasta atual e .. é a pasta de cima.

O que fazer	PowerShell (Windows)	bash / zsh (Mac e Linux)
Listar arquivos	`ls`	`ls`
Listar incluindo ocultos	`Get-ChildItem -Force`	`ls -la`
Entrar numa pasta	`cd projetos`	`cd projetos`
Voltar uma pasta	`cd ..`	`cd ..`
Criar pasta	`mkdir projetos`	`mkdir projetos`
Ver um arquivo de texto	`Get-Content README.md` (ou `cat`)	`cat README.md`
Abrir a pasta atual no gerenciador de arquivos	`explorer .`	`open .` (Mac) · `xdg-open .` (Linux)

Arquivos que começam com ponto .env, .gitignore e a pasta .git ficam ocultos por padrão. O .env guarda segredos (chaves de API) e nunca vai para o GitHub; o .gitignore diz ao Git o que ignorar. No Windows, ative "Itens ocultos" na aba Exibir do Explorador de Arquivos.

P2.3 Instalar Git, Node e Python

Prática · 1h30

Os laboratórios usam três ferramentas: Git (histórico do código), Node.js 20+ (TypeScript) e Python 3.10+. A forma mais simples de instalar:

Windows

winget install --id Git.Git -e
winget install --id OpenJS.NodeJS.LTS -e
winget install --id Python.Python.3.12 -e
winget install --id GitHub.cli -e

Mac

xcode-select --install     # traz o Git
brew install node python gh   # requer o Homebrew: https://brew.sh

Linux (Debian e Ubuntu)

sudo apt update
sudo apt install git nodejs npm python3 python3-venv gh

Feche e abra o terminal depois de instalar: só um terminal novo enxerga os programas recém-instalados. Depois confira as versões:

git --version
node --version
python --version
gh --version

Python no Windows Se python abrir a Microsoft Store em vez de mostrar a versão, o atalho da Store está na frente. Use py no lugar de python (o instalador traz esse lançador), ou desative o atalho em Configurações → Aplicativos → Configurações avançadas de aplicativos → Aliases de execução. Onde o curso escreve python3, no Windows use python ou py.

No Linux, versões antigas de distribuição podem trazer um Node anterior ao 20. Confira com node --version; se for menor, siga o instalador oficial em nodejs.org.

P2.4 Git e GitHub em cinco comandos

Leitura + prática · 1h30

O Git guarda fotografias do seu projeto, chamadas commits. Com elas você vê o que mudou, volta atrás e trabalha em paralelo em branches. O GitHub guarda uma cópia na internet e é onde os agentes abrem pull requests para você revisar.

Uma vez por computador, diga ao Git quem você é e conecte o GitHub (o login abre no navegador):

git config --global user.name "Seu Nome"
git config --global user.email "[email protected]"
gh auth login --web

No dia a dia, quase tudo são estes cinco comandos (iguais no PowerShell e no bash):

Comando	O que faz
`git clone <endereço>`	Baixa um repositório do GitHub para o seu computador
`git status`	Mostra o que mudou desde o último commit. Na dúvida, rode este
`git add <arquivo>`	Escolhe o que vai entrar no próximo commit
`git commit -m "mensagem"`	Tira a fotografia, com uma frase que diz o que mudou
`git push`	Envia os commits para o GitHub

Quiz rápido

Você editou dois arquivos e não lembra quais. Qual comando mostra isso sem mudar nada?

git status só lê. É o comando mais seguro para se situar antes de qualquer outro.

P2.5 PowerShell e bash: tabela de equivalências

Referência · 1h

A maior parte dos comandos do curso está escrita para bash. Nos módulos, cada bloco desses tem um botão No Windows PowerShell com a versão convertida, quando a conversão é direta. Para o resto, use esta tabela. Ela vale para o Windows PowerShell 5.1, o que vem no Windows.

No bash	No PowerShell 5.1	Observação
`cmd1 && cmd2`	Um comando por linha	O 5.1 não aceita `&&` (o PowerShell 7 aceita). `cmd1; cmd2` roda o segundo mesmo se o primeiro falhar
`export CHAVE="valor"`	`$env:CHAVE = "valor"`	Vale só para esta janela do terminal
`source .venv/bin/activate`	`.venv\Scripts\Activate.ps1`	Veja o aviso sobre scripts abaixo
`python3`	`python` ou `py`	Veja P2.3
`echo $?`	`$LASTEXITCODE`	Código de saída do último programa: 0 é sucesso
`ls -la`	`Get-ChildItem -Force`	`ls -la` dá erro no PowerShell
`rm -rf pasta`	`Remove-Item -Recurse -Force pasta`	Apaga sem lixeira, nos dois. Confira o caminho antes
`cmd \| head -20`	`cmd \| Select-Object -First 20`
`grep texto arquivo`	`Select-String texto arquivo`
`which node`	`Get-Command node`
`touch arquivo`	`New-Item arquivo`
`curl -s url`	`curl.exe -s url`	No 5.1, `curl` sozinho é outro comando (`Invoke-WebRequest`)
Quebra de linha com `\`	Quebra de linha com ` (crase)	Ou escreva o comando numa linha só
`echo "x" > arquivo`	`Set-Content arquivo "x" -Encoding utf8`	No 5.1, `>` grava em UTF-16, que muitas ferramentas não leem

"A execução de scripts foi desabilitada neste sistema" É a mensagem mais comum no Windows, ao ativar o ambiente Python ou ao rodar npm. O Windows bloqueia scripts do PowerShell por padrão. Para liberar os scripts locais e os assinados, só para o seu usuário, rode uma vez:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Scripts baixados da internet sem assinatura continuam bloqueados.

Chave de API permanente $env:ANTHROPIC_API_KEY = "..." some ao fechar o terminal. setx ANTHROPIC_API_KEY "..." grava para os próximos terminais, mas em texto puro nas configurações do seu usuário. Para os labs, prefira definir na sessão ou usar um arquivo .env fora do Git.

Alternativas: o Git para Windows instala o Git Bash, onde os comandos bash do curso funcionam quase todos como estão. O WSL roda um Linux completo dentro do Windows e é a opção mais próxima do ambiente dos labs. Escolha um e mantenha: misturar os três confunde caminhos e instalações.

Quiz rápido

No PowerShell 5.1, cd projeto && npm install dá erro. O que fazer?

O 5.1 não conhece &&. Separando em duas linhas, você também vê se o primeiro comando deu certo antes do segundo.

P2.6 O primeiro projeto

Prática · 1h

Com o plugin autonomo, /autonomo:novo-projeto cria o projeto já com testes, GitHub e verificação automática. Para fazer à mão e ver cada passo:

mkdir meu-primeiro-projeto
cd meu-primeiro-projeto
git init
Set-Content README.md "# Meu primeiro projeto" -Encoding utf8
git add README.md
git commit -m "Primeiro commit"
gh repo create meu-primeiro-projeto --private --source . --push

mkdir meu-primeiro-projeto
cd meu-primeiro-projeto
git init
echo "# Meu primeiro projeto" > README.md
git add README.md
git commit -m "Primeiro commit"
gh repo create meu-primeiro-projeto --private --source . --push

Abra o endereço que o último comando mostrar: o repositório está no seu GitHub, privado.

Projeto do módulo: pronto para o Módulo 1

Projeto · 1h

O módulo está concluído quando você consegue, no seu terminal:

Mostrar as versões de Git, Node (20 ou mais) e Python (3.10 ou mais).
Clonar o repositório do curso e rodar a preparação do Módulo 1, usando a versão do seu sistema:

git clone https://github.com/MarciodeCampos/o-arco.git
cd o-arco\curso-ia\codigo\modulo-01
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r python\requirements.txt
cd typescript
npm install
cd ..

Rodar o primeiro lab: python python/01_rede_neural_xor.py mostra a perda caindo.
Ter o repositório meu-primeiro-projeto no seu GitHub, com um commit.

Anote cada erro que apareceu e como você resolveu. Essa lista é o seu primeiro registro de problemas, e o mesmo hábito vale para depurar agentes mais tarde.

Próximo passo: na trilha com código, siga para o Módulo 1. Na trilha com agentes, siga para o P3 · Desenvolver com agentes.

Recursos para aprofundar

Gratuitos

Documentação do PowerShell · em português
Pro Git · livro oficial do Git, em português
Manual do GitHub CLI · o comando gh
Instalar o WSL · Linux dentro do Windows