Codex: Guia da Interface do Codex App
Última atualização: 2026-08-31
O Codex App apresenta um layout clássico de três painéis e oferece o conjunto de recursos mais completo. Esta lição aborda cada área em detalhe.
📋 Pré-requisitos: Codex App instalado (veja Lição 2)
1. O Que Você Vai Aprender
- Estrutura do layout de três painéis
- Painel esquerdo: funções da lista de tarefas
- Painel central: operações da janela de conversa
- Painel direito: uso da área multifuncional
2. Layout Geral
O Codex App usa um layout de três painéis:
| Área | Posição | Função |
|---|---|---|
| Lista de Tarefas | Esquerda | Gerenciar múltiplas tarefas paralelas |
| Janela de Conversa | Centro | Área primária de interação com o Codex |
| Área Multifuncional | Direita | Navegador de arquivos, terminal, visualizador de código |
3. Painel Esquerdo: Lista de Tarefas
(1) Funções
- Criar novas tarefas
- Alternar entre tarefas
- Ver status da tarefa (em andamento / completada / falhou)
- Deletar tarefas
(2) Status da Tarefa
| Status | Ícone | Descrição |
|---|---|---|
| Executando | 🔄 | O Codex está executando a tarefa |
| Completada | ✅ | Tarefa finalizada com sucesso |
| Aguardando confirmação | ⏸ | Precisa de uma ação Approve |
| Falhou | ❌ | Erro de execução |
| Cancelada | ⏹ | Cancelada manualmente pelo usuário |
▶ Exemplo 1: Alice Gerenciando Tarefas Paralelas
Alice lida com três tarefas simultaneamente:
🔄 Tarefa 1: Refatorar módulo auth
⏸ Tarefa 2: Corrigir bug de pagamento (aguardando confirmação para deletar arquivo)
✅ Tarefa 3: Adicionar logging (completada)
Clique na Tarefa 2 → Revise operações na janela de conversa → Clique em Approve
4. Painel Central: Janela de Conversa
(1) Área de Entrada
- Caixa de entrada de texto: Digitar descrições de tarefas ou acrescentar instruções
- Botão de anexo: Anexar arquivos ou imagens como contexto
- Botão de envio: Submeter tarefa
(2) Tipos de Mensagem
| Tipo | Descrição |
|---|---|
| Mensagem do usuário | Sua descrição de tarefa digitada |
| Resposta do Codex | Explicação de operações e resultados do Codex |
| Modificação de arquivo | Exibe diff de código |
| Execução de comando | Exibe comando shell e saída |
| Pedido de confirmação | Operações requerendo seu Approve/Reject |
(3) Botões de Ação
| Botão | Descrição |
|---|---|
| Approve | Aprovar operação do Codex |
| Reject | Rejeitar a operação |
| Edit | Modificar o código proposto pelo Codex |
| Retry | Pedir ao Codex para tentar novamente |
▶ Exemplo 2: Revisando Mudanças de Código
--- a/src/auth/login.ts
+++ b/src/auth/login.ts
@@ -15,3 +15,8 @@
return jwt.sign(payload, secret);
+}
+
+export function verifyToken(token: string): JwtPayload {
+ return jwt.verify(token, secret) as JwtPayload;
}
[Approve] [Reject] [Edit]
5. Painel Direito: Área Multifuncional
(1) Navegador de Arquivos
- Navegar pela árvore de arquivos do projeto
- Ver quais arquivos o Codex modificou
- Clicar em um arquivo para ver seu conteúdo
(2) Painel de Terminal
- Ver comandos executados pelo Codex
- Ver saída de comandos
- Digitar comandos manualmente
(3) Visualizador de Código
- Ver conteúdo completo de arquivos
- Ver comparações diff
- Syntax highlighting
(4) Painel de Contexto
- Ver arquivos de contexto atualmente usados
- Adicionar/remover contexto manualmente
- Ver uso da janela de contexto
6. Barra de Ferramentas Superior
| Recurso | Descrição |
|---|---|
| Seleção de modelo | Trocar o modelo de IA em uso |
| Modo sandbox | Alternar entre Suggest / Auto Edit / Full Auto |
| Seleção de projeto | Trocar o projeto de trabalho atual |
| Configurações | Abrir o painel de configurações |
7. Atalhos de Teclado
| Atalho | Função |
|---|---|
Cmd/Ctrl+N |
Nova tarefa |
Cmd/Ctrl+Enter |
Enviar mensagem |
Cmd/Ctrl+Shift+A |
Aprovar tudo |
Cmd/Ctrl+Shift+R |
Rejeitar tudo |
Cmd/Ctrl+1/2/3 |
Trocar painel direito |
Cmd/Ctrl+. |
Interromper tarefa atual |
8. Painel de Configurações
| Configuração | Descrição | Padrão |
|---|---|---|
| Modo sandbox | Suggest / Auto Edit / Full Auto | Suggest |
| Modelo padrão | Seleção de modelo de IA | gpt-5-codex |
| Auto-save | Salvar automaticamente modificações do Codex | On |
| Tema | Dark / Light | Seguir sistema |
| Tamanho da fonte | Tamanho da fonte do código | 14px |
❓ Perguntas Frequentes
P: Posso executar múltiplas tarefas ao mesmo tempo? R: Sim. O Codex App suporta paralelismo multi-tarefa — cada tarefa roda em um sandbox independente sem interferência.
P: Posso redimensionar a janela de conversa? R: Sim — arraste as bordas do painel para ajustar os tamanhos das áreas. Você também pode recolher o painel esquerdo ou direito.
P: Onde posso ver os arquivos modificados pelo Codex? R: O navegador de arquivos à direita marca os arquivos modificados — clique para ver o diff. A janela de conversa também mostra cada modificação em tempo real.
P: Os recursos do App e do CLI são os mesmos? R: Os recursos core são os mesmos. O App oferece uma experiência GUI mais rica (navegador de arquivos, gerenciamento multi-tarefa), enquanto o CLI é melhor para usuários de terminal e cenários de automação.
P: Como paro uma tarefa em execução? R: Clique com o botão direito na tarefa na lista de tarefas e selecione Cancel, ou use o atalho Cmd/Ctrl+.
📖 Resumo
- Layout de três painéis: lista de tarefas + janela de conversa + área multifuncional
- Painel esquerdo gerencia tarefas paralelas; painel central interage com o Codex
- Painel direito visualiza arquivos, terminal e mudanças de código
- Domine os atalhos de teclado para maior eficiência
- O painel de configurações controla modo sandbox, modelo e mais
📝 Exercícios
- Básico (⭐): Crie e complete uma tarefa simples no Codex App. Tire screenshots de cada área.
- Intermediário (⭐⭐): Execute duas tarefas simultaneamente e observe a execução paralela. Registre mudanças de status das tarefas.
- Avançado (⭐⭐⭐): Personalize as configurações do Codex App para encontrar sua configuração ideal e explique suas escolhas.
