Cómo configurar el archivo CLAUDE.md de tu empresa para que la IA deje de responder como un chatbot genérico
Llevas tres semanas usando la IA para redactar correos a clientes. Los textos están bien escritos, sin faltas, con buena estructura. Y totalmente descontextualizados: no menciona tu sector, usa un tono que no es el tuyo y en el segundo párrafo aparece la palabra «soluciones integrales», que juraste que nunca volverías a escribir.
El problema no es la IA. El problema es que nadie le ha dicho quién eres.
Cada vez que abres una sesión nueva, la IA empieza desde cero. No sabe que tu empresa lleva veinte años en el sector logístico, que a vuestros clientes les tratáis de tú, que el margen comercial no se menciona en comunicaciones externas o que el departamento de RRHH prefiere «personas» a «recursos humanos». Sin ese contexto, responde de manera genérica. Y genérico, en la práctica, significa inútil.
La solución tiene un nombre técnico poco atractivo: el archivo CLAUDE.md.
Formación presencial · Madrid
¿Quieres salir de aquí sabiendo hacer esto en tu empresa el próximo 14 de noviembre?
En un día presencial montas tus departamentos agénticos con IA y construyes tu propia app. Sin conocimientos técnicos. Máx. 16 plazas.
—
Qué es el archivo CLAUDE.md y cómo configurarlo para tu empresa
El archivo CLAUDE.md es un archivo de texto plano que Claude Code —la herramienta de desarrollo con IA de Anthropic— carga automáticamente al inicio de cada sesión de trabajo, sin que tengas que hacer nada. En una frase: es el documento de instrucciones permanente que le dice a la IA quién eres, cómo trabajáis y qué está prohibido en tu empresa.
No es un prompt que escribes cada vez. Lo configuras una vez, lo dejas en tu carpeta de trabajo y la IA lo tiene presente siempre. Configurar el archivo CLAUDE.md de la empresa es, en la práctica, lo primero que hay que hacer antes de poner a alguien del equipo a trabajar con Claude Code.
Piénsalo como el briefing de incorporación que le darías a un consultor externo muy capaz pero que no conoce tu empresa. Sin briefing, tiene que improvisar. Con un buen CLAUDE.md, puede trabajar como si llevara meses contigo.
La diferencia en la práctica es notable. Sin CLAUDE.md, le pides un correo de respuesta a una reclamación y recibes un texto corporativo estándar que podría haber escrito cualquiera para cualquier empresa. Con CLAUDE.md bien configurado, recibes un texto que respeta tu tono, menciona los plazos reales de vuestra política de atención, evita las frases que vuestro equipo jurídico ha prohibido y termina con la firma que usáis en comunicaciones formales.
—
Qué metes dentro cuando configuras el archivo CLAUDE.md
No hay un formato obligatorio. Sí hay unos bloques que, en mi experiencia, marcan la diferencia entre una IA que ayuda y una que entorpece.
1. Contexto de negocio
Quién eres, qué haces y para quién. No la versión del folleto comercial, sino la que le darías a alguien inteligente en diez minutos.
`
La empresa
Somos una gestoría especializada en pymes industriales de la zona de Valencia. Trabajamos con unos 120 clientes activos, la mayoría fabricantes con entre 10 y 80 empleados. Nuestros servicios principales son contabilidad, nóminas y asesoría fiscal. Llevamos 18 años en el mercado. `
Con esto, la IA deja de sugerir que ofrezcas «servicios cloud escalables» cuando le pides ideas de upselling.
2. Tono y estilo de comunicación
Cómo habláis con vuestros clientes y cómo no. Este bloque ahorra más tiempo del que parece.
`
Tono
- Tratamos de tú siempre, tanto en comunicaciones escritas como en persona.
- Directo y sin rodeos. Si hay un problema, se nombra sin eufemismos.
- Sin jerga financiera en comunicaciones externas. Si hay que usar un
- Nunca: «soluciones», «sinergias», «ecosistema», «disruptivo».
término técnico, se explica.
`
3. Reglas y políticas
Las cosas que «siempre hacemos» o «nunca hacemos» y que no están escritas en ningún sitio, pero todo el equipo sabe. Este es el bloque más valioso y el más infravalorado.
`
Políticas internas
- Los plazos de respuesta a clientes son siempre 24 horas laborables.
- No se citan precios en correos sin validación del responsable de cuenta.
- Los contratos se envían siempre en PDF, nunca en Word editable.
- Cualquier comunicación sobre litigios pasa primero por el departamento legal.
`
4. Vocabulario propio
Cada empresa tiene sus términos. El «expediente» que en otra empresa llaman «caso» o «ticket». El «cliente final» frente al «cliente directo». El nombre de vuestros productos o servicios internos.
`
Vocabulario
- «Expediente» = cada cliente activo tiene un expediente en el CRM.
- «Cierre» = proceso de cierre fiscal trimestral. No confundir con cierre
- No usamos «factura proforma», usamos «presupuesto formal».
de ventas.
`
5. Qué NO hacer nunca
Un bloque corto pero crítico. La IA tiende a ser útil hasta el punto de cruzar líneas que nadie le dijo que no cruzara.
`
Prohibido
- No mencionar a competidores por nombre en ningún tipo de texto.
- No prometer plazos de entrega sin confirmación del equipo operativo.
- No usar datos de clientes como ejemplos en materiales internos.
`
—
Cómo escribirlo bien: tres principios
Claro antes que completo. Un CLAUDE.md de 200 líneas que la IA no puede procesar bien es peor que uno de 50 líneas preciso. Empieza pequeño. Añade cuando veas que algo falla.
Bloques con títulos. La IA procesa mejor la información estructurada. Un bloque de texto corrido es menos eficaz que bloques con encabezados claros: ## Tono, ## Clientes, ## Restricciones. Usa el formato Markdown básico: ## para los títulos, guiones para las listas.
Ejemplos concretos en lugar de principios abstractos. «Sé cercano» es vago. «Tutea siempre, usa frases cortas, evita el subjuntivo en modo formal» es accionable. La diferencia entre los dos es la diferencia entre una IA que interpreta y una que aplica.
—
El antes y el después en un ejemplo real
Misma petición a la IA: «Redacta un correo para avisar a un cliente de que su declaración trimestral está lista para revisar.»
Sin CLAUDE.md: > Estimado cliente, nos complace informarle de que su declaración trimestral ya se encuentra disponible para su revisión en nuestra plataforma. Quedamos a su disposición para cualquier consulta que pudiera surgir al respecto.
Con CLAUDE.md configurado con los bloques anteriores: > Hola Carlos, ya tienes lista la declaración del segundo trimestre para revisar. La tienes en tu carpeta del expediente. Si ves algo que no cuadre, llámanos antes del jueves que el plazo de presentación es el viernes.
No es magia. Es contexto. La IA de serie es como un colaborador externo recién llegado que no sabe nada de tu empresa. El CLAUDE.md es el manual de incorporación que le pones encima de la mesa el primer día.
—
Por dónde empezar si nunca has escrito uno
No hace falta escribir el CLAUDE.md perfecto a la primera. En mi experiencia, el mejor punto de entrada es hacerse tres preguntas:
- ¿Qué respuestas genéricas de la IA te han hecho perder tiempo esta semana?
- ¿Qué le explicarías a un consultor externo en los primeros diez minutos?
- ¿Qué frases o decisiones nunca tomaríais aunque la IA las sugiera?
Con esas tres respuestas ya tienes material para un primer CLAUDE.md funcional. Con el tiempo, el archivo crece a medida que encuentras nuevos casos donde la IA falla por falta de contexto.
La lógica es la misma que con cualquier proceso de incorporación: cuanto mejor documentas cómo trabajáis, menos tiempo perdéis corrigiendo a quien no lo sabe.
Leer también: Las skills de Claude Code y Comandos esenciales de Claude Code.
—
Preguntas frecuentes
¿El CLAUDE.md funciona solo con Claude Code o también con otros chatbots de IA?
El nombre y el mecanismo son específicos de Claude Code: es una función documentada de la herramienta que carga el archivo automáticamente en cada sesión desde la carpeta del proyecto. ChatGPT tiene las «instrucciones personalizadas» y Gemini algo similar, pero ninguno lo hace de forma tan transparente para trabajo en equipo. Saber cómo configurar el archivo CLAUDE.md es, por tanto, una habilidad específica de esta herramienta.
¿Puede el CLAUDE.md tener información confidencial de la empresa?
Depende de dónde ejecutes Claude Code y qué datos incluyes. Si trabajas con información sensible (datos de clientes, márgenes, operaciones internas), conviene revisar las condiciones de uso de la herramienta y no incluir datos específicos de personas o clientes en el archivo. El CLAUDE.md es para reglas y contexto, no para bases de datos.
¿Cada departamento debería tener su propio CLAUDE.md?
Sí, es una práctica razonable. El CLAUDE.md del departamento comercial tiene reglas distintas al de RRHH o al de operaciones. Puedes tener un archivo base con el contexto general de la empresa y archivos específicos por departamento o proyecto. Claude Code permite estructurar esto de forma modular.
