RespostasPublicado18 fontes
Claude Code 2.1.277 adiciona suporte de fallback ao AGENTS.md
Lançado em 18 de setembro de 2026, o Claude Code 2.1.277 pode usar o AGENTS.md como instrução de projeto quando não existe um CLAUDE.md. A mudança reduz a necessidade de manter arquivos duplicados, links simbólicos ou diretivas de importação em repositórios que adotam o padrão aberto.
Publicado porEditado com GPT-5.6 TerraImagens geradas com GPT Image 2
Resposta de pesquisa
Principais conclusões
- Lançado em 18 de setembro de 2026, o Claude Code 2.1.277 pode usar o AGENTS.md como instrução de projeto quando não existe um CLAUDE.md.
- A mudança reduz a necessidade de manter arquivos duplicados, links simbólicos ou diretivas de importação em repositórios que adotam o padrão aberto.
- AGENTS.md reúne orientações do repositório; SKILL.md empacota capacidades reutilizáveis e acionadas quando necessário.
Prompt de IA
openai.comCreate a landscape editorial hero image for this Studio Global article: What changed in Claude Code version 2.1.277, released on September 18, 2026, regarding support for the open AGENTS.md project-instructions f. Article summary: Claude Code 2.1.277 adds native, opt-in-configurable fallback support for `AGENTS.md`: a repository without `CLAUDE.md` can now supply Claude Code’s project instructions through the shared open format instead. It is a fa. Topic tags: general, general web, user generated. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
O Claude Code 2.1.277 passou a oferecer suporte ao padrão aberto AGENTS.md como alternativa para as instruções de um projeto. Na configuração padrão documentada, se o repositório não tiver um CLAUDE.md, o Claude Code lê o AGENTS.md. Assim, projetos que já usam um único arquivo de orientação para vários agentes de programação podem funcionar com a ferramenta da Anthropic sem criar antes um arquivo exclusivo para ela. 1
Como funciona o fallback
A regra prática é simples:
- Sem
CLAUDE.mdno projeto: o Claude Code pode usar oAGENTS.mdcomo instruções do projeto.1
- Com
CLAUDE.mdno projeto: oCLAUDE.mdcontinua sendo o arquivo de instruções já estabelecido. O anúncio da versão não descreve uma combinação automática dos dois arquivos no comportamento padrão de fallback.
A opção pode ser ativada ou alterada em Project instructions, dentro de /config. A Anthropic informa que o recurso ainda não é compatível com implantações do Claude Code no Amazon Bedrock, no Google Vertex AI e no Azure AI Foundry. 1
O que é o AGENTS.md
O AGENTS.md é uma convenção aberta, baseada em Markdown, para registrar orientações específicas de um repositório destinadas a agentes de programação com IA — em termos simples, um “README para agentes”. O arquivo pode reunir contexto do projeto, passos de configuração, comandos de build e teste, convenções de código e expectativas de contribuição. 19
32
O formato surgiu de uma colaboração entre participantes do ecossistema de desenvolvimento assistido por IA, incluindo OpenAI Codex, Amp, Google Jules, Cursor e Factory. Hoje, ele é mantido pela Agentic AI Foundation, vinculada à Linux Foundation, e o projeto informa adoção em mais de 60 mil repositórios de código aberto. 19
21
Entre as ferramentas listadas no ecossistema estão OpenAI Codex, Google Jules, Cursor, o agente de programação do GitHub Copilot, Gemini CLI, Aider, Zed, Warp, VS Code, Devin, JetBrains Junie, Factory, Goose e OpenCode. As regras de descoberta e carregamento ainda variam entre os produtos; portanto, a existência do arquivo não garante comportamento idêntico em todas as ferramentas. 19
Por que a mudança importa
Antes do suporte nativo, equipes que adotavam AGENTS.md como arquivo compartilhado frequentemente precisavam manter também um CLAUDE.md, criar um link simbólico entre os dois ou usar um CLAUDE.md mínimo que importasse o arquivo compartilhado. Essas alternativas eram documentadas como soluções provisórias porque o Claude Code ainda não lia AGENTS.md diretamente. 10
O novo fallback reduz esse trabalho extra em repositórios que não precisam de instruções exclusivas do Claude Code. Na prática, um único arquivo pode passar a fornecer as regras básicas do projeto tanto para o Claude Code quanto para outras ferramentas compatíveis.
Isso não torna todos os sistemas de instruções equivalentes. As equipes ainda precisam verificar como cada agente encontra arquivos, aplica instruções em subdiretórios e resolve possíveis conflitos.
AGENTS.md não é o mesmo que SKILL.md
Os formatos são complementares, e não substitutos:
AGENTS.md: orientações permanentes de um repositório — o contexto e as regras gerais para trabalhar naquele código.19
32
SKILL.md: parte de uma Agent Skill, ou seja, um pacote reutilizável no sistema de arquivos que pode incluir instruções, metadados e recursos de apoio. O Claude usa essas skills quando elas são pertinentes para disponibilizar fluxos de trabalho ou conhecimento especializado.33
Segundo a documentação, as skills do Claude Code seguem o padrão interoperável Agent Skills. Em um projeto, uma skill pode ser organizada em um diretório com SKILL.md, como em .claude/skills/<nome>/SKILL.md. 37
39
Limitações que continuam valendo
A atualização cria um fallback para arquivo de instruções, mas não estabelece compatibilidade total com todas as convenções de agentes.
Em especial, a localização documentada para skills de projeto no Claude Code continua sendo .claude/skills/<nome>/SKILL.md. O changelog da versão 2.1.277 anuncia o uso de AGENTS.md para instruções de projeto, mas não anuncia a descoberta automática do diretório .agents/skills/. 1
37
Também não se deve interpretar o fallback como uma regra de mesclagem automática entre CLAUDE.md e AGENTS.md. Se um repositório precisa manter regras portáveis e comportamentos específicos do Claude, essa relação deve ser definida explicitamente.
Organização recomendada para projetos que já usam CLAUDE.md
Para equipes que já dependem de CLAUDE.md, uma divisão prática é:
- Colocar regras gerais e portáveis entre ferramentas no
AGENTS.md. - Manter o
CLAUDE.mdpara instruções específicas do Claude Code. - Quando fizer sentido, referenciar ou importar explicitamente a orientação compartilhada a partir do
CLAUDE.md, em vez de presumir que os dois arquivos serão carregados juntos.
A versão 2.1.277 representa, portanto, um avanço relevante de interoperabilidade: um repositório orientado primeiro por AGENTS.md passa a ser viável no Claude Code quando não existe CLAUDE.md, sem a promessa de que todos os padrões de instruções e descoberta de skills agora funcionem da mesma forma.
Studio Global AI
Continue sua pesquisa
Esta página inclui uma resposta baseada na fonte que você pode continuar em Studio Global.
As pessoas também perguntam
Qual é a resposta curta para "Claude Code 2.1.277 adiciona suporte de fallback ao AGENTS.md"?
Lançado em 18 de setembro de 2026, o Claude Code 2.1.277 pode usar o AGENTS.md como instrução de projeto quando não existe um CLAUDE.md.
Quais são os pontos-chave para validar primeiro?
Lançado em 18 de setembro de 2026, o Claude Code 2.1.277 pode usar o AGENTS.md como instrução de projeto quando não existe um CLAUDE.md. A mudança reduz a necessidade de manter arquivos duplicados, links simbólicos ou diretivas de importação em repositórios que adotam o padrão aberto.
O que devo fazer a seguir na prática?
AGENTS.md reúne orientações do repositório; SKILL.md empacota capacidades reutilizáveis e acionadas quando necessário.