Guías de configuración de agentes de programación con IA (español)

Todos los agentes de programación importantes tienen dos palancas: un interruptor de aprobación automática total (Run Everything en Cursor, --dangerously-skip-permissions en Claude Code, --yolo en Codex, Gemini CLI y Copilot CLI, YOLO Mode en Cline) y una lista de permitidos acotada que aprueba de antemano solo los comandos en los que confías. La lista de permitidos es la opción predeterminada más segura. Reserva el interruptor total para contenedores, VM o proyectos desechables.

Cursor lee archivos .mdc en .cursor/rules además de AGENTS.md. Claude Code lee CLAUDE.md y recurre a AGENTS.md cuando no hay CLAUDE.md. Codex, Amp, Kiro y Junie leen AGENTS.md de forma nativa. Gemini CLI lee GEMINI.md y se puede apuntar a AGENTS.md con context.fileName. GitHub Copilot lee .github/copilot-instructions.md, .github/instructions/*.instructions.md y AGENTS.md. Cline lee .clinerules/ y también detecta .cursorrules, .windsurfrules y AGENTS.md. Un solo AGENTS.md en la raíz del repo cubre la mayoría de los agentes.

Claude Code usa ~/.claude/settings.json además de .claude/settings.json y .claude/settings.local.json en el proyecto. Codex usa ~/.codex/config.toml además de .codex/config.toml en proyectos de confianza. Gemini CLI y Qwen Code usan ~/.gemini/settings.json y ~/.qwen/settings.json con una carpeta .gemini o .qwen por proyecto. OpenCode usa ~/.config/opencode/opencode.json y opencode.json, Amp usa ~/.config/amp/settings.json y .amp/settings.json, y Factory Droid usa ~/.factory/settings.json. Cursor guarda la configuración de IA en el panel Cursor Settings y los archivos del agente, como permissions.json, en ~/.cursor y .cursor. En todas las herramientas, el archivo del proyecto sobrescribe el del usuario.

La mayoría de los agentes leen un archivo JSON con un objeto mcpServers: .cursor/mcp.json en Cursor, .mcp.json en Claude Code, .kiro/settings/mcp.json en Kiro, .factory/mcp.json en Factory Droid y .junie/mcp/mcp.json en Junie. Las excepciones son VS Code (una clave servers en .vscode/mcp.json), Codex (tablas [mcp_servers.NAME] en ~/.codex/config.toml), OpenCode (una clave mcp en opencode.json), Zed (context_servers en la configuración) y goose (extensions en config.yaml). Claude Code, Codex, Gemini CLI, Amp y Factory Droid también tienen un comando mcp add.

Claude Code lee un bloque hooks en .claude/settings.json, Gemini CLI un bloque hooks en .gemini/settings.json, Cursor lee .cursor/hooks.json, Factory Droid .factory/hooks.json, GitHub Copilot .github/hooks/*.json y Kiro cualquier archivo JSON en .kiro/hooks/. Todos envían el evento a tu script como JSON por stdin. Para bloquear una llamada a herramienta, sal con código 2 en Claude Code, Cursor, Gemini CLI, Factory Droid y la Kiro CLI, o imprime una decisión deny como JSON (Copilot usa permissionDecision, Cursor usa permission).

Todos estos agentes leen una carpeta con un archivo SKILL.md cuyo frontmatter YAML tiene un name y una description. Claude Code usa .claude/skills/ y ~/.claude/skills/. Codex, Amp y OpenHands usan .agents/skills/ en el repo y ~/.agents/skills/ para ti. Cline usa .cline/skills/ y ~/.cline/skills/, y también lee .claude/skills/. Amp también lee .claude/skills/. Así, una skill en .agents/skills/ cubre Codex, Amp y OpenHands, y una copia en .claude/skills/ cubre Claude Code, Cline y Amp.

Claude Code compara cada llamada a herramienta con las reglas de permisos de tus archivos de configuración. Las reglas van en permissions.allow, permissions.ask y permissions.deny, usan el formato Tool o Tool(specifier) y se evalúan primero deny, luego ask y luego allow. Usa /permissions para ver cada regla y el archivo del que viene, o pasa --allowedTools y --disallowedTools para una sola sesión.

Presiona Shift+Tab para alternar entre modos de permisos, inicia con claude --permission-mode <mode> o preaprueba comandos específicos con reglas permissions.allow como Bash(npm run *) en .claude/settings.json. El modo auto se ejecuta sin confirmaciones rutinarias mientras un clasificador revisa las acciones; --dangerously-skip-permissions está pensado solo para contenedores o VMs.

Abre Settings > Agents > Approvals & Execution y elige un Run Mode. Run Everything ejecuta cada llamada a herramienta automáticamente, sin sandbox ni revisión; Allowlist ejecuta solo los comandos que enumeras; Auto-review ejecuta de inmediato las llamadas de la allowlist y envía los demás comandos de shell al sandbox cuando es posible.

Crea archivos .mdc en la carpeta .cursor/rules de tu repo, cada uno con frontmatter que define description, globs y alwaysApply. La forma más rápida es escribir /create-rule en el chat de Agent. Para markdown simple sin metadatos, usa un archivo AGENTS.md.

Ejecuta claude mcp add --transport http NAME URL para un servidor remoto, o claude mcp add [options] NAME -- COMMAND [args] para un servidor stdio local. Por defecto, los servidores se guardan con scope local, así que solo tú los ves y solo en el proyecto actual. Usa --scope project para escribir un .mcp.json compartido, o --scope user para que el servidor esté disponible en todos tus proyectos.

Las cinco herramientas te permiten definir agentes personalizados en archivos. Claude Code, Cursor, Gemini CLI y Copilot usan Markdown con frontmatter YAML. Codex usa archivos TOML independientes. Cada herramienta incluye subagentes integrados, como Explore en Claude Code, explorer en Codex, explore en Cursor y Copilot, y codebase_investigator en Gemini CLI. Claude Code, Cursor, Gemini CLI y Copilot pueden elegir un agente por su cuenta a partir de su descripción. En Codex pides subagentes directamente, o los solicitan las instrucciones de AGENTS.md o de una skill. Las herramientas difieren sobre todo en las restricciones de herramientas, la elección de modelo y cómo funcionan las ejecuciones en segundo plano o en paralelo.