Tutorial de Cursor 2026: cómo usar Agent en 15 minutos

Este tutorial muestra cómo usar Cursor si lo abres por primera vez. Sigue la documentación oficial de Cursor al 1 de noviembre de 2026, cuando la versión vigente era Cursor IDE 3.27.

Una nota sobre el método: el equipo de NxCode escribió esta guía a partir de esos documentos y no ejecutó los pasos en una instalación limpia. NxCode es nuestro propio producto, un creador de apps con IA, y es independiente de Cursor. Cuando la guía dice lo que deberías ver, eso sale de la documentación, así que tu pantalla puede variar en detalles. Cuando las páginas oficiales se contradicen o dejan un vacío, lo decimos.

Si leíste un tutorial de Cursor más antiguo, espera algunas sorpresas. El modo Composer, Inline Edit con Cmd+K y el modo Chat separado ya no aparecen en la documentación actual.

Tu ruta de 15 minutos

Minutos	Qué haces	Qué obtienes
0–3	Instalas, inicias sesión y abres una carpeta de práctica	Cursor funcionando en tu computadora
3–5	Conoces las dos ventanas y algunos atajos	Sabes dónde vive Agent
5–10	Haces la primera tarea con Ask y luego con Agent	Una página pequeña mejorada por Agent
10–12	Revisas los cambios y los pruebas	Sabes qué hizo Agent realmente
12–14	Practicas restaurar un checkpoint	Sabes cómo deshacer
14–15	Agregas una regla de proyecto	Agent sigue tus preferencias

¿Qué es Cursor?

Cursor es un editor de código con un agente de IA integrado. Describes una tarea en lenguaje natural, y Agent lee tu proyecto, edita archivos y puede ejecutar comandos.

Si has usado VS Code, el editor te resultará familiar. Los atajos normales de edición son los mismos, y puedes importar tus extensiones, temas, ajustes y combinaciones de teclas.

En un día normal, dentro de Cursor pasan tres cosas:

Agent se encarga de tareas en todo tu proyecto.
Tab predice lo que vas a escribir mientras escribes código por tu cuenta.
Rules le dicen a Agent cómo debe tratar tu proyecto.

Cursor conviene a quienes quieren trabajar con código o aprender a hacerlo. Quien solo quiere una app terminada y no tiene interés en leer diffs tiene otro trabajo por hacer, y eso lo cubrimos más abajo en "Cuándo usar otra herramienta". NxCode es una opción ahí.

Instala Cursor y ábrelo por primera vez

Paso 1: descarga

Ve a cursor.com/download y elige tu sistema.

Sistema	Requisito	Qué descargar
macOS	12 o posterior	`.dmg`, para Apple Silicon o Intel
Windows	10 o posterior	`.exe`, x64 o ARM64, cada uno con instaladores System y User
Linux	Debian/Ubuntu o RHEL/Fedora	Primero el repositorio apt o yum, AppImage también disponible

En Linux, la guía de inicio rápido oficial prefiere los repositorios apt y yum porque agregan un ícono de escritorio, actualizaciones automáticas y la herramienta de línea de comandos.

Paso 2: abre Cursor e inicia sesión

El orden oficial es corto: descargar, abrir, iniciar sesión, elegir una carpeta y empezar con una tarea pequeña. Necesitas una cuenta.

El inicio de sesión de Cursor puede enviarte a una página compartida de xAI con la marca Grok o xAI. Es lo esperado, porque la clientela nueva empieza ahora con The X Subscription, la suscripción con la que se vende Cursor. Iniciar sesión no fusiona cuentas ni cambia un plan.

Las guías más antiguas incluyen "elegir tu modelo de IA" como paso del primer inicio. La documentación actual no tiene ese paso. Puedes definir uno predeterminado más adelante en Cursor Settings > Models, o cambiarlo durante una conversación.

La documentación tampoco dice si quien recién llega entra primero a la Agents Window o al editor. La siguiente sección muestra cómo moverte entre ambos, así que cualquiera de los dos inicios sirve.

Paso 3: elige un plan

Empieza en Free ($0, uso limitado), pasa a Plus ($8/mes) si los límites interrumpen tu trabajo y elige Premium ($30/mes) solo cuando necesites Cloud Agents, modelos de terceros o tus propias claves de API.

Los precios no incluyen impuestos. Por encima están Super ($100) y Ultra ($200). Para más detalle, consulta nuestra guía de precios de Cursor o la página de precios oficial. Compra solo por el sitio oficial o por compra dentro de la app, ya que la página de precios dice que Cursor no autoriza la reventa: "not authorize any resellers or third-party sellers".

Paso 4: opcional, trae tu configuración de VS Code

Importar los ajustes de VS Code ya no se describe como un paso del primer inicio. Si quieres hacerlo, presiona Cmd+Shift+J (Ctrl+Shift+J en Windows y Linux) para abrir Cursor Settings y ve a General > Account > VS Code Import > Import.

Las extensiones en Cursor vienen de Open VSX, no de VS Code Marketplace, y no todas están ahí. Si falta una después de importar, ese es el motivo probable.

Revisa quién publica una extensión antes de instalar nada. El 29 de octubre de 2026, Cursor advirtió sobre una extensión maliciosa que se hacía pasar por Anthropic.claude-code (versiones 2.1.312 y 2.1.313) en su marketplace.

Conoce la interfaz

Dos ventanas: Agents Window y el editor

Cursor tiene dos interfaces principales, y la documentación dice que ambas siguen con soporte. Puedes tenerlas abiertas al mismo tiempo.

	Agents Window	Editor (IDE)
Se organiza alrededor de	Los agentes	Tus archivos
Sirve para	Varios repositorios, agentes en paralelo, trabajo local, en la nube y por SSH	Leer y editar código junto a Agent
Cómo llegar	Cmd+Shift+P, luego Open Agents Window	Cmd+Shift+P, luego Open IDE

En Windows y Linux, la paleta de comandos es Ctrl+Shift+P.

Algunas funciones existen solo en la Agents Window, entre ellas varios espacios de trabajo, la nueva vista de diff, agentes en la nube en paralelo y la interfaz nativa de Worktrees.

Para tu primer día, usa el editor. Puedes ver el archivo y la conversación lado a lado, lo que facilita seguir lo que hace Agent.

El panel de Agent

En el editor, presiona Cmd+I (Ctrl+I) para abrir el panel lateral. La documentación lo llama "Agent panel" y la tabla de atajos lo llama "Sidepanel". Son lo mismo.

Dentro del panel vas a usar:

El cuadro de entrada para tu petición. Arrastra o pega imágenes, o usa el micrófono para hablar.
El menú de modos, que cambia entre Agent, Ask, Plan y Debug.
El selector de modelos, en la parte superior del cuadro de entrada.
@ para señalar algo específico y / para llamar skills y comandos.

La lista oficial actual de @ es corta: un archivo o carpeta como @index.html o @src/components/, @Terminals, @Chats, @Commit (Diff of Working State), @Branch (Diff with Main) y @Browser. Si no sabes qué archivo importa, omite @. La documentación dice que Agent encuentra los archivos relevantes con su propia búsqueda.

Los tutoriales más antiguos enseñan @codebase, @docs y @web. No están en la lista actual, y no pudimos confirmar si todavía funcionan.

La barra lateral también tiene una página Customize, que reúne plugins, skills, MCP, subagentes, reglas, comandos y hooks en un solo lugar. La usarás más adelante.

Términos que conviene conocer: qué significan ahora los nombres

Muchos nombres de Cursor cambiaron. Esta tabla muestra qué significa cada uno hoy.

Término	Qué significa ahora	Si un tutorial viejo dice
Composer	El modelo propio de Cursor, actualmente Composer 2.5, descrito como rápido y eficiente en costos	"Modo Composer": ya no está en la documentación, usa Agent
Agent	El modo predeterminado y la forma principal de trabajar	"Cambia a Agent en Composer": no hace falta cambiar
Chat	No es un modo separado. La documentación escribe "Agent (Chat)"	"Abre Chat para hacer preguntas": usa Ask, el modo de solo lectura
Inline Edit	Retirado; ver abajo	"Selecciona código y presiona Cmd+K para editar en el lugar": selecciona código, presiona Cmd+K o Cmd+L, y va a Agent
Tab	Autocompletado, nombre sin cambios	"Supermaven": la palabra no aparece en la documentación oficial que leímos
Free	El plan de $0 para la clientela nueva	"Hobby": un plan heredado que se mantiene para quienes ya lo tienen
Regla `.mdc`	El tipo de archivo obligatorio para las reglas de proyecto	"`.cursorrules`": heredado y con obsolescencia prevista

La página de ayuda de Cursor dice que Cmd+K "used to open inline edit, which has been replaced by this workflow" (antes abría la edición en línea, que fue reemplazada por este flujo). Una publicación del personal de Cursor en el foro oficial da la fecha, 26 de octubre de 2026, y dice que esto incluye generar comandos con Cmd+K en la terminal. El reemplazo sugerido es Cmd+I y pedírselo a Agent. Una página de ayuda, sobre la terminal, todavía menciona generar comandos con lenguaje natural, así que la documentación no es del todo coherente aquí. Esta guía sigue la publicación del personal.

Atajos para tu primer día

La tabla de referencia de Cursor indica solo teclas de Mac, y las páginas de ayuda agregan algunas de Windows y Linux. Cuando no se indica nada, lo decimos en lugar de adivinar. En esos casos, revisa los ajustes de atajos en la app (Cmd+R y luego Cmd+S, o Ctrl+R y luego Ctrl+S).

Acción	Mac	Windows / Linux
Abrir o cerrar el panel de Agent	Cmd+I, Cmd+L o Cmd+K	Ctrl+I, Ctrl+L o Ctrl+K
Enviar el código seleccionado a un chat nuevo	Cmd+L o Cmd+K	Ctrl+L o Ctrl+K
Agregar el código seleccionado al chat actual	Cmd+Shift+L	No indicado, revisa la app
Alternar modos	Shift+Tab	Shift+Tab
Abrir el menú de modos	Cmd+.	Ctrl+.
Alternar modelos	Cmd+/	Ctrl+/
Aceptar una sugerencia de Tab	Tab	Tab
Aceptar Tab palabra por palabra	Cmd+→	Ctrl+→
Rechazar una sugerencia de Tab	Escape, o sigue escribiendo	Escape, o sigue escribiendo
Aceptar todos los cambios	Cmd+Return	No indicado, revisa la app
Rechazar todos los cambios	Cmd+Shift+Backspace	No indicado, revisa la app
Cursor Settings	Cmd+Shift+J	Ctrl+Shift+J
Paleta de comandos	Cmd+Shift+P	Ctrl+Shift+P

Dos teclas dependen de dónde estés. Cmd+K abre el panel en el editor, pero en la Agents Window abre una paleta de comandos. Cmd+Return también tiene varios significados según el contexto, como muestra la referencia de atajos de teclado. Cmd+Shift+Backspace también aparece para cancelar una respuesta en curso, así que presiónalo con cuidado.

Primera tarea paso a paso: mejora un proyecto pequeño con Agent

Este ejemplo usa una sola página web, así que no necesitas más herramientas que Cursor y un navegador. Primero vas a hacer preguntas y después dejarás que Agent haga cambios.

Paso 1: crea el proyecto de práctica

Crea una carpeta vacía llamada cursor-practice y elígela como tu carpeta en Cursor. Crea un archivo llamado index.html y pega esto:

<!doctype html>
<html>
  <head><meta charset="utf-8"><title>Tip calculator</title></head>
  <body>
    <h1>Tip calculator</h1>
    <label>Bill <input id="bill" type="number"></label>
    <button onclick="calculate()">Calculate 15% tip</button>
    <p id="result"></p>
    <script>
      function calculate() {
        const bill = Number(document.getElementById("bill").value);
        document.getElementById("result").textContent = "Tip: " + (bill * 0.15);
      }
    </script>
  </body>
</html>

Guarda el archivo y ábrelo en tu navegador. Presiona el botón con el campo Bill vacío y verás "Tip: 0". Ese es el pequeño problema que vas a arreglar.

Paso 2: pregunta antes de cambiar nada

Presiona Cmd+I (Ctrl+I). Abre el menú de modos y elige Ask, o presiona Shift+Tab hasta que aparezca. Escribe esta petición, que pide explicar en lenguaje sencillo qué hace index.html y luego listar los problemas que podría encontrar quien lo use:

Explain what index.html does in plain language.
Then list the problems a user could run into.

Lo que deberías ver: una respuesta escrita en el panel. Tu archivo no cambia, porque Ask es de solo lectura. Probablemente la respuesta mencione la cuenta vacía. La redacción exacta varía entre ejecuciones, así que no esperes una respuesta fija.

Paso 3: dale a Agent una tarea específica

Vuelve a Agent. Cambiar de modo abre una nueva ventana de contexto, así que escribe la petición de modo que se sostenga por sí sola. Esta pide mostrar un mensaje si la cuenta está vacía, es cero o es negativa, mostrar la propina con dos decimales y agregar un menú de 10%, 15% y 20% con 15% seleccionado de forma predeterminada, todo en este único archivo y sin bibliotecas:

In @index.html, improve the tip calculator:
1. If the bill is empty, zero or negative, show "Enter a bill above 0".
2. Show the tip with two decimal places.
3. Add a dropdown for 10%, 15% and 20%, with 15% selected by default.
Keep everything in this one file. Do not add libraries.

Lo que deberías ver: Agent lee el archivo y empieza a editar. Lo importante si estás empezando es que las ediciones se aplican mientras Agent trabaja. No apruebas cada cambio por adelantado. Revisas el resultado después, en una vista de diff.

Agent también puede querer ejecutar un comando. Cómo se maneja eso depende del modo de ejecución, que se define en Cursor Settings > Agents > Approvals & Execution. Las opciones son Auto-review (la predeterminada), Allowlist y Run Everything. Por ahora, déjalo en la predeterminada.

Paso 4: revisa el diff

Cursor muestra las ediciones en una vista de diff. La documentación no nombra el botón exacto, así que búscalo alrededor del archivo editado y del panel de Agent. Léelo línea por línea. Un diff muestra las líneas eliminadas y las agregadas, así que puedes ver exactamente qué cambió. Para esta tarea, busca:

una comprobación del valor de la cuenta
un menú con tres porcentajes
una propina redondeada a dos decimales
nada ajeno a la tarea, como un archivo nuevo que no pediste

Rechaza lo que no quieras. Para aceptar o rechazar todo de una vez en Mac, usa Cmd+Return o Cmd+Shift+Backspace. Para Windows y Linux, revisa la app, como se indicó arriba.

Paso 5: pruébalo por tu cuenta

Recarga la página en tu navegador y prueba estos casos:

Entrada	Resultado esperado
Cuenta vacía	El mensaje "Enter a bill above 0"
-5	El mismo mensaje
100 con 15%	Tip: 15.00, o algo similar
100 con 20%	Tip: 20.00, o algo similar

Si alguno falla, dile a Agent exactamente qué pasó: "Con una cuenta de -5, la página muestra Tip: -0.75. Debería mostrar el mensaje." Esto funciona mucho mejor que "está roto".

Paso 6: practica deshacer

Ahora haz un cambio que piensas descartar. Esta petición pide poner el fondo de la página en verde brillante y todo el texto a 40px:

Change the page background to bright green and make all text 40px.

Recarga el navegador para verlo. Luego sube en la conversación y haz clic en Restore Checkpoint en esa petición. Una página de ayuda llama a este botón Revert. Recarga otra vez y el verde debería desaparecer. Si no desaparece, restaura desde la petición anterior. Agent crea checkpoints antes de los cambios importantes, así que si no ves un botón para un cambio tan pequeño, recházalo en el diff. Tus mensajes se quedan en la conversación, porque una restauración solo revierte archivos.

Ese es todo el ciclo diario: preguntar, instruir, revisar, probar y deshacer si hace falta. Si leer diffs es la parte que nunca quieres hacer, conviene saberlo pronto. Puede ser señal de que NxCode, nuestro propio creador de apps, te conviene más que un editor.

Cuándo usar Agent, Ask, Plan y Debug

Hay cuatro modos. Cambia con Shift+Tab o con el menú del panel de Agent.

Modo	Úsalo cuando	¿Puede cambiar archivos?	Ejemplo de prompt
Agent	Quieres construir, refactorizar o arreglar algo. Es el predeterminado	Sí	"Agrega un botón de reinicio y borra el resultado cuando se presione."
Ask	Quieres entender el código	No, solo lectura	"¿Cómo se calcula la propina aquí?"
Plan	La tarea es grande o poco clara y quieres revisar el enfoque primero	Después de que apruebes	"Planifica cómo dividir esta página en archivos HTML, CSS y JS separados."
Debug	Un bug necesita evidencia del programa en ejecución	Sí	"La propina es incorrecta después de cambiar el porcentaje. Encuentra la causa."

Una forma sencilla de elegir:

¿Todavía no lo entiendes? Ask.
¿Sabes lo que quieres y el cambio es pequeño? Agent.
¿Toca muchos archivos o no tienes claro el enfoque? Plan.
¿Un bug que no puedes explicar leyendo el código? Debug.

En el modo Plan, Agent hace preguntas aclaratorias, investiga tu código y escribe un plan. No se construye nada hasta que haces clic en Build. Los planes se guardan en tu directorio personal de forma predeterminada, y Save to workspace mueve uno a tu proyecto. Cursor también puede sugerir Plan cuando tu petición parece compleja.

En el modo Debug, Agent forma hipótesis, agrega registros y usa la información en tiempo de ejecución para encontrar la causa.

Revisa y deshaz cambios

Lista de revisión

Úsala antes de conservar cualquier cambio de Agent:

Lee todo el diff, no solo el resumen.
Cada archivo cambiado tiene relación con la tarea.
Puedes explicar cada cambio. Si no puedes, pregunta en el modo Ask.
No se eliminó nada que debía quedarse.
No aparecen contraseñas, claves ni otros secretos en el código.
Lo probaste por tu cuenta, incluida una entrada incorrecta.

Además de tu propia revisión, Cursor tiene Agent Review, que se inicia con /agent-review o desde la pestaña Source Control.

Cómo funcionan los checkpoints

Agent crea un checkpoint automáticamente antes de los cambios importantes. Los checkpoints se guardan localmente y son independientes de Git.

Hay tres formas de restaurar:

Haz clic en un checkpoint en la línea de tiempo del chat para previsualizarlo y luego restáuralo.
Haz clic en Restore Checkpoint en una petición anterior.
Pasa el cursor sobre un mensaje y haz clic en el botón +.

Restaurar revierte archivos, pero no borra mensajes. Para acortar también la conversación, crea una bifurcación desde un mensaje anterior.

Las páginas oficiales se contradicen en un nombre. La documentación de Agent llama al botón Restore Checkpoint, mientras que la página de ayuda de Plan lo llama Revert, seguido de Confirm. Busca cualquiera de las dos etiquetas.

Usa Git para lo que quieras conservar

El propio consejo de Cursor es "use Git for permanent version control" (usa Git para el control de versiones permanente). Los checkpoints son un deshacer rápido, y Git es tu historial a largo plazo. Antes de una tarea grande de Agent, guarda un estado que funcione:

git init
git add .
git commit -m "Working version before Agent task"

Solo necesitas git init una vez por proyecto.

Agrega reglas a tu proyecto

Las reglas son instrucciones permanentes, para que no tengas que repetirte. Agrega una al proyecto de práctica. Hay tres formas de crear una regla de proyecto:

Escribe /create-rule en el chat.
Ve a Customize > Rules > Add Rule.
Ejecuta New Cursor Rule desde la paleta de comandos.

O crea el archivo por tu cuenta en .cursor/rules/practice.mdc:

---
description: Conventions for this practice project
globs:
alwaysApply: true
---

- Keep everything in index.html unless asked otherwise.
- Do not add libraries.
- Use clear variable names and short comments.

Ahora pídele a Agent otro cambio pequeño. Debería seguir estas reglas sin que se lo digas.

Cuatro cosas que debes saber:

La extensión debe ser .mdc. Los archivos que terminan en .md se ignoran en el sistema de reglas de esa carpeta.
AGENTS.md es la opción más simple. Es Markdown normal, ubicado en la raíz del proyecto o en una subcarpeta. Cursor lee CLAUDE.md de la misma manera.
Las reglas aplican solo a Agent. No afectan a Tab ni a Bugbot.
Mantenlas cortas. Cursor sugiere menos de 500 líneas por regla.

Las reglas tienen cuatro tipos: Always Apply, Apply Intelligently, Apply to Specific Files y Apply Manually (con una mención @). La precedencia es Team, luego Project, luego User. .cursorrules es heredado y quedará obsoleto, así que no empieces un proyecto nuevo con él.

MCP, Skills, subagentes y Cloud Agents de un vistazo

No necesitas nada de esto el primer día. Es solo para que reconozcas los nombres.

MCP conecta a Agent con herramientas y servicios externos. Instálalo desde Customize > MCPs > Add to Cursor, o configura .cursor/mcp.json en un proyecto o ~/.cursor/mcp.json de forma global. Si ambos definen el mismo nombre, gana el proyecto. Nuestra guía de Cursor MCP va más lejos.
Skills son carpetas con un archivo SKILL.md que le enseñan a Agent un procedimiento. Agent las usa cuando son relevantes, o llamas una con /. Algunos ejemplos integrados son /create-rule, /review y /shell.
Subagentes tienen su propio contexto y pueden ejecutarse en paralelo. Los integrados son Explore y Browser. Los personalizados van en .cursor/agents/.
Cloud Agents se ejecutan en máquinas aisladas en la nube, así que no dependen de que tu computadora siga en línea. Elige Cloud en el menú del cuadro de entrada del agente. Alguien con rol de administración debe conectar primero GitHub, GitLab, Bitbucket o Azure DevOps, y necesitas acceso de lectura y escritura al repositorio. No están disponibles en Free ni en Plus.

La línea de comandos: `agent`

Cursor también tiene una CLI, y el comando es agent. Instálala con:

# macOS, Linux, WSL
curl https://cursor.com/install -fsS | bash

# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex

Compruébala con agent --version e inicia sesión con agent login. Luego ejecuta agent en una carpeta de proyecto para una sesión interactiva, o agent -p "your request" para una sola ejecución no interactiva. Lee los mismos archivos .cursor/rules, AGENTS.md y CLAUDE.md que el editor. Si estás empezando, puedes dejar esto para más adelante.

Errores comunes

Seguir un tutorial viejo. Si una guía dice que abras el modo Composer, que presiones Cmd+K para editar en el lugar o que elijas un modelo en el primer inicio, describe un Cursor más antiguo.

Suponer que nada cambió hasta que aceptes. Las ediciones de Agent ya están aplicadas mientras trabaja. Revisa el diff antes de seguir, y no ejecutes el código por pura confianza.

Escribir peticiones vagas. "Arregla esto" le da poco con qué trabajar a Agent. Di qué pasa, qué debería pasar y dónde: "Cuando la cuenta está vacía, la página muestra Tip: 0. Debería mostrar un mensaje."

Empezar demasiado grande. No comiences con una app completa. Usa primero tareas pequeñas, y el modo Plan para cualquier cosa más grande.

Tratar los checkpoints como copias de seguridad. Son locales e independientes de Git. Haz commit de lo que te importe.

Guardar una regla como .md. Se ve correcta y no hace nada. Usa .mdc, o AGENTS.md en la raíz del proyecto.

Cambiar el modo de ejecución el primer día. Deja el predeterminado hasta que entiendas qué ejecuta Agent en tu computadora y qué permiso otorga cada opción.

Elegir un modelo de terceros sin revisar el costo. En Premium y superiores, los modelos de terceros cobran créditos prepago a precio de lista de API desde la primera solicitud. No usan tu bolsa semanal.

Aceptar código que no puedes explicar. Para eso existe el modo Ask. Pregunta "¿qué hace este cambio, paso a paso?" antes de conservarlo.

Solución de problemas

Interfaz y configuración

Lo que ves	Motivo probable	Qué hacer
No aparece el modo Composer	Ya no existe como modo	Usa Agent con Cmd+I (Ctrl+I)
Cmd+K no edita en el lugar	Inline Edit se retiró	Selecciona código, presiona Cmd+K y describe el cambio en Agent
Cmd+K abre una paleta de comandos	Estás en la Agents Window	Usa Cmd+Shift+P y luego Open IDE para volver al editor
Aparece una página de inicio de sesión de Grok o xAI	Inicio de sesión compartido	Es lo esperado. Iniciar sesión no fusiona cuentas
Falta una extensión	Puede que no esté en Open VSX	Busca una alternativa en Open VSX
Se ignora una regla	Extensión o ubicación incorrecta	Usa `.cursor/rules/name.mdc` y revisa su tipo
Agent olvida el contexto anterior	Cambiaste de modo	Cada cambio abre una nueva ventana de contexto, así que repite los puntos clave
Un atajo no hace nada en Windows	Puede diferir de la tecla de Mac	Revisa los ajustes de atajos con Ctrl+R y luego Ctrl+S

Modelos, planes y la CLI

Lo que ves	Motivo probable	Qué hacer
Falta Claude o GPT	Plan o región	Free y Plus excluyen los modelos de terceros. Algunos modelos también están ocultos en ciertas regiones
Cloud Agents no está disponible	Plan o configuración del repositorio	Necesita Premium o superior, un proveedor Git conectado y acceso al repositorio
Llegaste a un límite de uso	Se alcanzó el límite del plan	Revisa Usage en grok.com/dashboard. En planes de pago, espera el reinicio semanal, usa créditos prepago o mejora de plan
No encuentras la facturación	La facturación se movió	The X Subscription usa grok.com/dashboard/billing. Los planes heredados usan cursor.com/dashboard/spending
`agent: command not found`	`~/.local/bin` no está en tu PATH	Agrégalo a tu PATH y abre una terminal nueva

Cuándo usar otra herramienta

Cursor es una herramienta para trabajar con código. Estos escenarios pueden apuntar a otra parte:

No quieres escribir ni revisar código en absoluto. Quieres una app funcional a partir de una descripción. Para eso es NxCode, nuestro propio producto. Lo hacemos nosotros, así que tenlo en cuenta al leer esto, y consulta nuestra comparación con Cursor y Copilot.
Vives en la terminal. Prueba primero el comando agent de Cursor, o compáralo con el flujo de nuestro tutorial de Claude Code.
Usas JetBrains. Puede que no necesites cambiar de editor, porque el agente de Cursor se conecta a JetBrains mediante ACP.
Todavía estás comparando herramientas. Nuestro ranking de herramientas de programación con IA presenta las opciones.

Probar Cursor en Free no cuesta nada, así que una tarea real pequeña es una forma razonable de decidir. Si el flujo de arriba te pareció natural, quédate. Si el código mismo te estorbó, probablemente te corresponde el primer escenario.

FAQ

¿Cómo empiezo a usar Cursor por primera vez?

Descarga Cursor desde cursor.com/download, ábrelo, inicia sesión y elige una carpeta. Luego presiona Cmd+I (Ctrl+I en Windows y Linux) para abrir Agent y pídele que explique el código. La guía de inicio rápido de Cursor recomienda empezar con una tarea pequeña como esta.

¿Qué pasó con el modo Composer en Cursor?

El modo Composer no está en la documentación actual de Cursor. Composer es ahora el nombre del modelo propio de Cursor, actualmente Composer 2.5. Los cuatro modos son Agent, Ask, Plan y Debug. Para el trabajo en varios archivos que los tutoriales antiguos hacían en el modo Composer, usa Agent.

¿Qué pasó con la edición en línea de Cmd+K en Cursor?

Inline Edit se retiró. Una publicación del personal de Cursor en el foro oficial la fecha el 26 de octubre de 2026. En el editor, selecciona código y presiona Cmd+K o Cmd+L (Ctrl+K o Ctrl+L en Windows y Linux) para llevar la selección a Agent, y describe ahí el cambio.

¿Cursor es gratis?

Sí, hay un plan Free de $0 con uso limitado de Agent, Chat y Tab. Cursor no publica un número para esos límites. La página de precios actual no dice si se necesita tarjeta de crédito, así que revísalo al registrarte. Los planes de pago empiezan en Plus, a $8 al mes antes de impuestos.

¿Qué modelos de IA puedo usar en Cursor?

Los modelos propios de Cursor son Grok 4.7, al que llama su modelo insignia, Grok 4.6, Grok 4.5 y Composer 2.5. Los modelos de terceros, como Claude, GPT y Gemini, requieren Premium o superior y se cobran a precio de lista de API con créditos prepago. Free y Plus no los incluyen.

¿Cursor Agent cambia mis archivos antes de que los apruebe?

Sí. Agent aplica las ediciones mientras trabaja, y tú las revisas después en una vista de diff, donde puedes rechazar lo que no quieras. Agent también crea checkpoints antes de los cambios importantes, así que puedes restaurar estados anteriores de los archivos.

¿Necesito saber programar para usar Cursor?

Puedes probarlo sin mucha experiencia porque el modo Ask explica el código en lenguaje sencillo, pero igual tienes que leer los diffs y juzgar el resultado. Si prefieres describir una app y no trabajar con código en absoluto, NxCode, nuestro propio producto, está hecho para eso.

¿Dónde puedo comprar Cursor, y puedo suscribirme desde China continental?

Cursor dice que las suscripciones se venden solo por su sitio web oficial o por compra dentro de la app, y que no autoriza la reventa por terceros. La compra dentro de la app en iOS cubre las regiones de App Store excepto China continental. No se pudo verificar en las páginas oficiales si las suscripciones web están restringidas en China continental.

Fuentes

Todas las páginas se revisaron el 1 de noviembre de 2026. Los atajos, planes y nombres pueden cambiar, así que considera definitivos la app y las páginas oficiales.