Cursor es un editor de código que integra inteligencia artificial directamente en tu entorno de trabajo. A diferencia de los asistentes de IA externos, Cursor entiende tu proyecto completo y te sugiere código contextualizado mientras escribes. Si estás comenzando en programación, esta herramienta te permite escribir código funcional sin memorizar cientos de sintaxis. Este tutorial te explica cómo instalar Cursor, configurar tus primeros parámetros y usar sus funcionalidades esenciales. También descubrirás los errores frecuentes a evitar y trucos para ahorrar tiempo desde tus primeras líneas de código. No se requiere experiencia previa para seguir esta guía.

¿Qué es Cursor y por qué usarlo cuando empiezas?

Cursor es un editor de código basado en Visual Studio Code que integra modelos de IA (GPT-4, Claude) para asistirte en tiempo real. En concreto, escribes una frase en lenguaje natural, Cursor genera el código correspondiente, y puedes aceptarlo o modificarlo con un clic.

¿La diferencia con un editor clásico? Cursor lee la totalidad de tu proyecto (archivos, carpetas, dependencias) para proponerte código coherente con lo que ya has escrito. Si creas una función en un archivo, Cursor sabrá usarla automáticamente en otro archivo sin que tengas que copiar nada.

Por qué es útil para un principiante:

  • Cero memorización de sintaxis: describes lo que quieres en español, Cursor lo traduce a código
  • Aprendizaje mediante ejemplos: ves inmediatamente cómo estructurar una función, un bucle o una condición
  • Corrección instantánea: Cursor detecta errores antes incluso de que pruebes tu código
  • Ahorro de tiempo: pasas menos tiempo en Stack Overflow y más tiempo construyendo tu proyecto

Según la documentación oficial de Cursor, la herramienta analiza hasta 50 000 líneas de código en contexto, lo que la hace particularmente eficaz en proyectos de tamaño medio. Para un principiante, esto significa que incluso si tu proyecto crece, Cursor sigue siendo relevante.

Cómo instalar y configurar Cursor en tu ordenador

La instalación de Cursor toma menos de 5 minutos y no requiere ninguna habilidad técnica. Aquí están los pasos precisos, ya sea que uses Windows, macOS o Linux.

Descargar Cursor

  1. Ve a cursor.sh
  2. Haz clic en "Download" (el sitio detecta automáticamente tu sistema operativo)
  3. Ejecuta el archivo descargado (.exe para Windows, .dmg para macOS, .AppImage para Linux)
  4. Sigue el asistente de instalación (haz clic en "Siguiente" hasta el final)

Primera apertura y configuración inicial

En la primera apertura, Cursor te pide tres cosas:

  • Conexión a una cuenta: puedes usar tu cuenta de Google, GitHub o crear una cuenta con tu correo electrónico
  • Elección del modelo de IA: selecciona GPT-4 si quieres versatilidad, o Claude Sonnet si trabajas en código complejo (ambos son gratuitos en versión limitada)
  • Importar tus parámetros de VS Code: si ya has usado Visual Studio Code, Cursor puede recuperar tus extensiones y atajos de teclado

Una vez conectado, llegas a la interfaz principal. Se parece a Visual Studio Code: una barra lateral a la izquierda para navegar por tus archivos, un editor en el centro para escribir tu código, y una terminal abajo para ejecutar tus programas.

Configurar los parámetros esenciales

Presiona Ctrl + , (Windows/Linux) o Cmd + , (macOS) para abrir los parámetros. Aquí están los tres ajustes a modificar en prioridad:

  • Auto-completado: activa "Cursor Tab" para que la IA sugiera código mientras escribes
  • Modelo por defecto: elige GPT-4 Turbo (buen equilibrio velocidad/calidad) o Claude 3.5 Sonnet (mejor comprensión del contexto)
  • Privacy Mode: desactiva el envío de tu código a los servidores de Cursor si trabajas en un proyecto confidencial (disponible en versión Pro)

Si quieres una guía de instalación aún más detallada para otra herramienta similar, consulta nuestro tutorial de instalación de Claude Code en Windows.

Las 5 funcionalidades esenciales de Cursor para principiantes

Cursor ofrece cuatro modos de interacción con la IA, cada uno adaptado a una necesidad específica. Aquí te mostramos cómo usarlos en la práctica.

1. Cursor Tab: el auto-completado inteligente

Cursor Tab funciona como el auto-completado de tu teléfono, pero para código. Comienzas a escribir, Cursor adivina el resto y te lo propone en gris. Presiona Tab para aceptar.

Ejemplo: escribes function calcular, Cursor te propone automáticamente:

function calcularPromedio(notas) {
  const suma = notas.reduce((a, b) => a + b, 0);
  return suma / notas.length;
}

Ni siquiera necesitas describir qué hace la función, Cursor lo adivina por el nombre.

2. Cmd K: modificar código existente

Selecciona una porción de código, presiona Cmd + K (macOS) o Ctrl + K (Windows/Linux), y describe qué quieres cambiar.

Ejemplo: escribiste una función que calcula un precio con IVA, pero quieres añadir un descuento del 10%. Selecciona la función, escribe "añade un descuento del 10%", y Cursor modifica el código directamente.

3. Cmd L: el chat contextual

Presiona Cmd + L (macOS) o Ctrl + L (Windows/Linux) para abrir un chat en el lado derecho de la pantalla. Puedes hacer preguntas sobre tu código, pedir explicaciones o generar nuevas funcionalidades.

¿La diferencia con ChatGPT? Cursor tiene acceso a todos tus archivos. Si preguntas "¿cómo conecto mi base de datos?", Cursor ve que usas PostgreSQL y te da la respuesta adaptada, no una respuesta genérica.

4. Cmd I: generar código desde cero

Presiona Cmd + I (macOS) o Ctrl + I (Windows/Linux) para abrir un editor flotante. Describe lo que quieres crear en español, Cursor genera el código completo.

Ejemplo: "crea un formulario de contacto con nombre, correo y mensaje" → Cursor genera el HTML, CSS y JavaScript necesarios.

5. El modo Composer: crear múltiples archivos a la vez

El modo Composer (accesible mediante Cmd + Shift + I o Ctrl + Shift + I) permite generar una funcionalidad completa que toca múltiples archivos.

Ejemplo: "crea un sistema de autenticación con registro, inicio de sesión y cierre de sesión" → Cursor genera las rutas del backend, los formularios del frontend y la gestión de sesiones.

Estas funcionalidades se detallan en nuestro artículo sobre los comandos esenciales de Claude Code, que usa una lógica similar.

Cómo usar Cursor para tu primer proyecto concreto

La mejor manera de aprender Cursor es crear un mini-proyecto funcional en menos de 30 minutos. Aquí te mostramos un ejemplo paso a paso: una lista de tareas (to-do list) interactiva.

Paso 1: crear un nuevo proyecto

  1. Abre Cursor
  2. Haz clic en "File" > "Open Folder"
  3. Crea una nueva carpeta en tu escritorio (nómbrala "mi-lista-tareas")
  4. Selecciona esa carpeta

Paso 2: generar la estructura base

Presiona Cmd + I (o Ctrl + I) y escribe:

"Crea una lista de tareas con HTML, CSS y JavaScript. El usuario debe poder añadir una tarea, marcarla como completada y eliminarla."

Cursor genera tres archivos: index.html, style.css y script.js. Haz clic en "Accept" para crearlos.

Paso 3: probar tu proyecto

  1. Haz clic derecho en index.html en la barra lateral
  2. Selecciona "Open with Live Server" (si la extensión no está instalada, Cursor te propone hacerlo automáticamente)
  3. Tu navegador se abre y muestra tu lista de tareas funcional

Paso 4: añadir una funcionalidad

¿Quieres que las tareas se guarden incluso después de cerrar el navegador? Selecciona todo el contenido de script.js, presiona Cmd + K y escribe:

"Guarda las tareas en el localStorage del navegador"

Cursor modifica el código para añadir esta funcionalidad. Recarga la página, añade tareas, cierra el navegador, reabre: tus tareas siguen ahí.

Paso 5: entender el código generado

Selecciona una línea de código que no entiendas, presiona Cmd + L y pide: "Explícame esta línea como si tuviera 10 años".

Cursor te da una explicación en español simple, sin jerga técnica.

Este tipo de enfoque de proyecto es el corazón de la metodología Skilzy, que puedes descubrir en nuestra página de metodología.

Los errores frecuentes con Cursor y cómo evitarlos

Incluso con la IA, puedes caer en trampas que ralentizan tu aprendizaje. Aquí están los cinco errores más comunes y sus soluciones.

Error 1: aceptar todo el código sin leerlo

Cursor genera código rápidamente, pero eso no es razón para hacer clic en "Accept" sin pensar. Si no entiendes qué hace el código, no podrás depurarlo cuando falle.

Solución: lee cada línea generada, selecciona las que no entiendas y pide una explicación mediante Cmd + L.

Error 2: dar instrucciones demasiado vagas

"Crea un sitio web" no es suficiente. Cursor necesita contexto: ¿qué tipo de sitio? ¿Cuántas páginas? ¿Qué funcionalidades?

Solución: sé preciso. En lugar de "crea un formulario", escribe "crea un formulario de contacto con tres campos (nombre, correo, mensaje) y un botón de envío que muestre una alerta de confirmación".

Error 3: no verificar las dependencias

Cursor puede generar código que requiere bibliotecas externas (React, Tailwind CSS, etc.) sin avisarte.

Solución: después de cada generación de código, abre la terminal integrada (Ctrl + `) y verifica si Cursor creó un archivo package.json. Si es así, escribe npm install para instalar las dependencias.

Error 4: olvidar guardar regularmente

Cursor no guarda automáticamente tus archivos después de cada modificación.

Solución: activa el guardado automático en los parámetros (Ctrl + , luego busca "Auto Save" y selecciona "afterDelay").

Error 5: no usar control de versiones

Si modificas tu código y Cursor genera algo que lo rompe todo, no tienes forma de volver atrás sin Git.

Solución: inicializa Git desde el principio de tu proyecto. Abre la terminal y escribe git init, luego git add . y git commit -m "Primer commit" después de cada funcionalidad completada.

Los trucos avanzados para ahorrar tiempo con Cursor

Una vez que domines lo básico, estas técnicas te permiten codificar el doble de rápido. Aquí hay cinco trucos concretos.

Usar reglas personalizadas (.cursorrules)

Crea un archivo .cursorrules en la raíz de tu proyecto para dar instrucciones permanentes a Cursor.

Ejemplo de contenido:

- Usa siempre nombres de variables en español
- Comenta cada función en una frase
- Prefiere funciones flecha a funciones clásicas

Cursor aplicará estas reglas a cada generación de código.

Crear snippets personalizados

Los snippets son fragmentos de código reutilizables. Presiona Cmd + Shift + P (o Ctrl + Shift + P), escribe "Snippets: Configure User Snippets" y crea un snippet para el código que usas frecuentemente.

Ejemplo: un snippet para generar una función de validación de correo electrónico.

Usar @mentions en el chat

En el chat (Cmd + L), puedes mencionar archivos específicos con @nombreDelArchivo. Cursor se concentrará solo en ese archivo para responder.

Ejemplo: "@script.js ¿cómo optimizo este bucle?"

Activar el modo "Apply" automático

En los parámetros, activa "Auto-apply suggestions" para que Cursor aplique directamente las modificaciones sin pedirte confirmación cada vez.

Atención: activa esta opción solo cuando te sientas cómodo con Cursor, si no corres el riesgo de aceptar código que no entiendes.

Combinar Cursor con Claude Code

Si quieres automatizar tareas repetitivas (renombrar archivos, generar pruebas, etc.), usa Claude Code como complemento de Cursor. Las dos herramientas se complementan bien.

Cursor gratuito vs Cursor Pro: qué cambia realmente

La versión gratuita de Cursor te da 50 solicitudes por mes con GPT-4 y 200 auto-completados por día. Es más que suficiente para empezar, pero aquí está lo que ganas con Cursor Pro (20 $/mes):

Funcionalidad Gratuito Pro
Solicitudes GPT-4 50/mes Ilimitadas
Auto-completados 200/día Ilimitados
Privacy Mode No Sí
Modelos Claude Limitado Acceso completo
Soporte prioritario No Sí

Nuestra recomendación: comienza con la versión gratuita. Si codificas más de 2 horas al día y alcanzas los límites, pasa a Pro. Si no, quédate en gratuito.

Para profundizar en tu aprendizaje de IA, consulta nuestra guía Aprender IA: ¿por dónde empezar siendo principiante?.

Conclusión

Cursor transforma el aprendizaje de código permitiéndote crear proyectos funcionales desde el primer día. La instalación toma 5 minutos, las funcionalidades esenciales se dominan en una hora, y puedes codificar tu primer proyecto en 30 minutos. Comienza con un mini-proyecto simple (lista de tareas, calculadora, formulario), usa Cmd + L para hacer todas tus preguntas, y lee cada línea de código generado para entender la lógica. La versión gratuita es suficiente para empezar, y podrás pasar a Pro más tarde si codificas regularmente. Lo esencial es practicar todos los días, aunque sean solo 15 minutos.

Descubre todos nuestros programas en Skilzy para aprender a programar con proyectos concretos.