Como o OpenAI Codex funciona: modelos, agente de código e formas de uso

Ao final deste capítulo você será capaz de explicar, em palavras simples, o que é o OpenAI Codex hoje, como ele lê e modifica um projeto, e qual das três formas de uso combina melhor com o seu trabalho. Nada de instalação por enquanto: aqui construímos o mapa mental que vai sustentar todo o resto do livro.

De completador de código a agente de programação

O nome Codex existe há alguns anos. Na primeira geração, era um modelo que completava linhas de código enquanto você digitava. Hoje o significado é bem mais amplo. O OpenAI Codex atual é um agente de programação: um programa que recebe uma instrução em linguagem natural, explora os arquivos do seu repositório, decide o que precisa ser alterado, escreve as mudanças, executa comandos no terminal e verifica se o resultado funciona.

A diferença entre autocompletar e agir é o ponto central. Um autocompletador sugere o próximo trecho a partir do que está na tela. Um agente pode abrir cinco arquivos, rodar a suíte de testes, ler a mensagem de erro, corrigir o que quebrou e rodar os testes de novo. Ele trabalha em ciclos, não em uma única resposta.

Por baixo, o Codex é movido pelos modelos de raciocínio da OpenAI, treinados com foco em engenharia de software. Existem variações: modelos mais rápidos e econômicos para tarefas simples, e modelos com raciocínio mais profundo para problemas difíceis, que gastam mais tempo pensando antes de escrever. Você vai aprender a escolher entre eles nos capítulos de configuração e de boas práticas. Para agora, basta guardar a ideia: o modelo é o cérebro, e o Codex é o corpo que dá a ele mãos para mexer no seu projeto.

O ciclo do agente em cinco passos

Quase tudo que o Codex faz segue o mesmo ciclo. Entender esses cinco passos torna o comportamento da ferramenta previsível.

Continue em nosso aplicativo e ...

• Ouça o áudio com a tela desligada
• Ganhe Certificado após a conclusão
• + de 5000 cursos para você explorar!

ou continue lendo abaixo...

Baixar o aplicativo

1. Ler o contexto. O agente lista pastas, abre arquivos relevantes, procura por nomes de funções e lê arquivos de configuração para descobrir a linguagem, o gerenciador de pacotes e os comandos do projeto.
2. Planejar. Ele monta uma sequência de passos: quais arquivos tocar, em que ordem, o que rodar depois. Em tarefas maiores, esse plano aparece na tela e pode ser discutido com você antes de qualquer alteração.
3. Editar. As mudanças são aplicadas como um diff, ou seja, uma lista de linhas removidas e adicionadas em cada arquivo, exatamente no formato que você já conhece de um sistema de controle de versão.
4. Executar. O agente roda comandos: instalar dependências, compilar, executar o programa, rodar testes, usar o comando de formatação do projeto.
5. Verificar. Ele lê a saída do que executou. Se um teste falhou, volta ao passo de planejar com essa informação nova e tenta outra abordagem. O ciclo se repete até a tarefa terminar ou até ele pedir sua ajuda.

Na prática, a tela se parece com um diário de bordo. O agente narra o que faz, mais ou menos assim:

Lendo package.json
Lendo src/carrinho.js
Plano:
  1. Extrair o cálculo de frete para uma função
  2. Atualizar os pontos de chamada
  3. Rodar npm test

Alterando src/carrinho.js (+18 -6)
Executando: npm test
  14 passaram, 1 falhou
Ajustando src/carrinho.test.js
Executando: npm test
  15 passaram

Esse registro é a sua principal ferramenta de controle. Você não precisa confiar no resultado final às cegas, porque consegue ver cada arquivo lido e cada comando executado.

As três formas de usar o Codex

O mesmo agente é oferecido em três embalagens diferentes. Elas compartilham a conta, os modelos e a maneira de trabalhar, mas servem a momentos distintos.

A primeira é o Codex CLI, a interface de linha de comando. Você abre o terminal dentro da pasta do projeto e conversa com o agente ali. É a forma mais direta e mais poderosa, porque o agente tem acesso natural aos comandos que você já usa. É também a base para automações, que veremos mais adiante.

A segunda é a extensão para o editor, disponível para o Visual Studio Code e editores compatíveis. Aqui a conversa acontece em um painel lateral, e os diffs aparecem com o destaque colorido do próprio editor. É a opção mais confortável para quem passa o dia lendo código, porque revisar uma alteração dá dois cliques.

A terceira é o Codex na nuvem, acessível pelo ChatGPT e integrado ao GitHub. Nesse modo, o agente roda em um contêiner remoto, com uma cópia do seu repositório. Você delega a tarefa, fecha o navegador e volta depois para ver o resultado, que normalmente chega na forma de um pull request. Como cada tarefa roda isolada, é possível disparar várias em paralelo. Vale lembrar que, nesse modo, uma cópia do seu código sai da sua máquina para servidores da OpenAI: confirme a política da sua empresa e os termos do plano antes de conectar repositórios com dados sensíveis ou sob contrato de confidencialidade.

A escolha não é definitiva. Muita gente usa a linha de comando para o trabalho do dia, a extensão quando quer revisar uma mudança grande com atenção, e a nuvem para tarefas chatas que podem esperar, como atualizar dependências ou escrever testes que faltam.

O que o Codex consegue fazer

• Criar projetos e arquivos a partir de uma descrição.
• Explicar código que você nunca viu, inclusive em linguagens que não domina.
• Encontrar a causa de um erro a partir de uma mensagem e de um passo de reprodução.
• Aplicar a mesma alteração em muitos arquivos com consistência.
• Escrever e rodar testes, e insistir até que passem.
• Executar comandos de build, formatação e análise estática.

O que ele não consegue fazer

Essa lista é igualmente importante, e ignorá-la é a origem de quase toda frustração com ferramentas de inteligência artificial.

• Ele não sabe o que você não contou. Regras de negócio que só existem na cabeça da equipe, prazos, decisões de arquitetura não documentadas: nada disso está no repositório, então nada disso entra na conta.
• Ele pode errar com confiança. O agente às vezes inventa uma função de biblioteca que não existe ou sugere um pacote inexistente. O nome comum para isso é alucinação, e a defesa é sempre a mesma: rodar o código e revisar o diff.
• Ele não substitui sua revisão. A responsabilidade pelo código que entra no repositório continua sendo humana.
• Ele não vê o mundo fora do que você libera. Por padrão, o agente trabalha dentro da pasta do projeto e com acesso restrito à rede, justamente para que um comando infeliz não cause estrago. Isso é um padrão, não uma garantia: existem modos de aprovação que liberam o acesso total ao sistema de arquivos e à rede, e, mesmo na configuração padrão, o agente pode sobrescrever ou apagar arquivos dentro da própria pasta do projeto. Por isso, antes de colocar o agente para trabalhar, salve o que você já tem em um commit do Git, para conseguir desfazer qualquer alteração indesejada.
• Ele tem contexto finito. Em projetos gigantes, o agente lê partes do código, não tudo. Tarefas bem delimitadas funcionam muito melhor do que pedidos vagos e enormes.

O que você precisa ter

Para usar o Codex, você precisa de uma conta da OpenAI. Há dois caminhos de acesso. O primeiro é entrar com a sua conta do ChatGPT em um plano pago, como Plus, Pro, Business ou Enterprise, e nesse caso o uso do Codex já vem incluído, com limites que se renovam por período. O segundo é usar uma chave de interface de programação de aplicações, conhecida pela sigla API, e pagar por consumo. Os nomes e os limites dos planos mudam com frequência, então confirme no site oficial antes de decidir.

Além da conta, o mínimo prático é: uma máquina com macOS, Linux ou Windows, o Git instalado, e um projeto de verdade para experimentar. Uma ressalva importante: o suporte oficial da linha de comando é a macOS e Linux, e no Windows ele ainda é experimental, então a recomendação é rodar o Codex CLI dentro do WSL2, o subsistema Linux do Windows. Para o Codex na nuvem, acrescente uma conta do GitHub com acesso ao repositório que você quer conectar.

Recapitulando

O Codex de hoje é um agente de programação, não um completador de linhas. Ele funciona em um ciclo de ler contexto, planejar, editar, executar e verificar, e mostra na tela cada arquivo que abre e cada comando que roda. Existem três formas de uso: a linha de comando no terminal, a extensão para o editor e o agente na nuvem integrado ao GitHub, e elas se complementam. O agente é forte em tarefas delimitadas com verificação automática, e frágil quando falta contexto ou quando ninguém revisa o resultado. Com uma conta paga do ChatGPT ou uma chave de API, você já tem o necessário para começar na linha de comando e na extensão do editor; o Codex na nuvem, por sua vez, depende de um plano pago do ChatGPT, e não da chave de API.