Cursor es un editor basado en VS Code que integra modelos de IA directamente en el flujo de desarrollo. Claude, el modelo de Anthropic, es uno de los proveedores que Cursor ofrece de forma nativa — y para mucha gente, el que mejor rinde escribiendo y refactorizando código.
Esta guía cubre cómo configurarlo, qué cambió en los últimos meses, y la pregunta que casi todos hacen antes de decidirse.
¿Cursor o Claude Code? ¿Cuál conviene?
Es la duda más común, y la respuesta corta es que no compiten tanto como parece.
Cursor es un editor. Tienes el código a la vista, autocompletado mientras escribes, y un agente que trabaja sobre los archivos abiertos. El contexto visual es el punto fuerte: ves exactamente qué está cambiando, línea por línea.
Claude Code es un agente de terminal. No tiene editor propio — corre en tu shell, sobre el repositorio completo. Es más fuerte en tareas largas y autónomas: migraciones, refactors que tocan veinte archivos, trabajo que no quieres supervisar paso a paso.
En la práctica, muchos desarrolladores usan los dos: Cursor para el trabajo del día a día donde quieres ver el diff, Claude Code para las tareas grandes que lanzas y revisas al final. No hace falta elegir.
Si ya tienes suscripción a Claude, también puedes usar Claude Code dentro de la terminal integrada de Cursor. Es la combinación que más gente termina adoptando.
¿Qué modelos de Claude están disponibles en Cursor?
Cursor incorpora los modelos de Anthropic a medida que salen. Al día de hoy el catálogo incluye:
- Claude Opus 5 — el más capaz, para arquitectura y problemas difíciles
- Claude Sonnet 5 — el equilibrio entre capacidad y velocidad; la opción por defecto para la mayoría del trabajo
- Claude Fable 5
- Claude 4.5 Haiku — el más rápido y económico, para tareas mecánicas
Ojo: varios de estos modelos están ocultos por defecto en el selector. Si no ves el que buscas, actívalo en la configuración de modelos antes de asumir que no está disponible.
Si vienes de guías viejas: los identificadores tipo claude-3-sonnet-20240229 ya no existen. Los modelos con fecha en el nombre se retiran, y una configuración que los referencia devuelve un error 404. Usa siempre el selector de Cursor en lugar de escribir el ID a mano.
¿Necesito una API key de Anthropic?
No. Y este es el punto donde más guías desactualizadas confunden a la gente.
Con una suscripción de Cursor, los modelos de Claude vienen incluidos. Eliges el modelo en el selector y listo — no hay API key, no hay configuración adicional, no hay facturación separada con Anthropic.
La API key propia es una opción, no un requisito. Sirve si ya tienes créditos en Anthropic que quieres aprovechar, o si tu organización exige facturar el consumo por su propia cuenta.
¿Cómo configurar tu propia API key de Anthropic?
- Crea la key en console.anthropic.com → sección API Keys
- En Cursor, abre Cursor Settings → Models
- Busca Anthropic, pega la key y haz clic en Save
Importante: la key se muestra una sola vez al crearla. Guárdala en un gestor de contraseñas, nunca en un archivo del repositorio.
Las tres limitaciones que conviene saber antes
Usar tu propia key tiene consecuencias que no son obvias:
- La política de Zero Data Retention de Cursor deja de aplicar. Tus datos pasan a regirse por la política de privacidad de Anthropic. Si elegiste Cursor por su manejo de datos, esto lo cambia.
- El autocompletado (Tab) sigue usando los modelos propios de Cursor. La key personalizada solo afecta al chat y al agente. Tab no es configurable.
- La key viaja en cada petición a través de los servidores de Cursor sobre conexiones cifradas, aunque no queda almacenada de forma permanente ahí.
¿Cómo se usa Claude dentro de Cursor?
La interfaz cambió bastante respecto de las versiones de 2024. Los atajos actuales:
| Atajo | Qué hace |
|---|---|
Tab |
Acepta la sugerencia de autocompletado |
Cmd/Ctrl + I |
Abre el Agente en el panel lateral |
Cmd/Ctrl + E |
Muestra u oculta el layout del agente |
Cmd/Ctrl + K |
Edición inline — selecciona código y describe el cambio |
Cmd/Ctrl + . |
Menú de modos (Agente, Plan, etc.) |
Cmd/Ctrl + Shift + L |
Agrega el código seleccionado al contexto |
Cmd/Ctrl + N |
Chat nuevo |
Todos los atajos son personalizables desde la configuración de teclado.
El modo Plan
Vale la pena conocerlo porque es lo más útil que se agregó recientemente. En lugar de escribir código de inmediato, el modo Plan hace preguntas, investiga el repositorio y genera un plan de implementación que puedes revisar y editar antes de que se escriba una sola línea.
Sirve para funcionalidades complejas, cambios que tocan varios archivos, requisitos ambiguos, y decisiones de arquitectura donde quieres evaluar la estrategia primero. Para cambios rápidos, el modo Agente normal alcanza.
El “modo Composer” que mencionan las guías viejas se absorbió dentro del Agente. Si buscas Composer y no lo encuentras, no está roto — cambió de nombre.
¿Cómo darle instrucciones permanentes a Claude?
Repetir “usa TypeScript estricto” en cada conversación es una pérdida de tiempo. Cursor tiene dos mecanismos para que las instrucciones persistan.
Reglas de proyecto (.cursor/rules)
Son archivos .mdc con frontmatter YAML dentro de .cursor/rules/:
---
description: Convenciones de componentes React
globs: ["src/components/**/*.tsx"]
alwaysApply: false
---
Usa componentes de función con hooks, nunca clases.
Los props se tipan con interfaces, no con `type`.
Cada componente exportado lleva su test al lado.
El campo globs limita la regla a los archivos que coinciden. Con alwaysApply: true, la regla se aplica a todo el proyecto.
El error más frecuente: la extensión tiene que ser .mdc. Un archivo .md dentro de .cursor/rules/ se ignora en silencio — sin advertencia, sin error. Es la causa número uno de “configuré las reglas y no pasa nada”.
.cursor/rules/
react-patterns.mdc # ✅ se reconoce
api-guidelines.md # ❌ se ignora — extensión incorrecta
frontend/
components.mdc # ✅ se pueden organizar en carpetas
AGENTS.md
Si no necesitas reglas condicionales, un AGENTS.md en la raíz del proyecto alcanza: markdown plano, sin metadatos ni configuración. Cursor lo lee igual.
Si además usas Claude Code, el CLI de Cursor detecta también los archivos CLAUDE.md en la raíz, así que ambas herramientas pueden compartir el mismo contexto.
El archivo
.cursorrulesde las versiones viejas quedó obsoleto. Si todavía tienes uno, mígralo a.cursor/rules/.
¿Cómo controlar qué ve el modelo?
Dos archivos, con propósitos distintos:
.cursorignore— excluye archivos por completo. El Agente, Tab, la edición inline y las menciones@no pueden acceder a ellos. Aquí van secretos,.env, credenciales..cursorindexingignore— excluye solo del índice de búsqueda. Los archivos siguen accesibles para la IA, pero no aparecen en las búsquedas del repositorio. Aquí van archivos generados, dependencias vendorizadas, builds.
Ambos usan la sintaxis de .gitignore. Cursor ya ignora por defecto lo que esté en tu .gitignore.
Una limitación que sorprende: los patrones de negación (!) no pueden volver a incluir archivos dentro de una carpeta que excluiste con *. Hay que excluir explícitamente las subcarpetas primero y después des-ignorar el archivo puntual.
¿Cómo escribir mejores prompts?
La diferencia entre un resultado útil y uno inservible casi siempre está en el prompt.
Sé específico sobre el resultado, no sobre el síntoma:
✅ "Convierte esta función a async/await y agrega manejo de errores
con try/catch, propagando el error original"
❌ "Arregla esto"
Ancla el pedido en código que ya existe:
✅ "Basándote en el patrón de `utils/validate.js`, crea una función
equivalente en `helpers/format.js`"
Mencionar archivos concretos y usar los nombres de funciones y variables que ya están en el proyecto le da al modelo mucho más que cualquier descripción abstracta.
Pide el plan antes que el código cuando el cambio es grande. Es literalmente para lo que existe el modo Plan.
Solución de problemas
El modelo que quiero no aparece en el selector. Está oculto por defecto. Actívalo en la configuración de modelos.
Error de API key. Verifica que tengas créditos disponibles en tu cuenta de Anthropic — una key válida sin saldo falla igual. Si persiste, regenera la key.
Configuré reglas y no cambia nada. Revisa la extensión: tiene que ser .mdc, no .md.
El agente no ve un archivo. Fíjate si está alcanzado por .cursorignore — o por tu .gitignore, que Cursor respeta por defecto.
Respuestas lentas. Prueba Haiku para tareas mecánicas y reserva Opus para lo difícil. Un contexto más chico también ayuda.
Conclusión
La combinación de Cursor y Claude cambió bastante en el último año: los modelos con fecha en el nombre desaparecieron, .cursorrules quedó obsoleto, Composer se absorbió dentro del Agente, y la API key propia pasó de requisito a opción.
Lo que no cambió es lo importante: la IA potencia tu criterio, no lo reemplaza. Revisa y entiende el código generado antes de mandarlo a producción.
¿Usas Cursor, Claude Code, o los dos? ¿Qué reglas tienes en tu .cursor/rules? Cuéntanos en los comentarios 