El 25 de agosto, el CEO de Shopify, Tobi Lütke, declaró públicamente que está considerando prohibir el uso interno de Claude Code, a menos que Anthropic cambie de postura y permita que la herramienta lea archivos como AGENTS.md y .agents/skills. Su argumento es que Claude Code insiste en leer únicamente CLAUDE.md, lo que provoca una especie de "personalidad dividida" entre los miembros de un equipo que usan herramientas distintas, algo que calificó como un impuesto de complejidad que no debería existir.
La disputa gira en torno a un solo archivo Markdown
AGENTS.md es una convención que OpenAI introdujo en agosto de 2025: los comandos de compilación, las formas de prueba y las normas de seguridad de un proyecto se registran en un archivo Markdown en la raíz del repositorio, para que los agentes de programación lo lean y entiendan la base de código. A finales de 2025, datos públicos mostraban que más de sesenta mil proyectos de código abierto ya incluían este archivo, y el estándar en sí pasó a manos de la Agentic AI Foundation, dependiente de la Linux Foundation. Codex, Cursor, Gemini CLI, GitHub Copilot, Jules y VS Code lo reconocen todos.
Claude Code, en cambio, usa su propio CLAUDE.md. En proyectos individuales, esto solo implica mantener un archivo más; en organizaciones como Shopify, donde miles de personas comparten un repositorio grande, el problema cambia de escala: si en un mismo directorio solo hay uno de los dos archivos, los compañeros que usan otra herramienta reciben un contexto incompleto.
La solicitud llevaba un año pendiente
El issue de GitHub que pide soporte nativo de AGENTS.md en Claude Code existe desde agosto de 2025 y ha acumulado casi 5.000 votos, una de las peticiones de compatibilidad más respaldadas de ese repositorio. Varios issues similares se fueron cerrando después, uno de ellos con la conclusión de "sin planes por ahora". Los desarrolladores dejaron cientos de comentarios debajo, pero nunca hubo una postura oficial.
La comunidad ya tenía una solución alternativa desde hace tiempo: convertir CLAUDE.md en un enlace simbólico hacia AGENTS.md, o simplemente escribir en CLAUDE.md la instrucción "lee AGENTS.md". Funciona, pero hay que repetirlo en cada repositorio.
Anthropic finalmente dio una explicación
El mismo día de la declaración de Lütke, Thariq, de Anthropic, respondió en el hilo diciendo que el equipo está haciendo que Claude Code sea más personalizable, para que en el futuro sea fácil usar AGENTS.md o modificar directamente el system prompt, y que darían más detalles cuando estuviera listo. También fue la primera vez que explicó el motivo del rechazo anterior: no creen que las distintas familias de modelos sean intercambiables, porque el system prompt influye mucho en el rendimiento; internamente, Claude Code mantiene prompts de sistema distintos para cada modelo, lo que ya supone una carga de mantenimiento considerable.
Técnicamente, este argumento se sostiene. Las mismas instrucciones, aplicadas a modelos de proveedores distintos, sí producen resultados notablemente diferentes, y los prompts ajustados específicamente pueden ampliar esa diferencia de rendimiento. Pero eso explica por qué CLAUDE.md debería existir por separado, no por qué no se podría, de paso, leer también AGENTS.md; ambas cosas no son incompatibles.
Los archivos de contexto se han convertido en el nuevo campo de batalla
Un análisis de 2.926 repositorios de GitHub muestra que los archivos de contexto ya son la forma más común en que los desarrolladores dan instrucciones a los agentes de programación. En cuanto ese espacio quede ocupado por el formato propietario de una sola empresa, el costo de migración recaerá sobre quienes usan la herramienta: hoy es mantener un archivo más, mañana podrían ser las skills, los subagentes y las configuraciones de permisos enteras las que queden atadas a la estructura de directorios de un único proveedor.
Desde el punto de vista del esfuerzo de ingeniería, este enfrentamiento resulta un tanto desproporcionado. Hacer que Claude Code recurra a AGENTS.md cuando no encuentra CLAUDE.md es una lógica de búsqueda de archivos de apenas unas decenas de líneas, algo completamente distinto a "mantener system prompts por modelo". Si de verdad preocupa que unas instrucciones genéricas reduzcan el rendimiento, basta con añadir una línea de aviso. Precisamente esa es la solución intermedia que la comunidad ha propuesto repetidamente durante todo un año: leer CLAUDE.md por defecto, recurrir a AGENTS.md si no existe, y dar prioridad a CLAUDE.md cuando ambos estén presentes.
La presión pública de Lütke funcionó por una razón sencilla. Shopify es un cliente de gran escala de Claude Code, y que el CEO de una empresa cotizada declare públicamente que va a prohibirlo pesa mucho más que 5.000 votos anónimos. Para Anthropic, la ventaja actual de Claude Code se basa en la experiencia de producto, no en atar a los usuarios a un formato; en un momento en que los desarrolladores ya usan varias herramientas en paralelo, convertir la compatibilidad en una opción activable resulta más rentable que aferrarse a un nombre de archivo.
Fuentes: The New Stack, GitHub, CocoLoop, Hacker News; el alcance de adopción de AGENTS.md, el número de votos del issue y las declaraciones de Anthropic se verificaron en páginas de acceso público.