Configuración de Cursor — instalación, .cursorrules, MCP y cómo dividir el trabajo con Claude Code

Cursor es un fork de VS Code con integración profunda de IA: actualmente el camino más rápido para "usar la IA dentro del editor como herramienta diaria". Se solapa con Claude Code pero son complementarios: Cursor es un programador par integrado en el editor; Claude Code es un agente en el lado del terminal. El objetivo no es elegir uno, sino dividir el trabajo entre ambos.

La clave no está en elegir la herramienta "correcta", sino — creo que — en entender qué hace mejor cada una. En lugar de forzar a Cursor a tareas largas y autónomas, la combinación correcta es usarlo donde brilla: ediciones rápidas en el editor, feedback visual, ciclo corto de intención a resultado.

Esta guía es agnóstica a macOS/Linux/Windows: instalación → uso principal → .cursorrules → MCP → división con Claude Code.

TL;DR

1. Instalar: cursor.com → importa automáticamente extensiones/keymap/configuración de VS Code
2. Modelo: Claude Sonnet/Opus · GPT-4.1 · Cursor Composer. Recomendación por defecto: Claude Sonnet
3. Cuatro atajos: autocompletado con Tab · edición en línea con ⌘K · chat lateral con ⌘L · Composer con ⌘I
4. .cursorrules: reglas del proyecto inyectadas como system prompt en cada llamada
5. División con Claude Code: Cursor = ediciones + feedback instantáneo; Claude Code = multi-archivo + autónomo + CLI

Requisitos previos

• macOS 12+ / Windows 10+ / Linux (Ubuntu 22.04+)
• Internet + una cuenta (Cursor u OAuth de GitHub)
• Usuarios de VS Code: la importación es automática

1. Instalar Cursor

macOS

brew install --cask cursor

Windows

winget install -e --id Anysphere.Cursor

Linux

cursor.com/downloads para AppImage o .deb.

En la primera ejecución, Cursor importa tus extensiones de VS Code, la distribución de teclas y el tema con un clic. Los nuevos usuarios pueden aceptar los valores predeterminados.

2. Elegir un modelo

Cursor → Configuración → Modelos. Recomendaciones:

• Claude Sonnet 4: edición y refactorización diaria. Rápido.
• Claude Opus 4: depuración compleja y arquitectura. Más lento y costoso, pero más preciso.
• Composer (el propio de Cursor): multi-archivo, agéntico. Aún en territorio beta.
• GPT-4.1 / o1: útil como respaldo o para comparar.

Cursor Pro tiene cuotas de solicitudes por modelo. Sonnet tiene un límite generoso y es rápido: hacerlo predeterminado y recurrir a Opus solo cuando estés atascado.

3. Cuatro atajos esenciales

Autocompletado con Tab

• Rellena firmas, repite patrones e importa automáticamente.
• No confiar ciegamente: las API alucinadas son habituales. Pulsar Esc para rechazar cuando sea necesario.
• Configuración: Características → Cursor Tab → "Deshabilitar vista previa" reduce el ruido.

Edición en línea ⌘K

// selección: función completa
// ⌘K: "añadir manejo de errores y validación de entrada con zod"

Modifica solo la selección. No es para trabajos grandes. El ciclo más rápido de "intención → resultado".

Chat lateral ⌘L

• @nombre_archivo para adjuntar un archivo específico
• @Codebase para buscar en todo el repositorio (basado en embeddings, calidad beta)
• @Web para información actualizada (Cursor realiza la búsqueda)

Composer ⌘I

Trabajo en múltiples archivos ("refactorizar todo el flujo de autenticación"). En modo agente edita los archivos directamente. No aceptar el resultado completo de una vez: revisar diff por diff.

4. .cursorrules — reglas del proyecto

Un archivo .cursorrules en la raíz del repositorio se inyecta automáticamente como system prompt en cada chat, edición o llamada a Composer. Define el estilo de código, el stack y las prohibiciones una sola vez para no tener que repetirlos.

4.1 Plantilla

Para proyectos con Next.js + TypeScript:

# Mac/Linux
curl -fsSL https://devalice.jaceclub.com/assets/ai-agents/cursor-setup/cursorrules-nextjs.txt -o .cursorrules
shasum -a 256 .cursorrules
# esperado: 7f1ef76397375cae008ece09b46ddf91aa098dff5edaacebcd7e7e4dec92a21d

# Windows
Invoke-WebRequest -Uri https://devalice.jaceclub.com/assets/ai-agents/cursor-setup/cursorrules-nextjs.txt -OutFile .cursorrules

4.2 Secciones clave (en la plantilla)

• Contexto del proyecto — stack · gestor de paquetes · versiones de lenguaje
• Estilo de código — TS strict · convenciones de nombres de archivos · alias de rutas
• Enrutamiento/datos — patrones App Router · ISR · separación de env
• Seguridad — sin secretos · validación de entrada · bindings SQL
• Ámbito — no refactorizar fuera de la solicitud
• Formato de salida — estilo diff · una alternativa con tradeoffs

4.3 Qué cambia

Sin vs. con .cursorrules:

❌ "hazme un componente React aquí" → componente de clase, JS, dependencias extra aleatorias ✅ "hazme un componente React aquí" → Server Component TypeScript strict, alias @/*, Tailwind

Un buen archivo de reglas elimina 3–4 líneas de contexto en cada prompt.

5. .cursorignore

Misma sintaxis que .gitignore. Indica los archivos que la IA no debe incluir en el contexto.

# deps / build
node_modules
.next
dist

# fixtures grandes
fixtures/large/

# código generado
src/generated/

Omitir este archivo hace que @Codebase incluya resultados de build en el contexto, lo que reduce la calidad.

6. MCP (Model Context Protocol)

Cursor 0.42+ soporta MCP. Mismo estándar que Claude Code, así que las definiciones de servidor son portables.

Configuración → Características → MCP → Añadir servidor:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
    }
  }
}

7. Modo de privacidad

Configuración → General → Modo de privacidad:

• DESACTIVADO (predeterminado): Cursor puede usar logs y solicitudes para mejorar los modelos.
• ACTIVADO: sin uso para entrenamiento. Obligatorio para código de empresa.

Con el modo de privacidad ACTIVADO, algunas funciones (indexación) quedan solo en local. El impacto en el rendimiento es mínimo.

8. Dividir el trabajo con Claude Code

La combinación más potente: usar ambos. Roles:

Patrones prácticos

1. Edición pequeña → Cursor ⌘K — el cambio cabe en una función. Aceptar inmediatamente.

2. Multi-archivo → Claude Code — "añadir ISR a cuatro rutas". Ejecutar el cambio y la verificación del build desde el CLI.

3. Depuración → ambos — Cursor para hipótesis rápidas; Claude Code cuando necesitas contexto más profundo y ejecución autónoma.

4. Creación de PR → Claude Code — automatizar mediante gh pr create.

5. Revisión → Cursor ⌘L — leer los diffs en línea y preguntar línea a línea.

Verificación

1. Abrir Cursor en un index.tsx vacío y dejar que Tab proponga un esqueleto de componente React.
2. Seleccionar una función → ⌘K "añadir manejo de errores" → ver try/catch añadido.
3. Chat lateral ⌘L con @package.json adjunto → hacer una pregunta sobre dependencias.
4. Colocar .cursorrules en la raíz del repositorio → nuevo chat → el comportamiento cambia según las reglas.
5. Configuración → Privacidad → ACTIVADO → confirmar funcionamiento normal.

Solución de problemas

El autocompletado Tab es demasiado ruidoso

Configuración → Características → Cursor Tab → "Activar con más precisión", o deshabilitar temporalmente. Si rechazas con frecuencia, simplemente desactívalo.

Los resultados de @Codebase son imprecisos

Añadir los resultados de build y el código generado a .cursorignore. Forzar una reindexación del codebase (Configuración → Indexación).

El modelo propio de Cursor alucina con frecuencia

Establecer Claude Sonnet como predeterminado: Configuración → Modelos → Modelo predeterminado = Claude Sonnet.

.cursorrules parece ser ignorado

• El nombre del archivo debe ser exactamente .cursorrules (con punto inicial, sin extensión).
• Debe estar en la raíz del repositorio, no en una subcarpeta.
• Verificar en un chat nuevo: los chats existentes acumulan contexto y pueden enmascarar los cambios.

La cuota Pro se agota rápido

Se está sobreusando Composer. Usar ⌘K para ediciones pequeñas y reservar Composer para trabajo real en múltiples archivos.

Conflicto de atajos con Claude Code

Cursor está en el IDE y Claude Code en un terminal: las colisiones físicas son raras, pero ambos pueden usar ⌘L en algunas configuraciones. Reasignar uno de los lados.

Referencias

• Configuración de Claude Code — la configuración del agente terminal va bien con Cursor
• Flujo de trabajo multi-agente — combinación de varias herramientas
• Documentación de Cursor
• Guía MCP de Cursor

Registro de cambios

• 2026-05-12 — Traducción inicial al español (devAlice M2 i18n seed)