Gravação e reprodução do OpenAI Codex, explicado

O que é a gravação e reprodução do Codex?

Um pouco de contexto primeiro. O Codex é a ferramenta de programação agêntica da OpenAI: uma CLI de terminal, uma extensão de IDE e um aplicativo desktop que pode executar tarefas para você em sua máquina e na web. Nos últimos meses, ele cresceu muito além do código para uso geral do computador, o que é o que torna esse recurso possível.

Gravação e reprodução, segundo a documentação do Codex, "permite demonstrar um fluxo de trabalho no seu Mac e transformá-lo em uma skill reutilizável." A OpenAI sugere usá-lo "quando o fluxo de trabalho é repetitivo, depende das suas preferências ou é mais fácil de mostrar do que descrever em um prompt."

Os exemplos na documentação são deliberadamente mundanos, e esse é o ponto: você pode gravar como arquiva uma despesa, reserva uma vaga de estacionamento, cria uma issue corretamente configurada, publica um vídeo ou baixa um relatório recorrente. São tarefas chatas de escrever como prompt ("clique no dropdown, escolha a terceira opção, somente se o projeto for interno...") mas triviais de simplesmente fazer enquanto algo observa.

O recurso chegou no changelog de 18 de junho de 2026 junto com o aplicativo Codex 26.616 e a CLI 0.141.0. A apresentação oficial no lançamento, em um post da comunidade de desenvolvedores da OpenAI, foi que você "mostra ao Codex uma tarefa recorrente, como preencher um relatório de despesas ou enviar uma solicitação de folga," e "o Codex transforma essa demonstração em uma skill inspecionável e editável. Você controla quando a gravação começa e termina."

Como a gravação e reprodução funciona na prática

Aqui está o mecanismo de ponta a ponta, porque a "mágica" é na verdade três etapas concretas.

Gravação. Você inicia uma gravação no aplicativo Codex: abra Plugins, abra o menu + e selecione Record a skill. O Codex mostra um prompt sugerido, você adiciona contexto, e depois de aprovar a solicitação de permissão, basta executar o fluxo de trabalho no seu Mac. Você para pelo menu da barra de menus, pelo overlay ou dizendo ao Codex que terminou.

O que ele captura. Durante a gravação, a documentação diz que o Codex "observa as ações e o conteúdo das janelas necessários para aprender o fluxo de trabalho," e a gravação continua até você pará-la. Esse detalhe de "conteúdo das janelas" importa: ele está observando sua tela, o que é exatamente por isso que a central de ajuda da OpenAI avisa para evitar inserir senhas ou dados sensíveis durante a gravação.

O que você recebe de volta. Esta é a parte que acho mais interessante como alguém que constrói agentes. O Codex não salva uma macro literal de clique a clique. Ele inspeciona o fluxo de trabalho capturado e elabora uma skill que, nas palavras da OpenAI, "explica quando usar o fluxo de trabalho, quais entradas ele precisa, quais passos seguir e como verificar o resultado." O resultado é uma descrição de skill editável que você pode ler e refinar, não uma gravação opaca.

Em seguida, você reproduz: inicia um novo thread, pede ao Codex para usar a skill e "fornece os valores que diferem dessa vez, como o arquivo a fazer upload, a issue a criar ou o intervalo de datas do relatório." O Codex usa a skill como contexto e completa a tarefa com quaisquer ferramentas disponíveis, incluindo Computer Use, ações de navegador e plugins instalados.

Esse último ponto é a melhoria real em relação às gravadores de macro com os quais algumas pessoas estão comparando. Uma macro reproduz as mesmas coordenadas às cegas. Uma skill do Codex é uma descrição razoada de intenção, então ela pode se adaptar quando o nome do arquivo, a data ou o layout mudam.

Espere, existem dois "replays" diferentes

Se você pesquisou "gravação e reprodução do Codex" e chegou a um thread sobre transcrições JSONL e depuração, não estava imaginando. A expressão aponta para duas coisas diferentes, e confundi-las é a confusão mais comum que tenho visto nas discussões.

Gravação e reprodução (o recurso lançado) é sobre o que trata todo este post: ensinar ao Codex uma skill demonstrando um fluxo de trabalho de interface.

"Session replay" é o sentido das ferramentas de desenvolvimento: re-executar uma execução de agente salva para ver o que ela fez, reproduzir um resultado instável ou auditar uma decisão. As sessões do Codex são armazenadas como transcrições, e cresceu um apetite real por reproduzi-las. A solicitação de recurso mais votada no GitHub expressou a dor de forma direta:

"Cada sessão do Codex é efêmera. Quando os desenvolvedores encontram um fluxo de trabalho bem-sucedido... eles não conseguem facilmente: Reproduzi-lo em projetos diferentes, Compartilhá-lo com membros da equipe, Controlar a versão do fluxo de trabalho."

@Aki-07, GitHub openai/codex#5083

Essa lacuna é por que os desenvolvedores construíram suas próprias camadas de replay. Ferramentas da comunidade como o codex-replay transformam os logs de rollout de uma sessão em um único arquivo HTML compartilhável, e outras visualizam a cadeia de tool-calls ao vivo, porque, como um construtor colocou no Reddit r/codex, "O Codex é poderoso, mas sua execução é uma caixa preta. Você vê o resultado final, não a jornada."

Então: o novo recurso ajuda você a criar um fluxo de trabalho. O session replay ajuda você a inspecionar uma execução. Ambos são úteis, mas apenas o primeiro foi lançado em 18 de junho.

Quando usar gravação e reprodução (e quando não usar)

A OpenAI é surpreendentemente clara de que essa é uma das três formas de dar uma skill ao Codex, e elas se sobrepõem menos do que você imagina.

Se uma tarefa é fácil de descrever em palavras, basta usar um prompt no Codex e seguir em frente. A gravação não acrescenta nada.

A gravação e reprodução ganha seu lugar quando a tarefa é "mais fácil de mostrar do que descrever" e é seu próprio fluxo de trabalho repetitivo com critérios de sucesso estáveis e claros, o que a documentação aponta como o ponto ideal.

E quando você quer distribuir uma capacidade estável e documentada para uma equipe, agrupar várias skills ou integrar servidores MCP, a OpenAI orienta para criar um plugin. A gravação e reprodução é descrita como "uma forma rápida de criar uma skill a partir de um fluxo de trabalho demonstrado", não a forma de lançar algo durável para quarenta colegas.

As dicas da OpenAI para melhores gravações valem uma leitura rápida antes da primeira tentativa. As que realmente fazem diferença: diga ao Codex seu objetivo e quais entradas variam antes de pressionar gravar, mantenha a demonstração curta e completa, use entradas realistas (não secretas) e pare de gravar no momento em que o fluxo de trabalho terminar, em vez de continuar com limpezas não relacionadas.

Os limites que vale conhecer antes de depender do recurso

Este é um lançamento, não um recurso maduro, e as limitações são reais. Nenhuma delas é um impedimento absoluto, mas algumas vão determinar silenciosamente se você pode usá-lo.

A reação da comunidade seguiu essas limitações quase perfeitamente. O recurso em si impressionou as pessoas, com uma reação no r/accelerate sendo um direto "isso é surreal e muito mais poderoso do que gravação de macro." Mas as duas reclamações recorrentes foram exatamente as limitações acima:

"O Codex lançou gravação e reprodução essa semana. Mostre uma tarefa ao vivo, ele observa sua tela, transforma em uma skill. Recurso legal. Somente para Mac, e só funciona de volta pelo Codex."

u/RawalDelhi, Reddit r/AI_Agents

Esse ponto de "só funciona de volta pelo Codex" é o estratégico. A skill que você grava é portável em conceito, mas bloqueada no Codex na prática, o que é uma troca razoável se você já está comprometido com o ecossistema e uma fricção real se não estiver.

O que isso diz sobre o rumo dos agentes

Tire as ressalvas do macOS e resta uma mudança significativa: a forma mais barata de ensinar a um agente está começando a ser a demonstração, não a instrução. Escrever um prompt perfeito é difícil. Fazer a tarefa enquanto algo observa é fácil. Isso é um ajuste melhor a como a maioria das pessoas realmente detém conhecimento sobre seu próprio trabalho, que vive na memória muscular, não na documentação.

Esta é a parte onde vou mostrar minha posição, porque construo agentes de IA na eesel profissionalmente. O instinto de "ensinar mostrando, não dizendo" é exatamente certo, e é o mesmo instinto por trás de como uma boa automação de suporte já funciona. Passamos os últimos anos colocando agentes de IA em filas de suporte ao vivo, e a lição que ficou é que um agente é tão bom quanto o que aprendeu, e o professor mais rico é o trabalho que você já fez.

Para suporte ao cliente especificamente, você não grava a si mesmo respondendo tickets um por um. O histórico já está no seu helpdesk. Então a melhor versão de "gravação e reprodução" para uma equipe de suporte é um agente que lê seus tickets anteriores do Zendesk ou Front, sua central de ajuda e suas macros, e aprende os padrões desde o primeiro dia, sem necessidade de demonstração. O recurso do Codex é a versão para tarefas de desktop de uma ideia que, para suporte, já está mais avançada.

Experimente o eesel para automação de suporte

Se você chegou aqui porque está tentando automatizar as partes repetitivas do seu trabalho, e esse trabalho é suporte ao cliente em vez de preencher relatórios de despesas, esta é a parte que vale sua atenção.

O eesel AI é um agente de suporte com IA que se conecta ao seu helpdesk existente e aprende com o que você já tem. Em vez de gravar cada tarefa, ele treina com seus tickets históricos, documentos de ajuda e macros, depois elabora e resolve conversas de nível 1 na voz da sua marca. A coisa mais próxima do loop "demonstre e reproduza" do Codex é nosso modo de simulação: antes de responder a um único cliente ao vivo, você o executa contra milhares de seus tickets anteriores para ver exatamente como teria lidado com eles, encontrar as lacunas e só então ativá-lo.

Não é teórico. A Gridwise teve o eesel resolvendo 73% das solicitações de nível 1 no primeiro mês, e a Smava opera um agente Zendesk totalmente automatizado com mais de 100.000 tickets em alemão por mês. O preço é baseado em uso sem taxas por assento, e você pode começar gratuitamente sem cartão de crédito. Se sua stack é Zendesk, Freshdesk, Gorgias, Help Scout ou centenas de outras ferramentas, muito provavelmente se conecta.