O Que É o OpenAI Codex? Guia para Iniciantes em 2026

- Os fatos sobre o Codex mudam rápido (níveis de modelo, preços, domínio da documentação); tudo abaixo foi conferido contra a documentação oficial no momento em que escrevi - verifique a documentação ao vivo antes de depender de um número específico.

O Que É o OpenAI Codex?

O OpenAI Codex é o produto de codificação agêntica da OpenAI: ele lê uma base de código, planeja uma mudança, edita arquivos, roda seus testes ou linter e abre um pull request, quase tudo por conta própria depois que você entrega uma tarefa a ele. Essa é a definição central que vale a pena guardar, e é por isso que o Codex é comparado mais a um engenheiro júnior do que ao autocompletar.

O Codex vem em três superfícies que compartilham o mesmo agente por baixo: uma ferramenta de linha de comando que você roda no seu terminal, um serviço em nuvem que sobe sandboxes paralelas a partir da web, do GitHub, do Slack ou do Linear, e extensões de IDE para VS Code e JetBrains. Você dá uma instrução a ele - "adicione testes para este módulo", "conserte o job de CI que está falhando", "abra um PR que migre este endpoint" - e ele percorre o repositório do jeito que um desenvolvedor faria: lê arquivos, faz edições, roda comandos, confere o resultado, itera.

Ele é feito pela OpenAI, movido por um modelo da família GPT-5.6 (mais sobre isso abaixo) e incluído nos planos do ChatGPT em vez de vendido como um produto à parte. Se você só ouviu "Codex" mencionado no contexto da história inicial do GitHub Copilot, isso é um produto diferente e já aposentado - que cubro a seguir.

Para times que já usam o Claude Code, o modelo mental se transfere direto: mesmo padrão de agente em loop, fornecedor e padrões diferentes.

Não É o Mesmo Modelo Codex de 2021

O nome "Codex" foi reciclado, e isso causa uma confusão de verdade - a própria Wikipédia mantém duas páginas de desambiguação separadas para ele, o que mostra com que frequência as pessoas confundem os dois.

O Codex original era um modelo da OpenAI de 2021 descendente do GPT-3, ajustado com código público. Ele movia a versão mais antiga do GitHub Copilot e a própria Codex API da OpenAI, e desde então foi descontinuado em favor de modelos mais novos.

O Codex que você instalaria hoje é um produto de agente de 2025 em diante: uma base de código diferente, um modelo de interação diferente (um agente de CLI/nuvem/IDE em vez de uma API de autocompletar) e uma família de modelos por baixo completamente diferente. Se um artigo, vídeo ou post de fórum descreve o Codex como uma API de autocompletar código que você chama para receber sugestões, quase certamente está descrevendo o produto aposentado de 2021, não o que este guia cobre.

Codex vs. AgentKit vs. OpenAI AgentKit - Não Confunda Esses

Esta é a seção que todo guia de Codex pula, e é onde a maior parte da confusão realmente acontece. Três produtos compartilham nomes que se sobrepõem. Mantenha-os separados:

Vale sinalizar: a OpenAI anunciou em 2026-06-03 que está encerrando o Agent Builder e o Evals (desligamento em 2026-11-30, o Evals fica somente leitura em 2026-10-31), enquanto o ChatKit e o Connector Registry permanecem. Confira isso na página de descontinuações da OpenAI antes de depender disso - mas, no momento em que escrevo, significa que o AgentKit de terceiros (agentkit.best) é o produto com esse nome mais ativamente mantido.

Se você quer a análise completa, veja OpenAI AgentKit vs. AgentKit. Para saber como o kit de terceiros de fato se conecta ao Codex, veja usando o AgentKit dentro do Codex ou a análise do AgentKit.

Três Formas de Rodar o Codex - CLI, Nuvem, IDE

O Codex é um só agente, mas você pode alcançá-lo a partir de três superfícies diferentes conforme o trabalho:

A CLI é a superfície com que a maioria dos desenvolvedores começa, e é a que este cluster cobre com mais profundidade - veja o guia completo de instalação da Codex CLI. A instalação em si é um único comando de shell (nenhum runtime separado para gerenciar), o que faz parte do motivo de ela ter se espalhado rápido entre desenvolvedores que já usavam a CLI do Claude Code.

A nuvem é a superfície que mais surpreende as pessoas: em vez de um agente trabalhando em uma tarefa por vez, você pode disparar várias tarefas a partir de um issue do GitHub, uma mensagem do Slack ou do app web, e cada uma roda em sua própria sandbox isolada. Isso é útil para aquele tipo de trabalho pequeno e paralelizável - atualizações de dependência, pequenas correções de bug, PRs de boilerplate - que não precisa da sua atenção constante. Para o passo a passo completo, veja o guia do Codex Cloud.

As extensões de IDE importam menos como lugar para rodar tarefas longas e mais como lugar para revisar o que o Codex já fez, inline, sem sair do seu editor.

O Modelo Por Trás do Codex - GPT-5.6 (Sol / Terra / Luna)

O Codex roda no modelo GPT-5.6 da OpenAI, que chegou à disponibilidade geral em 2026-07-09 - este é o fato mais fresco desta página, então trate-o como um item para verificar ao vivo e confira openai.com/index/gpt-5-6/ antes de citá-lo em outro lugar.

O GPT-5.6 vem em três níveis, informalmente chamados de Sol, Terra e Luna, que trocam velocidade e custo por profundidade de raciocínio: o nível mais alto pensa por mais tempo e lida com refatorações mais difíceis, o nível mais baixo responde mais rápido e queima menos do seu orçamento de uso em edições rotineiras. O Codex escolhe um padrão sensato e deixa você trocar de nível dependendo de estar fazendo uma correção rápida ou uma migração grande.

As taxas exatas de créditos e os preços por nível mudam com frequência suficiente para eu cobri-los à parte, com números, no guia de preços do Codex em vez de congelá-los aqui.

Quanto Custa o Codex?

O Codex não tem uma etiqueta de preço própria e separada. Ele está incluído no seu plano do ChatGPT, então o que você paga é o plano em que você já está (ou para o qual faria upgrade):

Duas coisas para sinalizar antes de você planejar seu orçamento em torno desta tabela. Primeira, preços e limites de uso mudam - este é um número para verificar ao vivo, confira learn.chatgpt.com/codex/pricing antes de se comprometer. Segunda, "uso" não é ilimitado em nenhum nível; os níveis mais pesados do GPT-5.6 (o Sol especialmente) consomem seu orçamento mais rápido do que os mais leves, que é a verdadeira razão pela qual o seletor de nível da seção anterior importa. Para a análise atual completa por nível e plano, veja o guia de preços do Codex.

Configurando & Confiando no Codex - AGENTS.md, Sandbox, Skills

Três configurações decidem o quanto o Codex sabe sobre o seu projeto e o quanto ele tem permissão de tocar. Cada uma tem seu próprio aprofundamento; aqui vai a versão curta de cada uma.

AGENTS.md. O Codex lê as instruções do projeto no AGENTS.md, procurando nesta ordem: ~/.codex/AGENTS.override.md, depois ~/.codex/AGENTS.md, e então arquivos por diretório, da raiz do git para baixo até a sua pasta atual, concatenando de cima para baixo com os arquivos mais próximos sobrescrevendo. Há um limite de tamanho (32 KiB por padrão) e - vale saber se você também usa o Claude Code - o Codex não lê o CLAUDE.md. Todos os detalhes no guia de AGENTS.md para o Codex.

Sandbox e aprovações. Você escolhe quanto acesso ao sistema de arquivos o Codex recebe - read-only, workspace-write (o padrão) ou danger-full-access - e com que frequência ele precisa pedir antes de agir - untrusted, on-request ou never. Trate isso como o seu limite de segurança de verdade; não confie apenas no texto do prompt para impedir o Codex de tocar em algo que não deveria. Todos os detalhes em modos de sandbox e aprovação.

Skills. O Codex suporta skills baseadas em SKILL.md, e o formato é compatível com as skills do Claude Code - escreva uma, use nas duas ferramentas. Estou sendo cautelosa quanto ao link exato do catálogo canônico aqui porque os próprios repositórios de skills e plugins da OpenAI foram ambos arquivados; a referência segura é o hub de documentação ao vivo. Todos os detalhes em Codex Skills explicadas.

Nenhuma dessas três substitui o bom senso. O AGENTS.md diz ao Codex o que o seu projeto espera; as configurações de sandbox dizem a ele o que tem permissão de fazer, independentemente do que ele ache que a tarefa exige; as skills lhe dão manuais reutilizáveis. Erre a configuração de sandbox e as outras duas não te salvam.

Revisando Código & Comandos Rápidos

O Codex tem um comando /review embutido com presets para revisar um diff, suas mudanças não commitadas, um commit específico ou um intervalo personalizado. Revisar especificamente um pull request do GitHub precisa da CLI gh instalada e autenticada. É uma forma rápida de dar uma segunda olhada em uma mudança antes de você fazer o push, e vale rodar até em código que você mesma escreveu, não só no que o Codex gerou. Passo a passo completo no guia de revisão de código do Codex.

Além do /review, o Codex tem um conjunto de slash commands que vale a pena memorizar em vez de consultar toda vez - mantemos uma lista atualizada na folha de cola da Codex CLI.

Codex vs. Claude Code, GitHub Copilot, Gemini CLI

O Codex não é a única ferramenta de codificação agêntica, e escolher uma é menos sobre qual é a "melhor" e mais sobre qual encaixa na sua stack. Nenhum veredito aqui, de propósito - cada comparação ganha sua própria página dedicada, com link abaixo.

Se você já usa o Claude Code e está decidindo se vale a pena adicionar o Codex, a comparação direta está em Claude Code vs. Codex; aquela página é dona do veredito, esta só te dá o panorama. Os confrontos dedicados contra os outros dois estão em Codex vs. GitHub Copilot e Codex vs. Gemini CLI.

Você Também Pode Rodar o AgentKit Dentro do Codex

Deixo o limite bem claro aqui, porque é fácil de borrar: o Codex em si - a CLI, as sandboxes na nuvem, o modo autônomo /goal - é grátis (ou incluído no plano) e feito pela OpenAI. Nada nesta seção é obrigatório para usar o Codex.

O AgentKit é um complemento pago à parte (agentkit.best, sem afiliação com a OpenAI) que instala skills, subagentes e workflows prontos por cima do Codex. Mecânica confirmada: instale com ak kit init engineer --target codex (adicione --global para uma instalação para todo o usuário), depois rode os comandos do kit de dentro de uma sessão do Codex com $ak:cook ... (repare no prefixo $ - o Claude Code usa /ak:cook). No Codex especificamente, a entrega é nativa: skills, regras e o despacho de agentes funcionam, os hooks são parciais, e não há barra de status nem menu interativo de comandos do kit como há no Claude Code.

Se vale ou não o preço depende de quanto desse andaime você construiria por conta própria. Se você já tem suas próprias convenções de AGENTS.md e hábitos de revisão, talvez não precise dele. Se você está partindo de uma instalação em branco do Codex e quer um conjunto funcional de skills e um portão de revisão de código no primeiro dia, essa é a real proposta de valor - veja a análise do AgentKit para o quadro completo, ou o guia de AgentKit no Codex para os detalhes de configuração.

Perguntas Frequentes (FAQ)

O OpenAI Codex é grátis?

Não é um produto pago à parte - está incluído nos planos do ChatGPT, inclusive num nível gratuito limitado. Uso mais pesado precisa de um plano pago (Go, Plus, Pro ou Business), e os limites de uso variam por nível e por qual nível de modelo GPT-5.6 você escolhe. Confira learn.chatgpt.com/codex/pricing para os números atuais.

Este é o mesmo Codex de 2021?

Não. O Codex de 2021 era um modelo de autocompletar código baseado no GPT-3 que movia o GitHub Copilot inicial e desde então foi descontinuado. O Codex coberto neste guia é um produto de agente de 2025 em diante, com uma base de código diferente e um modelo de interação diferente.

Codex vs. ChatGPT - qual é a diferença?

O ChatGPT é um assistente de chat geral; o Codex é o produto de agente de codificação construído por cima dos mesmos modelos, acessado por uma CLI, sandboxes na nuvem ou extensões de IDE, e ele age diretamente no seu repositório em vez de só responder perguntas numa janela de chat.

É seguro deixar o Codex editar meus arquivos?

Pode ser, se você configurar a sandbox corretamente. O padrão workspace-write do Codex mais os prompts de aprovação (untrusted/on-request/never) são o seu limite de segurança de verdade - nunca dê a ele danger-full-access numa máquina com credenciais de produção, e não presuma que só as instruções do prompt vão impedi-lo de sair do escopo.

Posso usar o Codex no Windows?

Sim. A Codex CLI instala e roda no Windows, macOS e Linux, ao lado das superfícies de nuvem e IDE.

Qual é a diferença entre Codex e AgentKit?

O Codex é o agente de codificação da OpenAI; o AgentKit (agentkit.best) é um complemento pago de terceiros à parte que instala skills e workflows prontos dentro do Codex (e dentro do Claude Code). São feitos por empresas diferentes, e o AgentKit é opcional - o Codex funciona plenamente sem ele.

Conclusão - Para Onde Ir Agora

O OpenAI Codex é um agente de codificação, não o modelo de mesmo nome de 2021, e não é nenhum dos dois produtos "AgentKit" flutuando pela mesma conversa. Ele roda a partir de uma CLI, da nuvem ou do seu IDE, num modelo GPT-5.6 cujo nível você pode ajustar para velocidade ou profundidade, incluído no seu plano do ChatGPT em vez de vendido separadamente.

Daqui: instale a Codex CLI, confira os preços atuais, configure o AGENTS.md e os modos de sandbox, ou veja como o AgentKit se sobrepõe assim que o básico estiver funcionando.