Em 25 de agosto, o CEO da Shopify, Tobi Lütke, declarou publicamente que está considerando banir o uso do Claude Code dentro da empresa, a menos que a Anthropic mude de posição e passe a ler arquivos como o AGENTS.md e o .agents/skills. Segundo ele, o Claude Code insiste em ler apenas o CLAUDE.md, o que causa uma espécie de "personalidade dividida" entre membros da equipe que usam ferramentas diferentes — um imposto de complexidade que, na sua visão, não precisaria existir.
A disputa é sobre um único arquivo Markdown
O AGENTS.md é uma convenção lançada pela OpenAI em agosto de 2025: comandos de build, formas de teste e regras de segurança em nível de projeto são registrados em um arquivo Markdown na raiz do repositório, para que agentes de programação o leiam e entendam a base de código. Até o fim de 2025, dados públicos mostravam mais de sessenta mil projetos de código aberto usando esse arquivo, e o próprio padrão passou a ser mantido pela Agentic AI Foundation, ligada à Linux Foundation. Codex, Cursor, Gemini CLI, GitHub Copilot, Jules e VS Code o reconhecem.
Já o Claude Code usa seu próprio CLAUDE.md. Em projetos individuais, isso é apenas mais um arquivo para manter; em organizações como a Shopify, com milhares de pessoas compartilhando um repositório grande, o problema muda de forma: se apenas um dos dois arquivos estiver presente em um diretório, colegas que usam outra ferramenta recebem um contexto incompleto.
O pedido ficou parado por um ano
A issue no GitHub pedindo suporte nativo do Claude Code ao AGENTS.md existe desde agosto de 2025 e já acumulou quase 5.000 votos, uma das solicitações de compatibilidade mais apoiadas do repositório. Várias issues semelhantes foram sendo fechadas depois, uma delas com a conclusão "sem planos no momento". Desenvolvedores deixaram centenas de comentários, mas a Anthropic nunca deu uma posição oficial.
A comunidade já tinha uma solução alternativa havia tempos: transformar o CLAUDE.md em um link simbólico apontando para o AGENTS.md, ou simplesmente escrever no CLAUDE.md a instrução "leia o AGENTS.md". Funciona, mas precisa ser refeito em cada repositório.
A Anthropic finalmente deu uma justificativa
No mesmo dia da declaração de Lütke, Thariq, da Anthropic, respondeu no tópico dizendo que a equipe está tornando o Claude Code mais personalizável, para que no futuro seja fácil usar o AGENTS.md ou editar diretamente o system prompt — e que haveria mais detalhes assim que estivesse pronto. Foi também a primeira vez que a empresa explicou o motivo da recusa anterior: eles não acreditam que famílias de modelos diferentes sejam intercambiáveis, já que o system prompt afeta muito o desempenho — internamente, o Claude Code mantém prompts de sistema separados por modelo, o que já representa um esforço de manutenção considerável.
Tecnicamente, esse argumento se sustenta. O mesmo conjunto de instruções, aplicado a modelos de fornecedores diferentes, realmente produz resultados bem diferentes, e prompts ajustados especificamente para cada modelo podem ampliar essa diferença de desempenho. Só que isso explica por que o CLAUDE.md precisa existir separadamente, não por que o sistema não poderia também ler o AGENTS.md de passagem — as duas coisas não são incompatíveis.
Os arquivos de contexto viraram o novo campo de batalha
Um levantamento cobrindo 2.926 repositórios do GitHub mostra que arquivos de contexto já são a forma mais comum de os desenvolvedores darem instruções a agentes de programação. Uma vez que esse espaço seja ocupado por um formato proprietário de uma única empresa, o custo de migração recai sobre quem usa a ferramenta — hoje é mais um arquivo para manter, amanhã pode ser skills, sub-agentes e configurações de permissão inteiros presos à estrutura de diretórios de um único fornecedor.
Em termos de esforço de engenharia, esse impasse é um tanto desproporcional. Fazer o Claude Code recorrer ao AGENTS.md quando não encontra o CLAUDE.md é uma lógica de busca de arquivo de algumas dezenas de linhas, algo em um nível completamente diferente de "manter system prompts por modelo". Se a preocupação real é que instruções genéricas reduzam o desempenho, basta acrescentar uma linha de aviso. É exatamente essa a solução intermediária que a comunidade vem propondo há um ano: ler o CLAUDE.md por padrão, recorrer ao AGENTS.md quando ele não existir, e priorizar o CLAUDE.md quando os dois estiverem presentes.
A pressão pública de Lütke funcionou por uma lógica simples. A Shopify é uma usuária de grande escala do Claude Code, e um CEO de empresa de capital aberto dizendo publicamente que vai bani-lo pesa muito mais do que 5.000 votos anônimos. Para a Anthropic, a vantagem atual do Claude Code vem da experiência do produto, não de um formato proprietário; num momento em que os desenvolvedores já usam várias ferramentas em paralelo, transformar a compatibilidade em uma opção configurável compensa mais do que insistir em manter um único nome de arquivo.
Fontes: The New Stack, GitHub, CocoLoop, Hacker News; a escala de adoção do AGENTS.md, o número de votos na issue e as declarações da Anthropic foram verificados em páginas públicas.