Codex ou Claude Code: qual agente de codificação escolher?

Fala aí, beleza? Os dois agentes de codificação que mais aparecem na timeline hoje são o Codex, da OpenAI, e o Claude Code, da Anthropic

E quase todo mundo faz a pergunta errada: não é qual é melhor, é qual encaixa no teu projeto, no teu fluxo e no teu bolso

Aqui eu comparo os dois em quatro frentes que realmente doem no dia a dia: preço, forma de uso, integração com o repositório e perfil de quem se dá bem com cada um

Se tu quiser uma leitura mais curta sobre escolher entre Codex e Claude Code, ela existe aqui no blog também, mas neste post a régua é o comparativo linha a linha

Spoiler: não tem vencedor universal, tem perfil 🙂

Codex e Claude Code lado a lado

Antes de entrar no detalhe, o mapa geral

Essa tabela é a foto de agosto de 2026, com os valores das páginas oficiais dos dois produtos

Critério	Codex (OpenAI)	Claude Code (Anthropic)
Planos e preço de entrada	Incluído nos planos ChatGPT Free, Go, Plus, Pro, Business, Edu e Enterprise, com limites diferentes por plano: Go US$ 8/mês, Plus US$ 20/mês, Pro US$ 100/mês e US$ 200/mês	Incluído nos planos pagos do Claude: Pro US$ 20/mês, Max 5x US$ 100/mês, Max 20x US$ 200/mês; o plano gratuito NÃO dá acesso
Como o consumo é contado	Créditos por milhão de tokens de entrada, entrada em cache e saída, desde 2 de abril de 2026	Sessão de 5 horas em todos os planos, mais limite semanal, compartilhado com claude.ai e Claude Desktop
Ao bater o limite	Plus e Pro compram créditos avulsos sem trocar de plano	Uso extra cobrado a preços padrão de API, com bundles com desconto limitados a US$ 2000 por mês
Instalação	npm install -g @openai/codex ou brew install --cask codex	npm install -g @anthropic-ai/claude-code
Superfícies	Terminal (CLI), extensão de IDE, nuvem (web) e revisão de pull request no GitHub	Terminal, VS Code, JetBrains, app desktop e web, com sessões migrando entre superfícies
Arquivo de instruções do repo	AGENTS.md (com hierarquia e override)	CLAUDE.md mais auto memory (MEMORY.md)
Extensões	MCP via config.toml (STDIO e Streamable HTTP)	MCP, skills, subagents, hooks e plugins
Modelos atuais	GPT-5.6 Sol, Terra e Luna	Opus 5, Sonnet 5, Fable 5 e modelos anteriores (4.8, 4.7, 4.6, 4.5)
Código aberto	Sim, o CLI é Apache-2.0 no repositório openai/codex	Não confirmado

Repara que a linha mais importante não é o preço, é a de contagem de consumo

É ali que os dois pensam de forma completamente diferente, e eu volto nisso já já

Quanto custa cada um na prática

Preço de agente de IA é chato porque quase ninguém publica "quantas tarefas dá pra rodar"

Então vamos pelo que É publicado: o degrau de entrada, o degrau de cima e o que acontece quando estoura

O degrau de entrada:

No Codex, o degrau mais barato entre os planos pagos listados é o ChatGPT Go, a US$ 8/mês, seguido do Plus a US$ 20/mês

A página de preços do Codex lista ele incluído em todos os planos do ChatGPT, do Free ao Enterprise, com limites de uso diferentes em cada um

No Claude Code a porta de entrada é o Pro, a US$ 20/mês

E aqui tem um detalhe que pega muita gente de surpresa: não existe caminho gratuito, o Claude Code exige conta Pro, Max, Team, Enterprise ou Console (API)

Ou seja: se tu já paga ChatGPT, o Codex entra sem custo novo

Se tu já paga Claude, o Claude Code entra sem custo novo

A conta muda MUITO dependendo de qual assinatura tu já tem na mão

O que muda ao subir para US$ 100 e US$ 200:

Os dois produtos têm exatamente os mesmos dois degraus de cima, e isso não é coincidência

No ChatGPT, o Pro tem dois níveis: US$ 100/mês com 5x o uso do Plus e US$ 200/mês com 20x o uso do Plus, e a troca entre os níveis fica em Settings > My Plan

No Claude, o Max tem Max 5x por US$ 100/mês e Max 20x por US$ 200/mês (assinatura web), sendo 5x e 20x o uso do Pro por sessão de 5 horas

Mesmo número na etiqueta, base de comparação diferente: um multiplica o Plus, o outro multiplica o Pro por sessão

Como o consumo é contado (e por que isso importa):

Em 2 de abril de 2026 a cobrança do Codex deixou de ser por mensagem e passou a seguir o uso de tokens em créditos, para os planos Plus, Pro, Business e novos Enterprise

Para os Enterprise que já existiam, a mudança veio em 23 de abril de 2026

Os créditos são contados por milhão de tokens de entrada, entrada em cache e saída

Na prática: prompt gigante com o repo inteiro no contexto passou a ter peso na conta, não só a quantidade de pedidos que tu faz

Do lado do Claude Code a lógica é outra: sessão de 5 horas em todos os planos, mais um limite semanal (o Max tem dois limites semanais, um geral e outro só para modelos Sonnet)

E tem o ponto que mais gera reclamação: esse limite é COMPARTILHADO

Todo uso em claude.ai, no Claude Code e no Claude Desktop cai no mesmo balde

Se tu passou a manhã trocando ideia no chat, tu chega no terminal com menos gás

E quando o limite estoura?

No Codex, usuários Plus e Pro podem comprar créditos avulsos ao bater o limite, sem precisar trocar de plano

No Claude, assinantes pagos seguem trabalhando com créditos de uso extra cobrados a preços padrão de API, válido para Pro, Max 5x e Max 20x, com bundles com desconto limitados a US$ 2000 por mês (acima disso a cobrança é a padrão)

Os dois têm válvula de escape, beleza? A diferença é o formato: crédito avulso de um lado, consumo a preço de API do outro

E se eu preferir pagar por uso?

Aí a conversa vira preço de API, por milhão de tokens

No lado da OpenAI, contexto curto: GPT-5.6 Sol US$ 5,00 de entrada e US$ 30,00 de saída, Terra US$ 2,00 e US$ 12,00, Luna US$ 0,20 e US$ 1,20 (o Luna ficou 80% mais barato e o Terra 20% mais barato a partir de 30 de julho de 2026)

No lado da Anthropic: Sonnet 5 está com preço introdutório de US$ 2 de entrada e US$ 10 de saída até 31 de agosto de 2026, e depois passa para US$ 3 e US$ 15

O Opus 5 fica em US$ 5 de entrada e US$ 25 de saída

Repara que o topo dos dois está bem próximo (US$ 5 de entrada nos dois), e a diferença real aparece na saída e no modelo econômico

Onde cada agente roda: terminal, IDE, nuvem e GitHub

Preço resolve a primeira semana, superfície resolve o resto do ano

O Codex roda em quatro lugares: terminal (CLI), extensão de IDE, nuvem (web) e revisão de pull request no GitHub

Na integração com o GitHub, ele posta uma revisão direto no PR e, ali, sinaliza apenas problemas P0 e P1

Isso é uma decisão de produto interessante: em vez de encher teu PR de comentário de estilo, ele fica só no que é risco alto

Já o Codex cloud roda em containers isolados gerenciados pela OpenAI, num modelo de duas fases

A fase de setup tem rede pra instalar dependências e a fase do agente roda OFFLINE por padrão, a menos que tu habilite acesso à internet naquele ambiente

Tome cuidado com isso: se a tua tarefa precisa bater numa API externa no meio da execução, ela vai falhar em silêncio se tu não habilitar o acesso

O Claude Code roda em terminal, extensões de IDE (VS Code e JetBrains), app desktop e web

E tem um truque que muda o fluxo: as sessões podem migrar entre superfícies

Começa no terminal, continua no desktop, sem recomeçar o raciocínio do zero

No GitHub, a integração é via GitHub Actions mais a menção @claude

A Action executa o Claude Code dentro dos workflows e, mencionando @claude num PR ou issue, ele analisa o código, abre pull requests, implementa funcionalidades e corrige bugs

Na web, tu seleciona o repositório do GitHub, descreve a tarefa e ele trabalha num ambiente remoto

Resumindo a diferença de filosofia: o Codex separa bem "revisor de PR" de "executor na nuvem", enquanto o Claude Code trata tudo como a mesma sessão que anda com você

Como cada um entende o seu repositório

Essa é a parte que decide o comparativo pra quem trabalha em projeto grande

Agente bom sem contexto do repo é só um autocomplete caro

AGENTS.md: a hierarquia do Codex

O Codex lê instruções em arquivos AGENTS.md

A ordem é hierárquica: ele lê AGENTS.override.md ou AGENTS.md no diretório home do Codex (o padrão é ~/.codex, ou o que estiver em CODEX_HOME) e depois em cada pasta, da raiz do projeto até o diretório atual

Se tu conhece .gitignore empilhado por pasta, a ideia é parecida: o mais específico complementa o mais geral

Dá pra configurar nomes alternativos de arquivo e limite de tamanho em ~/.codex/config.toml, pelas chaves project_doc_fallback_filenames e project_doc_max_bytes

Esse limite de bytes é o detalhe que mais gente esquece: arquivo de instruções gigante pode ser cortado

CLAUDE.md mais memória automática:

O Claude Code usa CLAUDE.md, com instruções persistentes lidas no início de cada sessão

Em cima disso vem a auto memory (MEMORY.md), da qual são carregadas as primeiras 200 linhas ou 25KB

Tu liga e desliga isso pelo comando /memory, que grava a chave autoMemoryEnabled no ~/.claude/settings.json

A diferença conceitual é essa: no Codex, o que o agente sabe do teu projeto é o que TU escreveu no arquivo

No Claude Code, tem a camada escrita por você e uma camada que ele mesmo vai acumulando entre sessões

Pra quem trabalha sozinho isso é ótimo

Pra quem trabalha em time, o arquivo versionado no repo continua sendo a fonte da verdade nos dois casos

A camada de extensão:

No Codex, a extensão principal é MCP

A configuração fica no config.toml (padrão ~/.codex/config.toml, com escopo por projeto em .codex/config.toml para projetos confiáveis), em tabelas [mcp_servers.<nome>], com suporte a servidores STDIO e Streamable HTTP

Pra conferir o que está ativo:

codex mcp list

No Claude Code a pilha é mais larga: CLAUDE.md para contexto sempre ativo, skills (arquivos markdown de conhecimento e fluxos, invocáveis por comando ou carregados automaticamente), MCP para conexões externas, subagents para isolar tarefas laterais, hooks para automação por eventos e plugins como camada de empacotamento que junta skills, hooks, subagents e servidores MCP num pacote instalável

É bastante coisa, e sim, tem curva de aprendizado

Se tu quiser entender o pedaço que mais muda produtividade em repo grande, vale ler sobre usar subagents no Claude Code antes de sair configurando tudo de uma vez

Controle e segurança: quanto de rédea você entrega

Aqui os dois resolvem o mesmo medo ("e se ele rodar os rm -rf da vida?") com filosofias diferentes

O Codex trabalha com perfis de permissão

São três embutidos:

• :read-only, execução local só de leitura
• :workspace, escrita dentro dos diretórios do workspace e dos temporários do sistema
• :danger-full-access, sem restrições locais de sandbox

A troca é pelo comando /permissions, e a política de aprovação usa a flag --ask-for-approval

O Claude Code trabalha com modos de permissão:

• Manual, o padrão, onde tu revisa cada ação
• Auto, onde um classificador separado bloqueia o que parece arriscado
• Plan, acionado com Shift+Tab ou com o prefixo /plan
• Bypass Permissions, que aprova tudo (os hooks ainda rodam)

A alternância é com Shift+Tab na CLI, ou pelo seletor no VS Code, no Desktop e no claude.ai

Além disso ele tem sandbox nativo para comandos Bash, usando primitivas do sistema operacional pra restringir arquivos e rede de cada comando: Seatbelt no macOS e bubblewrap no Linux e WSL2

Sacou a diferença? Um pensa em PERFIL de sandbox (o que o processo pode tocar), o outro pensa em MODO de aprovação (quanto tu precisa clicar em sim)

Na prática os dois chegam num lugar parecido, mas o modelo mental que tu precisa carregar é diferente

Veredito: qual escolher para o seu tipo de projeto

Não vou eleger vencedor, porque não tem

Qualidade de código gerado entre os dois é justamente o ponto que eu não consigo cravar com dado verificado, então fico no que dá pra provar: preço, superfície, contexto de repo e controle

Já paga ChatGPT e quer o menor degrau de custo: Codex

Ele vem incluído nos planos listados, e o Go a US$ 8/mês é o degrau pago mais baixo dessa comparação

Quer auditar ou rodar o agente com código aberto: Codex

O CLI é Apache-2.0, escrito majoritariamente em Rust e TypeScript, e tu consegue ler exatamente o que ele faz na tua máquina

Do lado do Claude Code eu não tenho isso confirmado, então não afirmo nada

Repositório grande, com regras de time e muita convenção: Claude Code

A combinação de CLAUDE.md com memória automática, skills, hooks e subagents é feita pra projeto que tem regra demais pra caber num arquivo só

Faz muito review de PR: empate técnico, com estilos diferentes

O Codex publica revisão no PR e filtra só P0 e P1, o que dá menos ruído

O Claude Code responde à menção @claude no PR ou issue e ainda abre pull request e corrige bug, o que dá mais alcance

Alterna entre máquina, navegador e desktop: Claude Code

Sessão que migra entre superfícies resolve um problema chato que quase ninguém conta antes de você viver ele

Agora o que pesa CONTRA cada um, sem maquiagem:

No Claude Code, o limite compartilhado com o claude.ai e com o Desktop significa que teu uso de chat come teu uso de terminal

No Codex, a cobrança por token desde abril de 2026 significa que contexto grande virou custo, e não só quantidade de pedidos

E manter os dois? Custa US$ 20 mais US$ 20 no piso confortável (Plus mais Pro)

Não é absurdo pra quem vive de código, mas é uma escolha consciente, não um "deixa os dois abertos e vê no que dá"

Conclusão

Recapitulando: os dois cobram nos mesmos degraus de US$ 100 e US$ 200, mas contam consumo de formas opostas (créditos por token no Codex, sessão de 5 horas mais limite semanal compartilhado no Claude Code)

Os dois rodam em terminal, IDE, nuvem e GitHub, com filosofias diferentes de sessão e de revisão

E os dois leem o teu repositório por arquivo de instruções, AGENTS.md de um lado e CLAUDE.md mais memória automática do outro

O próximo passo prático é simples:

1. Instale primeiro o de entrada mais barata pro TEU caso (se tu já paga ChatGPT, começa pelo Codex; se já paga Claude, começa pelo Claude Code)

npm install -g @openai/codex
codex

No primeiro codex tu escolhe entre Sign in with ChatGPT ou usar chave de API

2. Do outro lado, o comando é este, e depois tu entra na pasta do projeto

npm install -g @anthropic-ai/claude-code
claude

O erro comum aqui: rodar a instalação com sudo

Não use, a documentação pede pra não usar

Pra atualizar depois: npm install -g @anthropic-ai/claude-code@latest

3. Antes de qualquer tarefa real, escreva o arquivo de instruções do repositório (AGENTS.md no Codex, CLAUDE.md no Claude Code)

Agente sem esse arquivo vai reinventar tua convenção de pastas toda sessão, e aí a culpa não é dele

4. Rode a MESMA tarefa nos dois por uma semana antes de fechar assinatura anual

Tarefa real do teu projeto, não exemplo de tutorial

É o único jeito honesto de descobrir qual dos dois combina com o teu jeito de trabalhar

Bora testar? 😀

Até o próximo post!

Perguntas frequentes

O Codex CLI é open source, e o Claude Code também é?

O Codex CLI tem código aberto: o repositório openai/codex está sob licença Apache-2.0 e é escrito majoritariamente em Rust e TypeScript. Já o Claude Code não tem código aberto confirmado. Se abrir o código for critério de escolha entre Codex ou Claude Code, esse ponto pesa pro lado da OpenAI.

Qual a diferença entre o AGENTS.md do Codex e o CLAUDE.md do Claude Code?

O Codex lê instruções em arquivos AGENTS.override.md ou AGENTS.md, primeiro no diretório home do Codex (padrão ~/.codex) e depois em cada pasta da raiz do projeto até o diretório atual. O Claude Code usa CLAUDE.md para contexto persistente somado a uma auto memory (MEMORY.md), da qual carrega as primeiras 200 linhas ou 25KB, ligando e desligando esse recurso pelo comando /memory.

Codex e Claude Code integram direto com o GitHub?

O Codex faz revisão de pull request publicando comentários no PR e sinalizando só problemas P0 e P1. O Claude Code integra via GitHub Actions, rodando dentro de workflows, e responde a menções @claude em PR ou issue para analisar código, abrir pull requests, implementar funcionalidades e corrigir bugs. O Claude Code também roda tarefas na web escolhendo um repositório do GitHub e descrevendo a tarefa, direto num ambiente remoto.

Como funcionam as permissões de cada agente antes de executar um comando?

O Codex tem três perfis embutidos: read-only para execução local só de leitura, workspace para escrita dentro dos diretórios do workspace e temporários do sistema, e danger-full-access sem restrições locais, trocados pelo comando /permissions junto com a política –ask-for-approval. O Claude Code tem quatro modos: Manual (revisa cada ação), Auto (um classificador bloqueia o que parece arriscado), Plan e Bypass Permissions, alternados com Shift+Tab na CLI ou pelo seletor no VS Code, Desktop e claude.ai.

Dá pra configurar servidores MCP no Codex e no Claude Code?

No Codex a configuração de MCP fica no config.toml, com escopo por projeto em .codex/config.toml para projetos confiáveis, em tabelas [mcp_servers.<nome>], suportando servidores STDIO e Streamable HTTP (o comando codex mcp list lista os configurados). O Claude Code também suporta MCP, mas como uma das camadas de extensão, ao lado de skills, subagents, hooks e plugins.

Qual modelo cada agente usa por padrão hoje?

O Codex recomenda a família GPT-5.6, com Sol para tarefas ambíguas ou de alto valor, Terra para o dia a dia e Luna para trabalho claro e repetível; o padrão Power usa gpt-5.6-sol com raciocínio médio. O Claude Code oferece Opus 5, Sonnet 5, Fable 5 e modelos anteriores como Opus 4.8 e Sonnet 4.5, escolhidos pela flag –model, por exemplo claude –model claude-sonnet-5.