Guias
Arquivos de regras e instruções em todo agente de IA para programação: .cursor/rules, CLAUDE.md, AGENTS.md, GEMINI.md, instruções do Copilot e mais (2026)
Qual arquivo de regras ou instruções cada agente de IA para programação lê, e o AGENTS.md funciona em todos?
O Cursor lê arquivos .mdc em .cursor/rules, além do AGENTS.md. O Claude Code lê o CLAUDE.md e recorre ao AGENTS.md quando não há CLAUDE.md. Codex, Amp, Kiro e Junie leem o AGENTS.md nativamente. O Gemini CLI lê o GEMINI.md e pode ser apontado para o AGENTS.md com context.fileName. O GitHub Copilot lê .github/copilot-instructions.md, .github/instructions/*.instructions.md e AGENTS.md. O Cline lê .clinerules/ e também detecta .cursorrules, .windsurfrules e AGENTS.md. Um único AGENTS.md na raiz do repo cobre a maioria dos agentes.
Esta página é uma tradução do guia em inglês. Comandos, chaves de configuração e código não foram alterados; em caso de diferença, vale a versão em inglês. Ler em inglês → · Outros idiomas: 简体中文 · 日本語 · 한국어 · Español
Saiba quando a configuração mudar
Quando uma configuração, flag ou regra de permissão dessas ferramentas mudar, você recebe um e-mail semanal (em inglês), conferido na documentação oficial.
Resposta rápida: o arquivo que cada agente lê
- Cursor: as regras do projeto são arquivos .mdc em .cursor/rules (um arquivo .md comum ali é ignorado). As User Rules ficam em Customize, depois Rules. As Team Rules vêm do dashboard nos planos Team e Enterprise. O AGENTS.md funciona na raiz e em subpastas.
- Claude Code: ./CLAUDE.md ou ./.claude/CLAUDE.md para a equipe, ~/.claude/CLAUDE.md para você, ./CLAUDE.local.md para notas privadas do projeto. Execute /init para gerar um.
- OpenAI Codex: AGENTS.md em ~/.codex para hábitos globais, depois um AGENTS.md (ou AGENTS.override.md) por diretório, da raiz do repo até onde você trabalha.
- Gemini CLI: ~/.gemini/GEMINI.md globalmente e GEMINI.md no seu projeto. /memory show mostra o que está carregado.
- GitHub Copilot: .github/copilot-instructions.md para o repo inteiro, .github/instructions/NAME.instructions.md com um glob applyTo para alguns arquivos, e AGENTS.md em qualquer lugar do repo.
- Cline: arquivos markdown em .clinerules/ ou .cline/rules/ no projeto, e ~/Documents/Cline/Rules para regras globais.
- Kiro: arquivos markdown de steering em .kiro/steering/ (workspace) ou ~/.kiro/steering/ (global), além do AGENTS.md.
- Junie: .junie/AGENTS.md, depois um AGENTS.md na raiz, depois o legado .junie/guidelines.md. Diretrizes globais vão em ~/.junie/AGENTS.md.
- Amp: AGENTS.md no diretório de trabalho e nos diretórios pais, além de ~/.config/amp/AGENTS.md.
- goose: AGENTS.md e .goosehints, globalmente em ~/.config/goose/.goosehints ou por projeto.
- Zed: ~/.config/zed/AGENTS.md para você, depois o primeiro arquivo do projeto que ele encontrar em uma lista que começa com .rules, .cursorrules e .windsurfrules e inclui AGENTS.md e CLAUDE.md.
- Aider: nenhum arquivo especial. Escreva um CONVENTIONS.md e carregue-o com aider --read CONVENTIONS.md ou read: no .aider.conf.yml.
O AGENTS.md funciona em todos?
Quase. Estes agentes leem o AGENTS.md sem configuração extra: Cursor, Codex, GitHub Copilot, Cline, Kiro, Junie, Amp, goose e Zed. O Claude Code lê o AGENTS.md só quando o repo não tem CLAUDE.md. Se você mantiver os dois, adicione @AGENTS.md dentro do CLAUDE.md para que o Claude Code o importe. O Gemini CLI precisa de context.fileName no settings.json.
CLAUDE.md que reaproveita o AGENTS.md
@AGENTS.md ## Claude Code only - Use plan mode for changes that touch more than three files.
Gemini CLI: .gemini/settings.json
{
"context": {
"fileName": ["AGENTS.md", "GEMINI.md"]
}
}E o .cursorrules?
A documentação atual de regras do Cursor descreve arquivos .mdc em .cursor/rules, User Rules, Team Rules e AGENTS.md. Ela não documenta um arquivo .cursorrules na raiz. Outras ferramentas ainda leem esse nome de arquivo: o Cline detecta .cursorrules automaticamente, e o Zed verifica .cursorrules em segundo lugar na sua lista de arquivos de instruções do projeto. Em projetos novos, coloque instruções compartilhadas no AGENTS.md e o escopo específico do Cursor em .cursor/rules.
Limitar uma regra a alguns arquivos
- Cursor: globs no frontmatter do .mdc, com alwaysApply: false.
- Claude Code: um campo paths em um arquivo markdown em .claude/rules/.
- GitHub Copilot: applyTo no frontmatter de um arquivo .instructions.md.
- Cline: uma lista paths no frontmatter YAML.
- Kiro: inclusion: fileMatch com um fileMatchPattern.
- Amp: globs no front matter de um arquivo que você @-menciona a partir do AGENTS.md.
- Codex: coloque um AGENTS.md ou AGENTS.override.md na subpasta que precisa de regras diferentes.
.cursor/rules/components.mdc
--- globs: src/components/**/*.tsx alwaysApply: false --- - Use named exports, not default exports
.github/instructions/python.instructions.md
--- applyTo: "**/*.py" --- Use type hints on every public function.
Guia completo de regras para cada agente
- Configuração de regras do Cursor: frontmatter .mdc, Team Rules e AGENTS.md
- CLAUDE.md do Claude Code: locais, imports e AGENTS.md
- AGENTS.md do Codex: arquivos globais, de projeto e de override
- GEMINI.md do Gemini CLI: locais, imports e /memory
- Instruções personalizadas do GitHub Copilot
- Cline Rules: regras de workspace, globais e condicionais
- Arquivos de steering do Kiro e modos de inclusão
- Diretrizes do Junie e AGENTS.md
- AGENTS.md do Amp e orientações com escopo por glob
- goose .goosehints e AGENTS.md
- Arquivos de instruções do Zed, MCP e permissões de ferramentas
- Aider CONVENTIONS.md e .aider.conf.yml
- Templates de regras do Cursor para copiar e colar
- Referência e gerador de AGENTS.md
Fontes
Documentação oficial (em inglês) usada para conferir este guia. Versão em inglês revisada em: 2026-10-18
Mais guias em português
- Permitir todos os comandos em qualquer agente de IA para programação: Cursor, Claude Code, Codex, Gemini CLI, Copilot CLI e mais 7 (2026)
- Locais dos arquivos de configuração de todo agente de IA para programação: Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Qwen Code, Amp e Factory Droid (2026)
- Adicionar um MCP server a qualquer agente de IA para programação: Claude Code, Cursor, Codex, Gemini CLI, VS Code e mais 8 (2026)
- Hooks em todo agente de IA para programação: Claude Code, Cursor, Gemini CLI, GitHub Copilot, Kiro e Factory Droid (2026)
- Agent Skills (SKILL.md) em todo agente de IA para programação: Claude Code, Codex, Cline, Amp e OpenHands (2026)
- Permissões do Claude Code: regras allow, ask e deny, sintaxe de regras e ferramentas permitidas
- Como permitir que o Claude Code rode todos os comandos: modos de permissão, regras allow e pular permissões
- Como permitir que o Cursor rode todos os comandos: Run Everything, allowlist e sandbox
- Configuração de regras do Cursor: regras de projeto, de usuário e Team Rules, frontmatter .mdc, globs e AGENTS.md
- Adicionar servidores MCP ao Claude Code (claude mcp add, .mcp.json, escopos)
- Subagents e agentes personalizados comparados: Claude Code vs Codex vs Cursor vs Gemini CLI vs GitHub Copilot (2026)