Codex: Computer Use do Codex
Última atualização: 2026-08-31
O recurso Computer Use do Codex é um diferencial-chave em relação a ferramentas de codificação tradicionais — ele não apenas escreve código, pode operar seu computador.
📋 Pré-requisitos: Entendimento das operações básicas do Codex e configurações de permissão
1. O Que Você Vai Aprender
- Conceitos e capacidades do Computer Use
- Controle de navegador
- Controle de aplicações desktop
- Considerações de segurança
2. O Que é Computer Use
O Computer Use permite que o Codex opere um computador como um humano:
| Capacidade | Descrição |
|---|---|
| Controle de Navegador | Abrir páginas web, clicar, digitar, capturar screenshots |
| Controle de App Desktop | Operar aplicações locais |
| Gerenciamento de Arquivos | Navegar, criar, modificar sistemas de arquivos |
| Execução de Comandos | Executar comandos no terminal |
graph LR
A[Codex Agent] --> B[Navegador]
A --> C[Terminal]
A --> D[Sistema de Arquivos]
A --> E[Apps Desktop]
B --> B1[Navegação]
B --> B2[Preenchimento de Formulários]
B --> B3[Análise de Screenshot]
C --> C1[Executar Comandos]
C --> C2[Ver Saída]
D --> D1[Ler/Escrever Arquivos]
D --> D2[Operações de Diretório]
3. Controle de Navegador
(1) Operações Básicas
> Open https://example.com and take a screenshot
> Type "Codex tutorial" in the search box and search
> Fill in the registration form with alice@example.com as email
> Click the "Submit" button
(2) Testes Web
> Open localhost:3000, verify login functionality works
> Screenshot the homepage, check responsive layout
> Test shopping cart flow: add item → checkout → confirm
▶ Exemplo 1: Alice Testa uma Página Web
# Alice faz o Codex realizar testes end-to-end
> Open http://localhost:8080
> Register a test account test@example.com / password123
> After login, create a new project
> Screenshot to confirm the project list displays correctly
> Delete the test account
# Saída do Codex:
# → Abrindo navegador em http://localhost:8080
# → Preenchendo formulário de registro
# → Clicando no botão "Register"
# → Fazendo login com credenciais de teste
# → Criando projeto "Test Project"
# → Capturando screenshot da lista de projetos
# → Conta deletada com sucesso
# → Teste completado ✓
4. Controle de Aplicações Desktop
(1) Exemplos de Operação
> Open VS Code and open the current project
> Run npm start in the terminal
> Open the browser to access localhost:3000
> Screenshot to confirm the page displays correctly
(2) Operações Multi-passo
> Execute the following:
> 1. Start the database in the terminal
> 2. Run database migrations
> 3. Start the development server
> 4. Open the browser to verify
> 5. Screenshot to confirm all functions work
▶ Exemplo 2: Verificação de Deploy do Bob
> Deploy to staging environment:
> 1. git push origin staging
> 2. Wait for CI to complete
> 3. Open staging.example.com
> 4. Test key functions: login, search, checkout
> 5. Screenshot each step
> 6. Generate test report
5. Segurança e Privacidade
(1) Requisitos de Permissão do Computer Use
O Computer Use requer modo sandbox Full-access, o que significa:
| Consideração | Descrição |
|---|---|
| Privilégios Elevados | O Codex pode operar qualquer aplicação |
| Acesso Visual | O Codex pode ver o conteúdo da tela |
| Simulação de Entrada | O Codex pode simular operações de teclado e mouse |
| Acesso à Rede | O Codex pode acessar qualquer site |
(2) Recomendações de Segurança
⚠️ Checklist de Segurança do Computer Use:
1. Não usar em telas contendo informações sensíveis
2. Não deixar o Codex acessar sites bancários/de pagamento
3. Sempre monitorar as operações do Codex
4. Verificar operações anormais após o uso
5. Cautela extra para operações em ambiente de produção
(3) Confirmação de Operação
No modo Computer Use, operações críticas ainda requerem confirmação:
⚠️ Codex solicita confirmação de operação:
- Open https://production.example.com
- Tipo de operação: Navegação do navegador
- Nível de risco: Alto (ambiente de produção)
[Approve] [Reject]
6. Configuração do Computer Use
# ~/.codex/config.toml
[computer_use]
enabled = true
browser = "chromium" # Motor do navegador
headless = false # Modo headless
screenshot_interval = 5 # Intervalo de screenshot (segundos)
max_operations = 100 # Máximo de operações por sessão
require_confirmation = true # Operações críticas precisam de confirmação
7. Computer Use vs Automação Tradicional
| Dimensão | Computer Use | Scripts Tradicionais |
|---|---|---|
| Flexibilidade | Alta (IA entende mudanças na página) | Baixa (depende de seletores fixos) |
| Custo de Manutenção | Baixo (auto-adapta a mudanças de UI) | Alto (scripts precisam ser atualizados quando a UI muda) |
| Curva de Aprendizado | Baixa (descrições em linguagem natural) | Alta (precisa aprender Playwright/Selenium) |
| Confiabilidade | Média (IA pode julgar mal) | Alta (correspondência exata) |
| Melhor Para | Testes exploratórios, verificação rápida | Automação CI/CD, testes de regressão |
❓ Perguntas Frequentes
P: Quais permissões o Computer Use requer? R: Modo sandbox Full-access é necessário porque o Codex precisa operar navegadores e aplicações desktop. Use apenas em ambientes confiáveis.
P: O Codex pode operar qualquer navegador? R: O Codex usa o motor Chromium para controlar navegadores. Suporte para outros navegadores é limitado.
P: O Computer Use grava vídeo? R: O Codex captura screenshots periódicos para análise e tomada de decisão, mas não grava vídeo continuamente. Screenshots são salvos em um diretório temporário.
P: O Computer Use funciona em modo headless? R: Sim. Defina
headless = true, e o Codex opera em um navegador headless, adequado para ambientes de servidor.
P: O Computer Use pode substituir o Playwright? R: Não inteiramente. O Computer Use é mais flexível mas menos confiável, ótimo para testes exploratórios; o Playwright é mais preciso e confiável, melhor para automação CI/CD. Eles se complementam.
📖 Resumo
- O Computer Use permite que o Codex opere navegadores e aplicações desktop
- Controle de navegador: navegação, formulários, screenshots, testes
- Requer modo Full-access, risco de segurança mais alto
- Sempre monitorar operações, proteger informações sensíveis
- Complementa ferramentas de automação tradicionais, não substitui totalmente
📝 Exercícios
- Básico (⭐): Faça o Codex abrir uma página web e capturar um screenshot.
- Intermediário (⭐⭐): Faça o Codex completar automaticamente um fluxo de preenchimento de formulário web.
- Avançado (⭐⭐⭐): Use Computer Use para implementar testes end-to-end — do registro ao login a operações, gerando um relatório de teste.
