Guias de configuração de agentes de programação com IA (português)

Todo grande agente de programação tem duas alavancas: um botão de aprovação automática total (Run Everything no Cursor, --dangerously-skip-permissions no Claude Code, --yolo no Codex, Gemini CLI e Copilot CLI, YOLO Mode no Cline) e uma allowlist restrita que pré-aprova só os comandos em que você confia. A allowlist é o padrão mais seguro. Reserve o botão total para containers, VMs ou projetos descartáveis.

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.

O Claude Code usa ~/.claude/settings.json, além de .claude/settings.json e .claude/settings.local.json no projeto. O Codex usa ~/.codex/config.toml, além de .codex/config.toml em projetos confiáveis. O Gemini CLI e o Qwen Code usam ~/.gemini/settings.json e ~/.qwen/settings.json, com uma pasta .gemini ou .qwen por projeto. O OpenCode usa ~/.config/opencode/opencode.json e opencode.json, o Amp usa ~/.config/amp/settings.json e .amp/settings.json, e o Factory Droid usa ~/.factory/settings.json. O Cursor guarda as configurações de IA no painel Cursor Settings e arquivos do agente, como permissions.json, em ~/.cursor e .cursor. Em todas as ferramentas, o arquivo do projeto sobrescreve o arquivo do usuário.

A maioria dos agentes lê um arquivo JSON com um objeto mcpServers: .cursor/mcp.json no Cursor, .mcp.json no Claude Code, .kiro/settings/mcp.json no Kiro, .factory/mcp.json no Factory Droid e .junie/mcp/mcp.json no Junie. As exceções são o VS Code (uma chave servers em .vscode/mcp.json), o Codex (tabelas [mcp_servers.NAME] em ~/.codex/config.toml), o OpenCode (uma chave mcp em opencode.json), o Zed (context_servers nas configurações) e o goose (extensions em config.yaml). Claude Code, Codex, Gemini CLI, Amp e Factory Droid também têm um comando mcp add.

O Claude Code lê um bloco hooks em .claude/settings.json, o Gemini CLI um bloco hooks em .gemini/settings.json, o Cursor lê .cursor/hooks.json, o Factory Droid .factory/hooks.json, o GitHub Copilot .github/hooks/*.json e o Kiro qualquer arquivo JSON em .kiro/hooks/. Todos enviam o evento ao seu script como JSON no stdin. Para bloquear uma chamada de ferramenta, saia com código 2 no Claude Code, Cursor, Gemini CLI, Factory Droid e na Kiro CLI, ou imprima uma decisão deny em JSON (o Copilot usa permissionDecision, o Cursor usa permission).

Todos esses agentes leem uma pasta com um arquivo SKILL.md cujo frontmatter YAML tem name e description. O Claude Code usa .claude/skills/ e ~/.claude/skills/. Codex, Amp e OpenHands usam .agents/skills/ no repo e ~/.agents/skills/ para você. O Cline usa .cline/skills/ e ~/.cline/skills/, e também lê .claude/skills/. O Amp também lê .claude/skills/. Então uma skill em .agents/skills/ cobre Codex, Amp e OpenHands, e uma cópia em .claude/skills/ cobre Claude Code, Cline e Amp.

O Claude Code verifica cada chamada de ferramenta contra as regras de permissão nos seus arquivos de configuração. As regras ficam em permissions.allow, permissions.ask e permissions.deny, usam o formato Tool ou Tool(specifier) e são avaliadas primeiro deny, depois ask, depois allow. Use /permissions para ver todas as regras e o arquivo de origem de cada uma, ou passe --allowedTools e --disallowedTools para uma única sessão.

Pressione Shift+Tab para alternar entre os modos de permissão, inicie com claude --permission-mode <mode> ou pré-aprove comandos específicos com regras permissions.allow como Bash(npm run *) em .claude/settings.json. O modo auto roda sem confirmações de rotina enquanto um classificador revisa as ações; --dangerously-skip-permissions é só para containers ou VMs.

Abra Settings > Agents > Approvals & Execution e escolha um Run Mode. Run Everything executa toda chamada de ferramenta automaticamente, sem sandbox nem revisão; Allowlist executa só os comandos que você listar; Auto-review executa na hora as chamadas da allowlist e envia outros comandos de shell para o sandbox quando possível.

Crie arquivos .mdc na pasta .cursor/rules do seu repositório, cada um com frontmatter que define description, globs e alwaysApply. O jeito mais rápido é digitar /create-rule no chat do Agent. Para markdown simples sem metadados, use um arquivo AGENTS.md.

Rode claude mcp add --transport http NAME URL para um servidor remoto, ou claude mcp add [options] NAME -- COMMAND [args] para um servidor stdio local. Por padrão, os servidores são salvos no escopo local, então só você os vê e só no projeto atual. Use --scope project para gravar um .mcp.json compartilhado, ou --scope user para deixar o servidor disponível em todos os seus projetos.

As cinco ferramentas permitem definir agentes personalizados em arquivos. Claude Code, Cursor, Gemini CLI e Copilot usam Markdown com frontmatter YAML. O Codex usa arquivos TOML independentes. Cada ferramenta traz subagents nativos, como Explore no Claude Code, explorer no Codex, explore no Cursor e no Copilot, e codebase_investigator no Gemini CLI. Claude Code, Cursor, Gemini CLI e Copilot conseguem escolher um agente sozinhos a partir da descrição dele. No Codex você pede subagents diretamente, ou instruções do AGENTS.md ou de skills os solicitam. As ferramentas diferem mais em restrições de ferramentas, escolha de modelo e no funcionamento de execuções em segundo plano ou em paralelo.