Guía completa del modo Agent de Cursor: 3 pasos para programar con automatización (2026)

Actualizado el 2026-06-08: revisado con la documentación oficial de Cursor — abre Agent con ⌘/Ctrl + I y cambia entre Agent / Ask / Plan / Debug con Shift + Tab; el antiguo «modo Yolo» ahora se llama «Auto-run» (en los ajustes de Agent, con una lista de comandos permitidos en lenguaje natural); y la lista de modelos refleja ahora las versiones actuales de Claude / GPT / Gemini además del modo Auto.

Hace unos días estaba corrigiendo un bug y en Cursor Chat intercambié más de diez rondas con la IA. La IA decía «puedes cambiarlo así», yo copiaba el código, pegaba, ejecutaba y obtenía un error; volvía a preguntar, la IA proponía otra solución, otra vez copiar y pegar… un ciclo sin fin.

Luego, al ejecutar el proyecto, faltaba una dependencia. La IA me dijo «tienes que ejecutar npm install xxx» y tuve que ir a la terminal a escribirlo manualmente. En ese momento pensé: si la IA ya sabe qué instalar, ¿por qué no puede hacerlo por mí?

Hasta que descubrí el modo Agent de Cursor. Todo cambió. Agent ya no solo «da consejos»: trabaja de verdad por ti: crea archivos, ejecuta comandos y corrige bugs automáticamente. La verdad es que la primera vez me sorprendió: la programación con IA puede ser tan automatizada.

En este artículo aprenderás a activar el modo Agent en 3 pasos y verás 5 casos prácticos para empezar. Al terminar, verás que gran parte del trabajo repetitivo de desarrollo puede delegarse en la IA.

¿Qué es el modo Agent?

Una analogía sencilla

Si comparas los distintos modos de Cursor con miembros de un equipo:

• Modo Chat es como un consultor: le preguntas y te aconseja, pero tú ejecutas
• Modo Agent es como un asistente: le das una tarea y la completa, incluyendo crear archivos, ejecutar comandos y corregir errores

Por eso Cursor llama a Agent «el modo con mayor capacidad de conducción autónoma»: de verdad trabaja por sí solo.

El modo Agent se lanzó el 24 de noviembre de 2024 con Cursor 0.43. Hasta ahora (enero de 2026), se ha convertido en la herramienta principal de muchos desarrolladores.

Agent vs Chat: ¿en qué se diferencian?

Aquí tienes una tabla comparativa:

Un ejemplo concreto:

Modo Chat:

• Tú: «Ayúdame a crear un componente de login»
• IA: «De acuerdo, aquí está el código… (un bloque largo)»
• Tú: (copias y pegas en un archivo nuevo)

Modo Agent:

• Tú: «Ayúdame a crear un componente de login»
• IA: (crea Login.tsx, escribe el código, añade los import necesarios y, si falta alguna dependencia, la instala)
• Tú: (no haces nada; ya está listo para usar)

La diferencia es evidente.

Las 4 capacidades clave de Agent

Por mi experiencia, Agent tiene estas «superpotencias»:

1. Búsqueda automática en el código

• Usa búsqueda semántica para encontrar código relacionado rápidamente
• No hace falta decirle «mira src/utils/auth.ts»; lo encuentra solo

2. Creación y modificación de varios archivos

• Puede cambiar varios archivos a la vez (por ejemplo, al añadir una función: componente, rutas, API)
• Mantiene el estilo de código y completa los import automáticamente

3. Ejecución automática de comandos de terminal

• Instalar dependencias: npm install
• Arrancar el servicio: npm run dev
• Ejecutar pruebas: npm test
• Con Yolo activado, ni siquiera necesitas confirmar; se ejecuta directamente

4. Lectura de errores y corrección automática

• Ve los mensajes de error de la terminal
• Analiza el problema (¿falta una dependencia? ¿error de código? ¿configuración?)
• Corrige automáticamente y reintenta si no puede arreglarlo

3 pasos para activar el modo Agent

Método 1: atajo de teclado (el más rápido)

Es lo que más uso; se activa en 1 segundo:

• Abrir el panel Agent: en Mac ⌘ + I, en Windows/Linux Ctrl + I
• Cambiar de modo: Shift + Tab recorre Agent / Ask / Plan / Debug

Se abre el panel de Agent. (Las versiones antiguas también respondían a ⌘/Ctrl + .; las recientes unifican en ⌘/Ctrl + I.)

Método 2: cambio en la interfaz (recomendado para principiantes)

Si es tu primera vez, mejor cambiar desde la interfaz para verlo con claridad:

Alibaba Cloud - Opción preferida para desarrolladores, 15 % de descuento exclusivo en Lighthouse

Obtener 15% dto. →Anuncio

1. Abre Cursor y haz clic en el panel Composer a la derecha (o usa ⌘/Ctrl + I)
2. En la parte superior del panel verás el selector de modo
3. Elige el modo Agent
4. El texto del cuadro de entrada cambiará a algo como «Tell me what to build…»

Ya tienes Agent activado.

Cómo comprobar que funciona

¿Cómo saber si Agent está activo? Fíjate en estas señales:

• ✅ Aparece «Agent mode» o una etiqueta similar
• ✅ El placeholder del cuadro de entrada cambia (ya no es «pregúntame sobre código», sino «dime qué quieres construir»)
• ✅ En la barra de herramientas hay opciones extra (como el interruptor de Yolo)

Si no ves esto, puede que no se haya activado; repite los pasos anteriores.

Configuración recomendada (opcional pero útil)

Tras activar Agent, te conviene ajustar estos ajustes:

1. Activar Auto-run (antes modo Yolo)

• Ubicación: ajustes de Agent (las versiones recientes renombraron «Yolo» como «Auto-run»)
• Función: ejecuta comandos de terminal sin confirmación cada vez; puedes describir en lenguaje natural qué comandos (tests, builds, lint) pueden ejecutarse solos
• Nota: solo se autoaceptan los comandos de terminal — los cambios de archivos siguen mostrando un diff para confirmar

Sinceramente, suelo tener Auto-run activado salvo en proyectos de producción muy importantes.

2. Solo para Windows: cambiar a Git Bash

• Por qué: Agent genera comandos al estilo Linux y CMD nativo puede no soportarlos
• Cómo: Ajustes → Terminal → Perfil predeterminado → Git Bash

3. Elegir el modelo de IA

• Por defecto a diario: Auto (Cursor elige el mejor modelo para cada tarea)
• Trabajo multi-archivo / refactorizaciones complejas: Claude Sonnet 4.6 o Claude Opus 4.8
• Razonamiento / planificación: GPT-5.5
• Bases de código muy grandes: Gemini 3.1 Pro (mayor contexto)

Los modelos disponibles cambian con las actualizaciones de Cursor — el desplegable de modelos en la parte superior del panel de chat es la referencia.

5 casos prácticos: qué puede hacer Agent

La teoría no basta. Aquí van 5 escenarios reales para ver Agent en acción.

Caso 1: crear un proyecto Todo List desde cero (nivel básico)

Escenario: quieres montar rápido una app React Todo List sin configurar el proyecto manualmente.

Enfoque tradicional:

1. Crear el proyecto: npx create-react-app my-todo
2. Instalar TypeScript: npm install --save-dev typescript
3. Configurar tsconfig.json
4. Crear carpetas de componentes
5. Escribir TodoList.tsx, TodoItem.tsx…
6. (media hora como mínimo)

Con Agent:

Abre Agent y escribe:

Ayúdame a crear un proyecto Todo List con React + TypeScript

Y puedes ir a por un vaso de agua. Cuando vuelvas, Agent ya habrá:

• ✅ Creado la estructura de carpetas
• ✅ Generado package.json
• ✅ Escrito App.tsx, TodoList.tsx, TodoItem.tsx
• ✅ Ejecutado npm install
• ✅ Posiblemente añadido estilos básicos

Todo el proceso tarda 3-5 minutos; solo revisas el código al final.

Consejo para principiantes: si hay un error a mitad de camino, Agent suele reintentar. En mis pruebas, la tasa de éxito es bastante alta.

Caso 2: instalar dependencias automáticamente (escenario frecuente)

Escenario: clonas un proyecto de GitHub y al hacer npm start aparece:

Error: Cannot find module 'axios'

Enfoque tradicional:

1. Lees el error y ves que falta axios
2. Ejecutas npm install axios
3. Vuelves a arrancar y falta react-router-dom
4. Instalas otra vez… (y así sucesivamente)

Me pasaba a menudo y era muy molesto.

Con Agent:

Pega el error directamente:

Al ejecutar el proyecto me sale este error, ayúdame a arreglarlo:
Error: Cannot find module 'axios'

Agent:

1. Analiza el error y detecta que falta axios
2. Ejecuta npm install axios
3. Comprueba si faltan otras dependencias
4. Si sigue fallando, sigue corrigiendo

Dato real: según la comunidad, la tasa de éxito al corregir dependencias automáticamente ronda el 70%. Si tras 2 intentos no lo consigue, pídele que añada logs para mejorar las probabilidades.

Caso 3: corregir bugs automáticamente (escenario central)

Escenario: tienes un código que falla al ejecutarse y no ves dónde está el problema.

Por ejemplo:

function calculateTotal(items) {
  return items.reduce((sum, item) => sum + item.price, 0)
}

calculateTotal(null) // error

Enfoque tradicional:

1. Lees el error: Cannot read property 'reduce' of null
2. Consultas documentación y Stack Overflow
3. Descubres que hace falta comprobar null
4. Modificas el código manualmente

Con Agent:

Selecciona el código y dile:

Aquí hay un error al ejecutar, ayúdame a corregirlo

Agent:

1. Lee el log de error
2. Detecta que items puede ser null
3. Modifica el código:

function calculateTotal(items) {
  if (!items) return 0
  return items.reduce((sum, item) => sum + item.price, 0)
}

4. Comprueba si la corrección funciona

Truco avanzado:

Railway - Plataforma de despliegue moderna, sin ops complejas, en producción en minutos

Empezar ahora →Anuncio

Si tras 2 intentos sigue fallando, prueba:

Añade console.log en puntos clave primero para localizar el problema

Con logs, Agent localiza mejor el bug y la tasa de éxito puede superar el 70%.

Es el escenario que más uso; voy mucho más rápido que depurando yo solo.

Caso 4: desarrollo de funciones en varios archivos (nivel intermedio)

Escenario: tu proyecto ya tiene una base y quieres añadir «login de usuario».

La función requiere:

• Componente de login (Login.tsx)
• Configuración de rutas (routes.ts)
• Lógica de llamadas API (api.ts)
• Posiblemente cambios en el estado global

Enfoque tradicional:

• Chat te da código archivo por archivo
• Creas archivos y copias manualmente
• Mantienes las referencias entre archivos a mano

Con Agent:

Dile a Agent:

Ayúdame a añadir login de usuario: componente, rutas y llamadas API

Agent:

1. Busca en el proyecto dónde están rutas y API
2. Modifica varios archivos a la vez:
   • Crea Login.tsx
   • Actualiza routes.ts con la ruta de login
   • Añade el método login en api.ts
   • Completa los import necesarios
3. Mantiene el estilo (si usas componentes funcionales, no escribe clases)

Ahí está la gran diferencia con Chat: Agent trabaja entre archivos y entiende la arquitectura del proyecto.

Una vez le pedí modo oscuro y tocó 7 archivos correctamente; me ahorró al menos una hora.

Caso 5: pruebas automatizadas con Playwright (nivel avanzado)

Escenario: quieres pruebas end-to-end sin escribir cada caso a mano.

La combinación Agent + MCP:

Si configuras Playwright MCP (Model Context Protocol, el protocolo de extensión de Cursor), Agent puede automatizar este ciclo:

Tú: Añade pruebas E2E para el login de usuario

Agent:
1. Genera casos de prueba con Playwright
2. Ejecuta las pruebas
3. Detecta fallos (por ejemplo, selector incorrecto del botón de login)
4. Corrige el código
5. Vuelve a ejecutar las pruebas
6. Repite hasta que pasen

Todo el ciclo «requisito → prueba → corrección» queda automatizado.

Llevo poco con esta función, pero me impresionó. Antes las pruebas eran lo más tedioso; ahora la IA puede encargarse.

Consejos y precauciones al usar Agent

Tras usar Agent un buen tiempo, recopilo buenas prácticas y errores que he cometido.

4 trucos para sacar más partido a Agent

1. Instrucciones concretas, no vagas

❌ Mal:

Optimiza este código

✅ Bien:

Reduce la complejidad temporal de esta función de O(n²) a O(n) usando una tabla hash

Agent no lee tu mente; cuanto más concreto, mejor.

2. Proporciona contexto suficiente

La primera vez, explica el proyecto:

Es un proyecto React + TypeScript + Tailwind CSS con ESLint y Prettier.
Ayúdame a añadir una página de configuración de usuario.

Así el código encajará mejor con tus convenciones.

3. Usa Yolo cuando confíes en Agent

Para «montar un proyecto nuevo» o «añadir una función», Yolo permite ejecutar todos los comandos automáticamente.

Para «modificar lógica de negocio central», mejor desactivar Yolo y confirmar cada paso.

4. Aprovecha los puntos de control

Antes de modificar, Agent crea un punto de control (como el staging de Git). Si algo sale mal:

Vultr - Servidor cloud NVMe de alto rendimiento, 32 ubicaciones globales, despliegue Docker con un clic

Ver precios →Anuncio

• Pulsa Ctrl+Z para deshacer
• O dile: «La última modificación tiene un problema, vuelve a la versión anterior»

No tengas miedo de probar; siempre puedes deshacer.

Guía para evitar errores comunes

Resumen de lo que me ha pasado:

❌ No des tareas demasiado complejas de una vez

• Por ejemplo «refactoriza todo el proyecto»; Agent también se pierde
• Mejor dividir: «primero el módulo Auth, luego…»

❌ No cambies de archivo constantemente mientras Agent trabaja

• Puede interrumpir su flujo
• Espera a que termine antes de revisar

❌ No dejes que Agent modifique directamente proyectos críticos

• Haz git commit antes
• Trabaja en una rama
• Fusiona cuando las pruebas pasen

✅ Practica primero en proyectos pequeños

• Todo List, calculadora, etc.
• Cuando te sientas cómodo, úsalo en proyectos reales

✅ Usa deshacer y reintentar

• Si algo sale mal, deshaz; no pasa nada
• Agent también se equivoca; prueba varias veces

Para cerrar

Al escribir esto repasé cómo cambió mi forma de trabajar desde que probé Cursor Agent.

Antes dedicaba el 50% del tiempo a la lógica y el otro 50% a tareas repetitivas: crear archivos, copiar y pegar, instalar dependencias, cambiar configuración, corregir bugs menores…

Con Agent, casi todo eso lo hace la IA. Yo me centro en «qué quiero construir» y Agent se encarga del resto.

Después de usarlo, ya no quiero volver atrás.

Pruébalo ahora

Si has llegado hasta aquí, abre Cursor y prueba:

1. Pulsa ⌘ + . (o Ctrl + .) para activar Agent
2. Empieza por lo simple: «Ayúdame a corregir este bug»
3. O crea un proyecto pequeño: «Hazme un Todo List sencillo»

Poco a poco verás que Agent puede ahorrarte un 30%-50% del tiempo de desarrollo.

No tengas miedo de equivocarte; si Agent cambia mal algo, Ctrl+Z. Lo importante es dar el primer paso.

Lecturas relacionadas (en este blog)

• Guía completa de indexación del código en Cursor
• Resolución completa de problemas de red en Cursor
• Guía completa del nivel gratuito de Cursor

Recursos para profundizar

Si quieres ir más allá:

Documentación oficial:

• Resumen de Cursor Agent
• Modos de Agent
• Funciones de Cursor

Tutoriales prácticos:

• Guía para principiantes de Cursor Agent
• Cómo usar el modo Agent de Cursor

Comunidad en chino:

• Cursor 效率之道：Agent 模式 + 7 大高级技巧
• 72 小时研究 Cursor Agents 的硬核干货
• Cursor 实战万字经验分享

Vídeos:

• Cursor 0.43 全新升级 Agent 功能深度解析

Última palabra

¿Para qué quieres usar Agent? ¿Corregir bugs automáticamente, montar proyectos rápido u otra cosa?

Comparte en los comentarios tus ideas o experiencias con Agent. Me gustaría saber qué estáis haciendo con él.

Happy Coding! 🚀