Cursor IDE: La Guía Completa de Desarrollo con IA
Todo lo que necesitas saber sobre Cursor IDE — desde la instalación y migración de VS Code hasta Tab completion, Cmd+K, Chat, Composer, modo Agente, gestión de contexto, .cursorrules, selección de modelos, servidores MCP y workflows de equipo. Incluye comparación con Windsurf, Copilot, Claude Code y Cline.
Por Jose Nobile | Actualizado 2026-06-11 | 25 min de lectura
¿Qué es Cursor y Por Qué Importa?
Cursor es un editor de código AI-nativo construido como fork de VS Code. Integra modelos de lenguaje directamente en cada capa de la experiencia de edición — no como un chatbot en la barra lateral, sino tejido en los completados, ediciones inline, refactoring multi-archivo y workflows de agente autónomo. El resultado es un IDE donde la IA es ciudadano de primera clase en vez de un agregado tardío.
Lo que hace distintivo a Cursor es la profundidad de su integración. Las extensiones de VS Code como GitHub Copilot agregan completados y paneles de chat, pero están limitadas por la API de extensiones. Cursor controla toda la superficie del editor, así que puede renderizar diffs inline para cambios propuestos, transmitir ediciones multi-archivo en tiempo real, indexar todo tu código para búsqueda semántica y ejecutar agentes autónomos que crean branches, editan archivos y ejecutan comandos de terminal — todo dentro del editor.
Cursor soporta múltiples modelos de IA simultáneamente: Anthropic Claude (Sonnet 5, Opus 5, Fable 5), OpenAI GPT-5.5, Google Gemini 3 Pro, y su propio modelo agente frontier Composer (Composer 2.5, mayo 2026), más un modelo Tab propietario para completados rápidos. Eliges el modelo correcto para cada tarea — Claude para razonamiento profundo, Composer para ediciones agénticas rápidas, Gemini para análisis de contexto grande. Esta flexibilidad de modelos es única entre los IDEs AI.
Base VS Code
Construido sobre el núcleo open-source de VS Code. Todas las extensiones, temas, atajos y configuraciones de VS Code funcionan nativamente.
Arquitectura Multi-Modelo
Cambia entre Claude, GPT-5.5, Gemini y el modelo Composer propio de Cursor por interacción. Sin dependencia de proveedor. Usa el mejor modelo para cada tarea.
IA en Cada Capa
Tab completion, edición inline (Cmd+K), chat conversacional (Cmd+L), Composer multi-archivo (Cmd+I) y modo Agente autónomo. La IA no es un plugin — es el editor.
Inteligencia del Código
Indexación semántica automática de todo tu proyecto. La IA entiende tu arquitectura, no solo el archivo actual. Busca con lenguaje natural vía @codebase.
Instalación y Setup
Cursor está disponible para macOS, Windows y Linux. Descarga el instalador desde cursor.com. En macOS, arrastra a Aplicaciones. En Linux, usa el AppImage o paquete .deb. Cursor se actualiza automáticamente.
En el primer lanzamiento, Cursor ofrece importar tus configuraciones de VS Code, extensiones y atajos de teclado. Esta migración es transparente — tus temas, snippets y configuraciones se transfieren con un click.
Requisitos del Sistema
macOS 12+, Windows 10+ o Linux (Ubuntu 20.04+). 8 GB RAM mínimo, 16 GB recomendado. Conexión a internet necesaria para funciones de IA. No se necesita GPU.
Migración de VS Code
Importa todas las extensiones, temas, atajos y configuraciones de VS Code con un click. Tus configuraciones de workspace, snippets y ajustes por lenguaje se transfieren automáticamente.
Autenticación
Inicia sesión con tu cuenta Cursor (email o GitHub OAuth). El tier gratuito Hobby incluye completados Tab limitados y uso de agente limitado.
Compatibilidad de Extensiones
Soporte completo del marketplace de extensiones de VS Code. ESLint, Prettier, GitLens, Docker, paquetes de idiomas — todo funciona. Cursor agrega funciones de IA sobre el ecosistema existente.
Sincronización de Configuraciones
Cursor sincroniza configuraciones entre dispositivos vía tu cuenta. Tus preferencias de IA, modelos por defecto, reglas y configuración del editor te siguen a cualquier máquina.
Tab Completion: Autocompletado Predictivo con IA
Cursor Tab es la función de IA más visible — predice lo que vas a escribir y muestra texto fantasma inline. A diferencia del autocompletado tradicional que sugiere tokens individuales, Cursor Tab predice bloques multi-línea completos: cuerpos de funciones, cadenas condicionales, constructos de loops e implementaciones completas de métodos. Presiona Tab para aceptar, Esc para descartar.
El completado Tab usa el modelo Tab propietario de Cursor por defecto, optimizado para velocidad. Los completados llegan en menos de 200ms, lo suficientemente rápido para sentirse instantáneo al escribir.
Comportamientos clave de Tab: predice ediciones multi-línea (no solo inserciones), soporta predicción de cursor (mueve el cursor a la siguiente posición lógica de edición) y funciona en múltiples lenguajes incluyendo TypeScript, Python, Rust, Go, Java y más.
Predicciones Multi-Línea
Tab predice cuerpos de funciones completos, no solo el siguiente token. Empieza a escribir una firma de función y obtén una implementación completa de 10-20 líneas como texto fantasma.
Predicción de Cursor
Después de aceptar un completado, tu cursor salta a la siguiente posición lógica de edición. Cursor predice dónde vas a escribir después.
Predicciones de Edición
Tab no solo inserta código — predice ediciones. Si empiezas a modificar un parámetro de función, Tab sugiere cambios en el cuerpo de la función que coinciden con tu intención.
Latencia Sub-200ms
El modelo Tab propietario de Cursor está ajustado específicamente para velocidad de completado. Las predicciones aparecen instantáneamente mientras escribes.
Ejemplo práctico: Empieza a escribir una firma de función como function validateEmail( y Cursor Tab predice los tipos de parámetros, patrón regex, mensajes de error y tipo de retorno — frecuentemente generando una implementación completa de 15 líneas solo desde el nombre de la función.
Cmd+K: Edición Inline con IA
Cmd+K (Ctrl+K en Windows/Linux) abre una barra de prompt inline directamente en tu editor. Selecciona código, presiona Cmd+K, describe lo que quieres y Cursor reescribe la selección en su lugar. La IA muestra una vista previa del diff para que revises los cambios antes de aceptar.
Cmd+K soporta dos modos: Editar (selecciona código primero, luego prompta para modificarlo) y Generar (posiciona el cursor sin selección, luego prompta para generar código nuevo).
Cmd+K también funciona en la terminal. Abre la terminal integrada de Cursor, presiona Cmd+K y describe el comando que quieres. Cursor genera el comando shell — especialmente poderoso para comandos complejos de git, docker y kubectl.
Modo Editar
Selecciona código, presiona Cmd+K, describe el cambio. La IA reescribe la selección en su lugar. Ve una vista previa del diff antes de aceptar.
Modo Generar
Posiciona el cursor sin selección, presiona Cmd+K, describe qué crear. La IA genera código que se ajusta al contexto circundante.
Terminal Cmd+K
Presiona Cmd+K en la terminal para describir un comando shell en lenguaje natural. Cursor genera el comando exacto para git, docker, kubectl, find, awk y más.
Vista Previa de Diff
Cada edición Cmd+K muestra un diff coloreado antes de aceptar. Revisa exactamente qué cambios propone la IA. Acepta con Enter, rechaza con Esc o modifica el prompt.
Ejemplo práctico: Selecciona una consulta SQL cruda en código de aplicación, presiona Cmd+K y escribe "convertir a consulta parametrizada con prepared statement." Cursor reescribe la consulta con binding de parámetros apropiado, previniendo inyección SQL.
Chat: IA Conversacional con Contexto Completo
El panel de Chat (Cmd+L) proporciona una interfaz conversacional con el modelo de IA de tu elección. A diferencia de chatbots genéricos, Cursor Chat tiene conocimiento profundo de tu proyecto: puede referenciar archivos, buscar en tu código, leer documentación y navegar la web — todo a través del sistema de contexto @.
Los mensajes de Chat pueden incluir bloques de código que Cursor renderiza como diffs accionables. Cuando la IA sugiere cambios, ves exactamente qué archivos se modificarán y qué líneas cambiarán.
Chat soporta conversaciones multi-turno con retención completa de contexto. Haz una pregunta, obtén una respuesta, y luego continúa con "ahora agrega manejo de errores a eso" — la IA recuerda el contexto previo.
Diffs Accionables
Las respuestas del Chat incluyen botones Apply en los bloques de código. Haz click para insertar o reemplazar código directamente en tus archivos.
Sistema de Contexto @
Referencia archivos (@file), carpetas (@folder), documentación (@docs), la web (@web), historial git (@git) o todo tu código (@codebase) en los mensajes del chat.
Memoria Multi-Turno
El contexto se acumula entre mensajes. Referencia un archivo una vez, luego haz preguntas de seguimiento. La IA recuerda toda la conversación.
Comprensión de Imágenes
Pega capturas de pantalla, mockups o imágenes de error directamente en el Chat. La IA analiza contenido visual y genera código que coincida con diseños.
Ejemplo práctico: Abre Chat con Cmd+L, escribe "@codebase cómo funciona el middleware de autenticación?" Cursor busca en todo tu proyecto, encuentra los archivos relevantes de middleware, handlers de rutas y configuración JWT, y luego explica el flujo de auth con referencias directas a tu código.
Composer y Modo Agente
Composer (Cmd+I) es la interfaz de edición multi-archivo de Cursor. Mientras Chat sugiere cambios un archivo a la vez, Composer edita múltiples archivos simultáneamente — creando archivos nuevos, modificando existentes y eliminando código obsoleto en una sola operación.
Modo Agente lleva a Composer más lejos dándole capacidades autónomas a la IA. En modo Agente, Cursor puede leer archivos que descubre como relevantes, ejecutar comandos de terminal, buscar en el código e iterar sobre su propia salida cuando los tests fallan.
El modo Agente soporta agentes en background que corren en la nube. Inicia una tarea, cierra el panel de Composer (o incluso el IDE), y el agente sigue trabajando en una VM remota.
Edición Multi-Archivo
Edita, crea y elimina múltiples archivos en un solo prompt. Composer muestra un diff unificado de todos los archivos afectados.
Ejecución Autónoma
El modo Agente lee archivos adicionales, ejecuta comandos de terminal, corre tests e itera sobre fallos — todo sin intervención manual.
Agentes en Background
Ejecuta tareas de agente en la nube mientras sigues trabajando. Los agentes en background crean branches, editan archivos, corren tests y abren pull requests.
Checkpoints
Composer crea checkpoints automáticos antes de cada cambio. Revierte a cualquier estado anterior con un click.
Uso de Herramientas en Modo Agente
El agente lee archivos, busca código, ejecuta comandos shell, invoca herramientas MCP y navega documentación. Cada uso de herramienta se registra y es visible.
Salida Lista para PR
Los agentes en background producen branches con historial de commits limpio. Revisa el diff, aprueba y mergea. El agente escribe mensajes de commit y descripciones de PR.
Ejemplo práctico: En modo Agente, prompta "Agrega un endpoint /users/:id/orders con paginación, filtrado por rango de fechas, validación de input, tests unitarios y actualiza el spec OpenAPI." El agente crea la ruta, controller, servicio, esquema de validación, archivo de tests y actualiza el spec.
Gestión de Contexto: El Sistema @ y .cursorrules
El sistema de contexto de Cursor determina qué información ve la IA al generar respuestas. Cuanto más contexto relevante provees, mejor el resultado. El símbolo @ es el mecanismo principal para agregar contexto.
Proveedores de contexto disponibles:
- @files — Agrega archivos específicos al contexto. La IA lee el contenido completo de los archivos referenciados.
- @folders — Incluye árboles de directorios completos para una imagen completa de un módulo o paquete.
- @codebase — Activa búsqueda semántica en todo tu proyecto usando el índice del código.
- @docs — Referencia documentación de terceros. Cursor obtiene e indexa docs externos para que la IA tenga referencias actualizadas.
- @web — Busca en la web en tiempo real para eventos actuales, últimas versiones de librerías o changelogs recientes.
- @git — Referencia diffs de git, historial de commits o commits específicos.
El archivo .cursorrules funciona como el CLAUDE.md de Claude Code — define los estándares de código, patrones de arquitectura, librerías preferidas y prácticas prohibidas de tu proyecto. La IA lee este archivo al inicio de cada interacción. El directorio más nuevo .cursor/rules/ soporta múltiples archivos de reglas con metadatos, activación basada en glob (alwaysApply, autoAttach, agentRequested, manual) y reglas por tipo de archivo.
## Project Architecture
- Next.js 15 App Router with server components by default
- TypeScript strict mode, no `any` types
- Tailwind CSS for styling, no CSS modules
- Prisma for database access, Zod for validation
## Coding Standards
- Use named exports, not default exports
- Error handling with Result pattern, not try/catch
- All API routes must validate input with Zod schemas
- Write JSDoc comments for all public functions
## Testing
- Vitest for unit tests, Playwright for E2E
- Minimum 80% coverage on new code
- Test file naming: *.test.ts co-located with source
## Forbidden
- Never use console.log in production code (use logger)
- Never commit .env files
- Never use inline styles (use Tailwind classes)
Búsqueda Semántica @codebase
El índice del código usa embeddings para búsqueda semántica. Pregunta "cómo funciona el auth" y la IA encuentra middleware JWT, handlers de login y stores de sesión — incluso sin coincidencias de palabras clave.
Documentación Externa @docs
Indexa cualquier URL como fuente de docs. La IA lee docs de React, guías de Next.js, tu wiki interna o cualquier documentación accesible por web.
Archivo .cursorrules
Instrucciones a nivel de proyecto que la IA lee en cada interacción. Define estándares de código, patrones de arquitectura, prácticas prohibidas y requisitos de testing. Commitéalo al repo para consistencia del equipo.
Directorio .cursor/rules/
Archivos de reglas con patrones glob. Reglas de API se activan solo para app/api/**, reglas de tests solo para *.test.ts. Soporta modos alwaysApply, autoAttach, agentRequested y manual.
.cursorignore
Como .gitignore pero para el índice del código. Excluye artefactos de build, node_modules, código generado y archivos binarios grandes de la búsqueda semántica.
Reglas Globales vs Proyecto
Las reglas globales (Settings > General > Rules for AI) aplican a todos los proyectos. Las reglas de proyecto (.cursorrules o .cursor/rules/) aplican por proyecto. Las reglas de proyecto anulan a las globales cuando hay conflicto.
Ejemplo práctico: Crea .cursor/rules/api-routes.mdc con patrón glob app/api/** conteniendo "Todas las rutas de API deben usar el wrapper de middleware withAuth." Esta regla solo aplica cuando la IA edita archivos dentro de app/api/.
Configuración de Modelos
Cursor soporta múltiples modelos de IA y te permite cambiar entre ellos por interacción. Claude Sonnet 5 y Opus 5 sobresalen en razonamiento complejo y refactors grandes, y Fable 5 es el nivel más alto para el trabajo más difícil y de mayor horizonte. OpenAI GPT-5.5 es rápido y confiable para generación de código rutinaria. Gemini 3 Pro maneja contextos muy grandes. El Composer 2.5 propio de Cursor ofrece codificación agéntica de nivel frontier a menor costo, y un modelo Tab propietario potencia el completado con latencia sub-200ms.
La selección de modelo ocurre en la parte inferior del panel de Chat o Composer vía un dropdown. Puedes configurar un modelo por defecto y cambiarlo por conversación. Para equipos con necesidades de compliance, Cursor soporta API key propia para Anthropic, OpenAI, Azure OpenAI y Google Vertex AI.
Claude Sonnet 5 / Opus 5 / Fable 5
Mejor para razonamiento complejo, refactors grandes y análisis arquitectónico. Fable 5 para los problemas más difíciles y de mayor horizonte, Opus 5 como buque insignia del día a día, Sonnet 5 para el mejor balance de velocidad e inteligencia.
GPT-5.5
Rápido, confiable y costo-efectivo para tareas de codificación rutinarias. GPT-5.5 (abril 2026) destaca en generación de código y sesiones largas de codificación agéntica, con contexto de 1M tokens.
Gemini 3 Pro
Modelo de Google con ventanas de contexto muy grandes (hasta 1M tokens). Útil para analizar archivos grandes y codebases complejos.
Composer 2.5 (Cursor)
Modelo agente frontier propio de Cursor, lanzado en mayo 2026. Optimizado para codificación agéntica rápida en el editor a bajo costo. Un modelo Tab propietario separado potencia el autocompletado sub-200ms.
API Key Propia
Configura tus propias claves de Anthropic, OpenAI, Azure OpenAI o Google Vertex AI. Las solicitudes van directamente desde tu máquina a tu proveedor, sin pasar por el proxy de Cursor.
Ejemplo práctico: Usa Claude Opus para "refactorizar el sistema de autenticación para soportar OAuth2 + PKCE" (razonamiento profundo necesario). Cambia a Composer 2.5 para "agregar un spinner de carga al dashboard" (tarea agéntica rápida). El modelo Tab propietario maneja los completados durante todo.
Integración de Servidores MCP
Cursor soporta el Model Context Protocol (MCP), permitiéndote conectar herramientas externas y fuentes de datos directamente a la IA. Los servidores MCP exponen capacidades como consultas de base de datos, llamadas API y lógica de negocio como herramientas que la IA puede invocar.
Configura servidores MCP en Configuración de Cursor > Features > MCP o vía un archivo .cursor/mcp.json en la raíz del proyecto. Cursor soporta transportes stdio (proceso local) y sse (HTTP remoto).
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem",
"/path/to/allowed/directory"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres",
"postgresql://user:pass@localhost:5432/mydb"]
}
}
}
Acceso a Base de Datos
Conecta PostgreSQL, MySQL o SQLite vía MCP. El agente consulta tu esquema, entiende tu modelo de datos y genera migraciones, consultas y tipos informados por tu base de datos real.
Integración GitHub / GitLab
Crea issues, lee PRs, busca repositorios y gestiona workflows a través de MCP. El agente puede crear un PR con descripción, asignar revisores y vincular issues.
Servidores MCP Personalizados
Construye tu propio servidor MCP para exponer APIs internas, lógica de negocio o herramientas propietarias. La IA invoca tus herramientas personalizadas durante el modo Agente.
Config MCP a Nivel de Proyecto
El archivo .cursor/mcp.json vive en tu repo. Cada miembro del equipo obtiene las mismas herramientas MCP automáticamente. Sin setup individual.
Ejemplo práctico: Configura el servidor MCP de PostgreSQL, luego pídele al modo Agente que "analice el esquema de la tabla users y cree una migración para agregar columnas de verificación de email." El agente consulta tu esquema de base de datos vía MCP, genera el archivo de migración y crea los tipos TypeScript.
Comparación: Cursor vs Windsurf vs Copilot vs Claude Code vs Cline
Cursor
IDE AI completo (fork de VS Code). Soporte multi-modelo, Composer/modo Agente, indexación de código, servidores MCP, agentes en background, .cursorrules. $0-200/mes.
Windsurf (Cognition)
IDE AI (fork de VS Code) con agente Cascade y Flows. Tier gratuito fuerte. Adquirido por Cognition en 2025. $0-15/mes.
GitHub Copilot
Extensión de VS Code. Completados inline, Chat, Copilot Workspace. Integración más profunda con GitHub. Múltiples modelos incluyendo Claude. $10-39/usuario/mes.
Claude Code
Herramienta agéntica terminal-first. CLAUDE.md, skills personalizados, equipos de agentes, servidores MCP, worktrees. Pro $20/Max $100-200/mes.
Cline (Extensión VS Code)
Extensión open-source de VS Code con capacidades agénticas completas. Multi-modelo, servidores MCP, edición de archivos, acceso a terminal. Trae tu propia API key. Gratis.
La elección depende de tus preferencias de workflow. Cursor es ideal si quieres un IDE visual con flexibilidad multi-modelo y capacidades de agente integradas. Claude Code es mejor para workflows terminal-first. GitHub Copilot tiene sentido para equipos totalmente GitHub. Windsurf atrae con su tier gratuito fuerte. Cline es la opción open-source para capacidades agénticas dentro de VS Code existente. Muchos equipos usan Cursor y Claude Code juntos.
Precios y Planes
Plan Hobby: completados Tab limitados y solicitudes de agente limitadas por mes. Indexación de código y sistema @context incluidos.
Completados Tab ilimitados, uso ilimitado de Auto-mode, y ~$20/mes de uso incluido de modelos frontier a tarifas de API (Claude, GPT-5.5, Gemini, Composer). Modo Privacidad disponible. Pro+ ($60/mes) y Ultra ($200/mes) agregan 3x y 20x de uso.
Todo lo de Pro más dashboard de admin, facturación centralizada, Modo Privacidad obligatorio, .cursorrules a nivel de equipo, SSO/SAML, analíticas de uso y soporte prioritario. $32/usuario/mes con facturación anual; el tier Teams Premium ($120/usuario/mes) agrega 5x de uso.
Todos los planes incluyen compatibilidad con extensiones de VS Code, indexación de código y acceso multi-modelo. Los planes Pro y Business soportan la opción de API key propia. El uso que excede los créditos mensuales incluidos se factura on-demand a tarifas de API del proveedor, con límites de gasto configurables.
Optimización de Uso
Usa Tab y Auto mode para trabajo rutinario (ilimitado en Pro). Reserva la selección manual de modelos frontier para tareas complejas — consume tus créditos de uso mensuales. Configura límites de gasto para controlar la facturación on-demand.
Economía de API Key
Los usuarios intensivos ahorran dinero con API key propia. Un plan Pro de $20/mes más $30-50/mes en costos de API frecuentemente entrega más uso que pagar excedentes on-demand.
Workflows de Equipo y Colaboración
Cursor Business proporciona gestión de equipo centralizada a través de un dashboard de admin. Los administradores controlan el acceso a modelos, aplican Modo Privacidad, gestionan facturación y monitorean uso..cursorrules files ensure consistent AI behavior across the organization.
El Modo Privacidad asegura que tu código nunca se almacena en los servidores de Cursor, nunca se usa para entrenar modelos y nunca se registra más allá de la duración de la solicitud. Se aplica a nivel organizacional para planes Business.
.cursorrules Compartido
Commitea .cursorrules y .cursor/rules/ a tu repositorio. Cada miembro del equipo obtiene comportamiento de IA idéntico. Aplica estándares de código automáticamente.
Fuentes @docs Compartidas
Configura fuentes de documentación compartidas para que todos los miembros tengan acceso indexado a APIs internas, frameworks propietarios y estándares de la empresa.
Autenticación SSO/SAML
Integración con proveedores de identidad enterprise. Okta, Azure AD, Google Workspace — tu equipo se autentica a través de tu proveedor SSO existente.
Analíticas de Uso
El dashboard de admin muestra completados aceptados, solicitudes premium consumidas, usuarios activos y distribución de uso de modelos.
Modo Privacidad (Obligatorio)
Los admins de Business obligan el Modo Privacidad para todos los miembros. Sin almacenamiento de código, sin datos de entrenamiento, sin logs.
Code Review con IA
Usa @git para referenciar un diff de PR en Chat. Pídele a la IA que revise por problemas de seguridad, rendimiento y adherencia a .cursorrules.
Onboarding en el Código
Los nuevos miembros del equipo usan @codebase para hacer preguntas de arquitectura. La IA explica usando tu código real con @docs indexados para APIs internas.
Servidores MCP Compartidos
Pon .cursor/mcp.json en el repo. Cada miembro del equipo obtiene acceso a las mismas herramientas MCP sin configuración individual.
Ejemplo práctico: Un equipo de 15 personas configura @docs compartidos para APIs internas, aplica .cursorrules vía el repositorio, habilita Modo Privacidad a nivel organizacional y commitea un .cursor/mcp.json con herramientas de base de datos y GitHub. Cada desarrollador obtiene IA que entiende las APIs del equipo, sigue los estándares de código y mantiene el código privado — con cero configuración individual.