A maioria das pessoas conhece o Codex pelo App, pela interface de linha de comando ou pela extensão para IDE. Essas interfaces são importantes, mas representam apenas algumas das maneiras de usar o sistema que todas elas têm em comum.
O harness de código aberto do Codex é a base de todas essas interfaces. Ele ajuda os modelos a reunir contexto, raciocinar sobre as tarefas, usar ferramentas, respeitar os limites configurados, pedir 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 integrar o agente a um software pensado para a atividade que a equipe realiza. Pode ser 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 criado para uma equipe especializada.
O ciclo do agente é a parte que você pode reutilizar
Um agente precisa de mais do que um prompt e uma resposta do modelo para realizar uma tarefa. Ele precisa de meios para entender a tarefa, manter o contexto ao longo do tempo, examinar informações relevantes, chamar ferramentas, mostrar o progresso, lidar com falhas, pedir aprovação humana quando necessário e devolver um resultado útil.
O harness é o sistema que coordena essa execução.
A forma como o harness é projetado pode afetar bastante os resultados. No ARC-AGI-3, a combinação da preservação do raciocínio com a compactação de contexto elevou a pontuação do GPT-5.6 Sol de 13,3% para 38,3% e reduziu a quantidade de tokens de saída a um sexto da original.
Criamos o harness do Codex para gerenciar o estado da conversa, transmitir o andamento da execução em tempo real, 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 esses recursos por meio de um protocolo documentado para clientes. Os aplicativos podem criar threads, iniciar turnos, receber eventos e processar pedidos de aprovação.
Se você está desenvolvendo um software que precisa de um agente, pode começar pelo Codex sem precisar criar um ambiente de execução do zero. Depois, você decide quais responsabilidades ficam com o aplicativo.
Um harness de código aberto que os desenvolvedores podem examinar e adaptar
Como o harness tem código aberto, você pode examinar a camada entre seu aplicativo e o modelo, entender como ela funciona e adaptar a integração ao seu produto.
Os desenvolvedores têm controle sobre os aspectos que permitem adequar o agente ao produto:
-
Interface. A equipe pode manter os painéis, editores, filas, mapas, registros e fluxos de aprovação que já usa, sem ter que conduzir todas as interações em uma janela de chat genérica.
-
Contexto e ferramentas. O aplicativo pode disponibilizar os sistemas, documentos, dados e ações relevantes para um fluxo de trabalho específico, inclusive seus próprios serviços MCP.
-
Limites operacionais. O aplicativo que hospeda o agente pode definir onde ele é executado, a quais arquivos e ferramentas tem acesso, quais ações exigem aprovação, como o trabalho é monitorado e como os resultados voltam ao sistema que mantém os registros oficiais.
Publicamos a CLI do Codex, o app-server e o SDK oficial do Codex como componentes de código aberto. Nosso guia de componentes de código aberto lista os componentes disponíveis e indica onde encontrar cada um.
A camada de código aberto inclui o harness e as interfaces de integração. O acesso aos modelos e os serviços gerenciados são oferecidos separadamente.
Escolha a camada de integração adequada
A integração que você usa para desenvolver com o Codex pode variar conforme o caso de uso.
-
Para um script, um job de CI ou uma tarefa pontual em segundo plano, o codex exec pode executar um fluxo de trabalho com um agente dentro de um escopo delimitado e retornar uma saída estruturada.
-
Se o código do aplicativo precisa iniciar ou retomar tarefas do Codex, ou acompanhar sua execução em tempo real, 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. Com ele, seu aplicativo pode se conectar a um processo local do Codex, manter conversas abertas, transmitir eventos em tempo real, interromper o trabalho, disponibilizar ferramentas e responder a pedidos de aprovação. O SDK simplifica os fluxos programáticos mais comuns. O app-server dá às equipes de produto controle direto sobre o ciclo de vida do agente e a experiência do usuário.
Desenvolva o software a partir do fluxo de trabalho
Mais interessante do que reproduzir o Codex App com outro logotipo é criar um software que reflita a maneira como uma pessoa ou equipe já trabalha.
Um analista de segurança pode precisar de uma fila de investigações, dos alertas recentes, da lista de serviços afetados e de uma etapa de aprovação antes de abrir um chamado para corrigir o problema. 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 a coluna de itens prontos dê início a 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, disponibiliza as ferramentas adequadas e oferece ao usuário um lugar para revisar os próximos passos.
Figura 1. Seu aplicativo gerencia o contexto do produto, as regras de negócio e as ferramentas. O Codex app-server fornece o ciclo do agente e a execução em ambiente isolado.
Exemplo: Relay
Criamos o Relay como exemplo de aplicativo de operações baseado no Codex app-server. Ele coloca um agente ao lado de um painel fictício de remessas, conecta o agente às ferramentas MCP do próprio aplicativo e exige aprovação humana antes de reagendar uma remessa.
Para começar, o usuário não precisa escrever um prompt do zero. Basta selecionar uma remessa e clicar em uma ação como Comparar opções de recuperação. O aplicativo fornece o contexto relevante, o Codex consulta os dados operacionais mais recentes do exemplo e o agente explica as opções disponíveis. Qualquer alteração nos dados que tenha impacto na operação exige aprovação.
O Codex pode então usar as ferramentas MCP do aplicativo para consultar os dados atuais antes de recomendar uma ação ou, após a aprovação, executá-la. Quando uma ferramenta altera um registro, o aplicativo atualiza os dados exibidos no painel de operações. O harness gerencia o ciclo do agente, o estado da conversa, a transmissão das atividades em tempo real e a interação com as 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 mais ampla. O mesmo padrão pode servir para resposta a incidentes, operações de contas, fluxos de pesquisa ou outros aplicativos em que o agente deva atuar dentro de um produto já em uso.
Figura 2. O Relay integra o Codex a um painel de operações de remessas, com ferramentas MCP do próprio aplicativo e aprovação humana para ações com impacto na operação.
O que os desenvolvedores estão criando
Já há exemplos públicos de uso desse padrão:
-
GitHub e JetBrains integram o Codex aos fluxos de trabalho que os desenvolvedores já usam nas IDEs.
-
Cisco usa o SDK do Codex no App Builder 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 da área. O projeto-piloto processou 7.000 declarações e reduziu o tempo de preparação em cerca de um terço.
Além da engenharia, o mesmo padrão se aplica a equipes de suporte que investigam problemas de clientes, de operações que coordenam fluxos de trabalho, de segurança que fazem a triagem de incidentes, de vendas que pesquisam contas e de marketing que desenvolvem campanhas. Em todos esses casos, o aplicativo fornece o contexto, disponibiliza as ferramentas e gerencia as aprovações, enquanto o Codex conduz o ciclo do agente.
Vá além do óbvio
Em muitas atividades, o contexto essencial está em um painel, uma linha do tempo, um mapa, um documento ou um registro do sistema. A função dessas visualizações vai além da estética. É por meio delas que as pessoas entendem o que está acontecendo, tomam decisões e mantêm o controle.
Em vez de substituir essas interfaces por uma janela de chat universal, você pode ampliar o que elas permitem fazer. Para isso, integre um agente capaz de entender o trabalho, investigar o contexto relevante, propor o próximo passo e executar uma ação aprovada.
O Codex App, a CLI e a extensão para IDE mostram o que o harness pode fazer. Ao abrir o código do harness, damos aos desenvolvedores a possibilidade de examinar esses recursos, integrá-los aos seus próprios produtos e adaptá-los aos seus fluxos de trabalho.
Para desenvolver com o harness do Codex, comece pelo repositório de código aberto do Codex. Depois, escolha a integração adequada ao seu produto: codex exec para tarefas não interativas, o SDK do Codex para fluxos de trabalho programáticos com agentes ou o Codex app-server para aplicativos que precisam manter conversas persistentes, transmitir eventos em tempo real e processar pedidos de aprovação.