MÓDULO 2.1
Terminal e Codex na prática
Abrir um projeto de treino no Codex e produzir uma alteração verificável.
O que é
Terminal é a janela em que você escreve comandos para o computador. Shell é o programa que interpreta esses comandos. Aqui os exemplos de terminal usam Bash no Linux ou macOS; no Windows, use um ambiente Bash via WSL ou siga o instalador oficial para Windows. Não cole comandos Linux diretamente no PowerShell sem adaptação.
Por que aprender
Saber em qual ambiente você está evita erros que parecem falhas da IA. O comando cd muda a pasta atual; pwd mostra a localização no Bash. Não é necessário decorar dezenas de comandos para começar.
Conceitos-chave
Terminal; shell; pasta atual; comando e resposta.
O que é
A página oficial do Codex oferece instalador para macOS/Linux e orientações específicas para Windows. Instalar significa adicionar o programa à máquina. O comando de instalação baixa e executa um script oficial; leia a fonte, confira o domínio e use sua própria conta. Não execute comandos recebidos de páginas desconhecidas.
Por que aprender
Instalação, login e execução são etapas diferentes. Um programa instalado ainda precisa de autenticação. Um login concluído não significa que você abriu a pasta correta.
Conceitos-chave
Fonte oficial; instalação; versão; diagnóstico.
O que é
Execute codex login e conclua o fluxo de navegador para entrar com ChatGPT. Se optar por API, a chave precisa estar na variável OPENAI_API_KEY; encaminhe-a pela entrada padrão, sem digitá-la no comando. Um arquivo .env sozinho não autentica o Codex: algum mecanismo deve carregar a variável.
Por que aprender
Colar a chave em exemplos, mensagens ou histórico pode expor a conta. Também é possível estar autenticado pelo método errado e consumir uma modalidade diferente da esperada.
Conceitos-chave
codex login; codex login status; entrada padrão; conta ativa.
O que é
A pasta de trabalho é a bancada da tarefa. Crie uma área pequena, com arquivos de treino, antes de permitir mudanças. Um README.md descreve a finalidade para pessoas; AGENTS.md dá instruções operacionais ao agente. Você não precisa abrir sua pasta pessoal inteira para experimentar.
Por que aprender
Um escopo pequeno reduz ambiguidade e facilita revisar diferenças. Quando algo sai errado, fica claro quais arquivos deveriam ter sido afetados.
Conceitos-chave
Escopo local; README; AGENTS; arquivos de entrada.
O que é
Comece solicitando inspeção: listar estrutura, ler instruções e explicar pendências. Peça que o agente cite quais arquivos utilizou. Depois de conferir, autorize uma alteração pequena e nomeada, como criar plano.md com três próximos passos.
Por que aprender
Separar diagnóstico e alteração cria uma referência para a revisão. Você aprende o fluxo sem misturar instalação, grande refatoração e publicação numa única tentativa.
Conceitos-chave
Inspecionar; planejar; alterar; validar.
O que é
As permissões do cliente controlam acesso a arquivos, rede e execução. Instruções em linguagem natural orientam o comportamento, mas não substituem isolamento técnico. Comece com permissões restritas à pasta de treino. Não ensine a remover todas as proteções para contornar qualquer erro.
Por que aprender
Recuperar uma alteração exige saber o que existia antes. Git e cópias de arquivos oferecem pontos de retorno; eles serão praticados adiante. Leia o que o comando fará antes de ampliar permissões.
Conceitos-chave
Permissão mínima; alterações pequenas; comparação; ponto de retorno.