A maioria das pessoas conhece o Codex pelo App, pela interface de linha de comando ou pela extensão para IDE. Essas experiências são importantes, mas representam apenas algumas das formas de usar o mesmo sistema que está por trás delas.
O harness de código aberto do Codex é o que viabiliza todas essas experiências. Ele ajuda os modelos a reunir contexto, raciocinar sobre tarefas, usar ferramentas, operar dentro dos limites configurados, solicitar aprovação e dar continuidade ao trabalho.
Isso muda o que os desenvolvedores podem criar. Em vez de pedir que cada equipe transfira seu trabalho para um assistente de programação de uso geral, você pode incorporar o agente a um software projetado para o trabalho em questão: um fluxo de trabalho de engenharia, um painel de operações, uma investigação de segurança, um console de atendimento ao cliente ou um aplicativo interno desenvolvido para uma equipe especializada.
A parte reutilizável é o ciclo do agente
Um agente capaz é mais do que um prompt e uma resposta do modelo. Ele precisa de meios para entender uma tarefa, manter o contexto ao longo do tempo, examinar informações relevantes, chamar ferramentas, mostrar o progresso, lidar com falhas, solicitar aprovação humana quando necessário e retornar um resultado útil.
Esse sistema de execução que dá suporte ao agente é o harness.
O projeto do harness pode mudar significativamente os resultados: no ARC-AGI-3, a retenção do raciocínio e a compactação do contexto elevaram a pontuação do GPT-5.6 Sol de 13,3% para 38,3%, reduzindo ao mesmo tempo a quantidade de tokens de saída a um sexto.
Criamos o harness do Codex para gerenciar o estado da conversa, transmitir a execução em streaming, usar ferramentas, aplicar as políticas configuradas de sandbox e aprovação e dar continuidade ao trabalho entre turnos. Com o Codex app-server, disponibilizamos essas capacidades por meio de um protocolo de cliente documentado: os aplicativos podem criar conversas, iniciar turnos, receber eventos e lidar com solicitações de aprovação.
Se você está desenvolvendo um software que precisa de um agente, pode começar com o Codex em vez de inventar um novo ambiente de execução e, então, decidir quais responsabilidades devem ficar com o aplicativo.
Um harness de código aberto que os desenvolvedores podem examinar e adaptar
Como o harness é de código aberto, você pode examinar a camada entre seu aplicativo e o modelo, entender como ela se comporta e adaptar a integração ao seu produto.
Isso dá aos desenvolvedores controle sobre os aspectos que permitem adequar o agente ao produto:
-
A interface. Uma equipe pode manter seus painéis, editores, filas, mapas, registros e fluxos de aprovação existentes, em vez de forçar todas as interações a acontecerem em uma janela de chat genérica.
-
Contexto e ferramentas. Um aplicativo pode disponibilizar os sistemas, documentos, dados e ações relevantes para um fluxo de trabalho específico, incluindo serviços MCP controlados pelo próprio aplicativo.
-
Limites operacionais. O aplicativo hospedeiro pode decidir onde um agente é executado, quais arquivos ou ferramentas ele pode acessar, quais ações exigem aprovação, como o trabalho é acompanhado e como os resultados retornam ao sistema oficial de registro.
Publicamos o Codex CLI, o app-server e o SDK oficial do Codex como componentes de código aberto. Nosso guia de componentes de código aberto lista o que está disponível e onde encontrar cada componente.
A camada de código aberto abrange o harness e as interfaces de integração; o acesso aos modelos e os serviços gerenciados permanecem separados.
Escolha a camada de integração adequada
Desenvolver com o Codex não exige a mesma integração para todos os casos de uso.
-
Para um script, um job de CI ou uma tarefa pontual em segundo plano, codex exec pode executar um fluxo de trabalho de agente com escopo delimitado e retornar uma saída estruturada.
-
Para código de aplicativo que precisa iniciar, retomar ou acompanhar tarefas do Codex em streaming, o SDK oficial do Codex oferece uma interface programática direta.
Para ver um exemplo que você pode executar, consulte a documentação do SDK do Codex.
Use o Codex app-server quando o agente fizer parte do próprio produto. Ele permite que seu aplicativo se conecte a um processo local do Codex, mantenha conversas abertas, transmita eventos em streaming, interrompa o trabalho, disponibilize ferramentas e responda a solicitações de aprovação. O SDK simplifica fluxos de trabalho programáticos comuns; o app-server dá às equipes de produto controle direto sobre o ciclo de vida e a experiência do usuário.
Desenvolva o software em torno do fluxo de trabalho
A oportunidade mais interessante não é reproduzir o aplicativo Codex com um logotipo diferente, mas desenvolver um software que reflita como uma pessoa ou equipe específica já trabalha:
Um analista de segurança pode precisar de uma fila de investigações, alertas recentes, serviços afetados e uma etapa de aprovação antes de abrir um chamado de correção. Um engenheiro de suporte pode precisar do histórico da conta, dos logs do produto, da documentação interna e de um rascunho de resposta. Uma equipe de produto pode querer um quadro de tarefas em que mover uma issue para o estado de pronta para execução inicie um fluxo de implementação com escopo delimitado.
Em cada exemplo, a interface é uma parte importante da experiência. Ela informa ao agente o que o usuário está vendo, fornece as ferramentas certas e oferece ao usuário um lugar para revisar o que acontece a seguir.
Figura 1. Seu aplicativo é responsável pelo contexto do produto, pelas regras de negócio e pelas ferramentas; o Codex app-server fornece o ciclo do agente e a execução em ambiente isolado.
Exemplo: Relay
Criamos o Relay como um aplicativo de operações de exemplo baseado no Codex app-server. Ele coloca um agente ao lado de um painel fictício de remessas, conecta esse agente a ferramentas MCP controladas pelo aplicativo e exige aprovação humana antes de reagendar uma remessa.
O usuário não começa escrevendo um prompt do zero. Ele seleciona uma remessa e clica em uma ação como Comparar opções de recuperação. O aplicativo fornece o contexto relevante, o Codex busca os dados operacionais de exemplo mais recentes, o agente explica as opções disponíveis e qualquer operação de escrita com consequências relevantes exige aprovação.
O Codex pode então usar as ferramentas MCP do aplicativo para buscar dados atuais antes de recomendar uma ação ou, após aprovação, executá-la. Quando uma ferramenta altera o registro subjacente, o aplicativo atualiza sua visualização de negócio. O harness cuida do ciclo do agente, do estado da conversa, da atividade transmitida em streaming e da interação com ferramentas; o produto continua responsável pelo painel, pelos registros e pelos controles.
O Relay usa dados fictícios pré-carregados, mas o padrão de integração tem aplicação geral. O mesmo padrão poderia viabilizar a resposta a incidentes, operações de contas, fluxos de trabalho de pesquisa ou outros aplicativos nos quais um agente deva trabalhar dentro da experiência de um produto existente.
Figura 2. O Relay incorpora o Codex a um painel de operações de remessas, com ferramentas MCP controladas pelo aplicativo e aprovação humana para ações com consequências relevantes.
O que os desenvolvedores estão criando
Esse padrão já aparece em implementações públicas:
-
GitHub e JetBrains
integram o Codex aos fluxos de trabalho existentes em IDEs.
-
Cisco
usa o SDK do Codex no App Builder, dentro do Cisco Cloud Control.
-
Thrive Holdings e Crete
usam o Codex em um fluxo de preparação de declarações de impostos que incorpora o feedback dos profissionais. O projeto piloto processou 7.000 declarações e reduziu o tempo de preparação em cerca de um terço.
Esses exemplos não se limitam à engenharia: o mesmo padrão se aplica a equipes de suporte que investigam problemas de clientes, equipes de operações que coordenam fluxos de trabalho, equipes de segurança que fazem a triagem de incidentes, equipes de vendas que pesquisam contas e equipes de marketing que desenvolvem campanhas. Em cada caso, o aplicativo fornece o contexto, as ferramentas e as aprovações, enquanto o Codex executa o ciclo do agente por trás de tudo.
Crie além do óbvio
Em muitos tipos de trabalho, o contexto essencial está em um painel, uma linha do tempo, um mapa, um documento ou um registro do sistema. Essas visualizações não estão ali só para enfeitar: é por meio delas que as pessoas realmente entendem o que está acontecendo, tomam decisões e mantêm o controle.
A oportunidade não é substituir essas interfaces por uma caixa de chat universal, mas ampliar suas capacidades com um agente que possa entender o trabalho, investigar o contexto adequado, propor um próximo passo e executar uma ação aprovada.
O aplicativo Codex, a CLI e a extensão para IDE mostram o que o harness pode fazer. Ao disponibilizar o harness como código aberto, damos aos desenvolvedores uma forma de examinar essas capacidades, integrá-las e adaptá-las aos próprios produtos e fluxos de trabalho.
Se você quer desenvolver com o harness do Codex, comece pelo repositório de código aberto do Codex e escolha a integração adequada ao seu produto: codex exec para jobs não interativos, o SDK do Codex para fluxos de trabalho programáticos com agentes ou o Codex app-server para aplicativos que precisam de conversas persistentes, eventos transmitidos em streaming e tratamento de aprovações.