Para que serve o Codex
Codex é o agente de programação da OpenAI. Ele pode trabalhar nos arquivos de um projeto para ajudar a criar, revisar e corrigir código. Uma aplicação concreta é investigar uma página que funciona no computador, mas fica difícil de ler no celular.
Você explica o problema e acompanha a alteração. Para avaliar a entrega, precisa conseguir abrir o resultado e comparar com o que pediu. Saber descrever a necessidade e verificar o comportamento faz parte desse trabalho, mesmo quando a IA escreve o código.
Um exemplo: corrigir uma página no celular
Imagine que seu site de serviços tem um botão de contato que sai da tela quando a janela fica estreita. O objetivo é que uma pessoa consiga ler a página e acionar o contato no celular.
Com o Codex configurado para trabalhar na pasta de uma cópia desse site, você pode pedir:
Na página de serviços, o botão de contato sai da tela quando a largura é pequena. Leia os arquivos e identifique a causa. Corrija o problema preservando o texto, as cores e o destino do botão. Explique o que mudou e como posso conferir a página em uma largura de 390 pixels.
Esse é um exemplo de pedido para um site que você já tem. Se a página ainda não existe, descreva primeiro o que quer criar, quem vai usá-la e quais informações ela precisa apresentar.
Que contexto fornecer
Informe qual página apresenta o problema, como você chegou até ele e qual comportamento esperava. Se puder, acrescente uma captura da tela sem dados privados. O relato “o botão sai da tela no celular” dá mais direção do que “o site está ruim”.
Peça ao Codex que identifique como visualizar o projeto antes de fazer a alteração. Um site pode exigir uma ferramenta para rodar localmente; outro pode abrir como um arquivo. Não copie comandos de um projeto diferente sem entender para que servem.
A interface e a configuração dependem de como você usa o Codex. Consulte a documentação da interface de linha de comando se esse for o seu ambiente.
Quando usar um AGENTS.md
O Codex lê arquivos AGENTS.md para receber instruções de trabalho. Na pasta do projeto, você pode registrar regras recorrentes como “escrever em português do Brasil”, “preservar o e-mail de contato” e “explicar como revisar a página depois de uma mudança”.
O pedido específico continua na conversa. O arquivo guarda o que deve continuar valendo em outras tarefas. Escopos e prioridade entre arquivos estão na documentação oficial de AGENTS.md. As instruções ajudam com o contexto, mas você ainda precisa conferir a entrega.
Como revisar o resultado
Para o botão do exemplo, confira três coisas: ele cabe na tela estreita, continua legível e abre o mesmo contato correto. Veja também a página no computador, porque uma correção em uma largura pode afetar outra.
Peça a lista de arquivos alterados e o que foi testado. Se o Codex só revisou o código e não abriu a página, essa parte da verificação continua pendente. Quando houver uma falha, descreva o que permaneceu errado e peça uma correção pequena.
Antes de publicar, mantenha uma cópia da versão anterior. Considere a tarefa concluída quando o comportamento estiver corrigido, e não apenas quando a ferramenta disser que terminou.
Como escolher a próxima tarefa
Depois dessa correção, escolha outro problema observável: uma informação desatualizada, um link quebrado ou uma instrução pouco clara. Resolver uma mudança de cada vez facilita entender o efeito e desfazer o que não ajudou.
Você não precisa transformar toda necessidade em um novo aplicativo. Muitas vezes, melhorar uma página ou ferramenta que já existe traz um resultado mais direto para quem a usa.
Documentação oficial
Fontes consultadas em 9 de setembro de 2026. Os exemplos e critérios de revisão deste artigo são sugestões editoriais da WebVIP.
