Codex OpenAI: o que é, como funciona e como começar

Agente de código que roda no seu terminal e edita arquivo sozinho. Rodei uma primeira tarefa real e cronometrei o que sai do outro lado.

Codex OpenAI: o que é, como funciona e como começar
Neste artigo
  1. O que é o Codex, afinal?
  2. Como o Codex funciona por dentro?
  3. Como rodar a primeira tarefa?
  4. Quanto tempo leva uma tarefa de verdade?
  5. Que tipo de tarefa ele faz bem?
  6. Quanto custa usar?
  7. Codex ou outro agente, como escolher?
  8. Que erros de iniciante custam mais caro?
  9. O que perguntam sobre o Codex da OpenAI?

O Codex OpenAI é um agente de código que roda no seu terminal, lê o repositório sozinho e edita arquivo, em vez de sugerir texto dentro do editor. Ele não é autocompletar nem chat, é um processo que recebe uma tarefa, decide os passos e mexe no disco dentro de uma caixa com permissão limitada. Rodei uma primeira tarefa real aqui para medir quanto tempo leva e o que sai do outro lado.

O que é o Codex, afinal?

É um programa de linha de comando que você instala na sua máquina e chama passando uma instrução em português mesmo. Ele abre a pasta do projeto, lê o que precisa ler, escreve os arquivos e devolve um resumo do que fez.

A diferença para o que veio antes está no verbo. Autocompletar sugere, chat responde, e o agente executa: ele cria arquivo, roda comando, lê a saída do comando e decide o próximo passo a partir dela. Você entra no fim, para revisar o resultado, e não no meio, aprovando linha por linha.

Vale desfazer uma confusão comum de nome. “Codex” já foi o nome de um modelo antigo da OpenAI, aposentado faz tempo, e hoje é o nome dessa ferramenta de agente. Quando alguém fala em Codex em 2026, quase sempre está falando do agente de terminal.

Como o Codex funciona por dentro?

O ciclo dele é curto e se repete: ele lê o seu pedido, olha os arquivos que julga relevantes, propõe uma ação, executa, lê o resultado e decide se terminou ou se continua. É esse laço que separa agente de chat, porque o resultado de um passo alimenta o próximo.

Duas coisas nesse laço mudam bastante a sua experiência, e vale entender antes de usar.

A primeira é o sandbox. Por padrão ele roda em modo de leitura, ou seja, analisa e explica, mas não toca em nada. Para ele escrever, você libera explicitamente, e essa é a diferença entre uma ferramenta que você deixa rodar sozinha e uma que precisa de babá.

A segunda é o contexto. Ele não carrega o repositório inteiro, ele procura o que parece relevante. Em projeto grande isso significa que a qualidade da sua instrução determina o que ele vai encontrar, e nomear o arquivo certo no pedido economiza minutos.

Como rodar a primeira tarefa?

Três passos, e o terceiro é o único que importa de verdade.

Instale o pacote pelo gerenciador do Node e faça o login, que abre o navegador e vincula a sua conta. Se você já paga assinatura, ela costuma cobrir o uso, sem precisar de chave de API separada.

Depois, entre na pasta do projeto e chame o agente com a tarefa escrita como você explicaria para uma pessoa. Comece pelo modo de leitura, pedindo para ele explicar alguma coisa que você já entende, porque assim você calibra a qualidade da resposta contra algo que você sabe conferir.

Só então libere a escrita, e faça isso em pasta versionada, com tudo commitado antes. A rede de segurança não é a permissão do sandbox, é o seu histórico do git.

Quanto tempo leva uma tarefa de verdade?

Medi duas execuções reais aqui, na mesma máquina e no mesmo dia, com a mesma ferramenta e enunciados de tamanhos diferentes:

Execução (medido em 29/08/2026, fonte: cronometragem própria, codex-cli 0.144.1) Pedido Tempo Saída
Enunciado detalhado, com formato de entrada, saída e lista de testes 1214 caracteres 159 s 2 arquivos, 87 linhas, 7 testes
Enunciado vago, uma linha 71 caracteres 148 s 2 arquivos, 60 linhas, 3 testes

Repare que o tempo praticamente não muda com o tamanho do pedido. O que muda é a quantidade de decisão que ele toma sozinho, e no pedido vago foram sete decisões que eu não tinha tomado, incluindo o formato de saída inteiro.

Essa é a lição prática do primeiro dia. Escrever um enunciado maior não deixa o agente mais lento, deixa o resultado mais previsível.

Que tipo de tarefa ele faz bem?

Aqui no meu processo ele leva vantagem em trabalho fechado e mecânico, aquele que tem resposta certa e muito volume. Converter um módulo para outro padrão, escrever teste para código que já existe, ajustar assinatura de função em vinte lugares, migrar sintaxe.

Ele também vai bem em explicar código alheio, e esse é um uso que a maioria descobre tarde. Entrar num repositório desconhecido e pedir um mapa do que faz o quê economiza a primeira hora de qualquer projeto novo.

Onde ele sofre mais é em tarefa que depende de contexto espalhado e de decisão de produto. Não é que ele erre, é que ele decide sozinho, e decisão de produto tomada em silêncio custa caro depois.

Quanto custa usar?

Se você já tem assinatura do ChatGPT, o uso pelo terminal costuma entrar nela, e é assim que eu uso aqui. Existe também o caminho por chave de API, cobrado por token, que faz mais sentido quando você está automatizando alguma coisa e não trabalhando de forma interativa.

O limite prático não é preço, é a janela de uso da assinatura, que zera de tempos em tempos. Quem roda muita tarefa em sequência esbarra nela antes de esbarrar em qualquer outra coisa, e vale acompanhar quanto sobrou antes de despachar um trabalho grande.

Codex ou outro agente, como escolher?

Eu uso mais de um, e não por indecisão. Rodei a mesma tarefa nos dois e o resultado foi curioso: os dois passaram nos testes um do outro e mesmo assim entregaram comportamento diferente num caso que nenhum dos dois testou.

Para mim o Codex leva vantagem quando o trabalho é fechado e o enunciado é preciso, e ele tende a entregar código mais enxuto. Isso varia bastante conforme o tipo de projeto, então o melhor teste é rodar uma tarefa sua nos dois e olhar o que volta, em vez de confiar em comparação de terceiro.

Que erros de iniciante custam mais caro?

Três, e eu cometi os três.

Liberar escrita em pasta sem git. Sem histórico, desfazer vira arqueologia, e é a diferença entre um comando e uma tarde perdida.

Pedir uma tarefa grande demais na primeira vez. Agente entrega mais consistente em pedaço médio, e tarefa enorme sai com decisões demais empilhadas, que é justo o que você não consegue revisar.

E aceitar o resultado sem rodar o teste. Nas minhas duas execuções o próprio agente avisou que não tinha conseguido rodar a suíte no ambiente dele, o que foi honesto da parte dele, mas quem tem que rodar sou eu.

O que perguntam sobre o Codex da OpenAI?

Preciso saber programar para usar? Ajuda muito, principalmente para revisar. Dá para fazer coisa útil sem saber, mas você fica sem conseguir julgar quando ele decidiu errado, e é aí que o custo aparece.

Ele roda em Windows? Roda, e é onde eu uso. Vale saber de uma pegadinha: em Windows o executável é um atalho de terminal, e prompt com várias linhas passado como argumento pode ser cortado na primeira quebra. Mandar por arquivo ou pela entrada padrão resolve.

Ele apaga meu código? Ele pode alterar arquivo quando você libera escrita, e é para isso que serve o sandbox de leitura como padrão. A proteção real é commitar antes e revisar o diff depois.

Dá para usar em projeto de cliente? Dá, com as mesmas cautelas de qualquer ferramenta que lê o seu código: saber o que sobe, o que fica local, e o que o contrato com o cliente permite. Se o dado não pode sair da máquina, a conversa é outra.

WA in X