Guia completo sobre o OpenAI Codex — o que é, como usá-lo em…

INEMA

emanalmente

Agenda: toda segunda-feira às 9h.

Tarefa: 1. atualizar dependências se for seguro; 2. rodar testes; 3. rodar build; 4. revisar erros recentes; 5. gerar relatório em reports/weekly-review.md; 6. se houver mudanças, criar commit com mensagem clara.

Use uma nova thread a cada execução. Use raciocínio médio. Não faça deploy sem minha aprovação.

13. Resumo rápido dos nomes⌗

Nome	O que é	Como usar
Agente principal	O Codex coordenando a tarefa	Chat/thread normal
Agent thread	Uma conversa/tarefa separada	Nova thread no projeto
Worker agent	Trabalhador para uma parte do trabalho	“Divida em workers…”
Task agent	Agente com tarefa específica	“Crie um task agent para…”
Subagente	Agente especializado em paralelo	“Use subagentes…”
Background agent	Agente rodando em segundo plano	Thread/tarefa em background
Agente paralelo	Várias tarefas ao mesmo tempo	Threads, subagentes ou worktrees
Automação	Tarefa agendada	Aba Automations
Skill	Receita reutilizável `\| /nome-da-`skill ou linguagem natural
AGENTS.md	Instruções permanentes do projeto	Arquivo no projeto

Minha recomendação: comece usando threads + skills + automações. Depois que isso estiver claro, passe para subagentes e workers para tarefas maiores.

No Codex, esses nomes de agentes diversos existem, mas não são todos botões separados. Na prática, você cria e executa “agentes” de três jeitos:

Thread / tarefa normal no Codex.
Subagentes configurados para tarefas especializadas.
Automações para rodar tarefas em horário ou frequência definida.

A documentação oficial diz que o Codex app foi feito para trabalhar com threads em paralelo, com suporte a worktrees, automações e Git. No Windows, ele também suporta navegador interno, previews, plugins e skills. (OpenAI Developers)

1. Agente principal⌗

O agente principal é o próprio Codex rodando em um chat/thread.

Você executa assim:

Abra este projeto e analise a estrutura. Depois crie um plano para melhorar a organização dos arquivos. Não altere nada ainda; primeiro me mostre o plano.

Depois, quando gostar do plano:

Pode executar o plano. Faça as alterações, rode os testes e me mostre o resumo do que mudou.

No terminal, o Codex CLI roda localmente e pode ler, alterar e executar código dentro do diretório selecionado. Ele funciona em macOS, Windows e Linux. (OpenAI Developers)

Comando básico:

codex

Isso abre o modo interativo no terminal.

2. Agent thread⌗

Uma agent thread é uma conversa/tarefa separada do Codex.

Pense assim:

Thread 1: corrigir bugs Thread 2: criar documentação Thread 3: revisar segurança Thread 4: preparar deploy

No Codex app, você pode abrir várias threads dentro do mesmo projeto e deixar tarefas rodando em paralelo. A documentação chama o app de uma experiência para trabalhar com Codex threads in parallel. (OpenAI Developers)

Como criar:

Nova thread: revise o código e encontre bugs potenciais.

Outra thread:

Nova thread: crie a documentação técnica deste projeto.

Outra:

Nova thread: analise o fluxo de deploy e encontre riscos.

3. Worker agent⌗

Um worker agent é um agente trabalhador que recebe uma parte específica do trabalho.

No Codex, você pode pedir isso em linguagem natural:

```Divida esta tarefa em 3 workers:

Worker 1: analisar a arquitetura do projeto. Worker 2: encontrar bugs e riscos. Worker 3: revisar testes e cobertura.

Cada worker deve trabalhar separadamente e depois você deve consolidar tudo em um único relatório.```

Esse tipo de divisão é parecido com subagentes: agentes especializados trabalhando em paralelo e depois juntando os resultados.

4. Task agent⌗

Um task agent é um agente dedicado a uma tarefa específica.

Exemplos:

Crie um task agent para revisar apenas os arquivos de autenticação. Ele deve procurar falhas de segurança, problemas de sessão e validação ruim. No final, traga uma lista priorizada.

ou:

Crie um task agent para gerar testes unitários para os componentes principais. Não altere a lógica do app, apenas adicione testes.

Use task agents quando a tarefa tiver um objetivo bem definido.

5. Subagentes⌗

Subagentes são agentes especializados que o Codex pode disparar em paralelo e depois reunir os resultados em uma resposta só. A documentação oficial diz que subagentes ajudam especialmente em tarefas complexas e paralelizáveis, como explorar uma codebase ou implementar um plano com múltiplas etapas. (OpenAI Developers)

Exemplo de prompt:

```Use subagentes especializados para esta análise:

Subagente de arquitetura: - Entenda a estrutura do projeto. - Identifique módulos principais.
Subagente de bugs: - Procure erros prováveis. - Encontre edge cases.
Subagente de testes: - Veja quais partes não têm testes. - Sugira testes prioritários.
Subagente de documentação: - Verifique se README e docs explicam bem o projeto.

Depois consolide os resultados em um plano único de melhoria.```

Esse é um bom formato porque você define:

Nome do subagente.
Objetivo.
Escopo.
Entregável final.

6. Background agent⌗

Um background agent é um agente rodando em segundo plano enquanto você faz outra

As skills globais e skills locais se diferenciam pelo lugar onde ficam salvas e pelo alcance de uso.

Skill global⌗

A skill global fica na pasta global do Codex, geralmente algo como:

.codex/skills

ou dentro da pasta global de configuração do Codex no seu usuário.

Ela fica disponível para todos os projetos.

Use quando a skill serve para qualquer contexto, por exemplo:

revisar código;
gerar documentação;
criar relatório;
fazer QA com navegador;
analisar planilhas;
criar dashboards;
preparar deploy.

Como pedir:

Transforme esse fluxo em uma skill global para que eu possa usar em qualquer projeto.

ou:

Crie uma skill global chamada "code-review-checklist" com esse processo.

Skill local⌗

A skill local fica dentro da pasta do projeto atual.

Exemplo:

meu-projeto/ .codex/ skills/ minha-skill/ SKILL.md

ou algo parecido dentro do diretório do projeto.

Ela fica disponível somente naquele projeto.

Use quando a skill depende de regras, arquivos, APIs ou contexto daquele projeto específico.

Exemplos:

skill para analisar comentários de um canal específico;
skill que usa uma API key daquele projeto;
skill que conhece uma estrutura de pastas específica;
skill para atualizar um dashboard específico;
skill para rodar um fluxo interno daquele produto.

Como pedir:

Transforme esse fluxo em uma skill local deste projeto.

ou:

Crie essa skill apenas dentro deste projeto, não global.

Como dizer para o Codex ser global ou local⌗

Para criar global:

Crie uma skill global com esse workflow, disponível para todos os meus projetos no Codex.

Para criar local:

Crie uma skill local neste projeto, porque ela depende dos arquivos e regras daqui.

Para mover de local para global:

Mova essa skill para global, para eu conseguir usar em outros projetos.

Para mover de global para local:

Torne essa skill local deste projeto, porque ela só faz sentido aqui.

Para conferir onde ela está:

Mostre onde essa skill foi salva e me diga se ela é global ou local.

Regra simples⌗

Use global quando for uma habilidade reutilizável em vários projetos.

Use local quando a habilidade depende do contexto de um projeto específico.

Exemplo prático:

A skill "revisar código antes do commit" deve ser global. A skill "atualizar dashboard de comentários do YouTube" deve ser local.

**Uso de modelos e níveis de raciocíni

**Se recomenda não usar sempre o nível mais alto

.Sugestão geral

:Medium: bom para planejamento, brainstorming e tarefas normais .High: bom para builds maiores ou tarefas mais complexas .Extra High: usar quando há bugs difíceis ou problemas que o modelo não conseguiu resolver .Fast: ele quase nunca usa, porque pode consumir mais limite e normalmente não há tanta pressa

Alerta que usar “extra high” em tarefas simples pode gerar overengineering.

Pets do Codex

O “pet” do Codex, uma pequena animação que fica na tela.

Apesar de ser um detalhe visual divertido, ele também tem utilidade prática:

Mostra quando o Codex está trabalhando. Mostra se há sessões que precisam de atenção. Permite acompanhar atividades enquanto você faz outras coisas.

O pet pode ser trocado nas configurações de aparência.

/pet ativa e desativa

Personalidade do Codex

O comando /personality.

Troca a personalidade de “friendly” para “pragmatic”.

A personalidade pragmática é descrita como:

Mais direta. Mais concisa. Mais focada em tarefa. Menos conversacional.

Recomenda esse modo para trabalho produtivo.

**Side chat

**É possível abrir um chat lateral sem interromper a tarefa principal

.Isso é útil para

:Fazer perguntas paralelas .Pedir atualizações .Consultar contexto do projeto .Não interromper uma execução longa

.O side chat continua tendo acesso ao contexto do projeto.

Comandos com / e referências com @

O Codex permite usar comandos com /, como:

/personality /plan mode /model /reasoning /browser use /pet /skill creator

Também é possível usar @ para referenciar arquivos específicos do projeto ou plugins.

Isso ajuda a apontar exatamente qual arquivo, ferramenta ou contexto o Codex deve usar.

Arquivo agents.md

Depois de dar contexto ao Codex, o autor pede para criar um arquivo chamado agents.md.

Esse arquivo funciona como uma documentação de onboarding para o agente.

Ele pode conter:

Quem é o usuário. Qual é o objetivo do projeto. O que o projeto está tentando construir. Quais decisões já foram tomadas. Quais erros já aconteceram. Quais instruções o Codex deve lembrar em novos chats.

A comparação feita é com o arquivo claude.md usado no Claude Code. No Codex, o equivalente seria o agents.md.

contexto, arquivos, histórico e tarefas separados.

Arquivos locais⌗

No app e no CLI, ele pode trabalhar com arquivos locais do diretório escolhido, lendo, editando e criando arquivos.

Worktrees⌗

O Codex suporta worktrees, permitindo que agentes trabalhem em paralelo sem misturar alterações no mesmo branch ou diretório. A OpenAI destaca worktrees como parte do fluxo multiagente do Codex.

Agentes em paralelo⌗

Você pode ter mais de uma tarefa rodando ao mesmo tempo, o que é útil para revisão, refatoração, testes e experimentos em paralelo.

Git⌗

O Codex pode ajudar com Git: ver diferenças, preparar commits, revisar mudanças e trabalhar com repositórios.

GitHub⌗

O Codex pode se conectar ao GitHub e também tem suporte a GitHub Action para rodar em CI/CD, aplicar patches ou postar revisões em workflows. ([OpenAI Developers][8])

Terminal⌗

Ele pode rodar comandos, executar testes, instalar dependências, iniciar servidores locais e verificar resultados.

Navegador interno⌗

No app, o Codex pode usar navegador interno para testar interfaces, abrir previews e validar aplicações.

Artifact previews⌗

Permite visualizar entregáveis, páginas, interfaces ou outros artefatos gerados durante o trabalho.

Plugins⌗

Plugins conectam o Codex a ferramentas externas e ampliam o que ele consegue acessar ou operar.

Skills⌗

Skills são instruções reutilizáveis para tarefas recorrentes. Servem como “receitas” para o Codex repetir fluxos com mais consistência.

Automações⌗

O app no Windows suporta automações, permitindo configurar rotinas ou tarefas recorrentes dentro do fluxo do Codex.

CLI⌗

O Codex CLI permite usar o agente direto no terminal, em macOS, Windows e Linux.

IDE extension⌗

A extensão coloca o Codex dentro do editor, útil para trabalhar diretamente no código.

7. Quando usar cada versão⌗

Use Codex web quando quiser delegar tarefas em nuvem, trabalhar com repositórios conectados ou acompanhar agentes sem depender tanto do ambiente local.

Use Codex no Windows app quando quiser uma interface visual completa para projetos, automações, navegador interno, skills, plugins, previews e várias threads de agentes.

Use Codex no terminal quando quiser velocidade, controle local e integração direta com comandos, testes e repositórios.

Use Codex na IDE quando quiser ficar dentro do VS Code/Cursor e pedir alterações no contexto do código aberto.

8. Em uma frase⌗

Codex é o agente da OpenAI para transformar conversa em trabalho técnico executado: código, revisão, arquivos, testes, automações, Git e entrega.

1. O que é o Codex⌗

Codex é um agente de programação da OpenAI que ajuda a escrever, revisar, alterar, testar e entregar código. Ele não serve apenas para responder perguntas: a proposta é trabalhar em projetos reais, lendo arquivos, editando código, rodando comandos e ajudando a levar uma ideia até uma entrega funcional.

Em termos simples:

ChatGPT responde. Codex executa trabalho técnico.

Ele pode ser usado para:

Criar funcionalidades.
Corrigir bugs.
Refatorar código.
Revisar pull requests.
Gerar testes.
Rodar comandos.
Trabalhar em repositórios.
Criar automações.
Ajudar no deploy.
Trabalhar com arquivos locais ou ambientes na nuvem.

2. Uso do Codex na web⌗

Você pode usar o Codex na nuvem pelo chatgpt.com/codex. A versão web é útil quando você quer delegar tarefas de desenvolvimento sem depender totalmente do seu computador local. A documentação da OpenAI descreve o Codex como disponível na nuvem pelo ChatGPT/Codex.

Na web, o Codex é mais indicado para:

Delegar tarefas de código.
Trabalhar com repositórios conectados.
Revisar alterações.
Executar tarefas em ambientes cloud.
Acompanhar agentes trabalhando em paralelo.
Usar o Codex como centro de comando para projetos.

A própria página da OpenAI descreve o app Codex como um “centro de comando” para programação com agentes, com worktrees e ambientes em nuvem para agentes trabalharem em paralelo.⌗

3. Uso do Codex no Windows⌗

O Codex tem app nativo para Windows. Segundo a documentação da OpenAI, o app no Windows permite trabalhar entre projetos, rodar threads de agentes em paralelo e revisar resultados em uma única interface. Ele também suporta recursos como worktrees, automações, Git, navegador interno, previews de artefatos, plugins e skills.

No Windows, você pode usar o Codex de três formas principais:

1. App nativo do Codex Bom para quem quer uma interface visual parecida com um ambiente de trabalho de projetos.

2. Terminal / CLI Bom para quem prefere trabalhar direto no terminal com repositórios locais.

3. Extensão de IDE Bom para quem usa VS Code, Cursor ou outro editor compatível e quer o Codex dentro do editor.

4. Uso do Codex no terminal⌗

O Codex CLI é a versão de terminal do Codex. Ele roda localmente e pode ler, alterar e executar código no diretório selecionado. A OpenAI informa que o Codex CLI está disponível para macOS, Windows e Linux; no Windows, pode rodar nativamente no PowerShell com sandbox do Windows ou via WSL2 quando for necessário um ambiente Linux.

No terminal, o Codex é útil para:

Trabalhar dentro de um repositório local.
Pedir alterações no código.
Rodar testes.
Gerar commits.
Refatorar arquivos.
Corrigir erros.
Executar comandos.
Automatizar tarefas técnicas.
Fazer sessões interativas direto no terminal.

A documentação também menciona o modo interativo, em que o Codex abre uma interface de terminal em tela cheia para trabalhar junto com você no repositório.

5. Uso do Codex em IDE⌗

Além da web, app e terminal, o Codex também pode ser usado como extensão de IDE.

Na prática, isso significa que ele pode aparecer dentro do seu editor, como VS Code ou Cursor, permitindo que você converse com o agente enquanto ele entende o contexto dos arquivos abertos e do projeto. A documentação da OpenAI menciona que, no VS Code, o Codex aparece na barra lateral do editor.

É uma boa opção quando você quer:

Revisar código sem sair do editor.
Pedir alterações em arquivos específicos.
Gerar testes.
Explicar trechos de código.
Corrigir erros diretamente no fluxo de desenvolvimento.

Uma forma simples de pensar:

Claude Code costuma ser ótimo para pensar junto. Codex costuma ser ótimo para executar, revisar e entregar.

Isso não significa que um substitui o outro. Eles podem ser usados juntos no mesmo projeto, principalmente porque ambos trabalham sobre arquivos e repositórios.

6. Recursos principais do Codex⌗

Projetos⌗

O Codex trabalha organizado por projetos. Isso ajuda a manter

Codex Conheça 97%

chatgpt.com ↗