Lição 1 de 8 · 12 min · Conteúdo de conceito, não envelhece
O que é um agente de código (e porque não é um chat)
No fim desta lição vais conseguir:
- Explicar a diferença entre um chat e um agente de código com um exemplo
- Descrever o ciclo ler, planear, agir e verificar
- Perceber porque é que o agente pede licença e o que deves olhar quando pede
- Situar o Claude Code e o Codex entre as ferramentas que existem
Pedes a um chat de IA: «Faz-me uma página para a padaria, com o horário.» Ele responde com um bloco de código. Tu copias, abres um editor, colas, gravas com o nome certo, abres no browser e vês que o horário de sábado ficou trocado. Voltas ao chat, explicas, ele dá-te outro bloco, e recomeças.
Quem fez o trabalho todo com as mãos? Tu. O chat só escreveu texto.
Agora o mesmo pedido a um agente de código, aberto no terminal dentro da pasta da padaria. Ele vê o que já lá está, diz-te o que vai fazer, cria o ficheiro (conforme o modo, pede licença antes de gravar), abre a página para confirmar e, se o sábado ficou trocado, corrige. Tu decides e confirmas. As mãos são dele.
Chat e agente, lado a lado
| Chat | Agente de código | |
|---|---|---|
| Onde está | Numa página web ou numa app | No terminal ou no editor, dentro de uma pasta |
| Vê os teus ficheiros | O que colares ou anexares | Lê a pasta onde o abriste |
| Altera ficheiros | No teu computador, não: dá-te texto ou um ficheiro para descarregar | Sim, conforme o modo e as tuas licenças |
| Confirma o resultado | Alguns correm código, mas num ambiente deles | Corre comandos no teu computador para verificar |
| Quem faz o trabalho | Tu | Ele, contigo a supervisionar |
O «cérebro» pode até ser parecido. O que muda é que o agente tem mãos e trabalha no teu computador.
O ciclo: ler, planear, agir, verificar
Um agente trabalha sempre em voltas do mesmo ciclo:
- Ler. Abre os ficheiros da pasta e procura o que importa. Numa pasta vazia, percebe que está vazia.
- Planear. Decide os passos. Podes pedir-lhe que te mostre o plano antes de fazer seja o que for (lição 1/03).
- Agir. Cria ou altera ficheiros e corre comandos.
- Verificar. Confirma se resultou: abre o ficheiro, corre o programa, lê a mensagem de erro.
Se a verificação falha, volta ao início: lê o erro, ajusta o plano, age outra vez. Continua até acabar ou até precisar de ti.
Exemplo
Pedes: «Na página da padaria, muda o horário de sábado para 7h–13h.»
Ler: abre index.html e encontra a linha do sábado.
Planear: «Vou mudar só essa linha.»
Agir: altera a linha; conforme o modo, mostra-te antes o diff (lição 0/03) e pede licença.
Verificar: volta a ler o ficheiro e confirma que o sábado diz 7h–13h e que o resto ficou igual.
As ferramentas são as mãos
Um modelo de IA, sozinho, só escreve texto. O agente é o programa à volta dele que transforma esse texto em acções. Cada acção chama-se uma ferramenta:
- Ler ficheiros e procurar texto dentro deles.
- Editar e criar ficheiros.
- Correr comandos no terminal (os da lição 0/01 e muitos outros).
- Em alguns casos, procurar na Internet.
Quando vês no ecrã «a ler index.html» ou «a correr ls», é o agente a usar uma ferramenta.
Porque é que pede licença
Ler um ficheiro não estraga nada. Apagar, gravar por cima, instalar ou enviar coisas para a Internet já pode estragar. Por isso, conforme o modo e as regras, o agente pára antes de certas acções, mostra-te o que quer fazer e espera pelo teu sim. Não é garantido: há modos em que faz sozinho o que cabe dentro de certos limites (lição 1/03).
Pensa num ajudante novo na padaria. No primeiro dia não lhe dás a chave do cofre: vês como trabalha. Com o tempo, deixas que faça sozinho as coisas pequenas. Com um agente é igual: há modos que pedem menos licenças, mas enquanto estás a aprender escolhe o que pergunta mais.
Cuidado
O agente engana-se, e às vezes com toda a confiança: diz «está pronto e testado» quando não está. Também pode ser enganado por texto que lê, por exemplo um ficheiro ou uma página com instruções escondidas. O pedido de licença não é burocracia: é o teu momento de olhar. Enquanto aprendes, não o desligues: nem a pasta de experiências te protege, porque um comando pode mexer noutras pastas. O modo sem licenças é só para ambientes isolados, como uma máquina virtual (lição 1/06).
Dica
Quando não perceberes o que o agente quer fazer, recusa e pergunta. «Explica-me em português simples o que este comando faz» é uma resposta perfeitamente válida a um pedido de licença.
Claude Code e Codex
Neste curso usamos dois agentes, sempre lado a lado:
- Claude Code, da Anthropic (a empresa do Claude). Corre no terminal e também existe como extensão para editores e como app de computador.
- Codex CLI, da OpenAI (a empresa do ChatGPT). Corre no terminal e também existe como extensão para editores e dentro da app de computador do ChatGPT.
Os dois fazem o ciclo ler, planear, agir e verificar. Os dois podem pedir licença, têm modo de plano e lêem um ficheiro de instruções na pasta do projecto (o CLAUDE.md num, o AGENTS.md no outro, lição 1/07). Mudam os nomes dos comandos e alguns pormenores, e é isso que vais ver nas próximas lições. Para saber que planos dão acesso a cada um, consulta a página Estado actual.
Há outros agentes de código, como o Gemini CLI (Google), o Cursor e o GitHub Copilot; a ideia é a mesma, e há uma página à parte que os compara.
Dica
Não precisas de escolher já. O que aprendes num serve quase todo no outro: a pasta de experiências, o plano antes de agir, a leitura do diff e o hábito de confirmar.
Exercício
Para cada tarefa, decide se chega um chat ou se dá jeito um agente de código:
Depois escreve, para a tarefa 2, o que o agente faria em cada passo do ciclo.
Como sei que ficou bem 1 e 3 são para um chat (o resultado é texto para leres). 2 e 4 são para um agente (há ficheiros no teu computador para ler e alterar). Para a tarefa 2: ler as doze páginas, planear a mudança, alterá-las pedindo licença e verificar que todas ficaram iguais.
Se não deu
- Hesitaste numa tarefa: pergunta-te «o resultado é texto para eu ler, ou são ficheiros no meu computador que têm de mudar?». A primeira é para um chat; a segunda, para um agente.
- Puseste a tarefa 3 no agente: não está errado, mas é como chamar o canalizador para mudar uma lâmpada. Um chat chega.
- Não te lembraste dos passos do ciclo: volta ao exemplo da padaria acima e copia a estrutura.
Vídeos
O Código Fonte TV explica o que são agentes de IA na engenharia de software e como trabalhar com eles.
A IBM define agentic coding e mostra um fluxo iterativo em que o agente trabalha sobre código existente, com confiança e controlo.
Testa o que aprendeste
Correcções a esta lição (1)
- : Depois de uma revisão externa: o agente pede licença «conforme o modo e as regras», sem a promessa de perguntar sempre; a tabela reconhece que os assistentes de conversa também recebem ficheiros e alguns correm código; a pasta de experiências deixou de ser apresentada como garantia de segurança. As opções do quiz foram reordenadas.