Mejores prácticas de prompt en Claude Code: cómo reducir tokens y costos

Las técnicas que usamos internamente para escribir prompts eficientes en Claude Code: contexto mínimo, instrucciones estructuradas, reuso de skills y patrones que recortan hasta 60% del consumo de tokens.

Cada token que Claude procesa cuesta dinero y tiempo. Si tus prompts son verbosos, repetitivos o cargan contexto innecesario, estás quemando presupuesto sin razón. Estas son las prácticas que aplicamos a diario para reducir el consumo de tokens hasta un 60% sin perder calidad.

1. Contexto mínimo, no contexto máximo

El error más común es darle a Claude todo el proyecto entero "por las dudas". Claude Code ya puede leer archivos cuando los necesita. En lugar de pegar 500 líneas de código en el prompt, referenciá el archivo y dejá que Claude lo lea bajo demanda.

# Mal: pega 300 líneas de código en el prompt
# Bien: referencia el archivo
> Revisá src/components/Header.tsx y agregá un toggle de modo oscuro

Regla de oro: Si Claude puede leer el archivo por sí mismo, no lo pegues en el prompt. Cada línea pegada son tokens que se procesan en cada interacción del chat.

2. Instrucciones estructuradas con listas

Claude procesa mejor las instrucciones cuando están estructuradas. En lugar de escribir un párrafo largo, separá los pasos en una lista numerada. Esto reduce ambigüedad y tokens al mismo tiempo.

# Mal
> Necesito que cambies el color del botón a azul, agregues un ícono de check, lo hagas responsive y también que arregle el padding que está muy grande

# Bien
> En src/components/Button.tsx:
> 1. Cambiar color primary a blue-600
> 2. Agregar ícono Check de lucide-react
> 3. Hacer responsive (full width en mobile)
> 4. Reducir padding de 24px a 16px

Comparación visual entre un prompt verboso con contexto innecesario y un prompt estructurado y mínimo, mostrando la reducción de tokens — Mismo pedido, dos prompts: el de la izquierda quema tokens de más sin mejorar el resultado.

3. Usá Skills para tareas repetitivas

Las Skills son instrucciones reutilizables que Claude carga solo cuando las necesita. Si te encontrás repitiendo los mismos pasos en cada proyecto (setup de base de datos, configuración de Stripe, estructura de carpetas), convertí ese flujo en una Skill.

Una Skill se activa solo cuando el prompt coincide con su descripción, sin consumir tokens del resto del chat
Las instrucciones de la Skill se cargan una vez y se reutilizan en cada invocación
Podés incluir scripts, templates y archivos de referencia dentro de la Skill
Reduce drásticamente el tamaño del prompt principal al externalizar el contexto

4. Evitá repetir el contexto del chat

Claude mantiene el historial de la conversación. No repitas en cada mensaje lo que ya dijiste. Si necesitás que Claude recuerde algo, hacé referencia al mensaje anterior en lugar de reescribirlo.

Cuidado con el contexto acumulado: Cada mensaje nuevo envía TODO el historial del chat. Si la conversación es muy larga, los tokens se acumulan. Cuando cambies de tema, abrí un chat nuevo para resetear el contexto.

5. Sé explícito sobre el output esperado

Si Claude no sabe qué formato esperás, va a generar texto extra explicando su razonamiento. Si le decís exactamente qué querés, produce solo eso.

# Mal
> ¿Qué te parece este código?

# Bien
> Revisá src/utils/auth.ts y respondé solo con:
> - Lista de bugs encontrados (máx 5)
> - Una línea por bug, sin explicación adicional

6. Usá /compact para conversaciones largas

Claude Code tiene un comando /compact que resume el contexto del chat actual. Si llevás 20 mensajes y necesitás seguir trabajando, ejecutá /compact para reducir el historial a un resumen eficiente sin perder el hilo.

Resultados reales

-60% — Reducción de tokens: Reducción promedio al aplicar contexto mínimo y prompts estructurados vs. prompts verbosos.
-45% — Costo mensual: Ahorro en factura de API al reducir tokens procesados por interacción.
+2x — Velocidad de respuesta: Menos tokens = respuestas más rápidas de Claude en cada interacción.
+3 — Chats por sesión: Con /compact y chats nuevos por tema, se aprovecha más cada sesión.

Conclusión

Reducir tokens no es solo un tema de costo: también hace que Claude sea más rápido y preciso. Menos ruido en el prompt = menos probabilidades de que Claude se confunda. Aplicá estas 6 prácticas y vas a notar la diferencia en la primera semana.