{"id":32689,"date":"2026-06-27T00:20:00","date_gmt":"2026-06-27T03:20:00","guid":{"rendered":"https:\/\/www.neolo.com\/blog\/?p=32689"},"modified":"2026-05-19T12:21:15","modified_gmt":"2026-05-19T15:21:15","slug":"claude-md","status":"publish","type":"post","link":"https:\/\/www.neolo.com\/blog\/claude-md.php","title":{"rendered":"\u00bfQu\u00e9 poner en CLAUDE.md?"},"content":{"rendered":"<span class=\"span-reading-time rt-reading-time\" style=\"display: block;\"><span class=\"rt-label rt-prefix\">Tiempo de lectura:<\/span> <span class=\"rt-time\"> 7<\/span> <span class=\"rt-label rt-postfix\">minutos<\/span><\/span>\n<p>El <strong>archivo <code>CLAUDE.md<\/code><\/strong> le indica a <a href=\"https:\/\/www.neolo.com\/blog\/vps-con-claude-code-instalado.php\" target=\"_blank\" rel=\"noreferrer noopener\">Claude Code<\/a> c\u00f3mo comportarse en tu proyecto: qu\u00e9 tecnolog\u00edas usas, qu\u00e9 convenciones seguir y qu\u00e9 errores evitar. Configurarlo bien desde el principio ahorra tiempo, reduce fricciones y hace que el asistente trabaje como si conociera tu proyecto de memoria.<\/p>\n\n\n\n\n\n<h2 class=\"wp-block-heading\" id=\"que-es\">\u00bfQu\u00e9 es CLAUDE.md y para qu\u00e9 sirve?<\/h2>\n\n\n\n<p><code><strong>CLAUDE.md<\/strong><\/code> es un archivo de texto en formato <strong>Markdown <\/strong>que<strong> Claude Code<\/strong> lee autom\u00e1ticamente al iniciarse en un proyecto. Su funci\u00f3n es darle contexto al asistente: qu\u00e9 tipo de proyecto es, c\u00f3mo est\u00e1 organizado, qu\u00e9 convenciones de c\u00f3digo se siguen y qu\u00e9 debe evitar hacer.<\/p>\n\n\n\n<p>Pi\u00e9nsalo como el documento de incorporaci\u00f3n que le entregar\u00edas a un desarrollador nuevo. Sin ese contexto, el asistente trabaja con suposiciones. Con un buen <code>CLAUDE.md<\/code>, trabaja con informaci\u00f3n concreta.<\/p>\n\n\n\n<p>Esto es especialmente valioso en proyectos medianos o grandes, donde las decisiones de arquitectura no son evidentes a simple vista. En la pr\u00e1ctica, la diferencia entre tener y no tener este archivo se nota desde la primera sesi\u00f3n de trabajo.<\/p>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Por qu\u00e9 Claude Code necesita un hosting VPS\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/o0i1RK9hg7g?feature=oembed&#038;enablejsapi=1&#038;origin=https:\/\/www.neolo.com\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-1 wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/www.neolo.com\/esp\/claude-code-vps\/\" target=\"_blank\" rel=\"noreferrer noopener\">EL MEJOR VPS PARA CLAUDE CODE<\/a><\/div>\n<\/div>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"donde-se-coloca\">\u00bfD\u00f3nde se coloca el archivo CLAUDE.md?<\/h2>\n\n\n\n<p>Claude Code admite m\u00faltiples ubicaciones para el archivo, y cada una tiene un alcance diferente:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Ra\u00edz del proyecto (<code>.\/CLAUDE.md<\/code>):<\/strong> es la ubicaci\u00f3n m\u00e1s com\u00fan. Se aplica a todo el repositorio.<\/li>\n\n\n\n<li><strong>Carpetas espec\u00edficas (<code>.\/src\/CLAUDE.md<\/code>, <code>.\/api\/CLAUDE.md<\/code>):<\/strong> \u00fatil cuando distintas partes del proyecto tienen l\u00f3gicas o tecnolog\u00edas diferentes.<\/li>\n\n\n\n<li><strong>Directorio home del usuario (<code>~\/.claude\/CLAUDE.md<\/code>):<\/strong> instrucciones globales que aplican a todos los proyectos. Sirve para preferencias personales del desarrollador.<\/li>\n<\/ul>\n\n\n\n<p>Cuando existen varios archivos, Claude Code los combina jer\u00e1rquicamente: primero el global, luego el de la ra\u00edz, luego los de subcarpetas. Las instrucciones m\u00e1s espec\u00edficas tienen m\u00e1s peso.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"estructura\">Qu\u00e9 poner en CLAUDE.md: estructura recomendada<\/h2>\n\n\n\n<p>No existe un formato oficial obligatorio, pero hay una estructura que funciona bien en la mayor\u00eda de los proyectos:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">1. Descripci\u00f3n general del proyecto<\/h3>\n\n\n\n<p>Una o dos frases que explican qu\u00e9 hace el proyecto y para qui\u00e9n. No hace falta que sea literaria: tiene que ser precisa.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Descripci\u00f3n del proyecto\nAPI REST en Node.js para gestionar reservas de turnos m\u00e9dicos.\nUsuarios principales: cl\u00ednicas peque\u00f1as y consultorios independientes.\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">2. Stack tecnol\u00f3gico<\/h3>\n\n\n\n<p>Listar las tecnolog\u00edas principales con las versiones exactas cuando sea relevante. Esto evita que Claude Code sugiera soluciones incompatibles con tu entorno.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Stack\n- Node.js 20.x\n- Express 4.x\n- PostgreSQL 15 con Prisma ORM\n- Jest para testing\n- Docker para entornos locales\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">3. Convenciones de c\u00f3digo<\/h3>\n\n\n\n<p>Este es uno de los bloques m\u00e1s importantes. Si tu equipo sigue reglas espec\u00edficas, ponlas aqu\u00ed de forma expl\u00edcita.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Convenciones\n- Usar camelCase para variables y funciones\n- Usar PascalCase para clases y componentes\n- Siempre usar async\/await en lugar de callbacks\n- No usar `var`. Solo `const` y `let`\n- Los archivos de test van en la misma carpeta que el m\u00f3dulo, con extensi\u00f3n `.test.js`\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">4. Estructura de directorios<\/h3>\n\n\n\n<p>Una descripci\u00f3n breve de c\u00f3mo est\u00e1 organizado el proyecto. No hace falta detallar cada carpeta: basta con las que tienen l\u00f3gica no evidente.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Estructura principal\n- \/src\/routes \u2192 definici\u00f3n de rutas HTTP\n- \/src\/services \u2192 l\u00f3gica de negocio\n- \/src\/repositories \u2192 acceso a base de datos\n- \/src\/middlewares \u2192 autenticaci\u00f3n, validaciones, logs\n- \/tests \u2192 pruebas de integraci\u00f3n\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">5. Comandos frecuentes<\/h3>\n\n\n\n<p>Los comandos que se usan durante el desarrollo. Tener esto en <code>CLAUDE.md<\/code> permite que Claude Code los ejecute directamente cuando corresponde.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n# Instalar dependencias\nnpm install\n\n# Iniciar en modo desarrollo\nnpm run dev\n\n# Ejecutar tests\nnpm test\n\n# Aplicar migraciones de base de datos\nnpx prisma migrate dev\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">6. Qu\u00e9 evitar<\/h3>\n\n\n\n<p>Esta secci\u00f3n es subestimada y muy \u00fatil. Indica comportamientos que no quieres que el asistente adopte.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Qu\u00e9 evitar\n- No modificar archivos en \/config sin consultar primero\n- No instalar dependencias nuevas sin mencionarlo expl\u00edcitamente\n- No refactorizar c\u00f3digo que no est\u00e9 directamente relacionado con la tarea actual\n- No usar librer\u00edas de fecha distintas a date-fns (ya incluida en el proyecto)\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">7. Contexto adicional relevante<\/h3>\n\n\n\n<p>Cualquier informaci\u00f3n que ayude a entender decisiones de dise\u00f1o ya tomadas. Por ejemplo: por qu\u00e9 se usa una librer\u00eda en lugar de otra, qu\u00e9 m\u00f3dulos est\u00e1n en proceso de migraci\u00f3n o qu\u00e9 partes del c\u00f3digo son legacy y no deben tocarse.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"ejemplos\">Ejemplos reales de secciones \u00fatiles<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Ejemplo 1: proyecto WordPress con Elementor<\/h3>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Contexto\nSitio corporativo en WordPress 6.x con Elementor Pro 3.x.\nNo usar el editor de bloques de WordPress (Gutenberg) para p\u00e1ginas de contenido.\n\n## Convenciones\n- Los hooks personalizados van en \/wp-content\/themes\/mi-tema\/includes\/\n- No editar directamente el theme padre; usar el child theme\n- Las traducciones est\u00e1n en \/languages\/ y usan la funci\u00f3n __() de WordPress\n\n## Qu\u00e9 evitar\n- No agregar plugins sin verificar compatibilidad con Elementor\n- No modificar funciones.php del theme padre\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">Ejemplo 2: proyecto de automatizaci\u00f3n con n8n<\/h3>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Proyecto\nFlujos de automatizaci\u00f3n para una empresa de e-commerce.\nSe procesan pedidos, notificaciones y sincronizaci\u00f3n de stock con un ERP externo.\n\n## Notas importantes\n- La conexi\u00f3n con el ERP usa autenticaci\u00f3n OAuth 2.0; las credenciales est\u00e1n en variables de entorno\n- Los flujos cr\u00edticos tienen versi\u00f3n de respaldo en \/backups\/n8n\/\n- No activar flujos en producci\u00f3n sin probar en el entorno de staging primero\n\n<\/pre><\/div>\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>Si quieres profundizar en c\u00f3mo escribir instrucciones que realmente mejoren los resultados, la gu\u00eda sobre <a href=\"https:\/\/www.neolo.com\/blog\/prompts-para-claude-code.php\">buenos prompts para Claude Code<\/a> ofrece ejemplos concretos que se complementan bien con lo que se puede definir en este archivo.<\/p>\n<\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"errores-comunes\">Errores comunes al escribir CLAUDE.md<\/h2>\n\n\n\n<p><strong>1. Escribir demasiado o demasiado poco<\/strong><br>Un archivo de 10 l\u00edneas no da suficiente contexto. Uno de 500 l\u00edneas diluve lo importante. Lo ideal es entre 50 y 150 l\u00edneas para la mayor\u00eda de los proyectos.<\/p>\n\n\n\n<p><strong>2. Usar lenguaje ambiguo<\/strong><br>Frases como \u00abseguir buenas pr\u00e1cticas\u00bb no significan nada sin contexto. Mejor especificar: \u00abusar el patr\u00f3n repositorio para acceso a datos\u00bb o \u00ablos errores deben lanzarse como instancias de la clase AppError\u00bb.<\/p>\n\n\n\n<p><strong>3. No actualizar el archivo<\/strong><br><code>CLAUDE.md<\/code> tiene que evolucionar con el proyecto. Si agregas una nueva dependencia importante, una nueva carpeta con l\u00f3gica espec\u00edfica o un cambio de convenci\u00f3n, actualizarlo es parte del flujo de trabajo.<\/p>\n\n\n\n<p><strong>4. Olvidar las restricciones<\/strong><br>La secci\u00f3n \u00abqu\u00e9 evitar\u00bb suele omitirse por considerar que el asistente \u00abya lo sabe\u00bb. En la pr\u00e1ctica, es una de las secciones que m\u00e1s previene errores costosos.<\/p>\n\n\n\n<p><strong>5. No probar el archivo<\/strong><br>Despu\u00e9s de escribir <code>CLAUDE.md<\/code>, vale la pena hacer algunas consultas de prueba para verificar que el asistente efectivamente toma en cuenta las instrucciones. Si no lo hace, es se\u00f1al de que algo est\u00e1 mal formulado o el archivo no est\u00e1 en la ubicaci\u00f3n correcta.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"consejos\">Consejos poco conocidos para usuarios avanzados<\/h2>\n\n\n\n<p><strong>Usar secciones condicionales por entorno<\/strong><br>Puedes incluir instrucciones espec\u00edficas para producci\u00f3n o desarrollo dentro del mismo archivo usando encabezados claros:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Solo para entorno de producci\u00f3n\n- No ejecutar migraciones destructivas sin respaldo previo\n- Verificar variables de entorno antes de hacer deploy\n\n<\/pre><\/div>\n\n\n<p><strong>Referenciar documentaci\u00f3n interna<\/strong><br>Si tu proyecto tiene un wiki, un README extendido o una especificaci\u00f3n de API, puedes mencionar d\u00f3nde est\u00e1. Claude Code puede pedirte que lo compartas si lo necesita.<\/p>\n\n\n\n<p><strong>Incluir ejemplos de c\u00f3digo v\u00e1lido<\/strong><br>En lugar de solo describir convenciones, incluir un peque\u00f1o fragmento de c\u00f3digo que muestre el patr\u00f3n esperado es m\u00e1s efectivo que cualquier descripci\u00f3n textual.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Ejemplo de estructura de controlador esperada\n```javascript\n\/\/ Correcto\nasync function getUser(req, res, next) {\n  try {\n    const user = await userService.findById(req.params.id);\n    res.json(user);\n  } catch (error) {\n    next(error);\n  }\n}\n\n<\/pre><\/div>\n\n\n<p><strong>Definir el idioma de respuesta<\/strong><br>Si trabajas en espa\u00f1ol y quieres que Claude Code responda en ese idioma, puedes indicarlo expl\u00edcitamente. Parece obvio, pero en proyectos con c\u00f3digo en ingl\u00e9s, el asistente a veces alterna entre idiomas.<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n## Idioma\nResponder siempre en espa\u00f1ol, independientemente del idioma del c\u00f3digo.\n\n<\/pre><\/div>\n\n\n<p>Para quienes est\u00e1n explorando todo lo que es posible construir con esta herramienta, puede resultar \u00fatil revisar qu\u00e9 se puede crear con Claude Code antes de definir las instrucciones del proyecto.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"hosting\">\u00bfQu\u00e9 hosting necesitas para trabajar con Claude Code?<\/h2>\n\n\n\n<p>Claude Code funciona en la terminal y necesita un entorno donde pueda ejecutar comandos, instalar dependencias y acceder a archivos del proyecto. En el desarrollo local esto funciona sin problemas, pero cuando el proyecto escala \u2014o cuando se quiere tener un entorno persistente, compartido o automatizado\u2014 un servidor propio marca la diferencia.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u00bfPor qu\u00e9 un VPS y no un hosting compartido?<\/h3>\n\n\n\n<p>Un hosting compartido impone restricciones sobre los procesos que se pueden ejecutar, el tiempo de ejecuci\u00f3n de scripts y el acceso SSH completo. Claude Code necesita precisamente ese acceso para funcionar de forma fluida: ejecutar comandos largos, instalar herramientas globales, gestionar entornos virtuales o mantener procesos activos.<\/p>\n\n\n\n<p>Un <a href=\"https:\/\/www.neolo.com\/esp\/claude-code-vps\/\">hosting VPS<\/a> resuelve todos estos l\u00edmites. El usuario tiene acceso root, puede configurar el entorno a medida y mantener sesiones de trabajo activas sin que el servidor las interrumpa.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/www.neolo.com\/esp\/vps-hosting\/\"><img decoding=\"async\" src=\"http:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2026\/03\/vps-hosting-claude-code.png\" alt=\"Hosting VPS para Claude Code en Neolo\"\/><\/a><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u00bfQu\u00e9 especificaciones m\u00ednimas se recomiendan?<\/h2>\n\n\n\n<p>Para un proyecto de desarrollo individual o de equipo peque\u00f1o:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>RAM:<\/strong> 2 GB como m\u00ednimo; 4 GB si se ejecutan procesos simult\u00e1neos o se aloja tambi\u00e9n la base de datos<\/li>\n\n\n\n<li><strong>CPU:<\/strong> 2 vCPUs suelen ser suficientes para desarrollo activo<\/li>\n\n\n\n<li><strong>Almacenamiento:<\/strong> SSD NVMe para tiempos de respuesta m\u00e1s r\u00e1pidos en operaciones de lectura\/escritura<\/li>\n\n\n\n<li><strong>Sistema operativo:<\/strong> Ubuntu 22.04 LTS es el entorno m\u00e1s documentado y compatible<\/li>\n<\/ul>\n\n\n\n<p>Neolo ofrece <a href=\"https:\/\/www.neolo.com\/esp\/vps-hosting\/\">hosting VPS<\/a> con estas caracter\u00edsticas, con soporte t\u00e9cnico real y tiempo de respuesta promedio inferior a una hora para el 80% de las consultas. Para quienes vienen del contexto de Claude Code, hay informaci\u00f3n espec\u00edfica sobre <a href=\"https:\/\/www.neolo.com\/blog\/claude-code-hosting-vps.php\">por qu\u00e9 Claude Code necesita un hosting VPS<\/a> que explica los detalles t\u00e9cnicos con m\u00e1s profundidad.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Cursor vs Claude Code<\/h2>\n\n\n\n<p>Si todav\u00eda est\u00e1s evaluando qu\u00e9 herramienta usar para tu flujo de trabajo, este video puede ayudarte a decidir:<\/p>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Cursor vs Claude Code: Cu\u00e1l elegir\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/Dv_CtIGnHz4?feature=oembed&#038;enablejsapi=1&#038;origin=https:\/\/www.neolo.com\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"resenas\">Lo que dicen los clientes de Neolo<\/h2>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>\u2605\u2605\u2605\u2605\u2605 <strong>Mauro Lopreste<\/strong><br>\u00abLlevo muchos a\u00f1os alojando mis webs en Neolo. La atenci\u00f3n siempre fue excelente.\u00bb<\/p>\n\n\n\n<p>\u2605\u2605\u2605\u2605\u2605 <strong>Marcelo Lara<\/strong><br>\u00abRespuesta eficaz e inmediata. Siempre brindan un excelente servicio.\u00bb<\/p>\n\n\n\n<p>\u2605\u2605\u2605\u2605\u2605 <strong>Alejandro Belmonte<\/strong><br>\u00abCliente desde 2006. Siempre me brindaron muy buen servicio, con atenci\u00f3n y respuesta r\u00e1pida.\u00bb<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"faq\">Preguntas frecuentes<\/h2>\n\n\n\n<p><strong>\u00bfCLAUDE.md es obligatorio para usar Claude Code?<\/strong><br>No. Claude Code funciona sin \u00e9l. Pero sin ese archivo, el asistente no tiene contexto del proyecto y opera con suposiciones generales. En proyectos con m\u00e1s de unas pocas semanas de desarrollo, la diferencia de calidad en las respuestas es notable.<\/p>\n\n\n\n<p><strong>\u00bfPuede haber m\u00e1s de un archivo CLAUDE.md en el mismo proyecto?<\/strong><br>S\u00ed. Se pueden tener archivos en subcarpetas con instrucciones espec\u00edficas para esa parte del proyecto. Claude Code los combina seg\u00fan la jerarqu\u00eda de directorios.<\/p>\n\n\n\n<p><strong>\u00bfCu\u00e1nto texto debe tener el archivo CLAUDE.md?<\/strong><br>No hay un l\u00edmite estricto, pero entre 50 y 150 l\u00edneas suele ser el rango m\u00e1s efectivo. Un archivo demasiado largo puede diluir las instrucciones m\u00e1s importantes.<\/p>\n\n\n\n<p><strong>\u00bfCLAUDE.md es compatible con otros asistentes como Cursor o Copilot?<\/strong><br><code>CLAUDE.md<\/code> es espec\u00edfico de Claude Code. Cursor usa un archivo llamado <code>.cursorrules<\/code>. Copilot no tiene un equivalente directo. Si usas m\u00faltiples herramientas, tendr\u00e1s que mantener archivos separados para cada una.<\/p>\n\n\n\n<p><strong>\u00bfPuedo incluir secretos o credenciales en CLAUDE.md?<\/strong><br>No. <code>CLAUDE.md<\/code> es un archivo de texto plano que suele estar en el repositorio. Las credenciales deben manejarse siempre con variables de entorno o un gestor de secretos, nunca en archivos de configuraci\u00f3n de texto.<\/p>\n\n\n\n<p><strong>\u00bfQu\u00e9 pasa si CLAUDE.md tiene instrucciones contradictorias?<\/strong><br>Claude Code intentar\u00e1 resolverlas seg\u00fan el contexto, pero puede dar resultados inconsistentes. Es recomendable revisar el archivo peri\u00f3dicamente para eliminar reglas redundantes o contradictorias.<\/p>\n\n\n\n<p><strong>\u00bfSe puede usar CLAUDE.md para proyectos en espa\u00f1ol?<\/strong><br>S\u00ed, y es recomendable hacerlo si el equipo trabaja en espa\u00f1ol. Se puede indicar expl\u00edcitamente el idioma de respuesta y documentar las convenciones directamente en espa\u00f1ol.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"conclusion\">Conclusi\u00f3n<\/h2>\n\n\n\n<p>Un<strong> <code>CLAUDE.md<\/code><\/strong> bien escrito es una inversi\u00f3n peque\u00f1a con retorno inmediato. Le da al asistente el contexto que necesita para trabajar de forma coherente con tu proyecto: las tecnolog\u00edas que usas, las convenciones que segu\u00eds, las restricciones que importan.<\/p>\n\n\n\n<p>La clave est\u00e1 en ser espec\u00edfico sin ser exhaustivo, y en mantener el archivo actualizado a medida que el proyecto evoluciona.<\/p>\n\n\n\n<p>Si est\u00e1s llevando tus proyectos con Claude Code a un entorno de servidor propio, un <a href=\"https:\/\/www.neolo.com\/esp\/claude-code-vps\/\">hosting VPS de Neolo<\/a> ofrece el acceso completo que necesitas para trabajar sin restricciones, con m\u00e1s de 20 a\u00f1os de experiencia en infraestructura y soporte t\u00e9cnico disponible cuando realmente lo necesitas.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>El archivo CLAUDE.md le indica a Claude Code c\u00f3mo comportarse en tu proyecto: qu\u00e9 tecnolog\u00edas usas, qu\u00e9 convenciones seguir y qu\u00e9 errores evitar. Configurarlo bien desde el principio ahorra tiempo, reduce fricciones y hace que el asistente trabaje como si conociera tu proyecto de memoria. \u00bfQu\u00e9 es CLAUDE.md y para qu\u00e9 sirve? CLAUDE.md es un [&hellip;]<\/p>\n","protected":false},"author":21,"featured_media":29065,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[351],"tags":[],"class_list":["post-32689","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-desarrollo-web"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.6 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>\u00bfQu\u00e9 poner en CLAUDE.md? - Neolo Blog<\/title>\n<meta name=\"description\" content=\"\u00bfQu\u00e9 poner en CLAUDE.md? En qu\u00e9 VPS conviene alojarlo al mejor precio.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.neolo.com\/blog\/claude-md.php\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"\u00bfQu\u00e9 poner en CLAUDE.md? - Neolo Blog\" \/>\n<meta property=\"og:description\" content=\"\u00bfQu\u00e9 poner en CLAUDE.md? En qu\u00e9 VPS conviene alojarlo al mejor precio.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.neolo.com\/blog\/claude-md.php\" \/>\n<meta property=\"og:site_name\" content=\"Neolo Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/neolohosting\" \/>\n<meta property=\"article:published_time\" content=\"2026-06-27T03:20:00+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp\" \/>\n\t<meta property=\"og:image:width\" content=\"1588\" \/>\n\t<meta property=\"og:image:height\" content=\"1054\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/webp\" \/>\n<meta name=\"author\" content=\"Leo\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@neolo\" \/>\n<meta name=\"twitter:site\" content=\"@neolo\" \/>\n<meta name=\"twitter:label1\" content=\"Escrito por\" \/>\n\t<meta name=\"twitter:data1\" content=\"Leo\" \/>\n\t<meta name=\"twitter:label2\" content=\"Tiempo de lectura\" \/>\n\t<meta name=\"twitter:data2\" content=\"8 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php\"},\"author\":{\"name\":\"Leo\",\"@id\":\"https:\/\/www.neolo.com\/blog\/#\/schema\/person\/5fe808bcffd4347c68bc5388a05a5a30\"},\"headline\":\"\u00bfQu\u00e9 poner en CLAUDE.md?\",\"datePublished\":\"2026-06-27T03:20:00+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php\"},\"wordCount\":1728,\"publisher\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp\",\"articleSection\":[\"Desarrollo web\"],\"inLanguage\":\"es\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php\",\"url\":\"https:\/\/www.neolo.com\/blog\/claude-md.php\",\"name\":\"\u00bfQu\u00e9 poner en CLAUDE.md? - Neolo Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp\",\"datePublished\":\"2026-06-27T03:20:00+00:00\",\"description\":\"\u00bfQu\u00e9 poner en CLAUDE.md? En qu\u00e9 VPS conviene alojarlo al mejor precio.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php#breadcrumb\"},\"inLanguage\":\"es\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.neolo.com\/blog\/claude-md.php\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php#primaryimage\",\"url\":\"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp\",\"contentUrl\":\"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp\",\"width\":1588,\"height\":1054},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.neolo.com\/blog\/claude-md.php#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Inicio\",\"item\":\"https:\/\/www.neolo.com\/blog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Desarrollo web\",\"item\":\"https:\/\/www.neolo.com\/blog\/temas\/desarrollo-web\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"\u00bfQu\u00e9 poner en CLAUDE.md?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.neolo.com\/blog\/#website\",\"url\":\"https:\/\/www.neolo.com\/blog\/\",\"name\":\"Neolo Blog\",\"description\":\"Blog de Neolo: Dominios, Web Hosting y Marketing Digital\",\"publisher\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.neolo.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"es\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.neolo.com\/blog\/#organization\",\"name\":\"Neolo\",\"url\":\"https:\/\/www.neolo.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\/\/www.neolo.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2017\/07\/neolo-verde-chico.png\",\"contentUrl\":\"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2017\/07\/neolo-verde-chico.png\",\"width\":392,\"height\":83,\"caption\":\"Neolo\"},\"image\":{\"@id\":\"https:\/\/www.neolo.com\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/neolohosting\",\"https:\/\/x.com\/neolo\",\"https:\/\/www.instagram.com\/neolodotcom\/\",\"https:\/\/www.linkedin.com\/company\/neolo.com\/\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.neolo.com\/blog\/#\/schema\/person\/5fe808bcffd4347c68bc5388a05a5a30\",\"name\":\"Leo\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"es\",\"@id\":\"https:\/\/www.neolo.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/279168ad52820892dbc4c5b373d7fec5?s=96&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/279168ad52820892dbc4c5b373d7fec5?s=96&r=g\",\"caption\":\"Leo\"},\"url\":\"https:\/\/www.neolo.com\/blog\/author\/leo\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"\u00bfQu\u00e9 poner en CLAUDE.md? - Neolo Blog","description":"\u00bfQu\u00e9 poner en CLAUDE.md? En qu\u00e9 VPS conviene alojarlo al mejor precio.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.neolo.com\/blog\/claude-md.php","og_type":"article","og_title":"\u00bfQu\u00e9 poner en CLAUDE.md? - Neolo Blog","og_description":"\u00bfQu\u00e9 poner en CLAUDE.md? En qu\u00e9 VPS conviene alojarlo al mejor precio.","og_url":"https:\/\/www.neolo.com\/blog\/claude-md.php","og_site_name":"Neolo Blog","article_publisher":"https:\/\/www.facebook.com\/neolohosting","article_published_time":"2026-06-27T03:20:00+00:00","og_image":[{"width":1588,"height":1054,"url":"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp","type":"image\/webp"}],"author":"Leo","twitter_card":"summary_large_image","twitter_creator":"@neolo","twitter_site":"@neolo","twitter_misc":{"Escrito por":"Leo","Tiempo de lectura":"8 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.neolo.com\/blog\/claude-md.php#article","isPartOf":{"@id":"https:\/\/www.neolo.com\/blog\/claude-md.php"},"author":{"name":"Leo","@id":"https:\/\/www.neolo.com\/blog\/#\/schema\/person\/5fe808bcffd4347c68bc5388a05a5a30"},"headline":"\u00bfQu\u00e9 poner en CLAUDE.md?","datePublished":"2026-06-27T03:20:00+00:00","mainEntityOfPage":{"@id":"https:\/\/www.neolo.com\/blog\/claude-md.php"},"wordCount":1728,"publisher":{"@id":"https:\/\/www.neolo.com\/blog\/#organization"},"image":{"@id":"https:\/\/www.neolo.com\/blog\/claude-md.php#primaryimage"},"thumbnailUrl":"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp","articleSection":["Desarrollo web"],"inLanguage":"es"},{"@type":"WebPage","@id":"https:\/\/www.neolo.com\/blog\/claude-md.php","url":"https:\/\/www.neolo.com\/blog\/claude-md.php","name":"\u00bfQu\u00e9 poner en CLAUDE.md? - Neolo Blog","isPartOf":{"@id":"https:\/\/www.neolo.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.neolo.com\/blog\/claude-md.php#primaryimage"},"image":{"@id":"https:\/\/www.neolo.com\/blog\/claude-md.php#primaryimage"},"thumbnailUrl":"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp","datePublished":"2026-06-27T03:20:00+00:00","description":"\u00bfQu\u00e9 poner en CLAUDE.md? En qu\u00e9 VPS conviene alojarlo al mejor precio.","breadcrumb":{"@id":"https:\/\/www.neolo.com\/blog\/claude-md.php#breadcrumb"},"inLanguage":"es","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.neolo.com\/blog\/claude-md.php"]}]},{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/www.neolo.com\/blog\/claude-md.php#primaryimage","url":"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp","contentUrl":"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2025\/08\/claude-code-que-es-.webp","width":1588,"height":1054},{"@type":"BreadcrumbList","@id":"https:\/\/www.neolo.com\/blog\/claude-md.php#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Inicio","item":"https:\/\/www.neolo.com\/blog"},{"@type":"ListItem","position":2,"name":"Desarrollo web","item":"https:\/\/www.neolo.com\/blog\/temas\/desarrollo-web"},{"@type":"ListItem","position":3,"name":"\u00bfQu\u00e9 poner en CLAUDE.md?"}]},{"@type":"WebSite","@id":"https:\/\/www.neolo.com\/blog\/#website","url":"https:\/\/www.neolo.com\/blog\/","name":"Neolo Blog","description":"Blog de Neolo: Dominios, Web Hosting y Marketing Digital","publisher":{"@id":"https:\/\/www.neolo.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.neolo.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"es"},{"@type":"Organization","@id":"https:\/\/www.neolo.com\/blog\/#organization","name":"Neolo","url":"https:\/\/www.neolo.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/www.neolo.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2017\/07\/neolo-verde-chico.png","contentUrl":"https:\/\/www.neolo.com\/blog\/wp-content\/uploads\/2017\/07\/neolo-verde-chico.png","width":392,"height":83,"caption":"Neolo"},"image":{"@id":"https:\/\/www.neolo.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/neolohosting","https:\/\/x.com\/neolo","https:\/\/www.instagram.com\/neolodotcom\/","https:\/\/www.linkedin.com\/company\/neolo.com\/"]},{"@type":"Person","@id":"https:\/\/www.neolo.com\/blog\/#\/schema\/person\/5fe808bcffd4347c68bc5388a05a5a30","name":"Leo","image":{"@type":"ImageObject","inLanguage":"es","@id":"https:\/\/www.neolo.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/279168ad52820892dbc4c5b373d7fec5?s=96&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/279168ad52820892dbc4c5b373d7fec5?s=96&r=g","caption":"Leo"},"url":"https:\/\/www.neolo.com\/blog\/author\/leo"}]}},"_links":{"self":[{"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/posts\/32689","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/users\/21"}],"replies":[{"embeddable":true,"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/comments?post=32689"}],"version-history":[{"count":1,"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/posts\/32689\/revisions"}],"predecessor-version":[{"id":32691,"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/posts\/32689\/revisions\/32691"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/media\/29065"}],"wp:attachment":[{"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/media?parent=32689"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/categories?post=32689"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.neolo.com\/blog\/wp-json\/wp\/v2\/tags?post=32689"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}