¿Las rules de Claude Code funcionan en Cursor u otros IDEs? Cómo hacer el contexto portable
Las rules de Claude Code son nativas de ese entorno. Cursor tiene su propio formato. Para ser IDE-agnóstico, la solución es agents.md — una fuente de verdad que cualquier asistente puede consumir.
Dónde viven las rules en cada IDE
Cada asistente de codificación tiene su propio mecanismo para cargar instrucciones persistentes en el contexto. Claude Code usa .claude/rules/, Cursor usa .cursor/rules/. El problema es que ninguno de los dos formatos es legible por el otro. Si tu equipo usa ambos IDEs, tienes que mantener las reglas duplicadas en dos lugares distintos — o encontrar un enfoque diferente.
| IDE / Asistente | Ruta de rules | Cómo se carga | Portabilidad |
|---|---|---|---|
| Claude Code | .claude/rules/ | Contexto global automático | Nativo — no portable |
| Cursor | .cursor/rules/ | Contexto del workspace | Nativo — no portable |
| Cualquier asistente | agents.md | Cargado explícitamente | IDE-agnóstico |
Qué son las rules en realidad
Las rules no son magia del IDE — son archivos de texto plano que el asistente lee e inyecta en su contexto antes de cada respuesta. En Claude Code, los archivos en.claude/rules/se cargan junto con las skills y los agentes en el contexto global. En Cursor, los archivos en .cursor/rules/ funcionan de forma análoga.
La consecuencia directa es importante: las rules consumen context window. Cuantas más reglas tengas, más tokens ocupan en cada llamada al modelo. En proyectos grandes con muchas reglas, esto puede volverse significativo. Vale la pena ser selectivo en qué conviertes en rule y qué simplemente documentas en el README.
Punto clave: las rules son fragmentos de prompt que se inyectan en el contexto. No son lógica ejecutable, no son código. Son texto que el modelo lee y sigue (o debería seguir) al generar respuestas. Esto significa que se pueden expresar en cualquier formato legible — Markdown, texto plano, pseudo-código.
La solución: agents.md
El formato agents.md es compatible con el Anthropic agents format y puede ser consumido por cualquier asistente que lo soporte. En lugar de mantener las reglas en dos rutas distintas para dos IDEs distintos, defines las reglas una sola vez en agents.md y cada IDE lo lee desde allí.
El flujo práctico es: escribe las reglas en agents.md, haz que los archivos específicos de cada IDE referencien o importen ese documento como fuente de verdad. Cuando actualices una regla, el cambio se propaga a todos los IDEs sin duplicación.
# agents.md ← fuente de verdad única ## Reglas de desarrollo - Usar TypeScript estricto, sin any - Commits en Conventional Commits format - Tests antes de PR - [...] # .claude/rules/main.md ← wrapper para Claude Code @include ../agents.md # .cursor/rules/main.mdc ← wrapper para Cursor @include ../../agents.md
Cómo carga Claude Code el contexto
En Claude Code, el contexto que llega al modelo en cada llamada incluye: el contenido de los archivos en .claude/rules/, las skills disponibles, los agentes definidos, el historial de la conversación y los archivos del proyecto que el modelo ha leído. Todo esto compite por espacio en el context window.
Las rules se cargan en el contexto global, lo que significa que están presentes en cada turno de la conversación independientemente de si son relevantes para la tarea en curso. Esta persistencia es su fortaleza — garantiza que las reglas siempre se apliquen — pero también su coste: tokens ocupados en cada llamada aunque la regla no sea pertinente.
Consejo práctico: agrupa reglas relacionadas en archivos temáticos (git.md, typescript.md, testing.md) en lugar de poner todo en un único archivo enorme. Facilita el mantenimiento y, si el IDE permite carga selectiva, permite activar solo las rules relevantes para cada tipo de tarea.
El takeaway
¿Quieres aplicar esto en tu equipo?
En Kuuli Technologies llevamos estas metodologías a equipos reales. Escríbenos si quieres una sesión de trabajo o una consultoría sobre agentes IA y SDD.