Neste tutorial eu vou te ensinar tudo que você precisa saber para começar a usar o Codex, o agente de programação da OpenAI. E fique tranquilo: mesmo que você nunca tenha mexido com programação ou com IA, você vai sair daqui entendendo como a ferramenta funciona e pronto para fazer seus primeiros projetos.
01O que é o Codex e quando usar
O Codex é um agente de programação da OpenAI. A grande diferença dele para o ChatGPT padrão é o seguinte: o chat é mais de conversa — você manda uma pergunta, ele responde e a coisa fica por aí, sem executar muitas ações. O Codex não. A gente instala ele dentro do nosso computador e, a partir daí, ele consegue acessar nossas pastas e arquivos. Como ele é especialista em programação, é excelente para criar sistemas, aplicativos e sites.
A regra é simples: se você quer tirar uma dúvida ou pegar ideias, converse no chat mesmo. Se você quer montar um sistema, um CRM ou uma landing page, aí sim você usa o Codex. Como referência, os principais concorrentes dele são o Antigravity (Google) e o Claude Code. Na minha opinião, o Claude é o melhor de todos, o Codex não fica muito atrás (tenho tido resultados excelentes com ele) e o Antigravity vem em terceiro.
02Como instalar e o plano necessário
Dá para usar o Codex de quatro formas diferentes. Nesta aula a gente vai usar o aplicativo, que já vem com uma IDE — um ambiente que facilita a vida de quem programa. O ponto positivo é que você visualiza as pastas e arquivos do projeto e consegue editar ou acompanhar o que a IA está criando, tudo no mesmo lugar.
Para instalar, é só baixar pela página inicial, clicar em executar, ir permitindo e depois fazer login — exatamente como em qualquer outro aplicativo. Um ponto importante: você precisa de um plano pago. É necessário ter pelo menos o plano Plus para ter acesso ao Codex.
03Projetos são pastas no seu computador
O conceito mais importante para começar: projeto é sinônimo de pasta dentro do seu computador. Você cria uma pasta para cada projeto. Eu gosto de manter tudo organizado dentro de uma pasta Projetos e, lá dentro, criar a pasta referente a cada trabalho.
Ao abrir o Codex, você tem a opção de começar do zero ou usar uma pasta existente. Basta selecionar a pasta do seu projeto e pronto — ele já passa a trabalhar ali dentro. No exemplo da aula, criei uma pasta para construir um projeto simples: um formulário (landing page) para coletar nome, e-mail e telefone.
04Comece sempre pelo modo de planejamento
Antes de sair pedindo para o Codex executar qualquer coisa, faça uma sacada que eu uso em todo projeto: tenha clareza do que você quer. Quanto mais informação você definir (paleta de cores, funcionalidades, o que precisa ser feito), melhor a IA executa.
E aqui vai uma dica de economia: como todas essas IAs (Codex, Claude Code, Antigravity) têm limite de uso por janela — geralmente a cada 5 horas — não gaste esse limite conversando para definir ideias. Faça esse bate-papo inicial em outra IA, como o Gemini, e chegue ao Codex com o planejamento pronto.
Com a ideia definida, ative o modo de planejamento (pelo botão ou digitando / e selecionando a opção). Ele analisa o que tem na pasta e monta um plano de implementação antes de executar. Eu recomendo fazer isso no início de qualquer projeto: se você sair pedindo para executar direto, ele provavelmente vai fazer de um jeito que você não quer e ficar batendo cabeça mais para frente. Depois de gerado, você pode aprovar o plano direto ou pedir ajustes — por exemplo, pedir para ele criar tudo dentro da pasta certa.
05Os três níveis de permissão
Conforme o Codex executa, ele vai pedir permissões. Existem três modos:
Padrão: ele faz sozinho o que sabe que é totalmente seguro e pede sua autorização para o resto. Para quem está começando, é o ideal — leia o que está acontecendo e veja se ele está fazendo certo.
Automática (revisão automática): em vez de você analisar cada ação, ele delega para um agente nativo revisar. Esse agente decide se vale renomear uma pasta, apagar um arquivo etc., e busca caminhos alternativos quando algo é arriscado. Útil quando você quer mais autonomia em projetos de baixo risco.
Acesso completo: ele executa tudo (criar, apagar, renomear) sem pedir nada. Eu uso quando já faço um projeto repetidamente — por exemplo, uma criação de carrossel que sempre sigo o mesmo passo a passo — porque o risco de besteira é baixo.
06Skills: personalizando o agente
Skills, em português, são habilidades: formas de personalizar o agente para ele funcionar do seu jeito. O exemplo mais clássico é uma skill de identidade visual. Em vez de explicar toda vez que a cor da minha empresa é laranja, preto e branco e que o nome é PLAS, eu crio uma skill e mando o Codex chamá-la sempre que precisar aplicar a identidade visual.
Tecnicamente, uma skill é uma pasta com um arquivo skill.md dentro. Esse arquivo tem um cabeçalho (o front matter / metadata) com nome e descrição, e depois o passo a passo do que a IA deve fazer. A descrição é o que diz à IA quando chamar aquela skill. Você também pode incluir imagens, códigos e outras referências dentro da pasta.
A estrutura no projeto é: pasta .agent → pasta skills → uma pasta para cada skill com seu skill.md. Importante: a cada mensagem, o agente lê apenas a descrição de todas as skills (não o documento inteiro). Se chamar uma, aí ele lê o conteúdo completo. Por isso, instale skills onde fazem sentido: uma skill pode ser global (vale para todos os projetos) ou específica de um projeto. Quanto menos informação ocupando a memória, melhor ele lembra das coisas e menos tokens gasta.
Você não precisa criar skills do zero. Pode pedir para o próprio Codex criar (existe uma skill nativa de criação), usar as skills nativas do sistema (gerar imagem, criar skills, criar plugins, buscar skills) ou baixar prontas de sites de ranking de skills. Para instalar uma da internet, basta copiar o link e pedir "instale essa skill no projeto" — ele acessa o GitHub e instala.
07Navegando pela interface
Na barra lateral você tem recursos importantes. Dá para abrir um chat paralelo no mesmo projeto (uma IA mexe nos textos enquanto outra mexe no design, por exemplo), acessar o terminal para rodar comandos e, principalmente, visualizar os arquivos — os documentos dentro da pasta do projeto, que você pode editar à mão.
Tem também o navegador integrado, que simula a web para você visualizar o resultado. No projeto da aula, a landing page apareceu ali com a minha identidade visual. O bom é que você consegue capturar a página e deixar comentários em pontos específicos — tipo "o título está muito grande, diminua 30%" — e depois pedir para o Codex aplicar os ajustes. Fazer correções é literalmente isso: olha o resultado, aponta o que não gostou e pede para ele editar.
08Janela de contexto e economia de tokens
Conforme você conversa, o agente vai acumulando informação no contexto. E aqui está o ponto: quanto maior o contexto, mais gasto. Mesmo que você mande só um "oi", ele relê tudo que está na memória antes de responder — então quanto mais histórico, mais tokens cada mensagem consome e mais rápido seu limite acaba.
Para controlar isso, você tem o compactar, que resume a conversa quando você vai partir para uma tarefa relacionada e quer manter algum contexto. E quando quer zerar de vez, a melhor opção é criar uma nova conversa: o contexto fica limpo (mesmo que, por um bug visual, ela não apareça na lista). A lógica é simples: quanto menos token você gasta, mais tempo consegue usar a IA.
09AGENTS.md: a memória manual do projeto
Se o contexto fica zerado numa nova conversa, como o Codex lembra do projeto? Com o AGENTS.md — um documento em Markdown que funciona como uma memória manual. Nele você (ou o próprio Codex) registra um resumo do que é o projeto: o que foi construído, as regras, as validações.
Meu fluxo é: faço o planejamento, peço para executar e, depois, peço para ele criar o AGENTS.md com um resumão do projeto. A partir daí, toda vez que eu mandar uma mensagem — mesmo em uma sessão nova com a memória limpa — ele lê esse documento e já entende o contexto, sem precisar reler todos os arquivos. Isso economiza tokens e evita que ele comece do zero a cada conversa. E você não precisa ser especialista em escrever o arquivo: peça para o próprio Codex criar.
10MCPs e plugins: conectando ferramentas externas
Os MCPs são conectores com ferramentas externas — Supabase (banco de dados), Meta, Google, Gmail e por aí vai. É um protocolo da própria empresa explicando como a IA se conecta e faz as requisições. Você pode pedir "instale o MCP no projeto" e ele faz a conexão, pedindo um login ou um token quando necessário.
Já o plugin é um pacote completo: junta o MCP (a conexão) com as skills (as instruções de como usar aquela ferramenta). Então, em vez de configurar tudo na mão, você instala um plugin do Supabase, por exemplo, e já vem a conexão pronta mais o passo a passo para a IA executar. Se você já sabe que vai precisar de Supabase, Gmail ou Google Calendar num projeto, pode instalar o MCP antes mesmo de começar a executar.
11Modelos, raciocínio e configurações
Digitando / você acessa os modelos disponíveis e o nível de raciocínio (baixo, médio, alto ou altíssimo) — quanto maior, mais capacidade de processamento e mais gasto. A regra que eu sigo: tarefa simples (renomear uma pasta, um ajuste pequeno) não precisa de raciocínio alto; tarefa complexa (criar um CRM completo) aí sim você sobe. Uma estratégia comum é usar o modelo mais inteligente para planejar e um modelo mais leve para executar, já que o plano pronto facilita a execução.
Nas configurações você personaliza bastante: modo de trabalho (programação ou dia a dia), permissões padrão, aparência (eu uso o modo claro), e até instruções pessoais — por exemplo, pedir para ele sempre me chamar de Pedro. Há também a opção de memória global, que registra coisas entre conversas e projetos; eu prefiro deixar desativada e trabalhar com o AGENTS.md, que já é suficiente.
12Forks, automações e Git
Alguns recursos extras que valem conhecer. O fork (bifurcar) cria uma cópia da conversa a partir de um ponto do projeto, para você testar duas coisas ao mesmo tempo sem uma interferir na outra — tipo mudar o projeto para azul em uma e para vermelho na outra. As automações permitem agendar ações recorrentes, como analisar os commits diariamente em busca de bugs.
Por fim, o Git: é um sistema que você instala no computador para salvar qualquer alteração do projeto e poder desfazer quando precisar. O GitHub é esse mesmo sistema na nuvem, onde você publica o repositório e, ao fazer o deploy, atualiza o projeto online. Há ainda hooks (gatilhos/automações), árvores de trabalho e o navegador integrado — tudo dá para configurar pedindo ao próprio Codex.
Com isso a gente cobriu basicamente tudo que funciona dentro do Codex: a interface, as configurações e a metodologia que eu uso para construir os projetos. A grande lição é a mesma de sempre: busque entender como a ferramenta funciona. Quando você domina os fundamentos, deixa de ser só mais um que mexe em IA e passa a obter resultados de verdade.