Productividad y documentos Guía paso a paso

Instrucciones que ahorran tokens: proyectos de Claude y CLAUDE.md eficientes

Las instrucciones que pones en un proyecto de Claude o en tu CLAUDE.md viajan en cada mensaje: bien escritas ahorran, mal escritas cuestan siempre. Esta guía explica qué consume realmente tu uso, qué ahorra de verdad el repositorio claude-token-efficient según sus propias mediciones y cómo escribir instrucciones cortas para tus proyectos y tu código.

Nivel
Principiante
Qué necesitas
Un plan de Claude con Proyectos o Claude Code; para el repositorio, solo un proyecto donde copiar el archivo.
Cuánto lleva
Unos 20 minutos.

Herramientas que usa esta guía

01 Qué consume realmente tu uso

Cada vez que envías un mensaje, Claude no recibe solo ese mensaje: recibe toda la conversación anterior, lo que ha leído por el camino (archivos, resultados de comandos) y tus instrucciones. Por eso una respuesta corta no garantiza ahorrar: en una sesión larga, lo que más pesa es lo que va de ida.

01

La conversación

Crece con cada turno. Es lo que más pesa en sesiones largas.

02

Lo que Claude lee

Archivos, logs y salidas de herramientas que se quedan en el contexto aunque ya no sirvan.

03

Tus instrucciones

Proyecto, perfil, CLAUDE.md. Se repiten en cada mensaje: cada línea de más se paga siempre.

04

Lo que trae de serie

Instrucciones del sistema y herramientas disponibles. No lo controlas.

02 Qué es claude-token-efficient y qué ahorra de verdad

Es un repositorio con un CLAUDE.md muy corto y varios perfiles para distintos tipos de proyecto. Sus reglas piden leer antes de escribir, no releer archivos sin cambios, ser concisos al responder, evitar halagos y relleno, y no inventar APIs, versiones ni nombres de paquetes.

Lo interesante es su honestidad: la cifra inicial del 63% salió de contar palabras en cinco prompts y el propio autor la presenta como orientativa. Su benchmark reproducible posterior mide una reducción de tokens de salida de alrededor del 4% en Haiku, 12% en Sonnet y 7% en Opus. Y advierte de que el archivo añade tokens de entrada en cada mensaje: solo compensa cuando generas mucho texto de salida.

Te conviene si… No te conviene si…
Ejecutas muchas tareas repetitivas o pipelines con mucha salida Haces consultas sueltas y cortas
Necesitas un formato de respuesta constante en el equipo Tu trabajo es exploratorio y quieres debate y alternativas
Trabajas en sesiones persistentes Necesitas salida 100% estructurada: ahí usa JSON o herramientas con esquema

03 Cómo usarlo en Claude Code

bash · Opción universal: descargar el CLAUDE.md en la raíz del proyecto
curl -o CLAUDE.md https://raw.githubusercontent.com/drona23/claude-token-efficient/main/CLAUDE.md
bash · Elegir un perfil
git clone https://github.com/drona23/claude-token-efficient
cp claude-token-efficient/profiles/CLAUDE.coding.md tu-proyecto/CLAUDE.md

Recuerda que los CLAUDE.md se combinan: pon tus preferencias generales de formato en ~/.claude/CLAUDE.md y las del proyecto en su raíz. Así no duplicas reglas.

04 Instrucciones de proyecto para la app de Claude

En la app, el equivalente son las instrucciones de cada Proyecto y las preferencias de tu perfil. La clave es la misma: pocas líneas, específicas para ese tipo de trabajo, y que digan qué hacer en lugar de una lista de prohibiciones. Estos son puntos de partida para adaptar.

Prompt · Proyecto: atención a clientes
Redactas respuestas a clientes de [empresa], que vende [producto o servicio]. Tono cercano y profesional, de tú. Responde primero a lo que pregunta el cliente en dos o tres frases; añade pasos numerados solo si tiene que hacer algo. No prometas plazos, descuentos ni excepciones: si hacen falta, escribe [CONSULTAR] y el motivo. Si falta un dato para responder, dime cuál en una línea. Entrega solo el texto listo para enviar.
Prompt · Proyecto: marketing y contenidos
Trabajas para [marca], cuyo público es [describe el público]. Escribe en español de España, frases cortas, sin tópicos publicitarios ni exclamaciones. Cuando pida piezas, entrega directamente el texto y como máximo tres variantes si lo pido. No expliques tus decisiones salvo que te pregunte. Si una afirmación necesita un dato que no te he dado, márcala con [DATO] en lugar de inventarlo.
Prompt · Proyecto: análisis de datos
Analizas los archivos que subo a este proyecto. Empieza siempre por la conclusión principal en una frase y después los datos que la sostienen, en una tabla si son más de tres cifras. Indica qué columnas o filas has usado. Si los datos no permiten responder, dilo y explica qué faltaría. Nada de introducciones ni resúmenes finales.
Prompt · Preferencias de perfil (para todos tus chats)
Respóndeme en español de España. Ve al grano: primero la respuesta, después el detalle solo si aporta. Sin frases de cortesía al principio ni al final. Si no estás seguro de algo, dilo en lugar de suponerlo. Si te pido explicaciones largas o alternativas, dámelas completas.

05 Un CLAUDE.md base escrito por ti

Las reglas genéricas («sé conciso») ayudan poco. Lo que más ahorra son reglas dirigidas a los fallos que tú has visto: bucles de depuración que se alargan, archivos reescritos enteros por un cambio de una línea o tareas dadas por terminadas sin probar. Este es un esqueleto corto para adaptar:

markdown · CLAUDE.md
# Proyecto
Tienda online en Laravel. Tests: composer test. Estilo: composer lint.

## Cómo trabajas
- Lee los archivos implicados antes de editar; no releas los que no han cambiado.
- Cambios mínimos y localizados: edita, no reescribas archivos completos.
- Antes de decir que algo está terminado, ejecuta los tests y muestra el resultado.
- Si un paso falla, para y enseña el error completo antes de intentar arreglarlo.
- No inventes versiones, flags ni nombres de paquetes: compruébalos en el código o la documentación.

## Cómo respondes
- Breve. Sin introducciones ni despedidas.
- Si te pido detalle o alternativas, dámelos completos: mis instrucciones mandan.
Prompt · Ajustar las reglas a tus fallos reales
Revisa mi CLAUDE.md y esta sesión. Dime qué reglas no han cambiado nada en tus respuestas (y por tanto solo cuestan tokens) y qué comportamientos tuyos me han hecho perder tiempo o tokens hoy. Propón como máximo tres reglas nuevas, de una línea cada una, dirigidas a esos fallos concretos, y qué reglas eliminarías.

06 Comprueba si ahorras

  • ✓Repite la misma tarea con y sin las instrucciones y compara la longitud de las respuestas y el número de turnos.
  • ✓Vigila que la calidad no baje: menos palabras no sirve si tienes que pedir aclaraciones.
  • ✓Elimina las reglas sobre comportamientos que el modelo actual ya no tiene: solo cuestan entrada.
  • ✓Revisa tus instrucciones cada vez que cambies de modelo.
  • ✓Si una regla es crítica (no tocar producción), no la confíes al texto: usa permisos o hooks.

Preguntas frecuentes

Para trabajo habitual, el archivo o las instrucciones de proyecto, porque se aplican solas y se benefician de la caché. Pegarlas en el chat sirve para una tarea puntual.

Depende del volumen. El propio repositorio mide reducciones modestas de tokens de salida con su archivo mínimo; el ahorro grande viene de gestionar bien el contexto de las sesiones.

No. Tanto el repositorio como los ejemplos de esta guía dejan claro que tus peticiones explícitas mandan sobre el estilo por defecto.

Las reglas son texto y cualquier modelo que lea contexto puede seguirlas, pero el autor solo las ha medido con Claude.

Sobre el autor

Equipo editorial de appyweb

Marketing, SEO y desarrollo con IA

Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.

Sigue con estas guías

Guía paso a paso · Principiante

Cómo ahorrar tokens en Claude Code sin perder calidad

Explicación práctica de dónde se van los tokens en Claude Code y qué hacer para que tu plan rinda más: medir con /usage y /context, elegir modelo y esfuerzo según la tarea, limpiar el contexto en el momento adecuado y evitar que entre información que no hace falta. Para quien se queda sin cuota a media jornada.

20 minutos para aplicarlo; el ahorro se nota desde la primera sesión Leer la guía →
Guía paso a paso · Intermedio

Cómo hacer que tu límite de uso de Claude Code dure más

Cuatro herramientas de código abierto para estirar tu plan Pro o Max: una comprime lo que Claude Code envía al modelo, otra le da memoria entre sesiones, la tercera te dice qué merece la pena instalar y la última te deja seguir con otros modelos cuando llegas al tope.

Unos 5 minutos para Claude Mem y Claude Code Setup; unos 15 para Headroom y OmniRoute Leer la guía →
Guía paso a paso · Principiante

Configura Claude para que tu plan rinda más: ajustes que deberías tocar hoy

Buena parte del uso que se pierde en Claude se debe a la configuración: repetir quién eres en cada chat, subir los mismos archivos, usar el modelo más potente para todo o dejar herramientas encendidas. Esta guía repasa, ajuste por ajuste, qué tocar en tu cuenta para que el plan te dure más y las respuestas lleguen ya adaptadas a tu negocio.

Unos 20 minutos para dejarlo todo configurado. Leer la guía →
Guía paso a paso · Principiante

Modo TDAH para Claude: respuestas que empiezan por la acción

Modo TDAH es una skill de código abierto que cambia la forma de las respuestas de Claude: primero la acción, pasos numerados, listas cortas, estado del progreso y ni un saludo de relleno. Es la versión en español de i-have-adhd. Pensada para personas con TDAH, pero útil para cualquiera que trabaje con prisas o interrupciones.

Unos 5 minutos. Leer la guía →
Guía paso a paso · Intermedio

context-mode: menos contexto gastado y sesiones más largas en Claude Code

context-mode es un plugin con servidor MCP que evita que capturas, registros, respuestas de API y archivos enormes acaben enteros en la conversación de Claude Code. Los procesa aparte, guarda lo importante en una base de datos local y devuelve solo lo relevante. Para quien trabaja en sesiones largas y ve cómo Claude pierde el hilo tras compactar.

Unos 10 minutos para instalarlo, comprobarlo y ver las primeras estadísticas. Leer la guía →

¿Quieres llevar la IA a tu empresa sin pelearte con todo esto?

Diseñamos e implantamos agentes, automatizaciones y asistentes con IA a medida de tu negocio.

Ver nuestros servicios de IA

Cuéntanos tu proyecto. Te respondemos en 48 h.

Auditoría gratuita de IA, campañas, web y SEO, con prioridades y cifras reales de tu negocio.

✓ Sin compromiso ✓ Respuesta en 48 h laborables ✓ Un consultor senior, no un bot
WA WhatsApp