Avaliar e melhorar agentes · ·
Comparar Claude Code e Codex na mesma tarefa
Diferencie aplicativo, modelo, ambiente e forma de cobrança.
Este capítulo faz parte do curso gratuito Avaliar e melhorar agentes.
Claude Code e Codex combinam modelos com ferramentas para trabalhar em projetos. A comparação precisa nomear o produto, a versão disponível, as permissões e o ambiente. Uma nota de laboratório sobre um modelo não descreve automaticamente o comportamento do aplicativo na sua empresa.
Ver como texto
Documentação do Claude Code sobre criação e carregamento de skills, com instruções e opções de configuração.
Use o mesmo pedido e critérios de aceitação. Registre intervenções humanas, alterações propostas e testes executados. Confirme também se o consumo vem de assinatura, créditos ou API. O aprendizado por reforço usado pelo fornecedor no treinamento não significa que sua sessão esteja treinando uma versão privada do modelo.
Ver como texto
Guia da OpenAI para criar skills, com estrutura e orientações de uso no ambiente do produto.
Exemplo: os dois assistentes recebem uma cópia da mesma página e devem corrigir o formulário sem mudar o preço. A equipe confere o percurso, o diff, que é a lista de alterações, e o tempo de revisão. A escolha decorre dessa evidência e das condições de acesso, sem transformar uma tarefa em ranking universal.
Ver como texto
Guia da OpenAI de boas práticas de avaliação de sistemas de IA, com etapas e critérios para comparar resultados.
| O que comparar | O que registrar |
|---|---|
| Entrega | Pedido, dados e critério de aceitação iguais. |
| Execução | Produto, modelo, permissões, ferramentas e limite de tentativas. |
| Resultado | Falhas, testes e tempo de revisão humana. |
| Compra | Origem da cobrança, condições do plano e prazo de suporte. |
Guia prático: o mesmo projeto nos dois assistentes, um gerador interno de links com UTM. É uma ferramenta pequena que resolve um problema caro em marketing: cada pessoa escreve a origem da campanha de um jeito, e o Google Analytics trata Google e google como origens diferentes. Desde a versão 2.1.277 do Claude Code, publicada em 18/09/2026, um único AGENTS.md na raiz do repositório orienta os dois assistentes, o que torna a comparação justa.
# AGENTS.md - gerador de links com UTM
## O que este projeto faz
Página interna que monta URLs de campanha com parâmetros UTM padronizados.
## Regras de negócio
- utm_source, utm_medium e utm_campaign são obrigatórios; sem eles, a página não gera o link.
- Todo valor vai para minúsculas, sem acento, com espaço trocado por hífen.
- utm_medium aceita só a lista aprovada: cpc, email, social, display, afiliado.
- Se a URL de destino já tem "?", os parâmetros entram com "&".
## Comandos
- Testes: npm test (rode antes de cada entrega)
- Lint: npm run lint
## Limites
- Não altere a pasta tests/ sem pedido explícito.
- Nenhuma chamada de rede; a página roda só no navegador.Gerador de UTM com Claude Code ou Codex, do repositório vazio aos testes verdes
Seis passos. Rode a mesma sequência nos dois assistentes e compare tempo, custo e retrabalho.
Passo 1: Crie o repositório e o AGENTS.md antes do primeiro pedido
As regras de negócio seguem a orientação do Google Analytics: as três UTMs obrigatórias e convenção de nome em minúsculas.
Deu certo quando: AGENTS.md com regras, comandos e limites no primeiro commit.
Erro comum: Explicar as regras só no chat, onde se perdem na próxima sessão.
Passo 2: Confirme que o assistente leu o arquivo
No Claude Code, sem CLAUDE.md no projeto, aparece a linha "AGENTS.md loaded" e o caminho surge em /memory. No Codex, peça para listar as fontes de instrução carregadas.
Deu certo quando: O assistente cita as regras do AGENTS.md quando perguntado.
Erro comum: Ter um CLAUDE.md antigo na pasta, que faz o Claude Code ignorar o AGENTS.md.
Passo 3: Peça primeiro os testes, depois o código
Casos: maiúsculas viram minúsculas, acento some, URL com "?" recebe "&", falta de utm_campaign bloqueia a geração.
Deu certo quando: Testes escritos e falhando antes de existir a função.
Erro comum: Pedir código e testes juntos, e o agente escrever teste que só confirma o que fez.
Passo 4: Escolha o modo de aprovação antes de liberar a edição
No Claude Code, cada edição pede confirmação até você liberar. No Codex, comece em Ask for approval, mudado pelo /permissions na linha de comando.
Deu certo quando: Toda edição fora da pasta do projeto passa por aprovação registrada.
Erro comum: Começar em acesso total num repositório que ainda não tem testes.
Passo 5: Rode os testes e leia o diff inteiro
Verde não basta: confira se o agente não alterou a pasta tests/ para passar.
Deu certo quando: npm test verde e nenhuma mudança em tests/ além das pedidas.
Erro comum: Aprovar pela mensagem final do agente sem abrir o diff.
Passo 6: Publique como página interna e registre a comparação
Página estática com acesso restrito ao time. Anote, para cada assistente, minutos, custo e quantas correções você pediu.
Deu certo quando: Ferramenta em uso pelo time e uma linha por assistente na planilha de comparação.
Erro comum: Publicar em endereço aberto, indexável por buscador.
No fim você tem: Links de campanha padronizados para todo o time e uma comparação entre os dois assistentes feita no seu próprio projeto.

Ver como texto
Extensão do Claude Code no VS Code mostrando o diff de uma função Python à esquerda e, à direita, a pergunta Make this edit to utils.py com as opções Yes, Yes and don't ask again e No
Guarde uma amostra das respostas e a configuração usada. Repita a parte afetada da comparação quando mudar o modelo, a ferramenta ou a tarefa. A escolha continua válida para as condições testadas, sem prometer o mesmo desempenho em todo trabalho.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
- Veja o que o Claude Code faz antes de instalarsugerido pelo grafoApresenta o conceito “Claude Code”, usado em “Comparar Claude Code e Codex na mesma tarefa”.
- Ponha dois agentes para revisar um ao outro, com limite de rodadassugerido pelo grafoApresenta o conceito “Codex”, usado em “Comparar Claude Code e Codex na mesma tarefa”.
- CursoSetup Completo: do zero ao Claude Code (Windows)sugerido pelo grafoO Setup ensina permissões, contexto do projeto e escolha de modelo por custo. Essa preparação sustenta os exercícios de comparação de assistentes, criação do gerador de UTM e regras de projeto no curso de aprendizado por reforço e vibecoding.
- CursoAstra profundosugerido pelo grafo4 capítulos de “Avaliar e melhorar agentes” usam conceitos apresentados em “Astra profundo”.
- Engenharia de Software para ExecutivosTestar um agente de código com uma tarefa pequenaExaminar conexões de Testar um agente de código com uma tarefa pequena
- Vibecoding para SEOPreparar o projeto em uma tarde: ferramenta, conta e regras do agenteExaminar conexões de Preparar o projeto em uma tarde: ferramenta, conta e regras do agente
- Claude Code: do zero à práticaEscolher entre Claude e ChatGPT: qualidade, custo e retrabalhoExaminar conexões de Escolher entre Claude e ChatGPT: qualidade, custo e retrabalho
- Redes sociais com agentes de IAConheça as ferramentas e escolha o assistenteExaminar conexões de Conheça as ferramentas e escolha o assistente
Terminou a leitura?
Você está aqui: capítulo 16 de 27
0 de 27 concluídos
- Próximo · Capítulo 17 de 27 · 16 minGrok e Claude: comparar modelos e ferramentas de códigoLer o capítulo 17 sem concluir
Marque como concluído para o capítulo contar no seu painel e no certificado.
- Anterior · Capítulo 15 de 27 · 25 minPiloto de 90 dias: critérios para aprovar um agenteVoltar para o capítulo 15
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
- 14Escolher entre configurar um agente e treinar um modelo
- 15Piloto de 90 dias: critérios para aprovar um agente
- 16Comparar Claude Code e Codex na mesma tarefa
- 17Grok e Claude: comparar modelos e ferramentas de código
- 18Comparar ferramentas do Google com o trabalho atual


