Cómo Usar Cursor IA: Guía Completa de Programación Asistida por Inteligencia Artificial
Aprende a usar Cursor IA, el editor de código potenciado por inteligencia artificial. Domina la edición en línea, reglas de proyecto, chat contextual y atajos clave.
TL;DR — Lo esencial en 3 puntos
- Cursor es un IDE basado en VS Code con soporte nativo para modelos de inteligencia artificial.
- Usa Cmd+K (Ctrl+K) para edición directa en línea dentro del archivo.
- Usa Cmd+L (Ctrl+L) para chatear con el contexto de tu proyecto usando menciones como @workspace y @docs.
- Usa Composer (Cmd+I) para realizar cambios coordinados en múltiples archivos simultáneamente.
- Configura reglas personalizadas para que la IA respete la arquitectura y estilos de tu proyecto.
Explicación completa
Cursor es un entorno de desarrollo integrado (IDE) basado en una bifurcación (fork) de Visual Studio Code que integra avanzados directamente en el flujo de trabajo de programación. A diferencia de las extensiones convencionales, Cursor está diseñado desde cero para que la interactúe de forma nativa con todo el repositorio de código.
1. Instalación e Importación de Configuración
Para comenzar a usar Cursor, descárgalo desde su sitio oficial e instálalo en tu sistema operativo. Durante la primera configuración, Cursor permite importar con un solo clic todas tus extensiones, atajos de teclado, temas y configuraciones previas de Visual Studio Code, facilitando una transición inmediata sin perder tu entorno de trabajo acostumbrado.
2. Las Tres Funciones Principales de Cursor
- Edición en Línea (Cmd+K / Ctrl+K): Selecciona cualquier bloque de código o pulsa en una línea vacía y presiona el atajo para dar instrucciones en lenguaje natural. Puedes pedir refactorizaciones, corrección de errores, agregar tipos de TypeScript o crear componentes desde cero.
- Chat Contextual del Repositorio (Cmd+L / Ctrl+L): Abre un panel lateral donde puedes hacer preguntas sobre todo tu proyecto. Al usar la mención `@workspace`, la IA indexa y analiza los archivos de tu repositorio para dar respuestas precisas basadas en la arquitectura actual.
- Generación e Integración Multistep (Cmd+I / Ctrl+I - Composer): Permite crear y editar múltiples archivos simultáneamente mediante agentes que ejecutan cambios coordinados a lo largo de todo el proyecto.
3. Indexación del Repositorio y Menciones `@`
Una de las mayores fortalezas de Cursor es su sistema de contexto. Puedes usar el símbolo `@` en el chat o en la edición en línea para adjuntar información específica:
- `@Files`: Adjunta un archivo en particular.
- `@Codebase`: Busca semánticamente en todo el proyecto.
- `@Web`: Permite a la IA buscar información actualizada en internet para consultar documentación reciente de librerías.
- `@Docs`: Permite indexar la documentación oficial de frameworks o librerías externas para recibir sugerencias alineadas a la versión exacta que utilizas.
4. Reglas de Proyecto (`.cursorrules` o `.agents/AGENTS.md`)
Para asegurarte de que Cursor siga las convenciones de tu equipo (como arquitectura de componentes, librerías CSS preferidas o patrones de testing), puedes definir archivos de reglas en la raíz de tu proyecto. Estas instrucciones se incluyen automáticamente en las consultas del modelo, garantizando que el código generado respete los estándares del repositorio.
5. Buenas Prácticas de Uso
- Revisa siempre las diferencias (diffs) antes de aceptar cambios automáticos.
- Mantén tus instrucciones claras, cortas y enfocadas en un solo objetivo por iteración.
- Utiliza la indexación local activa para que el modelo entienda las dependencias entre archivos.
Ejemplos reales
**Ejemplo de refactorización en línea:** Seleccionar un componente React y presionar Ctrl+K con el prompt: "Migra este componente a TypeScript agregando interfaces estrictas para sus props y estado local".
**Ejemplo de consulta contextual de arquitectura:** En el panel de chat (Ctrl+L), escribir: "@workspace ¿dónde se gestionan las llamadas API a la pasarela de pagos y cómo puedo agregar un nuevo endpoint de reembolso?"