Claude Code passa a suportar AGENTS.md da OpenAI

Autoria: Compilado do Código Fonte TV [OFICIAL] · Assistir no YouTube

Vídeo de autoria do canal indicado, não da IANIA; todos os direitos pertencem ao criador. Transcrição, resumo e tradução gerados automaticamente; o conteúdo no idioma original é preservado na versão em idioma original.

Idioma original: português

Vídeo original: Claude Code passa a suportar AGENTS.md da OpenAI · Canal: Compilado do Código Fonte TV [OFICIAL] · 05:47 · Assistir no YouTube

Tópicos: Agentes de IA, Claude Code, Ferramentas de desenvolvimento com IA, Open source e ecossistemas de software

Resumo

Claude Code passou a ler automaticamente o arquivo AGENTS.md quando não encontra um CLAUDE.md no diretório, a partir da versão 2.1.277. A mudança pode reduzir a necessidade de manter instruções duplicadas em projetos que usam Claude Code e outras ferramentas de código. Os participantes discutem se AGENTS.md pode se consolidar como padrão multiplataforma e se arquivos específicos, como CLAUDE.md, perderão relevância. Eles comparam essa disputa por compatibilidade à adoção de padrões comuns na história dos navegadores e dos formatos de tecnologia.

Pontos-chave

A compatibilidade com AGENTS.md foi introduzida no Claude Code a partir da versão 2.1.277.
Quando não há um CLAUDE.md no diretório, Claude Code processa automaticamente as instruções de AGENTS.md.
AGENTS.md é apresentado como uma especificação aberta e agnóstica a plataformas.
A adoção do formato pode evitar a manutenção de conjuntos duplicados de instruções em repositórios.
CLAUDE.md ainda pode conter parâmetros específicos da Anthropic que não se aplicam a outras ferramentas.
Os participantes especulam que AGENTS.md pode se tornar o padrão e que CLAUDE.md pode perder espaço.
A conversa compara a incompatibilidade entre ferramentas de IA a antigos ajustes específicos para o Internet Explorer.

Capítulos

Início	Capítulo	Resumo
00:02	Claude Code passa a ler AGENTS.md	A notícia apresenta a nova compatibilidade e explica que o arquivo é lido quando CLAUDE.md não está presente.
01:37	AGENTS.md como possível padrão	A conversa aborda a adoção do formato e a possibilidade de ele se tornar um padrão entre ferramentas.
03:11	A comparação com os padrões da web	Os participantes relembram os ajustes específicos do Internet Explorer e relacionam o caso à incompatibilidade entre ferramentas.
04:43	O futuro de CLAUDE.md	A discussão especula que AGENTS.md pode ganhar espaço e conclui com uma comparação à disputa histórica por formatos de tecnologia.

Citações

Se não houver o arquivo CLAUDE.md no diretório, o Claude Code verifica e processa automaticamente as diretrizes contidas em AGENTS.md. — 00:34

Os usuários que preferirem desativar essa leitura automática de padrões externos podem alterar a configuração. — 01:05

Acaba que é muito comum fazer esse symlink de um para o outro. — 02:40

O que o mercado usa e mais adota é o que acaba se tornando padrão. — 05:16

Conceitos e entidades

Claude Code (ferramenta): Ferramenta de programação da Anthropic que passou a oferecer compatibilidade com AGENTS.md.
AGENTS.md (conceito): Arquivo de instruções em Markdown concebido para orientar agentes de código de forma agnóstica a plataformas.
CLAUDE.md (conceito): Arquivo de instruções associado ao Claude Code, que pode incluir parâmetros específicos da Anthropic.
OpenAI (empresa): Empresa que criou a especificação AGENTS.md antes de transferi-la para uma fundação.
Agentic AI Foundation (empresa): Fundação mencionada na transcrição como responsável atualmente pela governança da especificação AGENTS.md.
Linux Foundation (empresa): Organização sob cuja tutela a transcrição situa a Agentic AI Foundation.
Anthropic (empresa): Empresa responsável pelo Claude Code, que anunciou a compatibilidade com AGENTS.md.
Microsoft Edge (ferramenta): Navegador citado na comparação sobre a adoção de padrões comuns e do Chromium.

Tradução completa (pt-BR)

00:02 E bora ver aqui, então, as notícias. Vamos começar falando sobre o Claude Code. Isso já tem alguns dias: ele passou a oferecer suporte ao arquivo AGENTS.md, que geralmente é usado com o OpenAI. Então, vai facilitar para a gente não ter vários arquivos duplicados dentro de um projeto. >> O formato AGENTS.md é uma especificação aberta criada pela OpenAI e atualmente governada pela Agentic AI Foundation, sob a tutela da Linux Foundation. Segundo uma publicação do engenheiro técnico da Anthropic, Tariq Shiripar, a

00:34 compatibilidade passou a valer a partir da versão 2.1.277 da aplicação. Pela nova regra de funcionamento, se o arquivo CLAUDE.md não estiver presente no diretório, o Claude Code verifica e processa automaticamente as diretrizes contidas no AGENTS.md. Esse arquivo em Markdown é processado por agentes de código a cada requisição para delimitar o comportamento esperado da ferramenta, as convenções de código adotadas pela equipe e as preferências técnicas. Segundo Shiripar, os usuários que preferirem

01:05 desativar essa leitura automática de padrões externos podem alterar a configuração executando o comando {barra} config. >> Até essa alteração técnica, quem usava o Claude Code com o OpenAI Codex ou outras ferramentas precisava manter dois conjuntos distintos de instruções nos repositórios, criando arquivos separados ou usando links simbólicos, né, para contornar a falta de integração entre esses ecossistemas. Embora tenha um objetivo semelhante, o CLAUDE.md pode conter parâmetros exclusivos da Anthropic, enquanto a

01:37 proposta do AGENTS.md é permanecer agnóstica a plataformas. No ano passado, a OpenAI transferiu a especificação para a Agentic AI Foundation, ligada à Linux Foundation, e, até o fim de 2025, mais de 60.000 projetos de código aberto já tinham implementado o formato. O executivo de produtos da OpenAI e engenheiros da Anthropic comemoraram publicamente a unificação técnica da especificação. Mas aí é que está o problema: não é só o nome do arquivo. No caso do Claude,

02:08 cria-se a pasta .claude. >> Uhum. >> E, no caso do Codex e da OpenAI, usa-se a pasta .agents. Isso também vai fazer com que ele recorra ao outro arquivo? Não fui a fundo para ver isso; provavelmente vai, porque, senão, não faz sentido os arquivos recorrerem a outro arquivo. Então, se a Anthropic abriu essa exceção, isso quer dizer o quê? Que quem está ganhando é o AGENTS.md. >> Até porque ele meio que virou o padrão para qualquer outra ferramenta. Então, a única diferente era o Claude Code, que precisava do CLAUDE.md. Agora,

02:40 acaba sendo muito comum também a gente fazer justamente esse link simbólico de um arquivo para o outro, porque, no Claude Code, você tem algumas especificações de comportamento da própria ferramenta que não vão funcionar nas outras com o AGENTS.md, né? >> Então, mas isso aí, voltando um pouco para quem é das antigas, me parece demais que daqui a pouco vai acontecer isso: dentro do AGENTS.md vai ter um hack, como a gente usava no CSS para o Internet Explorer, para funcionar no Claude. Se lembra? Então, essas especificações do Claude ou

03:11 elas vão morrer ou vão se adaptar dentro do AGENTS.md, porque isso faz mais sentido. Antigamente, pô, quem é das antigas sabe: você tinha que ter um arquivo CSS, e podia fazer um arquivo CSS só para o Internet Explorer. Geralmente, a gente tinha lá um ie.css e chamava ele somente… >> [risadas] >> Só e somente se. >> Mas isso era hack, isso era o problema. Então, por exemplo, você tinha uma propriedade e usava o sublinhado. O

03:42 Internet Explorer dava prioridade às propriedades de CSS que usavam o sublinhado como atributo, né? >> E por que tudo isso? Porque ele não usava o mesmo padrão dos outros. E, por fim, a própria Microsoft entendeu: “Ó, não tinha jeito, tinha que usar o mesmo padrão”. E hoje, no… Até esqueci o nome do navegador dela: o Edge. Hoje já usa o mesmo padrão dos outros, graças a Deus, né? >> Sim, já usa o Chromium, mas não começou como Chromium. >> Não, não, mas usa o mesmo padrão até de CSS, de tudo isso. Antes, não: ele

04:12 inventava moda e renderizava de forma diferente, então era problemático. >> Mas a gente falou desse caso do CSS porque isso aqui é exatamente a mesma coisa: uma incompatibilidade entre ferramentas, e aí uma delas abre uma exceção para adotar uma ferramenta que provavelmente já é considerada o padrão do mercado. E eu vejo que daqui a pouco o CLAUDE.md vai morrer. Porque, se a ferramenta já recorre ao AGENTS.md, não faz mais sentido manter o CLAUDE.md. Apesar de também ter virado uma referência, você pensa: “Ah, vamos criar o CLAUDE.md”, e tudo mais. Mas a tendência é a gente não ficar mais preso a modelos nem a empresas. É justamente poder trocar rapidamente os modelos que está usando. E o AGENTS.md já dá suporte a isso. Então, posso estar errado, tá? Mas acho essa história do CSS bem parecida com o que está acontecendo aqui. Nesse caso e em muitos outros que já aconteceram na indústria de formatos e padrões, a gente pode falar até de formatos que, por exemplo, foram criados pela Sony na época para… formatos de

04:43 áudio criados pela Sony para concorrer com outros formatos. No fim, cara, tudo aquilo morreu, e o que o mercado usa, adota e mais utiliza é o que acaba se tornando padrão. Ou seja, eu até trocaria o título da notícia para dar um clickbaitzinho. >> Hum. >> Tipo: “O CLAUDE.md está com os dias contados”. >> Nossa, ficou bom o bait, é. >> Pode ser isso, né? O que você acha? Diz aí… >> [risadas] >> nos comentários. E este aqui é um corte de uma notícia do compilado do Código Fonte TV. >> Onde toda semana tem episódio novo

05:16 sobre programação, tecnologia, inteligência artificial e cibersegurança. >> Então, já se inscreve aqui no canal do Compilado e acompanhe os episódios completos. >> [música] [música]

05:47 Falando de programação, tecnologia, inteligência artificial e cibersegurança. >> Então, já se inscreve aqui no canal do Compilado e acompanhe os episódios completos. >> [música] [música]

Transcrição original

[00:02] E bora ver aqui então as notícias. Vamos começar falando sobre o Cloud Code, isso aí já tem alguns dias, que ele passou a suportar o arquivo agents.md, que geralmente se usa com a Open AI. Então, eh vai facilitar aí pra gente não ter vários arquivos duplicados dentro de um projeto. >> O formato agents.md é uma especificação aberta criada pela Open AI e atualmente governada pela Agente AI Foundation sobre a tutela da Linux Foundation. Segundo publicação do engenheiro técnico da Anthropic, o Tariq Shiripar, a

[00:34] compatibilidade passou a valer a partir da versão 2.1.277 da aplicação. Pela nova regra de funcionamento, se não houver o arquivo cloud.md presente no diretório, o Cloud Code verifica e processa automaticamente as diretrizes contidas no agents.md. Esse arquivo de documento em markdown é processado por agentes de código em cada requisição para delimitar o comportamento esperado da ferramenta, convenções de código adotadas pela equipe e preferências técnicas. Segundo Shiripar, os usuários que preferirem

[01:05] desativar essa leitura automática de padrões externos podem alterar a configuração com a execução do comando {barra} config. >> Até a alteração técnica, quem utilizava aí o Cloud Code com o Open AI Codex ou outras ferramentas precisava manter sempre dois conjuntos distintos de instruções nos repositórios, criando arquivos separados ou usando simlinks, né, que são os links simbólicos entre os arquivos, pra contornar a falta de integração entre os esses ecossistemas. Embora traga um objetivo semelhante, o Cloud MD pode conter parâmetros exclusivos da Anthropic, enquanto a

[01:37] proposta do agents.md é permanecer agnóstica a plataformas. No ano passado, a Open AI transferiu a especificação para o Agente AI Foundation, ligada aí à Linux Foundation, registrando mais de 60.000 projetos de código aberto com o formato implementado até o fechamento de 2025. O executivo de produtos da Open AI e engenheiros da Anthropic comemoraram publicamente a unificação técnica da especificação, mas aí que tem o o problema, porque não é só o nome do arquivo, no caso do Claude

[02:08] se cria a pasta ponto Claude. >> Uhum. >> E no caso do do Codex e da OpenAi se utiliza o ponto agents, isso vai fazer fallback também, eu não fui a fundo para ver isso, provavelmente vai fazer porque senão não faz sentido o os arquivos fazer fallback de de arquivo. Então se a Anthropic abriu essa exceção, isso quer dizer que o quê? Quem tá ganhando é o agents.md. >> até porque ele virou meio que o padrão para qualquer outra ferramenta, então só o diferente era o Claude code que necessitava ali do Claude md, agora

[02:40] acaba que é muito comum também a gente pegar e justamente fazer esse symlink de um para o outro, porque ali no Claude code você tem algumas especificações de comportamento da própria ferramenta que no agents aí não vai funcionar nos outros, né? >> Então mas isso aí, voltando um pouco para quem das antigas, isso aí me parece demais, daqui a pouco vai acontecer isso, dentro do agents.md vai ter um hack, tipo a gente usava no CSS no Internet Explorer, para funcionar no Claude, se lembra? Então essas especificações do Claude ou

[03:11] elas vão morrer ou elas vão se adaptar dentro do agents.md, porque que faz mais sentido. Antigamente pô, você você tinha que ter, para quem das antigas aí, você usava um arquivo CSS, poderia ser feito no arquivo CSS só para o Internet Explorer. Geralmente a gente tinha lá um ie.css e a gente chamava ele somente isso somente >> [risadas] >> Só e somente se >> Mas isso era hack, isso era o problema, então por exemplo, você tinha uma propriedade, você usava o underscore, o

[03:42] Internet Explorer dava prioridade para para as propriedades lá de CSS que utilizavam o o underscore com com atributo, né? >> E isso tudo por quê? Porque ele não usava o mesmo padrão dos outros. E por fim, a própria Microsoft entendeu que ó, não tinha jeito, tinha que usar o mesmo padrão e hoje no, esqueci até o nome do, do navegador dela, o Edge, hoje já utiliza o mesmo padrão dos outros, graças a Deus, né? >> Sim, já utiliza o Chromium, mas não começou como o Chromium. >> Não, não, mas utiliza o mesmo padrão até de CSS, de tudo isso. Antes não, ele

[04:12] inventava uma moda e renderizava diferente, então era, era problemático. >> Mas a gente falou desse caso do CSS porque isso aqui é o, exatamente a mesma coisa, é uma incompatibilidade de ferramentas e aí uma abre, abre uma exceção para adotar uma ferramenta que provavelmente já é a considerada padrão pelo mercado e eu vejo que daqui a pouco o Cloud MD vai morrer. Porque se a ferramenta já faz o fallback para o Agents, não tem sentido mais manter o Cloud MD. Apesar de, de, ter virado até referência também, você, ah, vamos criar

[04:43] o Cloud MD, tudo. Mas a tendência é a gente não ficar preso mais a modelos e, e nem empresas. É justamente você poder trocar ali os modelos que você estão usando rapidamente. E o Agents já suporta isso. Então, eu posso estar errado, tá? Mas eu, eu acho esse, essa história do CSS bem parecido com o que está acontecendo aqui e nesse caso e muitos outros casos que já aconteceram na indústria de formatos, padrões, a gente pode falar até formatos, por exemplo, que foram criados pela Sony na época para é, formato de

[05:16] áudio criado pela Sony para concorrer com outros formatos, no fim, cara, morreu tudo e aquilo que o mercado usa e coloca, com, e e mais utiliza é o que acaba se tornando padrão. Ou seja, eu trocaria até o título da notícia para dar um clickbaitzinho. >> Hum. >> Tipo, o Cloud Code MD está com os dias contados. >> Nó, ficou, ficou bom o bait, é. >> Pode ser isso, né? O que que você, o que que você acha? Diz aqui >> [risadas] >> nos comentários. E esse aqui é um corte de uma notícia do compilado do Código Fonte TV. >> Onde toda semana tem episódio novo

[05:47] falando de programação, tecnologia, inteligência artificial e cibersegurança. >> Então, já se inscreve aqui no canal do Compilado e acompanhe os episódios completos. >> [música] [música]