Alternar tema

Codex Computer Use e o navegador integrado na prática: deixar o agente ver páginas, operar apps e iterar o frontend

Easton editorial illustration: Codex project workflow bench

"A introdução oficial do Codex da OpenAI menciona background computer use e o navegador integrado."

Codex Computer Use e o navegador integrado na prática: deixar o agente ver páginas, operar apps e iterar o frontend

Quando você termina uma mudança de frontend e o print ainda não mostra para o agente como a página realmente ficou, o loop fica pesado rapidamente. E se o agente pudesse abrir o navegador sozinho, olhar a página, comentar ali mesmo e seguir?

No macOS, o agente pode lidar com vários apps em segundo plano enquanto você continua escrevendo código. No Windows, ele assume o cursor, então você precisa pausar o restante do trabalho. Para iterar frontend, o fluxo fica bem claro: mudar o código, deixar o agente abrir o navegador, comentar na página e iterar de novo. Esse é o valor prático do Computer Use e do navegador integrado. As diferenças de plataforma definem o fluxo de trabalho, e os limites de segurança definem as permissões.

1. Noções básicas do Computer Use: usar o cursor para ver, clicar e digitar em apps

1.1 Não é tomada total, mas “você define o objetivo e ele opera a GUI”

O Computer Use permite que o Codex use o próprio cursor para ver, clicar e digitar em apps do seu computador, inclusive ferramentas de desktop sem API pública. Se você disser, por exemplo, “converta este PDF para Word”, o Codex muda o foco, clica janelas, digita texto e conclui o fluxo de GUI.

Isso é diferente de um script em segundo plano. No Windows, o Codex assume o cursor em primeiro plano. No macOS, ele trabalha em paralelo em segundo plano, então você pode continuar em outros apps.

Ele resolve principalmente dois tipos de tarefas:

  1. Operar ferramentas sem API: software de design, configurações do sistema e apps de desktop, desde que a tarefa possa ser concluída em uma GUI.
  2. Tarefas que precisam ver a interface real: depuração de GUI, reprodução de mockups de design e testes de interação desktop.

1.2 macOS vs Windows: paralelo em segundo plano vs tomada de cursor em primeiro plano

A maior diferença no Computer Use é saber se você consegue trabalhar em paralelo.

CaracterísticamacOSWindowsExplicação
Modo de operaçãoParalelo em segundo planoTomada de cursor em primeiro planoNo macOS, vários agentes podem rodar em paralelo; no Windows, o Codex assume o cursor
Impacto no seu trabalhoBaixoAltoNo macOS você continua trabalhando em outros apps
Vários agentes em paraleloSuportadoNão suportadoNo macOS, vários threads podem operar apps diferentes ao mesmo tempo
Melhor paraMultitarefa paralelaFoco em uma única tarefaEscolha pelo seu fluxo
VersãoLançamento inicial26.527 (2026-05-29)O Windows recebeu suporte em 29 de maio
DisponibilidadeEEE/Reino Unido/Suíça excluídosEEE/Reino Unido/Suíça excluídosDesdobramento gradual na UE e no Reino Unido

Se você usa macOS, o Computer Use funciona muito bem como um “assistente paralelo”: você deixa um agente operar um app de design enquanto continua escrevendo código no editor. No Windows, é melhor reservar um bloco de foco: o Codex assume o cursor, você pausa o resto do trabalho e espera terminar.

2. O navegador integrado: mudar o frontend -> abrir a página -> comentar ali -> continuar

2.1 O loop de iteração frontend em 4 passos

O problema principal que o navegador integrado resolve é simples: o agente muda o código frontend, mas não vê o render real. Sem navegador, sobra depender de capturas.

O loop é assim:

  1. Mudar o frontend: ajustar estilo, layout ou lógica de interação.
  2. Abrir o navegador: pedir ao Codex para abrir localhost ou um app web local.
  3. Comentar na página: clicar, anotar e comentar diretamente no navegador para passar instruções precisas ao agente.
  4. Continuar iterando: o agente usa o feedback, ajusta de novo e verifica o próximo render.

Assim, o frontend sai de “mudar código -> mandar captura -> receber feedback -> mudar código” e vira “mudar código -> ver a página -> comentar -> mudar código”. O agente vê o render direto, então você não precisa ficar mandando capturas o tempo todo.

2.2 Por enquanto, serve principalmente para frontend e jogos

A posição atual da OpenAI é clara: o navegador integrado serve principalmente para apps web localhost, desenvolvimento frontend e desenvolvimento de jogos.

A expansão para controle total do navegador ainda está em andamento. Se você quiser que o Codex opere sites externos, por exemplo para debug em produção ou testes em páginas de terceiros, isso ainda é limitado hoje e depende de futuros lançamentos.

2.3 Developer mode: dar ao Codex acesso controlado ao Chrome DevTools Protocol

O Developer mode foi lançado em 2026-06-11 na versão 6.609 e dá ao Codex acesso controlado ao Chrome DevTools Protocol.

Ele permite coisas como:

  • Análise de performance: perfilar JavaScript e medir tempo de render.
  • Depuração de rede: inspecionar requests, responses e timings.
  • Saída de console: ler erros de execução e console.log.
  • Inspeção do estado da página: analisar o DOM e os estilos aplicados.

Além disso, o CDP também acelera a iteração. Os DOM snapshots reduzem renders repetidos e o tráfego de capturas. Em páginas complexas, a iteração pode ficar até 2x mais rápida porque o agente não precisa recarregar a página inteira toda vez; ele continua a partir do snapshot.

O caminho para ativar é Settings > Browser > Enable full CDP access. Se a sua organização desativou o Developer mode, você não consegue ativá-lo localmente. Isso é política da organização, não uma configuração da conta pessoal.

3. Appshots: dar dois toques em Command no macOS e enviar o app ao Codex de uma vez

3.1 Não é captura comum, mas “captura + texto oculto”

O Appshots, lançado em 2026-05-21, resolve um detalhe das capturas: conteúdo fora da área visível de scroll é difícil de ver.

Se você der dois toques na tecla Command, o Codex captura a janela do app em primeiro plano e o texto disponível, incluindo o texto oculto fora da área visível. Por exemplo, se uma stack de erro web estiver abaixo da área visível, uma captura comum não mostra isso, mas o Appshots pode extrair todo o texto da página.

3.2 Casos de uso

Usos típicos do Appshots:

  • Depurar erros web: enviar ao Codex a janela inteira do navegador, incluindo a stack fora da tela.
  • Reproduzir mockups de design: enviar a janela de um app de design ao agente para ele analisar o layout.
  • Extrair texto não selecionável de PDF: ler diretamente o conteúdo da janela do PDF.

É mais eficiente do que enviar apenas uma captura, porque o agente vê ao mesmo tempo o visual e o texto.

3.3 Fluxo do Appshots

  1. Abra a janela do app alvo e clique nela para dar foco.
  2. Dê dois toques em Command e solte.
  3. Um ícone do Codex aparece no canto inferior direito por cerca de 1,2 segundo, indicando que a captura funcionou.
  4. A captura é anexada automaticamente ao thread ativo de conversa dos últimos 60 segundos.

Observação: o Appshots funciona apenas no macOS, e o idioma do sistema deve ser inglês ou chinês simplificado. Há limitações conhecidas em ambientes japonês e coreano. Nesses dois idiomas, o texto fora da área de scroll pode ficar incompleto, e alguns textos não selecionáveis podem não ser capturados corretamente. Se você usa um sistema japonês ou coreano, teste primeiro em inglês ou chinês simplificado.

4. Limites de segurança: quando não dar acesso total

4.1 Sandbox padrão + acesso sob demanda

O Codex roda em sandbox por padrão, então o agente fica limitado à pasta de trabalho e à branch. Ações com privilégio maior exigem sua aprovação. O Computer Use e o navegador integrado são capacidades de maior privilégio, então é preciso autorizá-los com cuidado.

CapacidadePermissão padrãoPrecisa de privilégio maiorRecomendação
Código normalsandboxNenhumSuficiente por padrão
Computer UsesandboxExige autorização extraAutorize sob demanda; no Windows, limite por app
Navegador integradosandboxExige aprovação do Developer modeAtive só para iterar frontend
AppshotsSomente leituraNenhumSeguro, somente leitura

Os usuários do Windows têm um controle adicional: Settings > Computer Use > Configure per-app access control permite limitar o Codex a apps específicos.

4.2 Quando não dar acesso total

O Computer Use exige uma postura disciplinada com permissões. Não autorize nestes casos:

  • Codebases de terceiros não confiáveis, onde o agente pode acessar arquivos sensíveis.
  • Bancos de dados de produção, onde o agente pode fazer uma alteração errada.
  • Ajustes de sistema com privilégio alto, onde o controle por app no Windows importa.

A regra conservadora é simples:

  • Fique no sandbox por padrão e conceda acesso só quando a tarefa realmente precisar.
  • No Windows, use per-app access control para reduzir o escopo.

5. Trade-off: quando usar Computer Use e quando o código normal sai mais barato

5.1 Matriz de cenários

O Computer Use não é uma ferramenta universal. Decida pelo tipo de tarefa.

CenárioAbordagem recomendadaMotivo
Mudanças de estilo frontend / UINavegador integradoVocê vê o render real e o loop de iteração fica completo
Operar ferramenta desktop sem APIComputer UseA GUI é o único caminho
Geração simples de códigoCódigo normalO Computer Use consome mais orçamento e não compensa
Depuração de performance frontendDeveloper modeAnálise CDP + depuração de rede
Enviar um app ao Codex rapidamenteAppshots (macOS)Captura em um gesto + texto oculto

A regra central é simples: se o código normal resolve, não ative o Computer Use. O valor dele está em operar ferramentas sem API e em tarefas em que é preciso ver a interface real.

5.2 Aviso de custo: Computer Use e navegador custam mais

O Computer Use e o navegador integrado custam mais do que o código normal:

  • O Computer Use consome mais tokens por causa do custo de capturas e interação.
  • A iteração no navegador dispara uma chamada em cada rodada.

Use código normal para tarefas simples e reserve o Computer Use para trabalhos GUI complexos.

6. FAQ: dúvidas comuns

Q1: O que é Computer Use e até onde ele vai?

O Computer Use permite que o Codex veja, clique e digite com o próprio cursor para operar todos os apps no seu computador, inclusive ferramentas de desktop sem API pública. Não é uma tomada total. Você define o objetivo e o Codex opera a GUI em primeiro plano no Windows ou em segundo plano no macOS.

Q2: Qual é a diferença entre macOS e Windows?

O macOS suporta trabalho paralelo em segundo plano, então vários agentes podem operar apps diferentes sem atrapalhar o que você está fazendo. O Windows hoje funciona em primeiro plano, com o agente assumindo o cursor, então normalmente você precisa pausar o resto do trabalho. Ambos conseguem operar todas as apps; a escolha depende do fluxo.

Q3: Como usar o navegador integrado para iterar frontend?

Você muda o frontend, abre a página localhost no navegador integrado, comenta diretamente na página, deixa o agente continuar as mudanças e depois abre o navegador de novo para conferir o resultado. Isso cria um loop editar-ver-comentar-editar. No momento, ele serve principalmente para frontend e jogos.

Q4: É seguro e preciso dar acesso total?

Por padrão, o Codex fica em sandbox e o agente é limitado à pasta de trabalho e à branch. Privilégios mais altos exigem aprovação. O Computer Use e o navegador são capacidades de maior privilégio, então conceda só quando necessário. No Windows, você também pode restringir por app, e cenários não confiáveis nunca devem receber acesso total.

Q5: Quando vale a pena usar Computer Use?

Vale para ferramentas de desktop sem API, como software de design ou ajustes do sistema, e para tarefas em que o agente precisa ver a interface real, como depuração GUI ou recriação de mockups. Geração simples de código sai mais barata com código normal.

Q6: O que o navegador Developer mode faz?

Ele dá ao Codex acesso controlado ao Chrome DevTools Protocol para análise de performance, depuração de rede, saída de console e inspeção de DOM e estilos. Esse recurso foi adicionado em 2026-06-11. Em alguns casos, o DOM snapshotting pode melhorar a iteração em até 2x.

7. Próximos passos e recursos

Artigos relacionados

  • Upstream: sandbox de segurança do Codex e limites de permissão: quando não dar acesso total (a publicar)
  • Downstream: fluxo de trabalho do Codex Cloud Agent: operação e monitoramento de dispositivos remotos (a publicar)
  • Downstream: custo do Codex na prática: controlar orçamento de Computer Use, navegador e tarefas longas (a publicar)

Recursos oficiais

  • Documentação oficial do Codex
  • Changelog do Codex
  • Codex for (almost) everything, a grande atualização de 2026-04-16

Conclusão

O Computer Use e o navegador integrado resolvem o mesmo problema central: a IA precisa ver a interface real para terminar a tarefa. O frontend precisa do render real, e ferramentas sem API precisam de uma GUI.

A diferença de plataforma define o fluxo. No macOS, você pode deixar o agente operar um app em segundo plano enquanto continua codando. No Windows, é preciso reservar um bloco de foco e deixar o agente assumir o cursor.

A segurança também pede contenção. Mantenha o sandbox por padrão, conceda acesso só quando a tarefa realmente precisar e use per-app access control no Windows para limitar o escopo.

O trade-off de custo também é claro: o código normal é mais barato para tarefas simples, enquanto o Computer Use agrega valor em trabalhos GUI complexos.

Próximos passos recomendados:

  • Se você usa macOS, tente deixar um app de design em segundo plano enquanto continua editando código.
  • Se precisar iterar frontend, construa o loop editar-ver-comentar-editar com o navegador integrado.
  • Se ainda tiver dúvidas sobre os limites de segurança, leia primeiro a sandbox de segurança do Codex e os limites de permissão antes de conceder acesso total.

Iterar o frontend com o Codex

Transformar mudanças de frontend, pré-visualização no navegador e comentários na página em um único loop fechado.

  1. 1

    Step 1: Mudar o frontend

    Comece ajustando estilo, layout ou lógica de interação.
  2. 2

    Step 2: Abrir o navegador

    Peça ao Codex para abrir localhost ou um app web local.
  3. 3

    Step 3: Comentar na página

    Clique, anote e comente diretamente na página para dar instruções precisas.
  4. 4

    Step 4: Continuar iterando

    Use o feedback da página para ajustar de novo e conferir o próximo render.

FAQ

O que é Computer Use e até onde ele vai?
O Computer Use permite que o Codex olhe, clique e digite com o próprio cursor para operar apps no seu computador, inclusive ferramentas de desktop sem API pública. Não é uma tomada total: você descreve o objetivo e ele opera a GUI em primeiro plano no Windows ou em segundo plano no macOS.
Qual é a diferença entre macOS e Windows?
O macOS suporta trabalho paralelo em segundo plano, então vários agentes podem operar apps diferentes enquanto você continua trabalhando. O Windows hoje funciona em primeiro plano, com o agente assumindo o cursor, então normalmente você precisa pausar o resto do trabalho.
Como usar o navegador integrado para iterar frontend?
Você muda o frontend, abre a página localhost no navegador integrado, comenta diretamente na página, deixa o agente continuar as mudanças e depois abre o navegador de novo para conferir o resultado. Assim nasce um loop editar-ver-comentar-editar.
Ele consegue operar apps sem API?
Sim. É exatamente aí que o Computer Use mais vale. Se uma tarefa pode ser feita em uma GUI, o Codex consegue operá-la vendo a tela, movendo o mouse, clicando em botões e digitando texto.
O Computer Use é seguro?
O modo padrão é sandbox, com o agente limitado à pasta de trabalho e à branch. Computer Use e o navegador integrado são capacidades de privilégio mais alto, então conceda acesso só quando necessário e evite acesso total em cenários não confiáveis.
Quando não devo usar Computer Use?
Se a mudança for uma edição simples de código, o código normal é mais barato e mais rápido. Se a tarefa envolver dados sensíveis, um banco de produção ou uma codebase de terceiros em que você não confia, não dê acesso total.

12 min de leitura · Publicado em: 6 ago 2026 · Atualizado em: 6 ago 2026

Comentários

Entre com GitHub para comentar

Easton BlogEaston Blog