Table of Contents

Codex CLI serve a um fluxo controlado por shell, com comandos explícitos e execuções programáveis. Codex desktop serve a projetos, conversas, resultados visuais e painéis de revisão. Escolha a interface conforme sua supervisão e mantenha modelo, repository e execution policy iguais. Nota de nome: a documentação antiga do Codex da OpenAI agora redireciona para a documentação do app ChatGPT desktop . Um chat sem acesso ao repository não é um coding agent.

Principais conclusões

  • Use CLI para composição de shell e execuções repetíveis.
  • Use desktop para organizar projetos, revisão visual e tarefas agendadas.
  • Deixe o local de execução explícito, sobretudo em conexões remotas.
  • A interface não garante código melhor nem uma cota de inferência independente. Escopo e data: a documentação oficial foi conferida em 10 de outubro de 2026. A recomendação trata do fluxo, não de desempenho medido do modelo. Use repository, testes funcionais e acesso adequado à conta. Reserve uma hora para o teste.

Compare os fluxos

NecessidadeCodex CLICodex desktop
Começar no repositoryIniciar de um diretório shellEscolher projeto e ambiente
Repetir tarefa scriptadacodex execPreparar prompts e inspecionar outputs
Ver várias tarefasFluxo de terminal/sessãoOrganização de projetos e chats
Revisar mudançasComandos e controles de revisãoPainéis diff e revisão
Gerenciar horáriosJob runner externoInterface de tarefas agendadas
Isolar mudançasCheckout/worktree separadoFluxo worktree integrado
As bases compartilhadas importam. OpenAI descreve CLI, app e extensão IDE em Codex como plataforma . O runtime administra estado, ferramentas e política.

Onde CLI se encaixa

codex

Inicie no repository certo. A CLI guide documenta inspeção, edição, comandos e revisão.

codex exec "Identify the documented test command. Do not modify files."

Use codex exec para uma tarefa delimitada. A referência não interativa explica progresso e output. Pedido sem edição é instrução, não limite imposto ao filesystem. Defina credenciais, repository, timeout, permissões, armazenamento e falhas em produção.

Onde desktop se encaixa

Desktop reúne trabalho relacionado. A documentação atual descreve troca de projetos, arquivos, ferramentas conectadas e tarefas longas. A revisão é uma diferença concreta. Consulte a documentação de code review e confirme comportamento fora do diff com evidência independente. Teste uma tarefa visual com screenshot e viewport.

Painéis de automação de terminal e revisão desktop ligados ao mesmo repository e a uma checklist independente

Mantenha repository e critérios de aceitação constantes na comparação

Worktrees e local de execução

Worktree é outro checkout de um repository Git. A worktree guide explica chats isolados e worktrees gerenciados. Isolamento não faz merge. Revise diff, testes, dependências, arquivos ignorados e serviços externos.

Antes da tarefaConfirme
RepositoryProjeto e revisão base corretos
CheckoutDiretório existente ou worktree isolado
HostComputador com arquivos e ferramentas
AmbienteRuntime, dependências e testes
PermissõesEscrita e rede permitidas
Use o mesmo ambiente na comparação e registre diferenças antes de culpar o cliente.

Agendamento e permissões

Desktop gerencia agendamentos. A guia de tarefas agendadas separa interface e CLI. codex exec com shell scheduler é outra operação. Confira o perfil efetivo na referência de permissões . Verifique sign-in, model, uso e cobrança em cada interface.

Teste de uma hora

  1. Prepare uma mudança limitada com teste de aceitação e base limpa.
  2. Execute em cada interface com model e policy iguais.
  3. Peça uma correção após o primeiro patch.
  4. Revise o diff final e execute as mesmas verificações.
  5. Registre seu esforço de contexto, output e aprovação. Escolha CLI para repetição no shell. Escolha desktop para organização e revisão visual. Guarde revisão inicial, model, host, permissões, comandos e verificação.

Solução de problemas e próximos passos

Arquivo ausente exige checagem de ambiente. Verifique projeto, checkout, host, runtime e dependências. Compare alternativas com a comparação CLI e a comparação GUI . Mantenha o registro para upgrades.