Claude Code vs Codex CLI: Quando Usar Qual

Eu uso o Claude Code como minha ferramenta principal de desenvolvimento. Vale declarar esse viés logo de início porque a melhor análise comparativa vem de conhecer uma ferramenta profundamente e testar a outra com honestidade. Ao longo de 36 duelos cegos — nos quais executei tarefas idênticas em ambas as ferramentas e avaliei os resultados sem saber qual produziu o quê ¹ — e centenas de sessões com ambas, descobri que a resposta para “qual é melhor?” é genuinamente “depende da tarefa.”

TL;DR

Claude Code e Codex CLI resolvem o mesmo problema — desenvolvimento assistido por IA — com arquiteturas fundamentalmente diferentes. O Claude Code governa por meio de hooks (17 tipos de eventos de ciclo de vida que aplicam políticas de forma determinística) ². O Codex governa por meio de sandboxing (restrições de kernel no nível do sistema operacional abaixo da camada de aplicação) ³. Nenhuma abordagem é estritamente superior.

O Claude Code superou consistentemente o Codex em revisão de código e verificação de segurança. O Codex oferece vantagens genuínas em sandboxing, portabilidade entre ferramentas via AGENTS.md e delegação de tarefas na nuvem.

Decisão rápida: Precisa de sandboxing no nível do kernel ou AGENTS.md compatível com múltiplas ferramentas? → Codex. Precisa de hooks de governança programáveis ou refatoração profunda? → Claude Code. Precisa de ambos os modelos de segurança? → Use os dois.

Novo em ambas as ferramentas? Comece com o guia do Claude Code ou o guia do Codex primeiro. Este post assume familiaridade com pelo menos uma delas.

Dois Modelos Mentais

Ambas as ferramentas são arquiteturas de três camadas, mas as camadas servem a propósitos diferentes.

Claude Code:

1. Raciocínio — Claude Opus processa sua base de código e raciocina sobre as mudanças
2. Execução — Bash, operações com arquivos, comandos git, chamadas de ferramentas MCP
3. Governança — Hooks interceptam ações em 17 pontos do ciclo de vida ²; permissões delimitam o escopo

Codex:

1. Modelo — GPT-5.3-Codex com 400K de entrada / 128K de saída de contexto ⁴
2. Sandbox — Aplicação no nível do kernel do sistema operacional (Seatbelt no macOS, Landlock + seccomp no Linux) ³
3. Aprovação — Três políticas (untrusted, on-request, never) controlam mutações antes da execução ⁵

A diferença crítica é onde a governança reside. O Claude Code aplica segurança na camada de aplicação — hooks são programas que você escreve para interceptar eventos específicos. O Codex aplica segurança na camada do kernel — o sistema operacional impede operações não permitidas independentemente do que o modelo tente fazer.

Por que essa distinção importa: A governança na camada de aplicação é programável. Você pode codificar lógica de negócios, executar linters, validar schemas — qualquer coisa expressível em código. A governança na camada do kernel é à prova de escape. O modelo não consegue contornar restrições porque o sistema operacional nega a chamada de sistema antes que ela alcance a aplicação. Toda arquitetura de segurança troca expressividade por robustez, e essas duas ferramentas estão em extremos opostos desse espectro.

Filosofia de Configuração

O Claude Code usa JSON. O Codex usa TOML. Ambos suportam escopo hierárquico. As filosofias diferem em como pensam sobre troca de contexto.

Claude Code: Configuração em camadas

// ~/.claude/settings.json (nível de usuário)
{
  "permissions": {
    "allow": ["Bash(git *)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

// .claude/settings.json (nível de projeto, herda do usuário)
{
  "permissions": {
    "allow": ["Bash(npm test)"]
  }
}

O Claude Code resolve configurações a partir de múltiplas camadas: configurações gerenciadas (prioridade mais alta) → linha de comando → projeto local → projeto compartilhado → padrões do usuário ⁶. Arquivos de memória (CLAUDE.md) seguem seu próprio escopo: usuário → projeto → local. Skills e hooks adicionam camadas extras. A flexibilidade é poderosa, mas a configuração ativa não é visível a partir de um único arquivo — você a reconstrói lendo a hierarquia.

Codex: Perfis com troca explícita

# ~/.codex/config.toml
model = "gpt-5.3-codex"
approval_policy = "on-request"

[profiles.deep-review]
model = "gpt-5-pro"
approval_policy = "never"

[profiles.careful]
approval_policy = "untrusted"

codex --profile careful "Review this PR"
codex --profile deep-review "Audit this module"

Os perfis do Codex permitem alternar entre configurações com uma flag ⁷. Sem resolução de camadas para raciocinar — a configuração ativa é sempre explícita. Para equipes padronizando políticas de aprovação, isso é mais simples de auditar. Os perfis são atualmente experimentais ⁷.

Modelos de Segurança

Segurança é a divergência arquitetural mais profunda entre as ferramentas.

Claude Code: Hooks determinísticos na camada de aplicação

Hooks interceptam ações antes de serem executadas. Um hook PreToolUse no Bash pode inspecionar cada comando e bloquear padrões perigosos ²:

# Hook: git-safety-guardian (PreToolUse:Bash)
if echo "$tool_input" | grep -q "push.*--force.*main"; then
  echo '{"decision": "block", "reason": "Force push to main blocked"}'
fi

O ponto forte: hooks são programas. Você pode codificar lógica de segurança arbitrariamente complexa — verificar caminhos de arquivos, validar JSON, aplicar convenções de nomenclatura, executar linters. Eu rodo 95 hooks cobrindo desde detecção de credenciais até portões de qualidade.

O ponto fraco: hooks operam na camada de aplicação. Em 2025, a Check Point Research divulgou a CVE-2025-59536, demonstrando que hooks maliciosos em arquivos de configuração de projeto podiam executar comandos shell durante a inicialização do Claude Code — antes que o usuário visse um diálogo de consentimento ¹⁹. A Anthropic corrigiu a vulnerabilidade em poucas semanas, mas a divulgação valida a preocupação arquitetural: a aplicação de segurança na camada de aplicação compartilha uma fronteira de processo com o agente. A orientação da equipe de Red Team da NVIDIA chega à mesma conclusão: “hooks e funções de inicialização MCP frequentemente rodam fora de um ambiente sandbox, oferecendo uma oportunidade de escapar dos controles do sandbox” ²⁰.

Codex: Sandboxing no nível do kernel

O Codex restringe o agente no nível do sistema operacional. No macOS, perfis Seatbelt limitam acesso ao sistema de arquivos, conectividade de rede e criação de processos ³. No Linux, Landlock + seccomp fornecem restrições equivalentes, com um pipeline opcional Bubblewrap (bwrap) disponível via configuração ³.

# Três modos de sandbox
codex --sandbox read-only           # Agente pode ler mas não escrever
codex --sandbox workspace-write     # Agente escreve apenas no diretório do projeto (padrão)
codex --sandbox danger-full-access  # Sem restrições (nome sinaliza o risco)

O ponto forte: a aplicação no nível do kernel está abaixo da aplicação. O modelo não consegue escapar das restrições criando comandos engenhosos — o sistema operacional nega a chamada de sistema antes que ela seja executada ³. O prefixo danger- no modo de acesso total reflete que remover as restrições do sandbox é uma ação excepcional, não uma configuração rotineira.

O ponto fraco: restrições de kernel são binárias. Você pode permitir ou negar escritas no sistema de arquivos, mas não pode dizer “permita escritas em src/ mas bloqueie escritas em config/ a menos que a mudança passe por um linter.” Essa governança refinada requer lógica no nível da aplicação.

A troca é real. Hooks fornecem segurança granular e programável, mas com fronteiras mais fracas. Sandboxing fornece fronteiras mais fortes, mas com controle mais grosseiro. Uma heurística rápida de decisão:

• Confiança interna, código externo: Use o Codex com sandbox read-only ao revisar PRs de contribuidores desconhecidos. O kernel impede modificação de arquivos independentemente do que o modelo tente.
• Código confiável, aplicação de políticas: Use hooks do Claude Code quando você confia na base de código mas precisa aplicar padrões organizacionais — formatos de mensagens de commit, varredura de credenciais, portões de linting.
• Ambas as preocupações: Use os dois. Use o Codex para a fronteira de segurança inicial, depois mude para o Claude Code para revisão com governança intensa.

Extensibilidade

Ambas as ferramentas suportam personalização, mas a maturidade varia por mecanismo.

Onde o Claude Code lidera: Hooks. O sistema de ciclo de vida com 17 eventos — abrangendo PreToolUse, PostToolUse, UserPromptSubmit, SessionStart, Stop, SubagentStart, SubagentStop, PreCompact e mais nove ² — habilita padrões de governança que o sistema de notificação de evento único do Codex não consegue igualar. Se você precisa aplicar portões de qualidade, detectar vazamento de credenciais antes de commits ou injetar contexto automaticamente, a arquitetura de hooks do Claude Code é substancialmente mais madura.

Onde o Codex lidera: Portabilidade entre ferramentas. AGENTS.md é um padrão aberto governado pela Agentic AI Foundation sob a Linux Foundation ¹³, adotado por mais de 60.000 projetos ⁸. O mesmo arquivo de instruções funciona no Codex, Cursor, GitHub Copilot, Amp, Windsurf e Gemini CLI (com configuração) ¹⁴. CLAUDE.md é poderoso mas exclusivo do Claude Code. A delegação de tarefas na nuvem também é exclusiva do Codex — codex cloud exec transfere trabalho de longa duração para a infraestrutura da OpenAI e retorna diffs ¹², um fluxo de trabalho que o Claude Code não oferece nativamente.

Onde Cada Ferramenta Ganha

Com base em 36 duelos cegos — prompts idênticos enviados para ambas as ferramentas com resultados avaliados às cegas — e uso diário em produção:

A metodologia completa e a pontuação por duelo estão em O Juiz Cego.

Vitórias do Claude Code

• Revisão de código e verificação de segurança. O Claude Code venceu 8 de 12 duelos decididos em tarefas de revisão ¹. O sistema de filosofia de qualidade e os portões de evidência capturam problemas que escapam pela abordagem mais procedural do Codex.
• Fluxos de trabalho com governança intensa. Se seu fluxo de trabalho requer verificações pré-commit, varredura de credenciais, validação de saída ou portões de qualidade, hooks são o mecanismo. O sistema de notificação do Codex dispara depois que o turno do agente é concluído ⁹ — tarde demais para bloquear ações perigosas.
• Orquestração complexa com múltiplos agentes. A delegação explícita de subagentes via ferramenta Task ¹⁰, combinada com sistemas de deliberação, habilita fluxos de trabalho onde múltiplos agentes especializados colaboram com contexto isolado.
• Refatoração profunda de base de código. O Opus se destaca em manter contexto arquitetural ao longo de sessões extensas. Os padrões de engenharia de contexto que governam a hierarquia de hooks/skills/regras do Claude Code se traduzem diretamente na forma como o modelo raciocina sobre grandes bases de código.

Vitórias do Codex

• Ambientes com sandbox crítico. Se você está executando um agente de IA contra código não confiável, processando PRs externos ou operando em um pipeline de CI/CD onde precisa de garantias sólidas sobre acesso ao sistema de arquivos e à rede, o sandboxing no nível do kernel do Codex é a ferramenta certa ³. Hooks na camada de aplicação não podem fornecer a mesma garantia.
• Equipes com múltiplas ferramentas. Se sua equipe usa várias ferramentas de codificação com IA, o AGENTS.md oferece um único arquivo de instruções que funciona no Codex, Cursor, Copilot, Amp, Windsurf e mais ¹⁴. Sem manutenção duplicada entre CLAUDE.md, .cursor/rules e instruções do Copilot.
• Fluxos de trabalho assíncronos na nuvem. O codex cloud exec delega tarefas para infraestrutura na nuvem e retorna diffs ¹². Para integração com CI/CD ou processamento em lote, esse é um fluxo de trabalho que o Claude Code não oferece nativamente.
• Direcionamento em tempo real. O modo steer do Codex permite injetar instruções no meio da tarefa com Enter (imediato) ou enfileirar instruções com Tab (próximo turno) ¹⁵. O Claude Code suporta mensagens de acompanhamento, mas não injeção no meio do turno.
• Experiência desktop. O aplicativo desktop do Codex (macOS) suporta multitarefa com worktrees paralelos e janelas flutuantes destacáveis ¹⁶. O Claude Code se integra com VS Code e JetBrains ¹⁷, mas é primariamente CLI.

Usando Ambas

As ferramentas não entram em conflito. CLAUDE.md e AGENTS.md coexistem no mesmo repositório. Aqui está minha configuração:

my-project/
├── .claude/
│   └── settings.json     # Configuração de projeto do Claude Code
├── CLAUDE.md              # Instruções do Claude Code
├── AGENTS.md              # Instruções do Codex + Cursor + Copilot
└── codex.md               # Configuração de projeto do Codex (opcional)

Um fluxo de trabalho concreto com duas ferramentas: Eu uso o Claude Code para desenvolvimento diário — implementação de funcionalidades, revisão de código, refatorações em múltiplos arquivos onde hooks aplicam portões de qualidade a cada passo. Quando um contribuidor externo abre um PR, eu mudo para o Codex com --sandbox read-only para revisar suas mudanças contra código não confiável. Quando preciso de uma segunda opinião sobre uma decisão de arquitetura, envio o mesmo prompt para ambas as ferramentas e comparo os resultados às cegas — a abordagem do juiz cego.

A abordagem com duas ferramentas tem suporte empírico além dos meus próprios testes. Uma pesquisa da Milvus descobriu que a revisão adversarial entre múltiplos modelos de IA aumentou a detecção de bugs de 53% para 80% ²³. Um estudo separado descobriu que ciclos iterativos de revisão Claude-Codex capturaram 14 problemas em 3 rodadas que nenhuma ferramenta encontrou sozinha ²⁴. Nenhuma ferramenta substitui a outra; elas cobrem diferentes modelos de ameaça e perfis de tarefa.

Principais Conclusões

Se você está escolhendo uma ferramenta:

• Comece pelos seus requisitos de segurança. Precisa de sandboxing no nível do kernel? Codex. Precisa de hooks de governança programáveis? Claude Code.
• Considere sua equipe. Múltiplas ferramentas de IA em uso? AGENTS.md evita manutenção duplicada de instruções entre ferramentas ¹⁴.
• Teste ambas em uma tarefa real antes de decidir. A metodologia do juiz cego funciona para avaliação pessoal também.

Se você já está investido:

• Usuários do Claude Code: escrevam um AGENTS.md de qualquer forma. Leva 20 minutos e torna seu projeto acessível a usuários do Codex, Cursor e Copilot.
• Usuários do Codex: acompanhem o sistema de hooks conforme ele amadurece. O evento notify atual ⁹ é um ponto de partida — solicitações da comunidade para eventos de hook expandidos estão ativas no GitHub ¹⁸.
• Ambas as ferramentas estão evoluindo rapidamente. A comparação neste post tem uma validade medida em meses, não em anos.

FAQ

Posso usar ambas as ferramentas no mesmo projeto?

Sim. CLAUDE.md e AGENTS.md são arquivos separados sem conflitos. Cada ferramenta lê seu próprio arquivo de instruções e ignora o outro. Eu mantenho ambos nos meus projetos ativos.

Qual ferramenta é melhor para iniciantes?

O Codex tem uma barreira de configuração menor — três modos de sandbox e três políticas de aprovação cobrem a maioria dos casos de uso ⁵. O poder do Claude Code vem dos hooks e skills, que requerem investimento para configurar. Comece com o modelo (Claude ou GPT) com o qual você já se sente confortável.

Como os custos se comparam?

Ambos usam precificação baseada em tokens através de suas respectivas APIs. O Claude Code roda na precificação da Anthropic; o Codex roda no sistema de créditos da OpenAI. Um benchmarking independente da Composio descobriu que o Codex consumiu 2-4x menos tokens para resultados comparáveis — em uma tarefa de plugin Figma, o Claude Code usou 6,2M tokens versus 1,5M do Codex ²². Eficiência de tokens não se traduz diretamente em custo (precificação por token diferente), mas o menor consumo de tokens do Codex é uma vantagem mensurável para fluxos de trabalho com restrição orçamentária.

O AGENTS.md funcionará com o Claude Code?

Não atualmente. O Claude Code lê CLAUDE.md; o Codex lê AGENTS.md. Os formatos são similares o suficiente para que o conteúdo se traduza facilmente entre eles, mas não há leitura cruzada automática. Escrever ambos requer esforço mínimo já que o conteúdo se sobrepõe.

Qual tem melhor integração com IDE?

O Codex tem um aplicativo desktop com multitarefa e janelas flutuantes (somente macOS em fevereiro de 2026) ¹⁶. O Claude Code se integra com VS Code via extensão e JetBrains via plugin (beta) ¹⁷. Ambos funcionam bem; a escolha depende de você preferir fluxos de trabalho primariamente CLI (Claude Code) ou primariamente GUI (Codex).

Referências