Como usar o Codex da OpenAI: o agente de código do ChatGPT no terminal, no navegador e no celular (2026)

Resposta rápida

O Codex é o agente de código da OpenAI, e hoje ele roda em quatro lugares diferentes: no terminal (Codex CLI), dentro do seu editor (extensão pra VS Code, Cursor e JetBrains), na web (chatgpt.com/codex) e no app do ChatGPT pra iOS. A forma mais rápida de começar é instalar o Node.js 22 ou superior, rodar npm install -g @openai/codex no terminal e digitar codex seguido do que você quer que ele faça, em português mesmo — ele lê os arquivos do seu projeto, propõe o código e mostra o diff antes de aplicar. Você não precisa saber programar pra pedir mudanças simples (corrigir texto, ajustar uma planilha, montar um app pequeno), mas pra revisar se o que ele fez está certo, noção básica ajuda bastante. O acesso já vem incluso em qualquer plano do ChatGPT, inclusive o gratuito, com limites de uso diferentes por faixa. Abaixo eu detalho a instalação passo a passo, os modos de segurança, os planos e a diferença real entre Codex, Cursor e Claude Code.

O que é o Codex da OpenAI e pra que ele serve?

Codex é o agente de código que a OpenAI conecta direto ao ChatGPT: você descreve uma tarefa em linguagem natural (“cria uma função que valida CPF”, “corrige esse bug no checkout”, “monta um app de lista de tarefas”) e ele lê o repositório inteiro, planeja os passos, edita os arquivos necessários, roda comandos no terminal (instalar dependência, rodar teste, subir servidor local) e devolve o resultado pra você aprovar. É diferente de um autocomplete de código dentro do editor — o Codex trabalha em modo agente, ou seja, ele decide sozinho a sequência de ações até entregar a tarefa pedida, não só sugere a próxima linha.

Ele nasceu em abril de 2025 como ferramenta de terminal e ao longo de 2026 ganhou as outras três frentes (IDE, web, celular), então hoje “Codex” não é mais sinônimo só de “linha de comando” — é o nome guarda-chuva pra esse agente em qualquer superfície que você prefira usar.

Como instalar e usar o Codex no terminal?

O jeito mais direto de sentir o que o Codex faz é pelo terminal:

1. Instale o Node.js 22 ou mais recente e confirme com node --version.
2. Instale o Codex CLI globalmente: npm install -g @openai/codex.
3. Autentique com a sua conta ChatGPT (Plus, Pro, Business, Edu ou Enterprise) ou com uma chave de API da OpenAI, se preferir pagar por uso separado da assinatura.
4. Rode seu primeiro pedido dentro da pasta do projeto: codex "explica o que esse projeto faz e lista os arquivos principais" — um bom primeiro comando pra qualquer projeto que você não escreveu.
5. Revise o diff antes de aprovar. No modo padrão (sugestão), o Codex mostra exatamente o que vai mudar em cada arquivo e espera você aceitar, recusar ou pedir ajuste — ele não aplica nada sem sua confirmação.

Se você já testou outro agente de terminal, como o Cursor no modo editor ou ferramentas de programação com IA em geral, a lógica de “descrever a tarefa, revisar o diff, aprovar” é a mesma — muda o motor por trás e onde ele roda.

Codex funciona só no terminal, ou tem versão web e celular?

Tem as quatro superfícies, e você pode alternar entre elas no mesmo projeto:

• CLI (terminal) — pra quem já vive no terminal e quer o agente trabalhando local, com acesso direto ao repositório na sua máquina.
• Extensão de IDE — plugin oficial pra VS Code (e forks como Cursor e Windsurf) e JetBrains, pra quem prefere ver o agente dentro do próprio editor.
• Codex web (chatgpt.com/codex) — roda em ambiente de nuvem isolado (sandbox), sem precisar do seu computador ligado; útil pra disparar uma tarefa e voltar depois pra revisar.
• App do ChatGPT (iOS) — dá pra acompanhar e aprovar tarefas do celular, bom pra revisar um diff rápido fora do computador, embora escrever código do zero pelo celular continue pouco prático.

Vale um alerta prático: até o início de 2026 o Codex não tinha suporte nativo a Windows nem Linux fora de ambiente Unix-like (WSL resolve no Windows) — se seu fluxo depende de rodar local nessas plataformas, confirme o suporte atual antes de montar o processo em cima disso.

Preciso saber programar para usar o Codex?

Pra tarefas pontuais, não. Você pode pedir em português algo como “cria uma página simples com um formulário de contato” ou “organiza essa planilha de vendas por mês” e o Codex entrega o resultado sem você escrever uma linha. É o mesmo espírito de ferramentas como Lovable, V0 e Bolt, que também tiram o código do caminho de quem só quer o resultado.

Onde o conhecimento técnico entra é na revisão: o Codex pode escrever algo que funciona mas não é a melhor prática, ou interpretar um pedido ambíguo do jeito errado. Pra projeto pessoal ou protótipo, tudo bem testar e ajustar por tentativa. Pra código que vai pra produção ou mexe com dado sensível (senha, pagamento, dado de cliente), ter alguém que entende de programação revisando o diff antes de aprovar deixa de ser opcional.

O Codex é seguro? Ele roda comando sozinho sem eu ver?

Depende do modo que você escolhe, e essa é a parte que mais gera dúvida de quem começa:

• Modo sugestão (padrão): o Codex só lê o projeto e propõe mudanças; nada é escrito em disco nem executado sem sua aprovação explícita, comando por comando.
• Modo automático: ele edita arquivos e roda comandos sozinho dentro de uma pasta liberada, mas ainda pede aprovação pra ações fora dela ou pra comandos considerados arriscados (apagar arquivo, acessar rede).
• Modo acesso total: ele executa tudo sem perguntar — recomendado só dentro de um ambiente isolado (sandbox, container, máquina virtual), nunca direto na sua máquina principal com dado real.

A regra prática que eu sigo: comece sempre no modo sugestão pra conhecer como o agente pensa, suba pro automático só depois de confiar no padrão de decisão dele, e reserve o acesso total pra ambiente descartável.

Qual a diferença entre Codex, Cursor e Claude Code?

Os três resolvem o mesmo problema (agente de IA que escreve e edita código de verdade), mas partem de lugares diferentes:

	Codex (OpenAI)	Cursor (Anysphere)	Claude Code (Anthropic)
Onde vive primeiro	Multi-superfície (CLI, IDE, web, app)	Editor próprio (fork do VS Code)	Terminal
Modelo de IA	Só modelos OpenAI	Acesso a modelos de vários laboratórios	Só modelos Anthropic (Claude)
Execução padrão	Cloud (sandbox) ou local, à sua escolha	Local, dentro do editor	Local, no terminal do seu projeto
Melhor pra	Quem já vive no ecossistema ChatGPT e quer alternar entre celular/web/terminal	Quem quer um editor de código pronto, com IA embutida no dia a dia	Quem prefere trabalhar 100% pelo terminal, em repositórios grandes

Não existe “o melhor” fora de contexto — existe o que combina com seu fluxo. Se você já assina ChatGPT e quer aprovar tarefas tanto do computador quanto do celular, o Codex tem vantagem de já estar incluso. Se você quer um editor completo com IA nativa no dia a dia, o Cursor entrega isso pronto. Se seu trabalho é terminal-first em repositório grande, o Claude Code tende a ser o mais direto.

Quanto custa o Codex e quais os limites de uso?

O Codex CLI em si é gratuito pra instalar — o custo está no plano do ChatGPT (ou na chave de API, cobrada por token, separada da assinatura):

• Free (R$ 0) e Go (a partir de US$ 8/mês) — acesso ao Codex incluso, com limite de uso mais restrito.
• Plus (US$ 20/mês) — inclui Codex na web, CLI, extensão de IDE e app iOS, com uma cota de uso renovada a cada janela de 5 horas.
• Pro (a partir de US$ 100/mês) — cota bem maior (a OpenAI fala em múltiplos de 5x a 20x o volume do Plus, dependendo do nível).
• Business (US$ 20/usuário/mês) — pensado pra equipe, com administração central.

Um ponto que pega gente de surpresa: a cota é compartilhada entre CLI, web e IDE — uma sessão pesada no terminal consome do mesmo limite de 5 horas que uma sessão pesada no navegador. Se você usa o Codex em mais de uma superfície ao mesmo tempo, isso conta junto.

O Codex realmente entrega ganho de produtividade?

Vale separar hype de dado medido. Segundo o Stanford AI Index Report 2026 (Stanford HAI), a adoção de ferramentas de IA por desenvolvedores profissionais chegou a 80%, com 51% usando IA todos os dias no trabalho — e o ganho de produtividade medido em tarefas de desenvolvimento de software fica entre 14% e 26%, variando bastante conforme o tipo de tarefa e a experiência de quem usa. O mesmo relatório mostra a evolução técnica por trás disso: no benchmark SWE-bench Verified (que mede se um agente resolve bugs reais de projetos open source), a taxa de acerto saltou de 60% para perto de 100% em um único ano.

Do lado da OpenAI, Sam Altman confirmou publicamente em abril de 2026 que o Codex já passava de 3 milhões de usuários ativos semanais, com o volume de tokens processados crescendo mais de 70% mês a mês — sinal de que quem experimenta tende a continuar usando, não só testar uma vez.

Na prática isso confirma o que eu já falo aqui pros alunos da CPDF (Comunidade Profissionais do Futuro - por Danilo Gato): o ganho não é “a IA escreve tudo sozinha e você não faz nada” — é tarefa repetitiva e esqueleto de código saindo muito mais rápido, com o tempo que sobra indo pra decisão e revisão, que é onde seu julgamento continua insubstituível.

Vale a pena trocar minha ferramenta atual pelo Codex?

Só se ela não resolve o que você precisa hoje. Se você já usa Cursor ou Claude Code e está satisfeito, trocar de ferramenta raramente compensa o tempo de reaprendizado. O Codex faz mais sentido em três cenários: você já paga ChatGPT Plus/Pro e quer aproveitar o que já está incluso; você quer aprovar tarefas pelo celular sem abrir o computador; ou seu time já vive dentro do ecossistema OpenAI (API, Assistants, outros produtos) e ganha em ter tudo na mesma conta.

Se você está começando do zero em programação com IA, comece pelo que já tem acesso — plano do ChatGPT que você já paga, ou editor que já usa — e troque de ferramenta só depois de sentir na prática onde ela te limita.

Leia também

• Programação com IA: como criar apps e sites sem escrever código do zero
• Como usar o Cursor: o editor de código com IA nativa
• Criar app sem programar: V0, Bolt e Lovable comparados