Conhecendo o Codex e suas quatro interfaces
📚 Navegação da série: Este é o primeiro artigo de abertura do "Tutorial de Codex para Iniciantes". Sem precisar de nenhum conhecimento prévio, vamos começar explicando "o que diabos é o Codex". No próximo artigo, 〈02 Visão geral dos conceitos principais〉, vamos esclarecer todos os termos de uma vez por todas.
O que é o Codex, o que cada uma das quatro interfaces faz e qual a real diferença entre ele, o ChatGPT e o Claude Code
Pessoal, neste tutorial vamos falar sobre o Codex da OpenAI.
Codex, esse nome soa familiar, não é? A OpenAI já tinha um modelo antigo chamado Codex há alguns anos, e ao abrir o site oficial você fica ainda mais confuso — como assim tem um Desktop App, uma linha de comando, uma extensão de navegador e ainda uma versão Web na nuvem? Afinal, qual é o "verdadeiro Codex"? Qual devo instalar?
Para ser sincero, esse é exatamente o ponto onde o Codex mais confunde os iniciantes: ele não é "um software", mas sim o mesmo agente (Agent) de programação de IA, que possui quatro faces diferentes. Se não entender isso, você ficará travado por muito tempo pensando "qual devo baixar".
Este artigo não ensina como instalar nem como digitar comandos (isso é assunto para o 3º artigo). Ele faz apenas uma coisa: explicar detalhadamente "o que é o Codex, do que cada uma das quatro faces cuida e qual a diferença entre ele, o ChatGPT e o Claude Code", para que você tenha um mapa claro em mente. Com o mapa em mãos, você saberá exatamente qual instalar e qual usar mais tarde.
Depois de ler este artigo, você conseguirá:
- Explicar em uma frase "o que é o Codex", sem ser enganado pelo nome
- Ter uma tabela de comparação das quatro interfaces (Desktop App / CLI / Extensão de IDE / Web Cloud), sabendo por qual você deve começar
- Ter um critério de avaliação: qual a diferença entre o Codex e o ChatGPT, e qual a diferença em relação ao Claude Code, sem confundi-los mais
- Um pequeno passo de custo zero, em 30 segundos para confirmar se o seu computador o reconhece
Esta imagem mostra o núcleo de todo o artigo à primeira vista: Desktop App, linha de comando CLI, extensão de IDE e Web Cloud são as quatro faces do Codex — a aparência e o local onde rodam são diferentes, mas por trás estão interligados pela mesma conta e pelo mesmo agente Codex.
01 O que é o Codex afinal
Vamos direto à conclusão: O Codex é o "Agente de Programação de IA" oficial da OpenAI — você dá um objetivo a ele, e ele consegue ler todo o seu projeto, modificar arquivos diretamente, executar comandos, rodar testes e entregar o trabalho pronto para você aprovar, em vez de apenas te responder com um trecho de código no chat.
Você com certeza conhece a OpenAI, a empresa que criou o ChatGPT. O Codex é uma ferramenta que ela fez especificamente para o cenário de "escrever código". De acordo com a documentação oficial, os trabalhos que ele faz são basicamente as seguintes categorias (estas opções equivalem à "lista de habilidades" dele, dê uma olhada rápida primeiro, e no 2º artigo vamos detalhar):
- Escrever código: Você descreve o que quer, e ele gera o código seguindo a estrutura e o estilo que seu projeto já possui, em vez de jogar um fragmento isolado.
- Entender bases de código desconhecidas: Ao assumir um projeto antigo sem documentação, pedir para ele primeiro "explicar a arquitetura deste projeto" é muito mais rápido do que tentar decifrar sozinho.
- Revisar código: Ajuda a encontrar possíveis bugs, condições extremas (edge cases) esquecidas e erros de lógica.
- Depurar e corrigir (Debug): Jogue o erro para ele, e ele segue o código para rastrear a causa raiz, localizar o problema e fornecer o patch de correção.
- Automatizar tarefas braçais: Trabalhos repetitivos como refatoração, adição de testes, migrações e configuração de ambientes, podem ser delegados com uma única frase.
Aqui está a diferença crucial onde os iniciantes mais caem, separada especificamente:
Analogia: Consultar uma receita (ChatGPT) vs Contratar um chef particular para cozinhar em casa (Codex). Quando você usa o ChatGPT para programar, é como consultar uma receita — ele diz "neste prato vai sal, açúcar, refogue por três minutos", mas quem tem que mexer a panela é você: copiar o código, voltar para o editor, colar, corrigir os erros, tudo isso é trabalho manual seu. O Codex é diferente, ele é como um cozinheiro que entrou direto na sua cozinha — você diz "quero comer isso", ele mesmo procura na geladeira (lê os arquivos), liga o fogo (roda os comandos), termina de cozinhar e serve na mesa (termina de modificar o código, passa nos testes), você só precisa provar e aprovar.
A diferença na prática torna a experiência completamente diferente.
Vou dar um exemplo meu. Em março deste ano, retomei um pequeno projeto de web scraper (rastreador) em Python que estava parado há mais de seis meses, as dependências já estavam desatualizadas e ao tentar rodar apareceu um monte de erros. Se fosse antes, eu teria que copiar cada erro no ChatGPT, ele me diria "pode ser um problema na versão de alguma biblioteca", aí eu voltaria, pesquisaria, alteraria, tentaria rodar de novo... Uma tarde inteira seria gasta apenas mudando de janelas. Desta vez, eu simplesmente abri o Codex no diretório do projeto e joguei a frase "este projeto não está rodando, verifique a causa raiz e conserte até rodar". Ele mesmo vasculhou o requirements.txt e a pilha de erros (stack trace), localizou duas dependências incompatíveis, modificou as versões e rodou de novo para confirmar. Eu fui pegar um café e, quando voltei, ele já estava me esperando para ver o diff (diferenças do código).
Com isso você já pode sentir o peso da palavra "Agente (Agent, uma IA capaz de executar tarefas de forma autônoma)" — ele não te dá ideias, ele põe a mão na massa e termina o trabalho por você.
💡 Resumo em uma frase: Codex = Agente de programação de IA oficial da OpenAI, você dá o objetivo, ele coloca a mão na massa e termina, não é apenas um "chat que sabe escrever código".
02 Quatro faces: o mesmo Codex, quatro interfaces
Esta é a parte onde o Codex é mais diferente de muitas ferramentas e onde é mais fácil as pessoas se confundirem, então vamos focar nisso.
Ao mencionar "linha de comando" ou "terminal", a primeira coisa que vem à mente de muitos iniciantes é uma janela preta, e eles desistem na hora. Não entre em pânico — o Codex é justamente uma das ferramentas de programação de IA mais amigáveis para "pessoas que não querem encostar na linha de comando", pois eles criaram especificamente um Desktop App com interface gráfica.
De acordo com a documentação oficial, o Codex possui um total de quatro interfaces, e você pode entrar por qualquer uma delas:
| Interface | Como ela é | Onde ela roda | Para quem / Qual cenário é adequado |
|---|---|---|---|
| Desktop App (Codex app) | Aplicativo independente, interface gráfica, permite visualizar o diff (diferenças), roda múltiplas tarefas lado a lado | Na sua máquina local | Pessoas que não querem mexer na linha de comando, gostam de clicar em interfaces, precisam acompanhar várias tarefas ao mesmo tempo |
| Linha de comando CLI (Codex CLI) | Ferramenta de linha de comando onde se digita codex no terminal | Na sua máquina local | Pessoas acostumadas com terminal, que precisam escrever scripts de automação, que trabalham em servidores / SSH |
| Extensão de IDE (IDE extension) | Plugin na barra lateral no VS Code / Cursor / Windsurf / JetBrains | Na sua máquina local | Pessoas que costumam ficar mergulhadas no editor escrevendo código o tempo todo |
| Web Cloud (Codex cloud) | Acessar chatgpt.com/codex pelo navegador, as tarefas rodam no ambiente em nuvem da OpenAI | Na nuvem (Cloud) | Para iniciar uma tarefa demorada em segundo plano, rodar várias em paralelo, sem ocupar a máquina local |
Dentre as quatro, as três primeiras (Desktop App, CLI, Extensão de IDE) são trabalhos realizados no seu próprio computador — leem os arquivos locais e executam os comandos na sua máquina. Apenas a quarta, a Web Cloud, é diferente:
Analogia: Terceirizar o trabalho. As três primeiras interfaces são como se você tivesse contratado um assistente para sentar na sua mesa, usar o seu computador e seus materiais para trabalhar, e você acompanha todo o processo. Já a Web Cloud é como terceirizar a tarefa para uma equipe remota — você faz o pedido no navegador, a OpenAI cria um ambiente isolado na nuvem deles, puxa o seu repositório do GitHub para lá, altera a portas fechadas, e depois de alterar te entrega o diff, ou até mesmo cria um PR (Pull Request) diretamente para você. Mesmo com o seu computador desligado, ele continua rodando.
Esse modelo de "terceirização" tem duas vantagens concretas: A primeira é o paralelismo — você pode mandar três ou cinco tarefas de uma vez para rodar ao mesmo tempo, sem que uma bloqueie a outra; A segunda é o isolamento — ele mexe na sua própria caixa de areia (sandbox), não toca no sistema da sua máquina local, e se der erro não vai afetar você. A combinação que eu mais uso é: para pequenos reparos na hora eu uso o Desktop App ou CLI para monitorar diretamente; trabalhos longos e demorados como "rodar todos os testes e consertar os casos que falharam", eu jogo para a nuvem e volto depois para conferir.
Aqui tem um ponto crucial e muito importante que vale a pena destacar e memorizar:
Essas quatro interfaces, por trás, usam o mesmo Codex, e as configurações podem, em grande parte, serem compartilhadas. Por exemplo, o AGENTS.md (arquivo de instruções do projeto, que explicaremos num artigo específico mais pra frente) que você escreveu, as Skills (comandos e fluxos de trabalho reutilizáveis) que você definiu — a documentação oficial deixa claro que eles podem ser reutilizados entre o Desktop App, CLI e a extensão da IDE. Configure uma vez, use em vários lugares. Se você já usou qualquer um deles antes, ao abrir o outro, ainda poderá ver o histórico de projetos anteriores.
Um conselho de amigo: Iniciantes não devem se preocupar com "qual aprender primeiro". Minha recomendação é — se tem medo da linha de comando, comece pelo Desktop App (interface gráfica, diff visual, o mais seguro); se já gosta de ficar no terminal, vá direto de CLI. Nos próximos quatro artigos desta série, detalharemos cada uma das interfaces separadamente (artigos 07~10), por agora você só precisa lembrar que "é o mesmo Codex com quatro faces".
💡 Resumo em uma frase: O Codex possui quatro interfaces (Desktop App / CLI / Extensão de IDE / Web Cloud), as três primeiras rodam na sua máquina local, e a Web Cloud terceiriza a tarefa para a nuvem, mas por baixo dos panos é o mesmo Codex, e as configurações são compartilhadas.
03 O que ele pode fazer e o que não pode fazer
Na seção 01 já listamos o que ele pode fazer, aqui vamos complementar com a metade mais importante a se reconhecer — o que ele não pode fazer. Isso é mais valioso do que "o que pode fazer", pois é aqui que a maioria dos iniciantes acaba se dando mal.
| ❌ Coisas que não se deve esperar que ele faça | Por que |
|---|---|
| Bater o martelo na direção técnica por você | Qual arquitetura escolher, se vale a pena refatorar, o que priorizar nos requisitos — julgamento e tomada de decisão são o seu trabalho, ele não é bom em design de sistemas globais |
| Garantir código 100% livre de bugs | Ele fornece opções de alta qualidade, não a resposta absolutamente correta, depois da alteração a revisão tem que ser feita por você |
| Adivinhar requisitos que você não deixou claro | Para as lógicas de negócio que você não explicou bem, ele só pode tentar adivinhar (chutar), e quanto mais automático, mais fácil é ele se desviar do caminho |
| Gerenciamento 100% automático em casos onde você não entende nada | Se você não consegue entender o que ele alterou, não terá como julgar se está certo ou errado, é como dirigir de olhos fechados |
O erro mais comum é o segundo. Já fiz uma burrada antes: pedi para o Codex adicionar tratamento de erros em lote a um projeto, ele modificou rapidamente mais de dez arquivos e, para economizar tempo, fiz o commit direto na hora. O resultado foi que em dois lugares ele "tomou a iniciativa" e alterou a lógica original sem me avisar, e só depois de vários dias descobri que o comportamento de uma API havia mudado. Desde então, criei uma regra de ferro: cada linha que ele modifica, devo revisar o diff pelo menos uma vez antes de comitar. Falando nisso, o guia de início rápido oficial do Codex também menciona especificamente — crie um ponto de verificação no Git antes e depois de iniciar as ações (checkpoint, que pode ser entendido como "salvar" o projeto), caso algo dê errado, é só reverter com um clique. É melhor o iniciante adquirir esse hábito o mais cedo possível.
A mentalidade para usar bem o Codex se resume, na verdade, a uma frase:
Deixe o Codex fornecer opções de alta qualidade, e não a resposta absolutamente correta.
Em outras palavras — Os humanos definem a direção, supervisionam e tomam as decisões; A IA se encarrega da execução, análise e trabalho manual repetitivo. Esta é a sua filosofia de design: colaboração, não substituição.
💡 Resumo em uma frase: Ele consegue ler o projeto, modificar arquivos, rodar comandos e fazer trabalhos braçais, mas decidir e supervisionar sempre será tarefa sua — ele é um parceiro, não um salva-vidas para você simplesmente delegar e lavar as mãos.
04 Codex vs ChatGPT vs Claude Code
As duas perguntas que os iniciantes mais fazem: "O Codex e o ChatGPT não são da mesma empresa? Qual a diferença?" e "Qual a diferença entre ele e o Claude Code?". Vamos esclarecer de uma vez.
Qual a diferença entre Codex e ChatGPT
Ambos pertencem à OpenAI, mas não estão de forma alguma na mesma dimensão.
Analogia: Estrategista (Conselheiro) vs Forças Especiais. O ChatGPT é como um estrategista sentado no quartel general — você descreve a situação para ele e ele te dá ideias e planeja soluções, mas ele não entra no campo de batalha, a execução ainda depende de você. O Codex é como um soldado das forças especiais que pode pousar direto no local — você dá um objetivo, ele entra no seu projeto sozinho (lê os arquivos, roda comandos, modifica código), conclui a missão e depois volta para se apresentar.
Trocando em miúdos: No ChatGPT você pergunta e ele responde, no Codex você dá comandos e ele põe a mão na massa. E o interessante é que — o próprio Codex está incluído na assinatura do ChatGPT (segundo a documentação oficial, todas as contas do ChatGPT — inclusive a versão gratuita — incluem cota de uso do Codex, e os planos pagos Plus / Pro / Business / Edu / Enterprise têm um limite maior), e também pode ser acessado via API key da OpenAI com pagamento por uso. Sobre qual limite cada nível de assinatura oferece e se as funções variam de acordo com a forma de login, elas mudam rapidamente, então sempre consulte a página oficial de preços (esse assunto será detalhado no 4º artigo).
Qual a diferença entre Codex e Claude Code
Eles costumam ser comparados com frequência. Primeiro um banho de água fria: Não pergunte "qual é o mais forte", o posicionamento dos dois é muito parecido, e a força deles depende de como você os utiliza na prática. A verdadeira diferença está no "foco do fluxo de trabalho":
| Dimensão | Codex (OpenAI) | Claude Code (Anthropic) |
|---|---|---|
| Origem | OpenAI, por baixo usa a série de modelos GPT | Anthropic, por baixo usa a série de modelos Claude |
| A interface mais prática | A equipe oficial criou um Desktop App com interface gráfica, amigável para quem não gosta da linha de comando | Nativo do terminal (CLI), com todas as funcionalidades e mais focado em mostrar os princípios subjacentes |
| Arquivo de instruções do projeto | AGENTS.md | CLAUDE.md |
| Quatro interfaces | Desktop App / CLI / Extensão de IDE / Web Cloud | Terminal / Plugin no editor / Desktop App / Web·Mobile |
| Pode alterar arquivos e executar comandos? | Sim, é um verdadeiro agente | Sim, é um verdadeiro agente |
Notou? A espinha dorsal de ambos é quase a mesma: ambos são agentes de programação que "conseguem ler o projeto e colocar a mão na massa", ambos têm várias interfaces locais e na nuvem e usam um arquivo de instruções do projeto para "serem treinados". As duas diferenças mais diretas são: primeiro a linhagem é diferente (GPT vs Claude, os modelos por trás são diferentes); e segundo, a vibe padrão é diferente — o foco oficial do Codex é promover aquele Desktop App de interface gráfica, com a clara intenção de atrair pessoas que "não querem mexer com linha de comando"; o Claude Code, por outro lado, é nativo de terminal, com uma "pegada" muito mais forte de linha de comando.
Eu uso ambos, e a divisão de trabalho é mais ou menos essa: tarefas que precisam de interface gráfica, onde quero acompanhar visualmente o diff, ou abrir várias linhas em paralelo num projeto, eu uso o Desktop App do Codex; trabalhos em que eu preciso ficar imerso no terminal, conectar um monte de scripts personalizados e ganchos (hooks), eu deixo para o Claude Code. Um complementa o outro, em vez de substituí-lo.
Aviso: Qual modelo é mais inteligente, qual preço vale mais a pena e quais funções cada um lançou, tudo isso muda extremamente rápido e a conclusão de hoje pode estar vencida na semana que vem. Por isso, este artigo propositalmente evita fixar resultados de benchmarks e preços — para compará-los, por favor veja diretamente as páginas oficiais de cada um.
💡 Resumo em uma frase: ChatGPT é um estrategista que dá ideias, o Codex é a força especial da OpenAI capaz de botar a mão na massa; Codex e Claude Code são "animais de espécies semelhantes, mas de famílias diferentes", com esqueletos parecidos, mas linhagens e vibes diferentes, não precisa escolher apenas um, delegue as tarefas conforme a necessidade de cada trabalho.
05 Mão na massa: Em 30 segundos confirme se o seu computador o reconhece
Dissemos que este artigo não iria ensinar a instalação, mas deixamos uma pequena ação de custo zero para checar o seu ambiente (quer você já o tenha instalado ou não, este comando funcionará e não quebrará nada).
Abra o seu terminal (no Mac use o App "Terminal", no Windows use o PowerShell) e digite esta linha apertando o Enter:
codex --versionExistem dois resultados esperados, e ambos são normais:
- Caso 1: Uma sequência com o número da versão aparecerá — Parabéns, você instalou o CLI anteriormente e pode pular direto para "Vamos usar" no artigo 03.
- Caso 2: O erro
command not found: codex(no Windows pode ser'codex' não é reconhecido como um comando interno ou externo) — O que também é completamente normal e significa que o CLI ainda não foi instalado, e esta é exatamente a primeira coisa a ser resolvida no artigo 03.
Vou dar um pequeno spoiler do comando de instalação do CLI (Não digite agora, dê apenas uma olhada rápida), o script oficial é assim:
# macOS / Linux：标准安装脚本
curl -fsSL https://chatgpt.com/codex/install.sh | sh# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Depois de instalado, ao digitar codex no terminal, ele te guiará no login (com conta do ChatGPT ou chave de API da OpenAI), e a partir daí você já poderá trabalhar no diretório atual.
Dica 1: O método acima é a instalação do CLI de linha de comando. Se você tem medo da linha de comando, o caminho para instalar o Desktop App é a famosa "baixar o pacote de instalação, e dar um duplo clique", interface totalmente gráfica (já existe para macOS e Windows, e o Linux está aguardando na fila) — sem nenhuma diferença em relação a instalar um software comum. No 3º artigo explicaremos as quatro opções separadamente, sem faltar nenhum passo.
Dica 2: O Codex usa o sistema de contas da OpenAI / ChatGPT, logo, os usuários da China precisam "usar magia" para instalá-lo e fazer login; como exatamente fazer e como logar, o 3º artigo falará detalhadamente, então não entraremos no assunto agora.
A figura abaixo ajuda a esclarecer a relação "Local / Nuvem" das quatro interfaces. Se você não conseguir ver a imagem, não tem problema; lembrar da tabela anterior já é suficiente:
O que esta imagem quer dizer é: As quatro interfaces são as suas "portas" para dar objetivos ao Codex, as três primeiras levam ao seu computador local, a última porta leva à nuvem da OpenAI, mas por trás da porta está o mesmo Codex.
💡 Resumo em uma frase: Um simples
codex --versioné suficiente para confirmar se o computador o reconhece — se der erro não se assuste, essa é a primeira tarefa do 3º artigo; se tem medo da linha de comando lembre-se que ainda tem a opção com interface gráfica do Desktop App.
06 Conclusão
Embora não tenhamos digitado muitos comandos neste artigo, conseguimos alinhar as coisas que deveriam ser compreendidas no início:
- O que ele é: O agente (Agent) de programação de IA oficial da OpenAI, você dá os objetivos e ele lê os projetos, modifica, roda comandos, e termina o trabalho — não é um "chat que escreve código".
- Quatro faces: Desktop App, CLI, Extensão de IDE e Web Cloud. As três primeiras trabalham na sua máquina, a Web Cloud terceiriza a tarefa para nuvem. Mas, por trás é o mesmo Codex, e as configurações podem ser compartilhadas.
- O que pode / não pode: Pode ler código, alterar arquivos, corrigir bugs, fazer tarefas manuais. Mas tomar decisões e controlar os requisitos é um trabalho sempre seu, sempre reveja os diffs.
- Com quem se parece: O ChatGPT atua como conselheiro, já o Codex é o soldado especial da OpenAI que entra em campo. O Codex e o Claude Code são parceiros com estrutura semelhante, mas linhagens e vibes diferentes — distribua as tarefas de acordo com o trabalho e não sinta que tem de escolher apenas um.
Agora você deve conseguir: Explicar numa frase aos colegas o que é o Codex, além de julgar por qual interface você deve entrar, e que tipo de trabalho você pode passar para ele. Esse "senso de mapa" é algo que um novato precisa primeiro para começar, — todas as outras funções mais para a frente serão passos adiante com esse mapa em mente.
No próximo artigo 〈02 Visão geral dos conceitos principais〉: Vamos alinhar todos aqueles termos no mundo Codex de uma vez por todas — como o loop do agente, contexto, AGENTS.md, modo de aprovação, sandbox, Skills, MCP... Tudo isso são as palavras do seu dia-a-dia. Volte um pouco lá no codex --version e escreva ele para ver se você está no "caso 1" ou no "caso 2", pois no 3º artigo iremos aplicar o remédio ideal pra cada um.