{"id":323470,"date":"2026-05-15T23:47:44","date_gmt":"2026-05-15T20:47:44","guid":{"rendered":"https:\/\/ceotudent.com\/andrej-karpathy-archivo-claude-md-guia-2026"},"modified":"2026-05-17T07:39:19","modified_gmt":"2026-05-17T04:39:19","slug":"andrej-karpathy-archivo-claude-md-guia-2026","status":"publish","type":"post","link":"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026","title":{"rendered":"\u00bfQu\u00e9 es el archivo CLAUDE.md de Andrej Karpathy? La nueva memoria del desarrollo de software en la era de la IA (gu\u00eda 2026)"},"content":{"rendered":"<blockquote>\n<p><strong>Respuesta corta:<\/strong> <strong>CLAUDE.md<\/strong> es el archivo de contexto persistente que la herramienta de desarrollador de Anthropic, <strong>Claude Code<\/strong>, lee al inicio de cada sesi\u00f3n. En 2026 soporta <strong>cuatro alcances<\/strong> (managed \/ project \/ user \/ local) y una <strong>sintaxis de imports<\/strong> (<code>@path\/to\/file<\/code>) para incorporar otros archivos. El <strong>auto memory<\/strong> introducido en v2.1.59 permite que Claude acumule conocimiento en un <code>MEMORY.md<\/code> por su cuenta; juntos otorgan al proyecto una <strong>memoria en dos capas<\/strong>. Entre noviembre de 2025 y enero de 2026, Andrej Karpathy traslad\u00f3 <strong>el 80 % de su rutina de coding al agent-driven coding<\/strong> y lo defini\u00f3 como <em>\u00abel mayor cambio de workflow en aproximadamente 20 a\u00f1os de programaci\u00f3n.\u00bb<\/em> En <strong>abril de 2026<\/strong> public\u00f3 el gist <a href=\"https:\/\/gist.github.com\/karpathy\/442a6bf555914893e9891c11519de94f\" rel=\"noopener\">idea file<\/a> y redefini\u00f3 CLAUDE.md como la <strong>columna esquema de una arquitectura de conocimiento personal<\/strong> compuesta por <code>raw\/<\/code> (fuentes), <code>wiki\/<\/code> (base de conocimiento mantenida por el LLM) y <code>CLAUDE.md<\/code> (esquema). Esta gu\u00eda recorre todas esas innovaciones y c\u00f3mo luce un CLAUDE.md efectivo en 2026.<\/p>\n<\/blockquote>\n<p>En esta era de IA fusionada con el desarrollo de software, <strong>lo que le dices a la IA y c\u00f3mo se lo dices<\/strong> determina la productividad real que recibes a cambio. Desde marzo de 2026, la documentaci\u00f3n oficial de Anthropic se traslad\u00f3 a su nueva direcci\u00f3n (<code>code.claude.com\/docs\/en\/memory<\/code>) y CLAUDE.md sigue siendo el concepto m\u00e1s cr\u00edtico de Claude Code, con capas complementarias formadas a su alrededor \u2014 <strong>auto memory<\/strong>, <strong>path-scoped rules<\/strong>, <strong>imports<\/strong>, <strong>subagent memory<\/strong>. Las publicaciones de Karpathy en los \u00faltimos seis meses empujaron este mecanismo m\u00e1s all\u00e1 de un mero archivo de configuraci\u00f3n hacia <strong>la arquitectura central de conocimiento del software en la era de la IA<\/strong>.<\/p>\n<hr>\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_84 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Alternar tabla de contenidos\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#Andrej-Karpathy-de-Software-20-al-Idea-File\" >Andrej Karpathy: de Software 2.0 al Idea File<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#%C2%BFQue-es-CLAUDEmd-y-como-se-integra-con-el-auto-memory\" >\u00bfQu\u00e9 es CLAUDE.md y c\u00f3mo se integra con el auto memory?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#Novedades-2026-imports-clauderules-interoperabilidad-con-AGENTSmd\" >Novedades 2026: imports, .claude\/rules\/, interoperabilidad con AGENTS.md<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#El-enfoque-idea-file-de-Karpathy-abril-de-2026\" >El enfoque idea file de Karpathy (abril de 2026)<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#Como-escribir-un-CLAUDEmd-efectivo-estandares-2026\" >C\u00f3mo escribir un CLAUDE.md efectivo (est\u00e1ndares 2026)<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#CLAUDEmd-vs-Cursor-Rules-vs-ChatGPT-Custom-Instructions\" >CLAUDE.md vs Cursor Rules vs ChatGPT Custom Instructions<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#Consejos-practicos-para-desarrolladores-hispanohablantes\" >Consejos pr\u00e1cticos para desarrolladores hispanohablantes<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-8\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#Preguntas-frecuentes-sobre-CLAUDEmd\" >Preguntas frecuentes sobre CLAUDE.md<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-9\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#Conclusion-CLAUDEmd-la-nueva-memoria-del-software-en-la-era-de-la-IA\" >Conclusi\u00f3n: CLAUDE.md, la nueva memoria del software en la era de la IA<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-10\" href=\"https:\/\/ceotudent.com\/es\/andrej-karpathy-archivo-claude-md-guia-2026\/#Fuentes\" >Fuentes<\/a><\/li><\/ul><\/nav><\/div>\n<h2><span class=\"ez-toc-section\" id=\"Andrej-Karpathy-de-Software-20-al-Idea-File\"><\/span>Andrej Karpathy: de Software 2.0 al Idea File<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p><strong>Andrej Karpathy<\/strong> (n. 23 de octubre de 1986, Bratislava) es uno de los diez ingenieros m\u00e1s influyentes de la IA moderna. Termin\u00f3 su doctorado en inform\u00e1tica en Stanford bajo Fei-Fei Li en 2016. Tres etapas estructuran su carrera: <strong>investigador fundador en OpenAI<\/strong> (2015-2017), <strong>Director de IA en Tesla<\/strong> (2017-2022) liderando el equipo Autopilot Vision, breve regreso a OpenAI en 2023 y fundaci\u00f3n de <strong>Eureka Labs<\/strong> en 2024. Su canal de YouTube \u2014 hogar de las maratones <em>\u00abLet&rsquo;s build GPT from scratch\u00bb<\/em> \u2014 super\u00f3 los 2 millones de suscriptores.<\/p>\n<p>Leer a Karpathy solo como investigador t\u00e9cnico se queda corto. Tambi\u00e9n es el dise\u00f1ador del vocabulario creativo de la IA. En <strong>Software 2.0<\/strong> (2017) sostuvo que los programas ser\u00e1n cada vez m\u00e1s \u00abescritos\u00bb no por desarrolladores sino por redes neuronales que aprenden pesos. Provocador en 2017, realidad compartida del sector en 2026. <strong>Vibe coding<\/strong> \u2014 construir software conversando con la IA en lugar de tecleando directamente \u2014 es el t\u00e9rmino que populariz\u00f3 a principios de 2025. <strong>Agentic coding<\/strong> describe la automatizaci\u00f3n de tareas largas con modelos aut\u00f3nomos como Claude Code, Codex CLI, Aider y Cline.<\/p>\n<p>El \u00faltimo punto de inflexi\u00f3n ocurri\u00f3 entre <strong>noviembre de 2025 y enero de 2026<\/strong>. En ese tramo Karpathy traslad\u00f3 <strong>el 80 % de su rutina del coding manual al agent-driven coding<\/strong> y lo calific\u00f3 como <em>\u00abel mayor cambio de workflow en aproximadamente 20 a\u00f1os de programaci\u00f3n.\u00bb<\/em> Claude Code y su archivo de memoria CLAUDE.md estuvieron en el centro. En <strong>abril de 2026<\/strong> llev\u00f3 el tema un paso m\u00e1s all\u00e1 con el concepto \u00abidea file\u00bb: una nueva arquitectura personal de conocimiento basada en <strong>compartir ideas, no c\u00f3digo<\/strong>. En sus palabras: <em>\u00abYou just share the idea, then the other person&rsquo;s agent customizes &amp; builds it for your specific needs.\u00bb<\/em><\/p>\n<p><iframe src=\"https:\/\/www.youtube.com\/embed\/LCEmiRjPEtQ?start=13&#038;rel=0\" title=\"Andrej Karpathy \u2014 Software Is Changing (Again), YC AI Startup School 2024\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen><\/iframe><\/p>\n<blockquote>\n<p>\ud83d\udcfa El punto de partida de este art\u00edculo es la keynote de Karpathy <em>\u00abSoftware Is Changing (Again)\u00bb<\/em> en la <strong>Y Combinator AI Startup School 2024<\/strong>. Vibe coding y agentic coding se sintetizan ah\u00ed con la mayor claridad.<\/p>\n<\/blockquote>\n<hr>\n<h2><span class=\"ez-toc-section\" id=\"%C2%BFQue-es-CLAUDEmd-y-como-se-integra-con-el-auto-memory\"><\/span>\u00bfQu\u00e9 es CLAUDE.md y c\u00f3mo se integra con el auto memory?<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>CLAUDE.md es el archivo de instrucciones persistente que t\u00fa escribes y mantienes; Claude Code lo lee al inicio de cada sesi\u00f3n. La doc de Anthropic lo dice claro: <em>\u00abInstructions you write to give Claude persistent context.\u00bb<\/em> En 2026 se sum\u00f3 una segunda capa de memoria: <strong>auto memory<\/strong>. El reparto: t\u00fa escribes CLAUDE.md (reglas, arquitectura); Claude escribe el auto memory (aprendizajes inferidos de tus correcciones y preferencias previas). El auto memory lleg\u00f3 con Claude Code v2.1.59 y se persiste en <code>~\/.claude\/projects\/&lt;project&gt;\/memory\/MEMORY.md<\/code>. Al inicio de cada chat se inyectan en el contexto las primeras 200 l\u00edneas (o 25 KB) del MEMORY.md.<\/p>\n<table>\n<thead>\n<tr>\n<th>Caracter\u00edstica<\/th>\n<th><strong>CLAUDE.md<\/strong><\/th>\n<th><strong>Auto memory<\/strong><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Autor<\/td>\n<td>T\u00fa<\/td>\n<td>Claude<\/td>\n<\/tr>\n<tr>\n<td>Tipo de contenido<\/td>\n<td>Instrucciones y reglas<\/td>\n<td>Aprendizajes inferidos y patrones<\/td>\n<\/tr>\n<tr>\n<td>Alcance<\/td>\n<td>Proyecto, usuario u organizaci\u00f3n<\/td>\n<td>Por worktree<\/td>\n<\/tr>\n<tr>\n<td>Carga<\/td>\n<td>Completa cada sesi\u00f3n<\/td>\n<td>Primeras 200 l\u00edneas \/ 25 KB por sesi\u00f3n<\/td>\n<\/tr>\n<tr>\n<td>Uso principal<\/td>\n<td>Est\u00e1ndares de c\u00f3digo, arquitectura, workflow<\/td>\n<td>Comandos de build, hallazgos de debug, preferencias<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>CLAUDE.md gan\u00f3 una estructura m\u00e1s rica en 2026. Soporta <strong>cuatro alcances<\/strong>: archivos <strong>managed policy<\/strong> desplegados por IT\/DevOps a nivel de organizaci\u00f3n (macOS en <code>\/Library\/Application Support\/ClaudeCode\/CLAUDE.md<\/code>, Linux en <code>\/etc\/claude-code\/CLAUDE.md<\/code>, Windows en <code>C:Program FilesClaudeCodeCLAUDE.md<\/code>); archivos <strong>project<\/strong> espec\u00edficos del equipo (<code>.\/CLAUDE.md<\/code> o <code>.\/.claude\/CLAUDE.md<\/code>); archivos <strong>user<\/strong> que aplican a todos tus proyectos (<code>~\/.claude\/CLAUDE.md<\/code>); y archivos <strong>local<\/strong> para notas personales de proyecto que van en <code>.gitignore<\/code> (<code>.\/CLAUDE.local.md<\/code>). Los alcances m\u00e1s espec\u00edficos sobrescriben a los m\u00e1s amplios.<\/p>\n<p>La mec\u00e1nica de carga tambi\u00e9n se ampli\u00f3. Partiendo del directorio de trabajo, Claude recorre <strong>hasta la ra\u00edz del sistema de archivos<\/strong> buscando <code>CLAUDE.md<\/code> y <code>CLAUDE.local.md<\/code> en cada carpeta; todas las coincidencias entran al contexto. Los CLAUDE.md de subcarpetas no se cargan al arrancar \u2014 lo hacen <strong>on-demand<\/strong> cuando Claude lee un archivo de esa carpeta. Si a\u00f1ades directorios extra con <code>--add-dir<\/code>, define <code>CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1<\/code> para que sus CLAUDE.md tambi\u00e9n carguen. Tras una compaction (<code>\/compact<\/code>), el CLAUDE.md ra\u00edz del proyecto se recarga autom\u00e1ticamente; los anidados vuelven con la pr\u00f3xima lectura relevante.<\/p>\n<hr>\n<h2><span class=\"ez-toc-section\" id=\"Novedades-2026-imports-clauderules-interoperabilidad-con-AGENTSmd\"><\/span>Novedades 2026: imports, .claude\/rules\/, interoperabilidad con AGENTS.md<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Para que CLAUDE.md no engorde hasta convertirse en un \u00fanico archivo gigante, Anthropic estandariz\u00f3 la sintaxis <strong><code>@path\/to\/import<\/code><\/strong>. Trae otros archivos Markdown a CLAUDE.md; soporta rutas relativas y absolutas; permite recursi\u00f3n hasta <strong>5 saltos<\/strong>. Uso t\u00edpico:<\/p>\n<pre><code class=\"language-markdown\">See @README for project overview and @package.json for available npm commands.\n\n# Additional Instructions\n- git workflow @docs\/git-instructions.md\n- personal preferences @~\/.claude\/my-project-instructions.md\n<\/code><\/pre>\n<p>La segunda gran adici\u00f3n es la carpeta <strong><code>.claude\/rules\/<\/code><\/strong> con sus <strong>path-scoped rules<\/strong>. En lugar de meter todas las instrucciones en un CLAUDE.md, parte las reglas en archivos Markdown por tema con frontmatter YAML que s\u00f3lo las active cuando Claude toque rutas que coinciden:<\/p>\n<pre><code class=\"language-markdown\">---\npaths:\n  - &quot;src\/api\/**\/*.ts&quot;\n  - &quot;lib\/**\/*.{ts,tsx}&quot;\n---\n\n# API Development Rules\n- All API endpoints must include input validation\n- Use the standard error response format\n- Include OpenAPI documentation comments\n<\/code><\/pre>\n<p>Los archivos de reglas sin frontmatter <code>paths<\/code> cargan siempre; los que lo tienen se activan s\u00f3lo cuando Claude trabaja en archivos coincidentes. Cr\u00edtico para monorepos donde varios equipos mantienen sus propios conjuntos de reglas. La configuraci\u00f3n <strong><code>claudeMdExcludes<\/code><\/strong> permite adem\u00e1s desactivar selectivamente CLAUDE.md de directorios ancestros.<\/p>\n<p>La tercera adici\u00f3n es la <strong>interoperabilidad con AGENTS.md<\/strong>. Cursor, Codex, Aider y otros agentes leen AGENTS.md; Claude Code s\u00f3lo lee CLAUDE.md. La forma est\u00e1ndar de resolver el choque:<\/p>\n<pre><code class=\"language-markdown\">@AGENTS.md\n\n## Claude Code\nUse plan mode for changes under `src\/billing\/`.\n<\/code><\/pre>\n<p>Mismo conjunto de instrucciones compartido por todas tus herramientas de agente; la secci\u00f3n breve espec\u00edfica de Claude a\u00f1ade los extras. Lado de comandos slash: <strong><code>\/init<\/code><\/strong> redacta el archivo, <strong><code>\/memory<\/code><\/strong> muestra los archivos cargados y permite editarlos, el <strong>hook <code>InstructionsLoaded<\/code><\/strong> sirve para depurar qu\u00e9 carg\u00f3 cu\u00e1ndo. Con <code>CLAUDE_CODE_NEW_INIT=1<\/code>, <code>\/init<\/code> se convierte en un flujo interactivo multi-fase: un subagente inspecciona el repo, te pregunta por las lagunas y propone un archivo revisable antes de escribir.<\/p>\n<hr>\n<h2><span class=\"ez-toc-section\" id=\"El-enfoque-idea-file-de-Karpathy-abril-de-2026\"><\/span>El enfoque idea file de Karpathy (abril de 2026)<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>El 3 de abril de 2026, Karpathy propuso en X y luego en un gist de GitHub un nuevo formato de compartir: el \u00abidea file\u00bb. Donde el open source cl\u00e1sico comparte c\u00f3digo, un idea file comparte la idea, y el agente del otro lado la <strong>reconstruye para su entorno<\/strong>. La raz\u00f3n es simple: en 2026 \u2014 con modelos de agente lo suficientemente fuertes \u2014 copiar la <strong>intenci\u00f3n<\/strong> es m\u00e1s eficiente que copiar el c\u00f3digo p\u00edxel a p\u00edxel.<\/p>\n<p>La forma concreta es una estructura de tres capas. Capa uno: la carpeta <code>raw\/<\/code>; art\u00edculos, papers, im\u00e1genes, datasets aterrizan aqu\u00ed. El LLM <strong>lee pero nunca modifica<\/strong> esta carpeta \u2014 las fuentes son inmutables y verificables. Capa dos: la carpeta <code>wiki\/<\/code>; p\u00e1ginas de resumen, de concepto y de entidades producidas por el LLM viven aqu\u00ed, cruzadas y <strong>creciendo acumulativamente<\/strong> en vez de re-derivarse por consulta. Capa tres: el archivo <code>CLAUDE.md<\/code> (alternativamente <code>AGENTS.md<\/code> o <code>OPENCODE.md<\/code>); define el <strong>esquema<\/strong> del sistema entero y c\u00f3mo se mantiene.<\/p>\n<p>El sistema corre sobre tres operaciones. <strong>Ingest:<\/strong> cuando una nueva fuente aterriza en <code>raw\/<\/code>, el LLM la lee y actualiza simult\u00e1neamente 10-15 p\u00e1ginas wiki, lleva un \u00edndice y un log de actividad. <strong>Query:<\/strong> las preguntas atraviesan la estructura; las respuestas valiosas se archivan como nuevas p\u00e1ginas \u2014 el conocimiento se compone. <strong>Lint:<\/strong> chequeos de salud peri\u00f3dicos sacan a la luz contradicciones, p\u00e1ginas hu\u00e9rfanas, conceptos faltantes y revisiones sugeridas. Karpathy lo conecta con el <strong>concepto Memex de Vannevar Bush (1945)<\/strong>; la pregunta no resuelta de Bush \u00ab\u00bfqui\u00e9n lo mantiene?\u00bb encuentra al fin respuesta con los LLM.<\/p>\n<p>Esta arquitectura diverge del RAG (Retrieval-Augmented Generation) cl\u00e1sico en un punto medular. RAG vuelve a las fuentes y sintetiza en cada consulta; el enfoque idea file <strong>compila el conocimiento una vez y lo mantiene al d\u00eda<\/strong>, en lugar de redrivarlo en cada llamada. Seg\u00fan Karpathy: <em>\u00abThe knowledge is compiled once and then kept current, not re-derived on every query.\u00bb<\/em> CLAUDE.md es el archivo esquema que convierte un chatbot gen\u00e9rico en un <strong>mantenedor wiki disciplinado<\/strong>.<\/p>\n<hr>\n<h2><span class=\"ez-toc-section\" id=\"Como-escribir-un-CLAUDEmd-efectivo-estandares-2026\"><\/span>C\u00f3mo escribir un CLAUDE.md efectivo (est\u00e1ndares 2026)<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Cuatro principios extra\u00eddos de la doc oficial de Anthropic forman el n\u00facleo de la escritura efectiva de CLAUDE.md. <strong>Tama\u00f1o:<\/strong> mantener el archivo bajo 200 l\u00edneas; los m\u00e1s largos consumen m\u00e1s contexto y bajan la tasa de adherencia. Si las instrucciones crecen, divide con path-scoped rules o imports. <strong>Estructura:<\/strong> instrucciones agrupadas bajo headings y bullets de Markdown son mucho m\u00e1s escaneables que p\u00e1rrafos sueltos; Claude lee como un humano. <strong>Especificidad:<\/strong> instrucciones verificables y concretas. <em>\u00abFormat the code properly\u00bb<\/em> \u2192 <em>\u00abUse 2-space indentation\u00bb<\/em>; <em>\u00abTest your changes\u00bb<\/em> \u2192 <em>\u00abRun <code>npm test<\/code> before committing\u00bb<\/em>; <em>\u00abKeep files organised\u00bb<\/em> \u2192 <em>\u00abAPI handlers live in <code>src\/api\/handlers\/<\/code>\u00bb.<\/em> <strong>Consistencia:<\/strong> en instrucciones contradictorias, Claude elige una al azar; revisa peri\u00f3dicamente CLAUDE.md y sus anidados.<\/p>\n<p>\u00bfCu\u00e1ndo a\u00f1adir algo a CLAUDE.md? La recomendaci\u00f3n de Anthropic es directa: <em>\u00abTreat CLAUDE.md as the place you write down what you&rsquo;d otherwise re-explain.\u00bb<\/em> Si Claude comete el mismo error dos veces, si una convenci\u00f3n cazada en code review tambi\u00e9n deber\u00eda conocerla Claude, si te encuentras escribiendo hoy la misma correcci\u00f3n que la sesi\u00f3n pasada, o si un nuevo compa\u00f1ero necesitar\u00eda ese contexto para ser productivo \u2014 todo eso va a CLAUDE.md. Procedimientos multi-paso o reglas aplicables solo a un rinc\u00f3n del c\u00f3digo pertenecen a una <strong>skill<\/strong> o <strong>path-scoped rule<\/strong>, no a CLAUDE.md.<\/p>\n<p>La plantilla de abajo es el punto de partida m\u00ednimo funcional para un CLAUDE.md 2026. C\u00f3piala tal cual:<\/p>\n<pre><code class=\"language-markdown\"># Project Name\n\n## What this is\nOne-paragraph summary of what the project does and why it exists.\n\n## Tech stack\n- Language: Python 3.12 \/ TypeScript 5.4\n- Framework: FastAPI \/ Next.js 15\n- DB: PostgreSQL 16\n- Tests: pytest + httpx \/ vitest\n\n## Commands\n- Install: `uv sync` \/ `pnpm install`\n- Run dev: `uv run uvicorn app.main:app --reload` \/ `pnpm dev`\n- Test: `uv run pytest -x` \/ `pnpm test`\n- Lint: `uv run ruff check .` \/ `pnpm lint`\n- Typecheck: `uv run mypy app\/` \/ `pnpm typecheck`\n\n## Conventions\n- Type hints everywhere\n- Public functions: docstrings (Google style)\n- Tests live in `tests\/` matching `app\/` structure\n- No global state \u2014 pass dependencies explicitly\n\n## Don't\n- No emoji in code or commits\n- No `print()` for debug \u2014 use `logger.debug()`\n- No new dependencies without justifying in PR description\n- Don't write code comments that just restate what code does\n\n## Common pitfalls\n- DB migrations: run `alembic upgrade head` after pulling\n- The `vendor\/` folder is git-tracked but not editable\n- `pytest` requires `.env.test` (copy from `.env.test.example`)\n\n## Architecture in 3 lines\n- Request \u2192 middleware (auth) \u2192 router \u2192 service \u2192 repository \u2192 DB\n- Async I\/O end-to-end with `asyncpg`\n- Background jobs in `app\/jobs\/` use `arq` (not Celery)\n\n## Imports\n@README.md\n@docs\/architecture.md\n@AGENTS.md\n<\/code><\/pre>\n<p>Dos consejos de la pr\u00e1ctica de Karpathy: primero, la analog\u00eda <em>\u00abAI is a junior dev with infinite enthusiasm\u00bb<\/em> \u2014 el agente IA es como un desarrollador junior talentoso pero amn\u00e9sico que espera el briefing de la ma\u00f1ana; CLAUDE.md es ese briefing puesto por escrito. Segundo, el principio de <em>\u00abliving memory\u00bb<\/em>: el archivo no deber\u00eda ser un README de escribir y olvidar \u2014 debe crecer con cada nuevo error que cometa la IA.<\/p>\n<hr>\n<h2><span class=\"ez-toc-section\" id=\"CLAUDEmd-vs-Cursor-Rules-vs-ChatGPT-Custom-Instructions\"><\/span>CLAUDE.md vs Cursor Rules vs ChatGPT Custom Instructions<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>Las tres principales herramientas de coding con IA almacenan el contexto del desarrollador de formas distintas. A 2026 el <strong>sistema CLAUDE.md de Claude Code<\/strong> es el m\u00e1s rico y jer\u00e1rquico \u2014 managed\/project\/user\/local + path-scoped rules + auto memory + imports. <strong>Cursor<\/strong> ofrece una estructura similar con Markdown + YAML frontmatter dentro de <code>.cursor\/rules\/<\/code>, pero sin un alcance de usuario compartido. <strong>ChatGPT Custom Instructions<\/strong> est\u00e1 ligado a tu cuenta de OpenAI, guardado en la nube, dos campos de texto plano \u2014 sin contexto de proyecto.<\/p>\n<table>\n<thead>\n<tr>\n<th>Dimensi\u00f3n<\/th>\n<th>CLAUDE.md (Claude Code)<\/th>\n<th>Cursor Rules<\/th>\n<th>ChatGPT Custom Instructions<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Ubicaci\u00f3n<\/td>\n<td>Repo + usuario + managed (org)<\/td>\n<td><code>.cursor\/rules\/*.md<\/code><\/td>\n<td>Cuenta OpenAI (nube)<\/td>\n<\/tr>\n<tr>\n<td>Jerarqu\u00eda<\/td>\n<td>4 alcances + anidados + auto memory<\/td>\n<td>Solo proyecto<\/td>\n<td>Solo usuario<\/td>\n<\/tr>\n<tr>\n<td>Formato<\/td>\n<td>Markdown + YAML frontmatter (rules)<\/td>\n<td>Markdown + YAML frontmatter<\/td>\n<td>Texto plano (2 campos)<\/td>\n<\/tr>\n<tr>\n<td>Imports<\/td>\n<td><code>@path<\/code> recursivo 5 saltos<\/td>\n<td>Limitados<\/td>\n<td>Ninguno<\/td>\n<\/tr>\n<tr>\n<td>Path-scoped rules<\/td>\n<td>\u2705 <code>.claude\/rules\/<\/code> + glob <code>paths<\/code><\/td>\n<td>Parcial<\/td>\n<td>\u274c<\/td>\n<\/tr>\n<tr>\n<td>Auto memory<\/td>\n<td>\u2705 v2.1.59+<\/td>\n<td>\u274c<\/td>\n<td>\u274c<\/td>\n<\/tr>\n<tr>\n<td>Interop AGENTS.md<\/td>\n<td>\u2705 Import <code>@AGENTS.md<\/code><\/td>\n<td>\u274c<\/td>\n<td>\u274c<\/td>\n<\/tr>\n<tr>\n<td>Versionado<\/td>\n<td>S\u00ed (en Git)<\/td>\n<td>S\u00ed (en Git)<\/td>\n<td>No (solo nube)<\/td>\n<\/tr>\n<tr>\n<td>Compartir en equipo<\/td>\n<td>S\u00ed<\/td>\n<td>S\u00ed<\/td>\n<td>No<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Recomendaci\u00f3n pr\u00e1ctica: si usas todas las herramientas en el mismo proyecto, escribe <strong>CLAUDE.md como fuente maestra<\/strong>, importa AGENTS.md desde \u00e9l y copia id\u00e9nticamente a <code>.cursor\/rules\/<\/code> para Cursor. En ChatGPT Custom Instructions pon solo <strong>preferencias personales<\/strong> (p. ej. \u00abResponde en espa\u00f1ol, comentarios de c\u00f3digo en ingl\u00e9s\u00bb) \u2014 los detalles de proyecto no van ah\u00ed porque se aplican a cada proyecto de tu cuenta.<\/p>\n<hr>\n<h2><span class=\"ez-toc-section\" id=\"Consejos-practicos-para-desarrolladores-hispanohablantes\"><\/span>Consejos pr\u00e1cticos para desarrolladores hispanohablantes<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>La adopci\u00f3n de CLAUDE.md se expandi\u00f3 r\u00e1pidamente en la comunidad de desarrolladores hispanohablantes desde finales de 2025. Se ve en side projects abiertos en GitHub desde Madrid, Barcelona, Buenos Aires, Ciudad de M\u00e9xico, Bogot\u00e1. La regla com\u00fan es la <strong>coherencia ling\u00fc\u00edstica<\/strong>: comentarios de c\u00f3digo, mensajes de error y docstrings en ingl\u00e9s; documentaci\u00f3n de usuario en espa\u00f1ol; descripciones de PR biling\u00fces. Una sola l\u00ednea en CLAUDE.md basta: <em>\u00abCode comments, docstrings, error messages: English. Documentation in <code>docs\/<\/code>: Spanish. PR descriptions: bilingual.\u00bb<\/em><\/p>\n<p>Segundo tema recurrente en proyectos hispanos: <strong>encoding y locale<\/strong>. UTF-8 (sin BOM), collation <code>utf8mb4_unicode_ci<\/code>, y <code>es_ES.UTF-8<\/code> (o <code>es_MX<\/code>, <code>es_AR<\/code>) expl\u00edcito en tests sensibles al orden es pr\u00e1ctica est\u00e1ndar. Sin esa nota, la IA produce inconsistencias con tildes y \u00f1. Tercer bloque cr\u00edtico: <strong>regulaci\u00f3n y reglas de negocio locales<\/strong>: cumplimiento del RGPD (UE) o la LFPDPPP (M\u00e9xico), facturaci\u00f3n electr\u00f3nica en formatos CFDI (M\u00e9xico) o Facturae (Espa\u00f1a), formateo de precios en EUR <code>f\"{amount:,.2f} \u20ac\"<\/code> o MXN\/ARS seg\u00fan el pa\u00eds \u2014 reglas que la IA no conoce por s\u00ed sola.<\/p>\n<p>\u00daltimo consejo: <strong>versiona CLAUDE.md con el equipo<\/strong>. Archivo en <code>main<\/code> y revisi\u00f3n en cada PR. Una regla a\u00f1adida por un desarrollador se convierte instant\u00e1neamente en el est\u00e1ndar del equipo porque la IA siempre lee la versi\u00f3n m\u00e1s reciente. Esa es la base del movimiento por el cual los equipos hispanohablantes codifican est\u00e1ndares t\u00e9cnicos junto con la IA.<\/p>\n<hr>\n<h2><span class=\"ez-toc-section\" id=\"Preguntas-frecuentes-sobre-CLAUDEmd\"><\/span>Preguntas frecuentes sobre CLAUDE.md<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<h3>\u00bfCLAUDE.md y auto memory son lo mismo?<\/h3>\n<p>No. CLAUDE.md es el archivo que escribes con reglas y arquitectura. El auto memory es lo que Claude lleva por su cuenta en <code>~\/.claude\/projects\/&lt;project&gt;\/memory\/MEMORY.md<\/code> \u2014 preferencias inferidas de correcciones pasadas. Los dos cargan juntos; ninguno reemplaza al otro. Auto memory est\u00e1 disponible a partir de Claude Code v2.1.59.<\/p>\n<h3>\u00bfQu\u00e9 pasa si <code>~\/.claude\/CLAUDE.md<\/code> y <code>.\/CLAUDE.md<\/code> chocan?<\/h3>\n<p>Cargan ambos, los contenidos se fusionan. En conflictos directos <strong>gana el nivel de proyecto (.\/CLAUDE.md)<\/strong> por ser m\u00e1s espec\u00edfico. Usa el nivel usuario para \u00abcosas que quiero en cada proyecto\u00bb, el de proyecto para \u00abreglas exclusivas de este proyecto\u00bb.<\/p>\n<h3>\u00bfC\u00f3mo funcionan los imports <code>@path<\/code>?<\/h3>\n<p><code>@README.md<\/code> o <code>@~\/.claude\/preferences.md<\/code> hacen que Claude incorpore el archivo al contexto. Se soportan rutas relativas y absolutas. Recursi\u00f3n m\u00e1xima de 5 saltos \u2014 un archivo importado puede importar otro, que a su vez puede importar otro, pero el 6\u00b0 nivel se rechaza. En el primer import externo aparece un di\u00e1logo de confirmaci\u00f3n; rechazarlo cierra el di\u00e1logo de forma permanente.<\/p>\n<h3>\u00bfQu\u00e9 diferencia hay entre <code>.claude\/rules\/<\/code> y CLAUDE.md?<\/h3>\n<p>CLAUDE.md carga siempre; los archivos bajo <code>.claude\/rules\/<\/code> con frontmatter <code>paths<\/code> cargan solo cuando Claude procesa un archivo coincidente. En proyectos grandes, la carpeta rules corta las instrucciones por tema\/ruta y <strong>baja el consumo de contexto<\/strong>. Los archivos rules sin <code>paths<\/code> tienen la misma prioridad que CLAUDE.md.<\/p>\n<h3>\u00bfC\u00f3mo se relacionan skills, plugins y subagents con CLAUDE.md?<\/h3>\n<p>Las skills son m\u00f3dulos m\u00e1s pesados invocados a demanda, no cargados en cada sesi\u00f3n. Los plugins empaquetan servidores MCP, comandos slash y bundles de skills para distribuci\u00f3n. Los subagents pueden tener su propio auto memory (<code>enable-persistent-memory<\/code>). CLAUDE.md sirve como capa de contexto base bajo todo eso; los flujos espec\u00edficos migran a skills.<\/p>\n<h3>\u00bfEl concepto \u00abidea file\u00bb de Karpathy redefini\u00f3 CLAUDE.md?<\/h3>\n<p>No directamente, pero ampli\u00f3 su alcance. El CLAUDE.md cl\u00e1sico contiene reglas y comandos. En la propuesta de abril de 2026 de Karpathy, CLAUDE.md adicionalmente cumple el rol de <strong>archivo esquema<\/strong> que gobierna <code>raw\/<\/code> (fuentes) y <code>wiki\/<\/code> (conocimiento compilado por el LLM). Eso lleva CLAUDE.md de una lista de comandos al <strong>centro del sistema de gesti\u00f3n de conocimiento<\/strong>.<\/p>\n<h3>\u00bfD\u00f3nde se sigue a Karpathy?<\/h3>\n<p>Cuatro canales principales: <strong>YouTube<\/strong> (<a href=\"https:\/\/www.youtube.com\/@AndrejKarpathy\" rel=\"noopener\">@AndrejKarpathy<\/a>) para las conferencias marat\u00f3n, <strong>X \/ Twitter<\/strong> (<a href=\"https:\/\/x.com\/karpathy\">@karpathy<\/a>) para observaciones diarias, <strong>GitHub<\/strong> (<a href=\"https:\/\/github.com\/karpathy\" rel=\"noopener\">github.com\/karpathy<\/a>) para proyectos open source como <code>nanogpt<\/code>, <code>nanochat<\/code>, <code>makemore<\/code>, <code>micrograd<\/code>, <code>llm.c<\/code>, y <strong>Eureka Labs<\/strong> (<a href=\"https:\/\/eurekalabs.ai\" rel=\"noopener\">eurekalabs.ai<\/a>) para los anuncios de la plataforma educativa de IA. El <strong>gist idea file<\/strong> est\u00e1 directamente en <a href=\"https:\/\/gist.github.com\/karpathy\/442a6bf555914893e9891c11519de94f\" rel=\"noopener\">gist.github.com\/karpathy\/442a6bf555914893e9891c11519de94f<\/a>.<\/p>\n<hr>\n<h2><span class=\"ez-toc-section\" id=\"Conclusion-CLAUDEmd-la-nueva-memoria-del-software-en-la-era-de-la-IA\"><\/span>Conclusi\u00f3n: CLAUDE.md, la nueva memoria del software en la era de la IA<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<p>CLAUDE.md es una convenci\u00f3n de apariencia simple que est\u00e1 reconfigurando la naturaleza del desarrollo de software. A 2026 ya no es <strong>un \u00fanico archivo<\/strong> sino un sistema que abarca <strong>cuatro alcances, imports, path-scoped rules, auto memory y arquitectura idea file<\/strong>. Como apunta Karpathy: la nueva moneda del software no es solo el c\u00f3digo, es el contexto que le das a la IA. Mantener ese contexto persistente, continuamente actualizado y compartido por el equipo se convirti\u00f3 en la nueva configuraci\u00f3n base de los equipos de software modernos.<\/p>\n<p>El plan pr\u00e1ctico es simple. <strong>D\u00eda uno:<\/strong> arranca Claude Code en cualquier proyecto abierto y ejecuta <code>\/init<\/code> (idealmente con <code>CLAUDE_CODE_NEW_INIT=1<\/code>). <strong>D\u00eda dos:<\/strong> edita el borrador generado contra la plantilla de esta gu\u00eda. <strong>Primera semana:<\/strong> ante cada error de la IA, a\u00f1ade una l\u00ednea a CLAUDE.md antes de arreglarlo. <strong>Segunda semana:<\/strong> comparte con el equipo e integra en la revisi\u00f3n de PR. <strong>Al mes:<\/strong> si el archivo se acerca a 200 l\u00edneas, divide con <code>.claude\/rules\/<\/code> y empieza a usar imports <code>@path<\/code>. <strong>Tres meses despu\u00e9s:<\/strong> considera la arquitectura idea file de Karpathy con las capas <code>raw\/<\/code> y <code>wiki\/<\/code>.<\/p>\n<p>Recomendaci\u00f3n clara: trata CLAUDE.md con la misma seriedad que <code>README.md<\/code>. Cada l\u00ednea a\u00f1adida en un mes es un error que la IA no cometi\u00f3 en ese mes. Esta inversi\u00f3n compone \u2014 el retorno crece a medida que pasan las semanas.<\/p>\n<hr>\n<h2><span class=\"ez-toc-section\" id=\"Fuentes\"><\/span>Fuentes<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li><strong>Anthropic.<\/strong> <em>Claude Code Documentation \u2014 How Claude remembers your project<\/em>. code.claude.com\/docs\/en\/memory (acceso: 2026-05-01)<\/li>\n<li><strong>Anthropic.<\/strong> <em>Claude Code: Skills, Plugins, Hooks, Subagents documentation<\/em>. code.claude.com\/docs\/en<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <em>Idea file<\/em> \u2014 gist de GitHub, abril 2026. gist.github.com\/karpathy\/442a6bf555914893e9891c11519de94f<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <em>Publicaciones en X (Twitter)<\/em>, <a href=\"https:\/\/x.com\/karpathy\">@karpathy<\/a> \u2014 tweet del idea file del 3 de abril de 2026 y discusiones posteriores.<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <em>Software Is Changing (Again)<\/em> \u2014 keynote, <strong>Y Combinator AI Startup School<\/strong>, 2024. YouTube: youtube.com\/watch?v=LCEmiRjPEtQ<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <em>Software 2.0<\/em>. Medium, noviembre 2017. karpathy.medium.com\/software-2-0-a64152b37c35<\/li>\n<li><strong>Karpathy, Andrej.<\/strong> <a href=\"https:\/\/github.com\/karpathy\" rel=\"noopener\">github.com\/karpathy<\/a> \u2014 ejemplos de CLAUDE.md y AGENTS.md en <code>nanogpt<\/code>, <code>nanochat<\/code>, <code>makemore<\/code>, <code>micrograd<\/code>, <code>llm.c<\/code>.<\/li>\n<li><strong>Antigravity Codes.<\/strong> <em>Karpathy&rsquo;s LLM Wiki: The Complete Guide to His Idea File<\/em>. antigravity.codes\/blog\/karpathy-llm-wiki-idea-file<\/li>\n<li><strong>MCP Directory.<\/strong> <em>Claude Code Best Practices: A Developer&rsquo;s Guide (2026)<\/em>. mcp.directory\/blog\/claude-code-best-practices<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>La memoria de proyecto CLAUDE.md de Claude Code (Anthropic) se transform\u00f3 en 2026 en una capa de memoria integral con cuatro alcances (managed \/ project \/ user \/ local), sintaxis de imports @path, auto memory (v2.1.59+), reglas con alcance de ruta v\u00eda `.claude\/rules\/` e interoperabilidad con AGENTS.md. Andrej Karpathy redefini\u00f3 CLAUDE.md en abril de 2026 con su concepto de `idea file` como n\u00facleo de una arquitectura de conocimiento de 3 capas (raw \/ wiki \/ schema). Esta gu\u00eda cubre todas esas innovaciones y los est\u00e1ndares 2026 para escribir un CLAUDE.md efectivo.<\/p>\n","protected":false},"author":1,"featured_media":324011,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4456,9],"tags":[],"class_list":["post-323470","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dijital","category-teknoloji"],"_links":{"self":[{"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/posts\/323470","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/comments?post=323470"}],"version-history":[{"count":0,"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/posts\/323470\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/media\/324011"}],"wp:attachment":[{"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/media?parent=323470"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/categories?post=323470"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ceotudent.com\/es\/wp-json\/wp\/v2\/tags?post=323470"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}