Guía · Principiante · 12 min
Cursor, guía de referencia: editor de código con IA, modos, reglas, precios y límites
Cursor combina un editor de código con agentes IA. Conozca sus modos, reglas, precios y un método para modificar sus proyectos sin perder el control del trabajo.

Cursor reúne un editor de código y agentes IA capaces de explorar un proyecto, preparar un plan y modificar archivos. Para utilizarlo correctamente, debe elegir el modo adecuado, aportar un contexto preciso, controlar los permisos y revisar los cambios. El coste depende de la suscripción, de los modelos utilizados y del consumo adicional.
Qué hace Cursor y qué sigue siendo responsabilidad suya
Cursor permite pasar de una pregunta sobre el código a una intervención en el proyecto. Esa continuidad resulta práctica, pero acerca dos actividades distintas: recibir una explicación y autorizar a un programa para que actúe.
Un agente de programación puede buscar los archivos relevantes, proponer una corrección, aplicarla y después utilizar la terminal para comprobar el resultado. A usted le corresponde evaluar si el cambio resuelve la necesidad, respeta las restricciones del proyecto y se puede incorporar.
Veamos un ejemplo ficticio: un formulario acepta una dirección no válida. Una petición útil especifica el comportamiento esperado, los archivos que probablemente intervienen y cómo comprobar la corrección. Si pide una mejora general del formulario, deja más decisiones en manos del modelo y aumenta el riesgo de que el trabajo se extienda más allá de lo previsto.
Por tanto, debe examinar el conjunto del resultado: cambios en los archivos, comandos ejecutados, pruebas y explicación de las limitaciones. Un mensaje que anuncia que la tarea ha terminado no demuestra que se hayan realizado todas las comprobaciones necesarias.
Nuestro artículo sobre cómo funcionan los agentes de programación explica este ciclo de acciones. Esta guía presenta un método de trabajo con Cursor que puede mantener a lo largo del tiempo; el catálogo de herramientas de IA permite situar este uso entre las demás familias de herramientas.
Elegir entre explorar, planificar y modificar
Antes de empezar, decida qué acciones autoriza para la tarea. Comprender una arquitectura, elegir un enfoque y modificar una aplicación requieren distintos niveles de autonomía.
| Criterio | Ask | Plan | Agent |
|---|---|---|---|
| Objetivo | Comprender el código | Preparar una intervención | Realizar un cambio |
| Trabajo esperado | Búsqueda y explicación | Exploración y plan revisable | Edición y uso de herramientas |
| Momento adecuado | Primer contacto con un proyecto | Necesidad ambigua o que afecta a varias partes | Alcance suficientemente definido |
| Resultado que debe revisar | Referencias y razonamiento | Supuestos y pasos | Diferencias entre archivos y comprobaciones |
La documentación oficial describe Plan Mode como una fase de investigación y aclaración previa a la escritura del código. Puede revisar y corregir el plan antes de iniciar su ejecución. Esto resulta útil cuando una petición admite varios enfoques.
Para una corrección localizada, un plan extenso no siempre aporta mucho. Puede solicitar directamente una intervención limitada e indicar los criterios de aceptación. En cambio, una migración o un cambio en la autenticación merecen una revisión del enfoque antes de modificar nada.
No confunda un modo de trabajo con una garantía de seguridad. El modo organiza la tarea; los permisos y los accesos disponibles determinan lo que el entorno permite hacer en la práctica. Revise ambos aspectos antes de cualquier intervención delicada.
Requisitos previos: preparar un proyecto que pueda recuperar
Para empezar, necesita una cuenta de Cursor, una conexión de red y un proyecto que tenga autorización para enviar a los servicios utilizados. Instale también el entorno que requiera ese proyecto: el editor no sustituye su intérprete, su compilador ni sus dependencias.
Elija primero un repositorio de aprendizaje o una copia de trabajo sin datos sensibles. Debe saber cómo iniciar la aplicación y reconocer su funcionamiento normal. Sin esa referencia, un cambio puede parecer correcto y, al mismo tiempo, romper otra parte del uso de la aplicación.
Antes de pedir cualquier tarea al agente:
- guarde el trabajo existente e identifique los cambios que ya estaban presentes;
- prepare una rama específica si utiliza Git;
- localice las instrucciones de desarrollo y las pruebas disponibles;
- retire los secretos y los accesos de producción que no sean necesarios;
- defina el resultado esperado y las operaciones que requieren aprobación.
No pida al agente que limpie de forma indiscriminada una carpeta que contenga trabajo sin guardar. Sin una explicación, le resultará difícil distinguir entre una modificación deliberada suya y un archivo temporal.
Para quien empieza, el primer objetivo debe ser modesto: obtener una corrección comprensible y reversible. La guía para trabajar bien con un agente de programación profundiza en cómo dividir las tareas y revisar los resultados.
Instalar Cursor y preparar la primera sesión
1. Instalar la aplicación de escritorio
Utilice la página oficial de descargas y elija el paquete correspondiente a su sistema y a la arquitectura de su equipo. Cursor ofrece una aplicación para macOS, Windows y Linux, según la página consultada el 24 de octubre de 2026.
Después, abra una carpeta de proyecto concreta. Evite utilizar como espacio de trabajo toda su carpeta personal o un directorio que reúna proyectos de varios clientes. Un alcance claro facilita la búsqueda y reduce la exposición de archivos ajenos a la tarea.
Inicie sesión con su cuenta y revise la configuración de privacidad, el modelo seleccionado y las opciones de ejecución. En la primera sesión, mantenga la aprobación explícita de las operaciones que todavía no comprenda.
2. Instalar la CLI solo si la necesita
La CLI es una interfaz adicional para trabajar desde la terminal. No hace falta instalarla para seguir este método en la aplicación de escritorio.
Los siguientes comandos proceden de la documentación oficial de instalación de Cursor CLI, comprobada el 24 de octubre de 2026. En macOS, Linux o Windows con WSL:
curl https://cursor.com/install -fsS | bash
En Windows nativo, desde PowerShell:
irm 'https://cursor.com/install?win32=true' | iex
Estos comandos descargan y ejecutan un script. Si trabaja en un entorno profesional administrado, siga el procedimiento de instalación autorizado.
Compruebe después la instalación:
agent --version
Inicie una sesión interactiva:
agent
El comando de actualización que recoge la documentación es:
agent update
3. Conocer el estado del proyecto antes de modificarlo
Pida primero una explicación del proyecto: punto de entrada, organización de carpetas, procedimiento de inicio y ubicación de las pruebas. Solicite las rutas de los archivos para poder comprobar las respuestas.
Si el agente no encuentra una información, pídale que lo indique. Un comando de pruebas deducido sin confirmar puede producir un resultado que no tenga relación con el procedimiento que utiliza realmente el proyecto.
Realizar un primer cambio bajo control
4. Formular una petición verificable
Una buena petición incluye el problema, el resultado esperado, el alcance y las restricciones. Este ejemplo de instrucciones puede servirle como base:
El formulario acepta una dirección vacía.
Localice la validación existente y explique la causa.
Proponga una corrección limitada a este comportamiento.
No añada dependencias.
Añada o adapte una prueba pertinente.
Pida mi aprobación antes de realizar cualquier operación en una base de datos.
Estas instrucciones son un ejemplo editorial, no un comando integrado en Cursor. Sustituya cada restricción por un requisito real del proyecto.
Evite reunir en una sola petición una corrección, un rediseño visual y una reorganización técnica. Los cambios separados son más fáciles de revisar y de descartar de forma independiente.
5. Revisar el plan y los permisos
Si utiliza Plan, compruebe los archivos que se prevé modificar, los supuestos y las pruebas propuestas. Pida que se aclaren los aspectos desconocidos antes de iniciar la ejecución.
Cuando un comando solicite autorización, lea su contenido y compruebe el directorio en el que se ejecutará. Un comando aparentemente habitual puede actuar sobre un servicio remoto o llamar a un script cuyos efectos no se deducen de su nombre.
6. Comprobar el resultado antes de incorporarlo
Revise las diferencias entre archivos. Busque cambios que queden fuera del alcance acordado, eliminaciones, nuevas dependencias y modificaciones de configuración.
Ejecute las comprobaciones pertinentes del proyecto y reproduzca después el recorrido de uso afectado. Por último, pida un informe que distinga qué se ha ejecutado, qué ha funcionado y qué falta por comprobar. Mantenga en sus manos la decisión de incorporar los cambios.
Aportar contexto sin enviar todo el repositorio
Un agente puede trabajar a partir de un supuesto equivocado si no tiene acceso a los archivos relevantes. En el otro extremo, acumular documentos sin relación con la tarea dificulta que siga la petición.
Para cada tarea, indique el comportamiento observado, el resultado esperado y las referencias pertinentes: un archivo, un mensaje de error, una prueba existente o una directriz de arquitectura. Es preferible un ejemplo reproducible a una descripción larga e imprecisa.
La ventana de contexto representa la cantidad de información que un modelo puede procesar durante un intercambio. No garantiza que comprenda todo el repositorio ni que tenga en cuenta correctamente cada detalle.
Si la conversación se desvía, detenga las modificaciones y reformule el problema a partir de los hechos confirmados. Una nueva sesión con un resumen centrado en la tarea puede ser más fácil de controlar que una acumulación de correcciones contradictorias.
Separe también los datos de las instrucciones. Una incidencia, un comentario de código o una página externa pueden contener una inyección de instrucciones. Su contenido no debería autorizar una transferencia de archivos, un comando ni un cambio de permisos.
Una indicación práctica consiste en pedir al agente que señale las instrucciones operativas que encuentre en esos contenidos antes de seguirlas. Esta medida complementa las restricciones técnicas, pero no las sustituye.
Escribir reglas útiles y fáciles de mantener
Las reglas oficiales de Cursor incluyen, entre otras, reglas de usuario, reglas de proyecto, reglas de equipo y el archivo AGENTS.md. Las reglas de proyecto se guardan en .cursor/rules con la extensión .mdc.
Una regla puede aplicarse siempre, estar vinculada a determinados archivos, seleccionarse según su pertinencia o activarse manualmente. Colocar un archivo Markdown cualquiera en .cursor/rules no sustituye el formato requerido.
Este es un ejemplo editorial de regla de proyecto que puede adaptar:
---
alwaysApply: true
---
- Lea las instrucciones de desarrollo antes de modificar el proyecto.
- Respete las convenciones existentes.
- No añada dependencias sin explicar por qué son necesarias.
- No modifique los archivos generados.
- Presente las comprobaciones realizadas y las limitaciones pendientes.
Guarde las preferencias personales en las reglas de usuario y las convenciones compartidas en el repositorio. Reserve las reglas especializadas para los archivos a los que correspondan.
Una regla debe expresar un requisito verificable. Pedir código limpio deja mucho margen de interpretación; pedir que se conserve una interfaz pública proporciona un criterio concreto.
Revise las reglas junto con el código: un procedimiento desactualizado puede llevar al agente a repetir un error. Evite también las instrucciones duplicadas y contradictorias entre varios archivos. Las reglas siguen siendo indicaciones para el modelo, no barreras de seguridad.
Precios: distinguir entre suscripción y consumo
A fecha de 24 de octubre de 2026, la documentación oficial de precios presenta los siguientes planes en dólares, sin impuestos. Compruebe de nuevo los precios y las condiciones antes de contratar.
| Plan actual | Precio mensual | Uso incluido | Modelos de terceros |
|---|---|---|---|
| Free | 0 $ | Limitado | No disponibles |
| Plus | 8 $ | Básico | No disponibles |
| Premium | 30 $ | Cuatro veces el de Plus | Se facturan por separado |
| Super | 100 $ | Quince veces el de Plus | Se facturan por separado |
| Ultra | 200 $ | Cincuenta veces el de Plus | Se facturan por separado |
Los planes actuales forman parte de The X Subscription. Su cuota de uso para los modelos de Cursor es semanal y se comparte entre los servicios correspondientes. Los modelos de terceros disponibles a partir de Premium consumen crédito de prepago desde que se utilizan.
Las suscripciones anteriores, entre ellas Pro y Pro+, mantienen condiciones distintas. Por eso, no aplique una explicación antigua a un plan actual sin comprobar que siga siendo válida.
Para preparar un presupuesto, identifique su plan exacto, el modelo utilizado, el crédito disponible y los límites de gasto adicional. Revise también si está activada la recarga automática.
Después, evalúe el coste con tareas representativas: una corrección breve, una exploración y un cambio que afecte a varias partes del proyecto. Incluya el tiempo que una persona dedica a revisar el resultado y las correcciones posteriores necesarias.
El indicador útil es el coste de una tarea aceptada. Una respuesta barata que exige una revisión y corrección prolongadas puede resultar menos conveniente que una intervención más cara cuyo resultado se pueda verificar directamente.
Privacidad, secretos y herramientas MCP
Según la página de seguridad de Cursor, actualizada el 25 de agosto de 2026, Privacy Mode impide que sus datos se utilicen para el entrenamiento. El proveedor también describe controles y compromisos con sus proveedores de modelos. Esto no significa que el procesamiento se realice únicamente en su equipo.
Antes de abrir un repositorio confidencial, compruebe los compromisos aplicables a su organización, los servicios que intervendrán y los datos a los que tendrán acceso. No añada secretos a una conversación para resolver una dificultad de configuración.
El archivo .cursorignore limita el acceso de determinadas funciones de Cursor a ciertos archivos. Sin embargo, la documentación sobre archivos ignorados aclara que las herramientas de terminal y MCP pueden acceder al contenido afectado. Por tanto, este archivo no proporciona un aislamiento completo.
Cursor permite conectar herramientas externas mediante la configuración oficial de MCP. Cada conexión añade capacidades y accesos que debe examinar: lectura de documentos, consultas a un servicio o modificación de datos, según el servidor.
Para empezar, conecte únicamente una fuente necesaria y dé prioridad al acceso de solo lectura. Compruebe el origen del servidor, sus permisos y el procedimiento para revocar sus accesos.
El tutorial para instalar un servidor MCP en Cursor explica esta operación en detalle. En entornos sensibles, la guía para proteger un agente IA ayuda a organizar los permisos, el aislamiento y la aprobación humana.
Problemas frecuentes
El agente modifica demasiados archivos. Detenga la intervención y revise las diferencias antes de continuar. Reformule el alcance y separe la corrección de las mejoras opcionales. No acepte una reescritura solo porque el agente ya la haya generado.
La respuesta describe un archivo que no existe. Pida la ruta exacta y que se compruebe su existencia. Revise también si ha abierto la carpeta correcta. Una explicación plausible puede basarse en una convención general en lugar de en su proyecto.
Parece que se ha ignorado una regla. Compruebe su extensión, su alcance y su modo de aplicación. Después, pida que se verifique un requisito concreto. La presencia de un archivo no demuestra que se hayan seguido todas sus instrucciones.
No se encuentra el comando agent. Compruebe que haya instalado la CLI y vuelva a abrir la terminal. Revise la ruta de instalación y el PATH siguiendo la documentación oficial. La aplicación de escritorio y el comando de terminal son instalaciones que debe distinguir.
Las pruebas pasan, pero el problema continúa. Compruebe que la prueba reproduzca realmente el fallo inicial. Una prueba añadida después de la corrección puede limitarse a confirmar el comportamiento del nuevo código. Reproduzca también el escenario de uso.
El consumo resulta inesperado. Revise el modelo elegido, los créditos adicionales y la actividad de los servicios que comparten su cuota. Una petición en lenguaje natural no equivale necesariamente a una única llamada al modelo.
Límites y criterios de elección
Cursor puede encajar si desea trabajar dentro de un editor, seguir los cambios y alternar explicaciones con intervenciones. Aun así, debe poder dedicar tiempo a leer el código y realizar comprobaciones.
Para una persona que se inicia por completo en el desarrollo, el riesgo es aceptar un proyecto cuyas dependencias o cuyo despliegue ya no comprende. Mantenga objetivos acotados y pida explicaciones sobre cada decisión que determine la estructura o el funcionamiento del proyecto.
En un equipo, evalúe también la gestión de cuentas, las convenciones compartidas, la privacidad y el procedimiento de revisión. Una demostración que funciona con un ejemplo pequeño no basta para decidir una implantación en toda la organización.
La comparativa de Cursor y Claude Code presenta las diferencias de enfoque. Compare sobre todo las herramientas en el mismo repositorio y con los mismos criterios: corrección funcional, cambios innecesarios, comprobaciones, consumo y tiempo de revisión.
Lista de comprobación antes de incorporar un cambio
- El proyecto abierto y los datos accesibles corresponden al alcance autorizado.
- El trabajo anterior está guardado y se puede identificar.
- El modo elegido corresponde al objetivo de la sesión.
- La petición incluye un comportamiento esperado que se puede verificar.
- Las reglas necesarias están presentes y son coherentes.
- Se han revisado los comandos y los accesos sensibles.
- Se han revisado las diferencias entre archivos.
- Se han comprobado las pruebas pertinentes y el recorrido de uso afectado.
- Las limitaciones pendientes han quedado documentadas.
- Se comprenden el consumo y los gastos adicionales.
Páginas relacionadas
Preguntas frecuentes
¿Se puede usar Cursor sin saber programar?
Puede pedir explicaciones y cambios sencillos en lenguaje natural. Sin embargo, para publicar una aplicación debe poder comprobar su funcionamiento, sus dependencias y sus accesos a los datos. Que el resultado se vea bien no basta para confirmar que sea seguro.
¿Es obligatorio instalar Cursor CLI?
No. La aplicación de escritorio permite trabajar sin instalar la CLI por separado. Esta sirve para utilizar un agente desde la terminal o preparar automatizaciones. Empiece con una sola interfaz para entender los permisos y el consumo.
¿Una suscripción a Cursor incluye todos los modelos?
No. Los planes actuales distinguen entre el uso incluido de los modelos de Cursor y el consumo adicional de modelos de terceros, disponibles en determinados planes. Las suscripciones anteriores mantienen condiciones diferentes: compruebe el nombre exacto de su plan.
¿Las reglas de Cursor impiden ejecutar comandos peligrosos?
Una regla transmite una instrucción al modelo; no establece una prohibición técnica. La protección también depende de los permisos, del aislamiento del entorno y de las aprobaciones. Por tanto, una indicación de prudencia no sustituye la restricción de los derechos de acceso.
¿Se puede trabajar con un repositorio confidencial en Cursor?
Depende de los compromisos de su organización y de la configuración elegida. Revise el tratamiento de los datos, los proveedores implicados y las herramientas conectadas antes de abrir el repositorio. Evalúe Privacy Mode junto con estos elementos, sin confundirlo con una ejecución completamente local.