Subagentes y agentes personalizados comparados: Claude Code vs Codex vs Cursor vs Gemini CLI vs GitHub Copilot (2026)

Los subagentes personalizados son archivos Markdown con frontmatter YAML. El cuerpo se convierte en el system prompt del subagente. Solo name y description son obligatorios.

• Ubicaciones, por prioridad: managed settings, el flag de CLI --agents (JSON, solo la sesión actual), .claude/agents/ (proyecto), ~/.claude/agents/ (usuario) y luego el directorio agents/ de un plugin.
• Los campos opcionales incluyen tools (allowlist), disallowedTools (denylist, se aplica primero), model, permissionMode, maxTurns, skills, mcpServers, hooks, memory, background, effort, isolation (worktree) y color.
• Subagentes integrados: Explore (búsqueda de solo lectura), Plan (investigación de solo lectura en modo plan), general-purpose, claude, statusline-setup y claude-code-guide.
• Invocación: delegación automática según la descripción, lenguaje natural, una mención con @ como @agent-<name>, o claude --agent <name> para ejecutar toda la sesión como ese agente.
• Segundo plano: los subagentes en segundo plano se ejecutan de forma concurrente, y Ctrl+B mueve una tarea en curso al segundo plano. El límite predeterminado es de 20 subagentes concurrentes (CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS).
• Modelo: sonnet, opus, haiku, fable, un ID de modelo completo o inherit. CLAUDE_CODE_SUBAGENT_MODEL define un valor predeterminado.

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

Los agentes personalizados de Codex son archivos TOML independientes, un agente por archivo. Codex identifica el agente por su campo name, no por el nombre del archivo.

• Ubicaciones: ~/.codex/agents/ (personal) y .codex/agents/ (proyecto).
• Campos obligatorios: name, description, developer_instructions. Opcionales: model, model_reasoning_effort, model_reasoning_summary, model_verbosity, claves features.* y ajustes de skills.
• Un agente personalizado no puede anular sandbox_mode, approval_policy, model_provider ni mcp_servers. Los hereda del agente padre.
• Agentes integrados: default, worker y explorer. Un agente personalizado con el mismo nombre que uno integrado tiene prioridad.
• Invocación: pídelo directamente, por ejemplo "spawn two agents", o nombra un agente personalizado en tu prompt. Las instrucciones del proyecto o de una skill también pueden solicitar delegación.
• Paralelo: Codex lanza agentes, espera todos los resultados y devuelve una única respuesta consolidada. Puedes abrir el hilo de un subagente y pedirle a Codex que dirija, detenga o cierre hilos de subagentes.
• Los ajustes globales de [agents] incluyen agents.enabled, agents.max_concurrent_threads_per_session, agents.default_subagent_model, agents.default_subagent_reasoning_effort y agents.interrupt_message.
• Límites de herramientas: los subagentes heredan los permisos del padre. Para reducir capacidades, configura claves de features como features.shell_tool en false.

Los subagentes de Cursor son archivos Markdown con frontmatter YAML seguido del prompt. Cursor también lee las carpetas de agentes de Claude Code y Codex.

• Ubicaciones de proyecto: .cursor/agents/, .claude/agents/, .codex/agents/. Ubicaciones de usuario: ~/.cursor/agents/, ~/.claude/agents/, ~/.codex/agents/.
• Los agentes de proyecto anulan a los de usuario. Cuando los nombres coinciden, .cursor/ gana sobre .claude/ o .codex/.
• Campos: name (por defecto, el nombre del archivo), description, model (por defecto inherit), readonly (por defecto false), is_background (por defecto false).
• Subagentes integrados: explore (usa un modelo más rápido por defecto) y browser (controla el navegador mediante herramientas MCP).
• Invocación: el agente delega según la descripción, o llamas a uno con /name en un prompt, como /verifier, o nombrando al subagente.
• Paralelo y segundo plano: varias llamadas a la herramienta Task en un mismo mensaje se ejecutan al mismo tiempo. is_background: true regresa de inmediato. Los subagentes pueden ejecutarse en su propio Git worktree o en una VM en la nube. /in-cloud ejecuta la siguiente tarea como un subagente en la nube, y /autopilot entrega un pull request a un subagente en la nube.
• Modelo: inherit o un ID de modelo, con opciones entre corchetes como claude-opus-5[effort=high].
• Límites de herramientas: los subagentes heredan todas las herramientas del padre. readonly: true es el único campo de restricción documentado.

Los agentes de Gemini CLI son archivos Markdown con frontmatter YAML. El cuerpo se convierte en el system prompt del agente. Los subagentes están habilitados por defecto.

• Ubicaciones: .gemini/agents/*.md (proyecto) y ~/.gemini/agents/*.md (usuario).
• Campos: name y description (obligatorios), kind (local o remote, por defecto local), tools, mcpServers, model (por defecto inherit), temperature (por defecto 1), max_turns (por defecto 30), timeout_mins (por defecto 10).
• Subagentes integrados: codebase_investigator, cli_help y generalist están activos por defecto. browser_agent está desactivado por defecto y necesita Chrome 144 o posterior.
• Invocación: delegación automática, o empieza el prompt con @ y el nombre, como @codebase_investigator. Cada subagente se expone al agente principal como una herramienta con el mismo nombre.
• Modelo: defínelo por agente con model, o anúlalo en settings.json con agents.overrides.
• Límites de herramientas: la lista tools admite los comodines *, mcp_* y mcp_server_*. Los subagentes no pueden llamar a otros subagentes. Las reglas de policy.toml pueden apuntar a un subagente con la propiedad subagent.
• Desactiva los subagentes con "experimental": { "enableAgents": false } en settings.json. Adminístralos con /agents.

---
name: my-agent
description: When the main agent should call this subagent
tools:
  - mcp_*
model: inherit
max_turns: 30
---

System prompt for the subagent goes here.

Los agentes personalizados de Copilot son perfiles de agente: archivos Markdown con frontmatter YAML. El cuerpo contiene el prompt, de hasta 30,000 caracteres. El nombre del archivo, sin .md ni .agent.md, es el identificador del agente.

• Ubicaciones en Copilot CLI: .github/agents/ (proyecto) y ~/.copilot/agents/ (usuario), con la extensión .agent.md. La versión del directorio personal gana si hay conflicto de nombres.
• Ubicaciones del cloud agent: .github/agents/ en un repositorio, o /agents/ en el repositorio .github o .github-private de una organización. Los agentes de enterprise viven en un repositorio .github-private. Un agente de repositorio anula a uno de organización, que a su vez anula a uno de enterprise.
• Campos: description (obligatorio), name (nombre visible opcional), target (vscode o github-copilot), tools, model, disable-model-invocation, user-invocable, mcp-servers, metadata. infer está retirado.
• Agentes integrados de la CLI: explore, task, general-purpose, code-review, research (solo vía /research) y rubber-duck (se ejecuta con un modelo distinto).
• Invocación en la CLI: /agent en modo interactivo, nombrando al agente en un prompt, por inferencia a partir de la descripción, o copilot --agent <name> --prompt "...".
• Paralelo: los agentes se ejecutan como subagentes con ventanas de contexto separadas, en paralelo cuando corresponde.
• Límites de herramientas: omite tools o usa ["*"] para todas las herramientas, enumera alias como read, edit, search, execute, agent, web y todo, o usa [] para desactivarlas todas. Las herramientas MCP usan server/tool o server/*.

---
name: reviewer
description: Reviews pull requests for security issues
tools: ["read", "search"]
---

Review the changes and report security problems.

• Necesitas el control más fino sobre las herramientas: Claude Code tiene allowlist y denylist, además de modo de permisos por agente, hooks y aislamiento con worktree. Copilot también tiene una lista tools con alias y espacios de nombres MCP.
• Quieres una carpeta de agentes que funcione en más de una herramienta: Cursor lee .claude/agents/ y .codex/agents/ además de .cursor/agents/.
• Quieres workers en paralelo con una sola respuesta combinada: Codex documenta cómo lanzar muchos agentes y devolver una única respuesta consolidada.
• Quieres ejecuciones en segundo plano o en la nube: Claude Code (subagentes en segundo plano, Ctrl+B) y Cursor (is_background, subagentes en la nube) lo documentan. La página de Gemini CLI no.
• Necesitas agentes compartidos en toda la organización en GitHub: Copilot admite perfiles de agente de organización y enterprise en un repositorio .github o .github-private.
• Quieres ajustar el muestreo por agente: Gemini CLI documenta los campos temperature, max_turns y timeout_mins.