Cómo usar Cursor: guía completa

Cursor es un editor de código creado originalmente por Anysphere, construido sobre la base de código abierto de VS Code, con un agente de inteligencia artificial integrado en el propio editor —no añadido como una extensión aparte— capaz de leer y modificar varios archivos, ejecutar comandos y trabajar de forma autónoma en tareas de varios pasos.

Al estar basado en VS Code, conserva sus atajos, temas y la mayoría de sus extensiones, aunque usa el registro Open VSX en lugar del Marketplace oficial de Microsoft.

Cambio corporativo reciente y relevante: SpaceX completó el 14 de agosto de 2026 una adquisición de Anysphere en una operación íntegramente en acciones valorada en 60.000 millones de dólares, confirmada por múltiples medios (CNBC, Yahoo Finance, Quartz, Motley Fool). Cursor mantiene su marca y sigue operando como producto independiente, ahora integrado en una división interna llamada "SpaceXAI". No se encontró una declaración propia de cursor.com sobre qué implica este cambio de propiedad para el tratamiento de los datos de los usuarios — algo que merece la pena vigilar, sobre todo para equipos con requisitos de cumplimiento.

1. 1. Descargar Cursor

   Entra en cursor.com y descarga la aplicación para tu sistema operativo, o instala la CLI.

2. 2. Abrir tu proyecto

   Si vienes de VS Code, Cursor puede importar tus atajos, tema y extensiones automáticamente.

3. 3. Empezar con el plan gratuito

   El plan Hobby no pide tarjeta y permite probar el autocompletado (Tab) y el agente con límites de uso.

4. 4. Configurar .cursorignore

   Define, con sintaxis de gitignore, qué archivos quedan fuera del indexado, del autocompletado y de las herramientas del agente — importante en repositorios grandes para reducir ruido y tiempo de indexado.

5. 5. Activar el modo de privacidad

   Recomendado si vas a trabajar con código privado o sensible — evita que tus conversaciones se usen para entrenar modelos, y está disponible incluso en el plan gratuito.

La propia documentación de Cursor da una plantilla explícita para un buen encargo al agente: describir el objetivo, la zona del código a tocar, el comportamiento esperado, qué NO debe tocarse, y cómo se comprueba que la tarea está terminada (por ejemplo, que pasen los tests).

1. 1. Abrir el panel de Agent y elegir modelo

   Según el equilibrio deseado entre velocidad, coste y capacidad de razonamiento.

2. 2. Escribir el encargo con objetivo, alcance y criterio de éxito

   Cuanto más concreto, menos probable que el agente toque algo fuera de lo pedido.

3. 3. Dejar que explore el repositorio y proponga un plan

   El agente busca y lee el código relevante antes de editar nada.

4. 4. Revisar el diff antes de aceptar

   La propia guía de buenas prácticas de Cursor advierte explícitamente contra aceptar cambios multi-archivo sin revisar — un pitfall real y repetido: el agente a veces borra y recrea un archivo entero en vez de editarlo, lo que destruye el historial de git y puede reintroducir errores ya corregidos.

5. 5. Dividir tareas grandes en subtareas

   Para trabajos extensos, encargar partes más pequeñas por separado suele dar mejor resultado que un único encargo enorme.

Las reglas viven como archivos .mdc dentro de .cursor/rules/ (el antiguo archivo único .cursorrules en la raíz del proyecto sigue funcionando pero está marcado como heredado). Cursor también recoge automáticamente un archivo CLAUDE.md en la raíz del proyecto si existe, y lo aplica siempre — un dato útil de interoperabilidad entre herramientas de distintos fabricantes.

• Always Apply: la regla se aplica en cada conversación.
• Apply Intelligently: el propio agente decide cuándo es relevante.
• Apply to Specific Files: coincidencia con un patrón de archivos (por ejemplo, *.tsx).
• Apply Manually: solo cuando se menciona explícitamente en el chat.

Cursor CLI ofrece los mismos modos que el editor pero desde terminal: modo Agent (ejecuta directamente), modo Plan (diseña un enfoque antes de tocar código) y modo Ask (explora y responde sin editar nada) — una forma segura de pedirle primero que investigue antes de dejarle escribir. Los agentes en la nube, por su parte, clonan el repositorio (GitHub, GitLab, Azure DevOps o Bitbucket Cloud), trabajan en una rama separada y devuelven los cambios para revisión — se pueden lanzar desde el propio editor, la web, la app de iOS, Slack, GitHub, Bitbucket o Linear.

• Tab: autocompletado multi-línea que predice a partir del archivo, el contexto del proyecto y ediciones recientes, con salto automático al siguiente punto que necesita el mismo cambio tras aceptar una sugerencia (útil en renombrados repetitivos).
• Agent: lee y escribe en varios archivos, ejecuta comandos de terminal y corrige errores por su cuenta, con puntos de control para revertir cambios.
• Cursor Rules: convenciones del proyecto en archivos .mdc, con distintos modos de aplicación.
• Cursor CLI: los mismos modos de trabajo (Agent, Plan, Ask) desde la terminal, con detección automática de servidores MCP.
• Agentes en la nube: tareas en un entorno remoto y aislado, lanzables desde el editor, la web, iOS, Slack, GitHub, Bitbucket o Linear.
• Bugbot: revisión de código automatizada en cada pull request, ahora con facturación por uso en vez de una cuota fija mensual.
• Acceso a modelos de varios proveedores (OpenAI, Anthropic, Google, xAI y el modelo propio Composer), eligiendo el equilibrio entre inteligencia, velocidad y coste según la tarea.
• Modo de privacidad, disponible incluso en el plan gratuito.

Cursor tiene un plan gratuito (Hobby) sin tarjeta de crédito, con solicitudes limitadas del agente. Los planes de pago individuales (Pro, Pro+, Ultra) amplían esos límites y añaden acceso a más modelos, agentes en la nube y Bugbot; existen también planes de equipo (Teams) y un plan Enterprise personalizado con facturación centralizada, control de acceso por repositorio/modelo/MCP y registros de auditoría. El consumo de los modelos más avanzados puede facturarse por uso además de la cuota del plan. Cambio real detectado desde la última verificación: Bugbot pasó de una suscripción fija de 40 $/asiento/mes a facturación puramente por uso (coste medio citado de 1-1,5 $ por pull request revisado, según el tamaño), y el modo "Auto" de tarifa plana se retiró para clientes individuales. Los precios y límites exactos cambian con cierta frecuencia — la fuente fiable siempre es cursor.com/pricing.

• Generar una función o un componente nuevo a partir de una descripción en lenguaje natural.
• Refactorizar código existente en varios archivos a la vez.
• Depurar un error explicando el síntoma al agente, sin tener que localizar la causa a mano.
• Escribir pruebas automáticas para código ya existente.
• Aplicar el mismo cambio en varios archivos de golpe con el agente.
• Lanzar una tarea larga en un agente de la nube mientras se sigue trabajando en otra cosa en local.

• Encargos vagos: la causa más citada de resultados pobres es no especificar objetivo, alcance y criterio de éxito con claridad.
• Aceptar diffs multi-archivo sin revisar: el agente puede tocar algo fuera del alcance pedido, o borrar y recrear un archivo en vez de editarlo, perdiendo el historial de git.
• No tener en cuenta el coste de los modelos de frontera: usar manualmente un modelo caro consume la cuota de uso incluida del plan más rápido que dejar la selección de modelo en automático.
• Ignorar .cursorignore en repositorios grandes: sin ajustarlo, el indexado tarda más y la recuperación de contexto trae más ruido irrelevante.
• Confundir qué modelo usar para qué: hay varios hilos de la propia comunidad de Cursor preguntando explícitamente cuándo usar el modelo propio frente a uno de frontera — es una confusión real, no hipotética.
• Asumir cobertura total del repositorio: incluso con ventanas de contexto grandes, un monorepo real puede tener muchísimos más tokens de los que caben de una vez — Cursor depende de recuperación (embeddings + búsqueda), que puede fallar en refactors que cruzan varios servicios.

• El uso de los modelos más avanzados puede facturarse por consumo más allá de lo incluido en cada plan, y Bugbot ahora es puramente de pago por uso.
• No tiene acceso directo al Marketplace oficial de extensiones de Microsoft; usa el registro Open VSX, por lo que alguna extensión concreta puede no estar disponible.
• Delegar tareas a un agente que edita varios archivos exige revisar los cambios con atención, sobre todo en código en producción.
• El cambio de propiedad hacia SpaceX es reciente y no se ha encontrado una declaración pública propia de Cursor sobre su impacto en el tratamiento de datos — un punto a vigilar para compradores de nivel Enterprise.