Respuestas
¿Cómo comparto las mismas reglas de CLAUDE.md entre muchos repositorios?
Claude Code ofrece varias vías, y cada una se detiene en algún punto. La documentación que leí dice que carga el CLAUDE.md del directorio de trabajo y de todos los directorios superiores, así que un archivo en una carpeta madre llega a todo repositorio clonado debajo de ella en esa máquina. Un CLAUDE.md puede importar otro archivo con @ruta, y los enlaces simbólicos en .claude/rules/ pueden apuntar a una carpeta compartida, pero una importación o enlace que resuelve fuera del directorio de trabajo pide aprobación una vez por proyecto. Los directorios añadidos con --add-dir no cargan su CLAUDE.md salvo que se defina una variable de entorno. El archivo de usuario vale para todos tus proyectos, pero solo para ti, y el archivo de política gestionada solo llega a todos los usuarios de una máquina si TI lo distribuye. Cada una exige los mismos archivos en los mismos lugares del disco de cada persona, y quien usa otra herramienta no lee ninguno. Cuando lo que importa es que una regla valga para varios repositorios y para toda herramienta, regístrala una vez en un proyecto de Arroway y haz que cada repositorio apunte a ese proyecto. El primer paso es la página de instalación.
Última actualización 15 de octubre de 2026
Cómo viaja el archivo del proyecto en un repositorio
En un repositorio, el CLAUDE.md del proyecto está commiteado, el compañero lo recibe al hacer pull y Claude Code lo carga al inicio de la sesión. La documentación recomienda mantener cada archivo por debajo de unas 200 líneas y dice que Claude trata el contenido como contexto, no como configuración impuesta. La regla que vale para el equipo va a Arroway, donde alguien la ve y la aprueba.
Qué pasa con N repositorios, y dónde se detiene cada vía
Copiar la regla en cada repositorio es el primer movimiento, y cada copia se aleja de las demás: el día que la regla cambia, alguien actualiza cuatro de las seis. Un archivo en una carpeta madre lo lee todo repositorio debajo, lo que solo funciona si todos clonan con la misma estructura y abren Claude Code desde dentro. Una importación @ruta o un enlace simbólico a una carpeta compartida mantiene una sola fuente, pero la documentación dice que una ruta fuera del directorio de trabajo dispara un diálogo de aprobación la primera vez, y la carpeta tiene que existir en la misma ruta para cada persona. Añadir un directorio con --add-dir no carga su CLAUDE.md salvo que CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD esté definida. El archivo en tu directorio personal es solo tuyo, y el archivo gestionado es para una organización que puede empujar archivos a sus máquinas. En todos los casos la regla vive en un archivo en un disco, y nada en el archivo dice quién la aprobó ni cuándo deja de valer.
Cuándo usar Arroway
Usa Arroway cuando la regla pertenece al trabajo, no a un repositorio: la misma regla para la API, la app web y el código de infraestructura, en la herramienta en que alguien abra cada uno. La regla se registra una vez en el proyecto y una persona la aprueba. Cada repositorio solo necesita el bloque corto que añade la instalación, que le dice al agente qué proyecto leer antes de actuar y que registre lo decidido al terminar. Cuando la regla cambia, la nueva nombra la que reemplaza, así que los seis repositorios no guardan seis versiones. Claude Code, Codex, Cursor y cualquier otra herramienta que se conecte por MCP leen la misma regla. El primer paso es la página de instalación.
Cómo se ve en la práctica
Un pequeño estudio mantiene su trabajo en seis repositorios: el sitio web, la API, la app móvil, la infraestructura, la documentación y una carpeta de scripts. La regla del estudio es que no entra ninguna dependencia nueva sin una línea en el pull request que diga por qué. En marzo la regla se copia en los seis CLAUDE.md. En junio los socios la cambian: los paquetes utilitarios pequeños ya no necesitan la línea. Uno de ellos edita los archivos de la API y del sitio. Los otros cuatro conservan la regla antigua, y una IA que trabaja en la carpeta de scripts se niega a añadir un paquete que no tenía motivo para rechazar. Con la regla registrada una vez en el proyecto, el cambio de junio es una regla nueva que nombra la de marzo, con la aprobación del socio. Los seis repositorios no cambian, y una sesión en cualquiera de ellos lee la regla vigente al abrir. El estudio y la regla son ilustrativos; nada aquí se midió en un equipo real.
Preguntas que la gente hace sobre esto
- ¿Basta con un enlace simbólico a una carpeta de reglas compartida?
- Mantiene una sola fuente en tu máquina y en las de quien cree el mismo enlace. Según la documentación, un enlace que apunta fuera del directorio de trabajo pide aprobación una vez por proyecto, y un compañero que usa otra herramienta no lo lee. Tampoco registra quién aprobó una regla ni cuándo termina.
- ¿Cada repositorio debe mantener su propia copia de las reglas del equipo?
- No. Cada repositorio solo necesita el bloque corto que añade la instalación, que le dice al agente qué proyecto leer antes de actuar. Lo que el equipo decidió se registra una vez en el proyecto, donde alguien lo ve y lo aprueba, para que ningún repositorio guarde una copia vieja.
- ¿Cómo pruebo Arroway?
- Instálalo en la herramienta que ya usas — la página de instalación tiene una ruta para Claude, ChatGPT, Codex, Cursor o cualquier herramienta MCP — e inicia sesión cuando la herramienta lo pida. Desde entonces, las sesiones abren leyendo el proyecto y cierran registrando lo que se decidió.
Dónde se puede comprobar
La página de memoria de la documentación de Claude Code (code.claude.com/docs/en/memory), leída el 15 de octubre de 2026 — Claude Code se describe solo como esa página lo describe en esa fecha, y sus funciones pueden cambiar en cualquier versión. Documentación del producto en este sitio (Cómo funciona, Instalación), las respuestas sobre mantener tres archivos de instrucciones sincronizados y sobre alternativas a CLAUDE.md para un equipo, y las reglas de sanción, sustitución y condición de fin de la especificación sancionada del producto. Todo lo que aquí se describe sobre Arroway es comportamiento que las herramientas aplican hoy, no hoja de ruta. El estudio del ejemplo es ilustrativo.
https://www.arroway.app/es/answers/sharing-claude-md-rules-across-many-repos