2 min. de lectura (aproximado)

Cómo configurar claude code con un archivo claude.md

Claude Code es más útil cuando deja de responder “como un asistente genérico” y empieza a trabajar exactamente como realmente se quiere. La forma más sencilla y efectiva de lograrlo es creando un archivo de reglas llamado "CLAUDE.md". Este archivo actúa como un manual de instrucciones permanente y Claude lo lee automáticamente antes de cada respuesta y adapta su comportamiento a las preferencias de cada uno.

¿Por qué es tan importante?

Sin un archivo "CLAUDE.md" Claude decide solo cómo responder. Eso suele traducirse en:
  • Saludos innecesarios.
  • Explicaciones que no se pidieron.
  • Reescrituras completas de archivos cuando solo se quería cambiar una línea.
  • Comentarios o documentación que no se solicitó.
Con el fichero "CLAUDE.md" se evita todo eso y se consiguen respuestas más directas, precisas y alineadas con la forma de trabajar de cada usuario.

Cómo configurar CLAUDE.md en 3 pasos

Paso 1: Crear el archivo

Crear un archivo llamado exactamente "CLAUDE.md" y guardarlo en la carpeta raíz del proyecto ya que ese es el lugar donde Claude lo busca por defecto.

Paso 2: Claude lo lee solo

No es necesario hacer nada más. Cada vez que se interactúa con Claude Code, el archivo se carga automáticamente, como si fuera un manual de instrucciones interno. Aquí es donde se define cómo se quiere Claude trabaje contigo. Se puede ser tan específico como se necesite.

Ejemplo de un CLAUDE.md efectivo

# Cómo trabajar conmigo
- Respóndeme directo.
- Si solo te pido cambiar una línea, toca solo esa línea.
- No me expliques lo que no te he preguntado.
- No metas comentarios a menos que te lo pida.

Consejos para escribir buenas reglas

  • Ser claro y concreto. Las frases cortas y directas funcionan mejor.
  • Priorizar lo que más molesta, como explicaciones largas, cambios innecesarios, tono demasiado formal, etc.
  • Se pueden añadir reglas sobre el estilo del código, estructura de respuestas, uso de herramientas o preferencias de formato.
  • Actualizar el archivo cuando se cambien de preferencias; Claude lo respetará en las siguientes interacciones.

Resultado

Con este archivo se consigue que Claude Code se comporte más como un compañero de trabajo y menos como un asistente que intenta “ayudar de más”. Es una de las configuraciones más simples y de mayor impacto que se puede hacer.