Funcionalidades do Aplicativo Desktop
📚 Navegação da Série: O artigo anterior 06 · Executando a Primeira Tarefa orientou o primeiro prompt de refatoração local. Esta seção apresenta o aplicativo desktop, mapeando o leiaute dos painéis, parâmetros de inicialização e atalhos de controle. No próximo artigo 08 · Guia de Inicialização do Terminal CLI, apresentaremos a rota de linha de comando CLI.
A OpenAI disponibiliza quatro interfaces de uso para o Codex, concentrando a documentação oficial e os instaladores do portal no aplicativo desktop, que atua como a interface principal de controle do assistente de código.
As especificações de escopo detalhadas na documentação oficial cobrem extensivamente as propriedades da aplicação (features, commands, settings, review, worktrees, automations, browser, computer-use, local-environments, chrome-extension), enquanto a CLI possui documentação complementar reduzida.
Diferentemente de outros assistentes onde a versão desktop funciona como uma interface simplificada da linha de comando, o aplicativo do Codex integra recursos como processamento paralelo de tarefas, isolamento de Worktrees, revisão gráfica de diffs e sandboxes locais completas.
Mapearemos as seções do aplicativo, o gerenciamento de chamadas concorrentes e os atalhos operacionais.
Ao terminar de ler este artigo, você terá:
- O mapeamento visual das seções: painel lateral, terminal e review pane
- A especificação técnica dos modos Local, Worktree e Cloud
- O uso do painel de revisão visual para commits e rollbacks de diffs
- A utilização de terminais integrados, Actions personalizadas e Automations
- A tabela de atalhos rápidos e comandos de barra (/command) para navegação
⚠️ Observação: Os atalhos e parâmetros baseiam-se na documentação oficial do Codex. Os mapeamentos de teclado descritos referem-se ao macOS; usuários de Windows devem verificar as teclas equivalentes no menu de atalhos locais (Settings > Keyboard Shortcuts).
01 Posicionamento da Interface Gráfica
A interface gráfica do aplicativo foi projetada para organizar fluxos de trabalho avançados.
O aplicativo desktop do Codex foi construído para processamento concorrente. A especificação oficial descreve o software como "a focused desktop experience for working on Codex threads in parallel" (uma experiência desktop focada no trabalho paralelo com threads do Codex). Uma thread representa uma sessão de diálogo isolada no histórico.
Analogia: a gerência de múltiplos postos de trabalho. O terminal CLI assemelha-se a uma mesa única de tarefas executadas sequencialmente. O aplicativo desktop funciona como uma central de monitoramento, onde cada thread opera em paralelo (um módulo em depuração, uma rotina de testes gerada em segundo plano e uma análise de segurança rodando). O desenvolvedor acompanha o status de cada processo de forma unificada.
O aplicativo compartilha as mesmas regras locais configuradas no AGENTS.md, servidores MCP e Skills ativos na CLI e extensões de IDE. A mecânica de processamento do agente é idêntica; apenas a apresentação gráfica é expandida.
Cenários indicados para o uso do aplicativo:
- Desenvolvimento concorrente: implementação paralela de modificações sem colisões de escrita em arquivos locais.
- Prototipagem rápida: depuração visual de código Web com renderização no navegador embarcado.
- Automações de rotina: geração de relatórios de alterações ou execuções agendadas de auditoria.
💡 Resumo em uma frase: O aplicativo desktop encapsula o motor do Codex em uma central de trabalho voltada a tarefas paralelas e visualizações de código.
02 Instalação e Compatibilidade
Nota de compatibilidade: o aplicativo desktop não possui versão para Linux no momento.
Os desenvolvedores que usam Linux devem jogar com a CLI oficial. O download está homologado apenas para os sistemas macOS e Windows:
| Plataforma | Pacote de instalação | Observações técnicas |
|---|---|---|
| macOS (Apple Silicon) | Build nativa ARM no portal oficial | Evite emulação para preservar desempenho |
| macOS (Intel) | Build de arquitetura x64 | Certifique-se de selecionar a versão correta de CPU |
| Windows | Instalador via Microsoft Store ou comando winget | winget install Codex -s msstore (consulte regras de Sandbox no Artigo 03) |
| Linux | Indisponível (registro de fila de espera no portal) | Interface restrita à linha de comando (CLI) |
Atenção ao fluxo de credenciais de login:
O acesso via conta do ChatGPT ativa a totalidade dos recursos gráficos; chaves de API da OpenAI podem restringir o acesso a utilitários de nuvem. A documentação técnica destaca que determinadas funções dependem de sessões autenticadas nos planos corporativos ou Plus/Pro do ChatGPT, os quais já cobrem a cota de uso do Codex (descrito no Artigo 04).
Se encontrar botões de ações em nuvem desativados, alterne o método de autenticação de chaves de API para login direto com a conta do ChatGPT.
💡 Resumo em uma frase: A versão desktop está restrita a Windows e macOS. Utilize chaves de conta do ChatGPT para dispor de todas as integrações da interface.
03 Divisões de Interface da Central de Trabalho
O leiaute padrão divide o fluxo em três painéis verticais: o painel esquerdo gerencia escopos e caminhos, a seção central abriga os diálogos e instruções, e a seção direita audita os resultados (diffs e terminais).
Fluxo lógico de visualização do aplicativo:
O processamento corre da esquerda para a direita: seleção do escopo de trabalho → processamento da tarefa por prompt → validação dos arquivos modificados.
Painel Esquerdo: Menu e Navegação
Responsável pelo direcionamento de arquivos e configurações globais:
- Nova Thread (New Thread): Inicializa sessões de diálogos isoladas.
- Busca (Search): Histórico de interações e termos em bases de código.
- Plugins: Conexão com serviços de terceiros e repositórios remotos.
- Automations: Gerenciamento de tarefas agendadas localmente.
- Projects: Relação de diretórios locais mapeados na CLI.
- Chats: Diálogos gerais sem vínculo direto com arquivos do repositório.
Nota técnica: não confunda escopo de Projetos (Projects) com Conversas Gerais (Chats).
Analogia: funcionários registrados versus visitantes temporários. Projetos são associados a diretórios locais ativos e possuem credenciais (permissões de sandbox) para reescrever arquivos na máquina. Chats operam isolados em um diretório próprio do Codex (~/.codex/threads), sendo úteis para pesquisas conceituais e consultas teóricas que não envolvem escrita em seus repositórios.
Exemplos de uso de escopo:
- Mapear o diretório local para implementar tipagens ou refatorações: selecione Projects.
- Perguntar sobre padrões de arquitetura ou sintaxes de linguagens: selecione Chats.
Painel Central: Chat de Controle
O painel central reúne a linha do tempo do processamento e a entrada de prompts. O rodapé traz três parâmetros críticos:
- Modos (Local / Worktree / Cloud): Determina onde a gravação física dos arquivos ocorrerá.
- Seleção de Modelos: Permite alternar a engine de processamento ativa na thread.
- Nível de permissões: Ajusta o Sandbox e as interrupções de confirmação do console.
Painel Direito: Review Pane
Exibe os logs de saída de dados e arquivos gravados. Pode ser ocultado para ganhar área útil de tela:
- Revisão de Diffs: Análise visual de alterações de arquivos.
- Terminal integrado: Terminal de sistema com foco no escopo ativo.
- Visualizações: Renderização de arquivos locais, HTML e imagens.
Abaixo, uma representação do leiaute das áreas do aplicativo:
Mapeamento estrutural das seções: menu de controle superior, navegação lateral de sessões, prompt ativo, painel de diffs do review pane e console integrado no rodapé. A disposição das teclas e painéis muda de acordo com atualizações do aplicativo.
示意图讲清了「每区职责」，再看一眼真机长啥样，对照着就更踏实：
💡 Resumo em uma frase: A interface divide-se em navegação, prompt e monitoramento de diffs. Projetos alteram código localmente, enquanto Chats servem para consultas conceituais.
04 Modos de Execução: Local, Worktree e Cloud
Selecione o modo de sandbox apropriado antes de enviar instruções de escrita para proteger a integridade do repositório:
| Modo de execução | Escopo do sistema | Local de escrita de arquivos | Cenário indicado |
|---|---|---|---|
| Local | Máquina local | Reescreve diretamente o diretório ativo | Correções rápidas sob controle de versionamento direto |
| Worktree | Máquina local | Pasta isolada baseada em Git Worktree | Tarefas concorrentes e implementações experimentais |
| Cloud | Nuvem remota | Sandbox temporária da OpenAI | Execuções em lotes pesados sem impacto em recursos locais |
Tanto o modo Local quanto o Worktree executam o código localmente. Apenas as tarefas marcadas como Cloud consomem servidores remotos.
O isolamento via Worktree permite o paralelismo sem riscos de colisão de código.
Analogia: cópias de plantas de engenharia. Se múltiplos engenheiros desenharem alterações na mesma folha original ao mesmo tempo, as anotações se chocarão. O modo Worktree cria cópias completas do projeto (por meio de comandos git worktree locais). Cada thread opera em seu próprio clone sem afetar o diretório de trabalho original. Após a conclusão, o desenvolvedor mescla as edições validadas.
Rodar modificações simultâneas no modo Local em subpastas idênticas causa substituições de sintaxe e conflitos de versionamento no Git. Utilize Worktrees para isolar sessões de desenvolvimento paralelas.
Diretrizes técnicas para o uso de Worktrees:
- Dependência do Git: A criação de worktrees requer um repositório Git local inicializado.
- Arquivos ignorados: Pastas registradas no
.gitignore(comonode_modulesou.env) não são copiadas para as pastas temporárias. O setup de dependências deve ser automatizado por scripts de inicialização. - Armazenamento: Fica localizado no caminho
~/.codex/worktrees/em estado "detached HEAD", sem alterar diretamente as referências das branches locais. - Handoff (Transferência): O botão "Hand off" no menu superior move a sessão ativa e as edições entre os modos Local e Worktree, automatizando o alinhamento de commits.
- Limpeza automática: Por padrão, o sistema retém os últimos 15 diretórios temporários criados, descartando os mais antigos e guardando metadados de snapshots.
Nota: Os limites de armazenamento e descarte são customizáveis no menu de configurações do aplicativo.
💡 Resumo em uma frase: O modo Local modifica a pasta ativa; o Worktree isola as threads em pastas temporárias; o Cloud delega processos para a nuvem. Use o Worktree para concorrência.
05 Recursos Exclusivos da Interface Gráfica
Estes recursos aproveitam o ambiente de renderização visual para simplificar a auditoria de código:
Painel de Revisão Visual (Review Pane)
A CLI do Codex exibe diffs estruturados em console. O painel de revisão do aplicativo converte esses logs em uma interface interativa que permite aceitar, rejeitar ou fazer anotações em trechos específicos.
Analogia: da leitura de e-mails para comentários em documentos compartilhados. Apontar correções de código no terminal exige redigir prompts longos indicando números de linhas e métodos. O review pane atua como uma revisão de texto: você clica na linha específica e deixa o feedback direto.
Funcionalidades do painel de revisão:
- Histórico de alterações pendentes: Lista todas as edições locais que não foram consolidadas em commits, unindo modificações manuais do desenvolvedor com as do assistente.
- Filtros de escopo: Permite alternar entre visualizar todas as alterações da branch, comparar com a branch base ou revisar apenas a última iteração da IA.
- Comentários inline: Passe o cursor sobre a linha do diff, clique no botão + e adicione a instrução. Ao disparar o prompt, o Codex lerá esses blocos e fará as refatorações.
- Granularidade de commits: Permite staging e descarte (rollback) em três níveis: repositório completo, arquivos individuais ou blocos de código específicos (hunks).
Publicação integrada: Conclua revisões, crie commits, faça pushes e inicialize Pull Requests direto do painel do aplicativo.
Nota: O review pane exige que o Git esteja configurado. Para integração de comentários de PR do GitHub no app, autentique a CLI do GitHub em sua máquina executando
gh auth loginno terminal.
Terminal Integrado
Cada thread de trabalho possui um terminal acoplado com escopo no diretório ativo. Abra o console pelo atalho Cmd + J no macOS.
O terminal compartilha a pasta ativa com a thread do assistente. Ao rodar git status ou execuções de testes, os logs refletem o estado exato dos arquivos sob sandbox. Além disso, o Codex consegue ler o histórico do console para depurar erros de compilação.
Evite usar
Cmd + Kpara limpar o console; este atalho aciona o menu de comandos no aplicativo. UtilizeCtrl + Lpara limpar os outputs.
Actions (Atalhos de Comandos)
Configure tarefas de execução frequente (como formatadores de arquivos ou chamadas de testes) como Actions acessíveis por botões na barra superior.
As diretivas são salvas na pasta .codex/ no repositório de trabalho (integradas ao escopo de Local Environments). Enquanto os scripts de setup resolvem pacotes e dependências de novas worktrees em segundo plano, as Actions disparam comandos sob demanda.
Automations (Execuções Agendadas)
As tarefas programadas executam rotinas repetitivas com o Codex em horários definidos:
Cenários recomendados:
- Sumários de Commits: Geração diária de relatórios contendo o resumo das alterações inseridas no repositório.
- Auditoria de Erros: Checagem periódica de logs de telemetria com propostas automáticas de correção.
- Persistência de contexto: Despertar periódico de threads para processos lentos ou de longa duração.
Nota: O funcionamento das rotinas de automação requer o aplicativo ativo em segundo plano e acesso aos caminhos físicos dos arquivos.
💡 Resumo em uma frase: Comentários inline no review pane, terminal com escopo compartilhado, Actions de um clique e rotinas de agendamento constituem os diferenciais do aplicativo desktop.
06 Atalhos de Teclado e Comandos de Barra
Consulte as teclas de navegação no menu de atalhos locais. Os mapeamentos descritos utilizam a referência do macOS:
Windows autodetect: Windows usuários devem conferir a equivalência de teclas no menu Settings > Keyboard Shortcuts, configurando atalhos de acordo com as diretrizes do sistema.
Atalhos mais frequentes no macOS:
| Atalho no macOS | Ação do sistema | Finalidade operacional |
|---|---|---|
Cmd + Shift + P ou Cmd + K | Abre o menu de comandos | Centraliza buscas de ações globais no aplicativo |
Cmd + N ou Cmd + Shift + O | Abre nova thread | Inicializa tarefas paralelas de desenvolvimento |
Cmd + J | Alterna o terminal integrado | Abre ou oculta o console com foco na pasta ativa |
Cmd + B | Alterna la barra lateral | Maximiza a área de chat ocultando o menu de navegação |
Cmd + Option + B | Alterna o review pane | Abre ou fecha a visualização de diffs de arquivos |
Cmd + G | Busca no histórico | Localiza threads e conversas passadas |
Cmd + F | Busca na thread ativa | Localiza termos no histórico da conversa atual |
Cmd + , | Abre as configurações | Configurações de Sandbox, Git e servidores MCP |
Ctrl + L | Limpa o terminal integrado | Limpa o console de execução de testes |
Ctrl + M | Entrada de voz (Speech-to-Text) | Gravação de áudio com transcrição local em texto |
Comandos de barra digitados na caixa de prompt (/):
| Comando de barra | Finalidade técnica |
|---|---|
/status | Exibe o ID da thread ativa, limites de tokens e consumo de cotas |
/review | Abre o painel de revisão focado na comparação de código com a branch base |
/plan | Ativa ou desativa o modo plano (planejamento descritivo antes da escrita) |
/goal | Define uma meta persistente que orientará as tomadas de decisões do agente |
/mcp | Lista o status e as permissões de ferramentas dos servidores MCP conectados |
/feedback | Registra sugestões e envia logs de erros para o suporte técnico |
Nota: Digitar o caractere
$permite acionar as Skills carregadas no diretório. O recurso/goaldepende da ativação de flags correspondentes noconfig.toml.
💡 Resumo em uma frase: Memorize
Cmd + Kpara acessar o menu de comandos eCmd + Npara novas threads. Use/statuspara monitorar cotas e/reviewpara auditoria.
07 Prática: Executando Tarefas Paralelas via Worktrees
Abaixo, inicializaremos duas threads concorrentes no modo Worktree usando o review pane para validação.
Pré-requisitos: Conta do ChatGPT autenticada no app e repositório local inicializado com Git.
Passo 1: Vincule o Projeto no Modo Worktree
Adicione o repositório no menu lateral e selecione o modo Worktree abaixo do chat.
✅ Validação: O console exibirá a branch de origem. Caso surjam alertas de dependência de Git, certifique-se de que a pasta de trabalho possui o diretório .git ativo.
Passo 2: Envie o primeiro prompt
Envie uma modificação pontual de documentação:
给这个项目的 README 补一段「如何本地运行」的说明Saída esperada: O Codex gera um clone temporário no diretório de worktrees locais, gravando a alteração na ramificação paralela sem afetar o diretório raiz.
Passo 3: Inicialize uma thread paralela
Sem aguardar a finalização do primeiro processo, clique em "New Thread" no menu lateral e envie nova tarefa no modo Worktree:
找一处 TODO 注释，把它实现掉✅ Validação: A barra lateral exibirá duas threads concorrentes executando alterações distintas no mesmo repositório, sem riscos de substituição mútua de arquivos.
Passo 4: Audite as edições no Review Pane
Selecione uma das tarefas concluídas e abra o painel lateral de diffs (Cmd + Option + B no macOS).
Ações de teste recomendadas:
- Feedback inline: Passe o cursor sobre a linha alterada, clique no ícone de comentário (+), escreva uma anotação e submeta no prompt para refatoração.
- Staging de blocos: Use os botões de stage e revert para persistir ou rejeitar edições de forma cirúrgica.
✅ Validação: As gravações permanecem seguras na pasta temporária. O commit no repositório ocorrerá apenas sob sua autorização manual no review pane.
Passo 5: Transfira a Sessão para o Modo Local
Se optar por manter as alterações diretamente no diretório principal para editar no editor de código externo, clique em Hand off para mover os arquivos da worktree.
✅ Validação: As gravações passam a ter efeito imediato na pasta do repositório físico do desenvolvedor.
Ao concluir esta rotina, você dominou o ciclo completo de paralelismo do aplicativo desktop.
💡 Resumo em uma frase: Inicializar threads concorrentes no modo Worktree e revisar os diffs por commits granulares no review pane constitui a rotina recomendada no aplicativo.
08 Resumo
O aplicativo desktop funciona como o painel central de concorrência e auditoria gráfica do Codex.
Tópicos essenciais revisados:
| Diretriz de uso | Detalhes e especificações |
|---|---|
| Arquitetura compartilhada | Mantém as diretivas do AGENTS.md, Skills e MCP da CLI, mudando apenas a exibição gráfica |
| Compatibilidade | Disponível apenas para Windows e macOS. Priorize autenticação com a conta do ChatGPT |
| Painéis verticais | Mapeamento estrutural de menus (esquerda), prompts (centro) e review pane/terminais (direita) |
| Sandboxes locais | Modo Local grava na pasta principal; modo Worktree isola as threads em clones do repositório |
| Diferenciais visuais | Comentários inline no review pane, terminais sincronizados, Actions personalizadas e Automations |
| Navegação | Atalhos Cmd + K (menu de comandos), Cmd + N (threads) e comando de barra /status |
Com o entendimento dessas rotinas, você está pronto para conduzir refatorações concorrentes no repositório de desenvolvimento, gerenciando o sandboxing por Worktrees e auditorias finas de código.
O próximo artigo 08 · Guia de Inicialização do Terminal CLI retorna ao shell para detalhar a CLI oficial do Codex. Discutiremos integrações com pipelines de CI, automações de scripts em servidores e execuções no modo não-interativo.