Cursor error applying edit: por qué no aplica cambios

El error “error applying edit” en Cursor (o sus variantes “error calling tool write” y “Error calling tool ‘edit_file’”) significa que el modelo propuso un cambio, pero Cursor no pudo escribirlo en tu archivo. Las causas más comunes son que el archivo es demasiado grande, que cambió mientras el agente trabajaba, o que el modelo describió mal el fragmento a reemplazar. Casi siempre se resuelve pidiendo cambios más pequeños.

Por qué pasa

Para editar, el agente de Cursor no reescribe todo el archivo: indica “busca este fragmento y reemplázalo por este otro”. Si el fragmento no coincide exactamente con lo que hay en el archivo, o el archivo es enorme, la edición falla. Usuarios del foro de Cursor reportan que pasa más con archivos grandes, tareas largas y algunos modelos en particular.

Causas típicas:

1. Archivo muy grande (miles de líneas): el modelo pierde precisión al ubicar el fragmento.
2. El archivo cambió: lo editaste tú, lo formateó una extensión (Prettier al guardar) o lo cambió otra tarea del agente.
3. Cambio demasiado amplio: el agente intenta reescribir muchas secciones a la vez.
4. Modelo con problemas en la herramienta de edición: en el foro hay reportes de que ciertos modelos fallaban más que otros en algunas versiones.
5. Permisos o archivo bloqueado: el archivo es de solo lectura o lo tiene abierto otro programa (más común en Windows).
6. Error del propio Cursor en una versión específica: el equipo de Cursor ha reconocido en el foro casos donde los cambios se veían en el chat pero no llegaban al archivo.

Solución paso a paso

1. Guarda tu estado

Antes de reintentar:

git add -A
git commit -m "antes de reintentar edición"

2. Pide un cambio más pequeño

En lugar de “refactoriza todo el componente”, divide:

Solo modifica la función handleSubmit en src/components/Form.tsx.
No toques otras funciones ni otros archivos.

Algunos usuarios agregan una regla al proyecto (en las Rules de Cursor) del tipo “haz ediciones pequeñas, una función a la vez”.

3. Cambia de modelo

En el selector del chat, prueba otro modelo. Si usas Auto, elige uno específico.

4. Desactiva el formateo al guardar (temporalmente)

Si tienes “Format on Save” activo, el archivo puede cambiar entre que el agente lo lee y lo edita. Prueba desactivarlo en la configuración del editor mientras trabajas con el agente.

5. Divide archivos gigantes

Si un archivo tiene miles de líneas, pide primero que lo separe:

Divide src/pages/Dashboard.tsx en componentes más pequeños en
src/components/dashboard/. No cambies la lógica, solo muévela.

Archivos más pequeños son más fáciles de editar para la IA y para cualquier persona.

6. Aplica a mano

Si el chat muestra el cambio pero no lo aplica, copia el bloque y pégalo tú. O pide: “dame el archivo completo con el cambio aplicado” y reemplázalo.

7. Actualiza Cursor

Si el problema empezó tras una actualización, revisa si hay una versión más nueva o busca tu número de versión en el foro. Si reportas el error, incluye el Request ID del mensaje (en el menú del mensaje en el chat).

Qué revisar en Windows

• Que el archivo no esté abierto en otro programa que lo bloquee.
• Que la carpeta del proyecto no esté dentro de OneDrive sincronizando en ese momento.
• Que tengas permisos de escritura en la carpeta.

Cómo saber si la edición quedó a medias

A veces el agente dice que terminó, pero solo aplicó parte de los cambios, o los aplicó en un archivo y no en otro. Antes de seguir pidiéndole cosas, revisa qué cambió de verdad:

git status        # qué archivos se modificaron
git diff          # qué líneas cambiaron exactamente

Señales de una edición incompleta:

• Un archivo con funciones o etiquetas abiertas que no cierran (la app ni siquiera compila).
• Importaciones de componentes que no existen todavía.
• Comentarios del tipo // ... resto del código igual pegados dentro del archivo: el modelo escribió un resumen en vez del código.

Si el resultado no te convence, regresa el archivo al último commit y vuelve a pedirlo en partes más chicas:

git checkout -- src/components/Form.tsx

Variantes del mismo problema

• “Error calling tool ‘edit_file’” / “error calling tool write”: el agente intentó usar su herramienta de escritura y falló. Mismas causas y mismos pasos.
• El chat muestra el cambio pero el archivo no cambia: suele ser un fallo de la versión de Cursor o un archivo bloqueado. Aplica a mano y actualiza.
• El agente aplica el cambio en el archivo equivocado: pasa cuando hay archivos con nombres parecidos (Form.tsx en dos carpetas). Escribe siempre la ruta completa en tu petición.
• “Edit was rejected” o el cambio se revierte solo: revisa si rechazaste el cambio sin querer en la vista de diferencias, o si otra extensión está regresando el archivo.

Cómo evitarlo en adelante

Cursor permite guardar reglas del proyecto que el agente lee en cada tarea (según la versión, en la carpeta .cursor/rules o en el archivo .cursorrules; consulta la documentación de reglas de Cursor). Unas reglas útiles para este problema:

- Haz ediciones pequeñas: una función o un componente a la vez.
- Nunca dejes comentarios tipo "resto del código igual"; escribe el código completo.
- Si un archivo pasa de 400 líneas, propone dividirlo antes de editarlo.

Además, haz commit cada vez que algo funcione. Así cada error de edición te cuesta minutos, no una tarde.

Errores comunes

• Reintentar la misma petición enorme una y otra vez.
• Aceptar ediciones parciales sin revisar el git diff: puede quedar código a medias.
• Editar tú el mismo archivo mientras el agente trabaja.
• Dejar crecer archivos de miles de líneas generados por la IA.

Si el proyecto ya está muy enredado

Cuando la IA falla al editar seguido, suele ser señal de que el código creció sin orden: archivos gigantes, funciones duplicadas. Ahí ayuda revisar la estructura antes de seguir. Te puede servir corregir código con IA o, si comparas herramientas, Cursor vs Claude Code. Si prefieres que alguien ordene el proyecto para que tú y la IA puedan seguir trabajando, en Black Engine lo revisamos contigo por WhatsApp.