Claude Code es una herramienta poderosa pero puede volverse costosa rápidamente si no controlas tu consumo de tokens. Cada solicitud, cada archivo leído, cada mensaje enviado consume tokens. En un proyecto complejo, puede representar cientos de miles de tokens por sesión.
Esta guía está dirigida a todos los que usan Claude Code de forma intensiva: desarrolladores, fundadores técnicos, creadores de agentes autónomos. El objetivo: dividir tu consumo de tokens entre 2 y 5 veces sin sacrificar la calidad del trabajo producido.
## Módulo 1 : Entender cómo Claude Code consume tokens
Cómo funciona la ventana de contexto
Cada vez que Claude Code procesa una tarea, envía y recibe tokens. El consumo se divide en dos categorías:
Tokens de entrada (input): todo lo que Claude recibe : tu instrucción, los archivos leídos, el historial de conversación, el contenido del CLAUDE.md, los resultados de las herramientas.
Tokens de salida (output): lo que Claude genera : el código escrito, las explicaciones, las llamadas a herramientas.
Los tokens de entrada son generalmente más baratos que los de salida, pero representan la mayoría del consumo en tareas largas.
Los 5 grandes pozos de tokens
Aquí están las principales fuentes de consumo innecesario:
## Módulo 2 : Optimizar tus archivos CLAUDE.md
El CLAUDE.md se lee en cada sesión. Suele ser la primera fuente de optimización.
Regla de oro: el CLAUDE.md debe ser quirúrgico
❌ Mala práctica:
# Mi proyecto
Este proyecto es una aplicación web construida con Next.js 14, TypeScript,
Prisma, PostgreSQL, Tailwind CSS. Usamos Vercel para el despliegue.
La arquitectura sigue los principios DDD con bounded contexts...
[300 líneas de contexto general]✅ Buena práctica:
# Stack: Next.js 14 + TypeScript + Prisma + PostgreSQL + Tailwind
# Deploy: Vercel | DB: Supabase
# Convenciones: ver /docs/conventions.md (leer solo si necesario)
# Tests: Jest + Playwright — siempre ejecutar antes del commitEstrategia de CLAUDE.md anidados
Claude Code soporta archivos CLAUDE.md en subcarpetas. Usa esta jerarquía:
Generated by Thread Navigator
Press ⌘ + S to quick-export