Optimizacion de Costos

Claude Code no es gratis. Pero con las estrategias correctas, el ROI es brutal. Este modulo te ensena a maximizar valor y controlar gastos.

Modelo de Pricing

Claude Code cobra por tokens:

Pro Tip: Los output tokens cuestan 5x mas que los input tokens. Esto importa para la estrategia.

Ver Tu Uso Actual

/cost

Muestra:

• Tokens usados en la sesion
• Costo estimado
• Desglose por tipo (input/output)

/context

Muestra:

• Porcentaje de contexto usado
• Tokens en el contexto actual

Estrategias de Optimizacion

1. Limpiar Contexto Regularmente

Cada mensaje que mandas se acumula en el contexto. Despues de terminar una feature:

/clear

Esto resetea el contexto y reduce el costo de los proximos mensajes.

Regla: /clear entre features distintas. Siempre.

2. Usar /compact en Lugar de Acumular

Si necesitas mantener algo de contexto pero reducir tokens:

/compact

Claude resume el historial en lugar de mantener todo. Perdes detalle pero ahorras tokens.

3. CLAUDE.md > Repetir Instrucciones

Caro: Escribir las mismas instrucciones en cada mensaje.

Usa TypeScript estricto, functional components en React,
y Tailwind para estilos. Asegurate de...
[50 tokens cada vez]

Barato: Ponerlo en CLAUDE.md una vez.

Claude lee CLAUDE.md automaticamente. No necesitas repetir.

4. Prompts Concisos

Caro:

Podrias por favor crear un componente de React que muestre
una lista de usuarios? Necesito que sea responsive y que
tenga paginacion. Ah, y tambien que tenga un buscador.
El estilo deberia seguir lo que ya tenemos en el proyecto.
Gracias!

Barato:

Crea UserList component:
- Lista de usuarios
- Responsive
- Paginacion
- Buscador
- Mismo estilo del proyecto

Mismo resultado, 40% menos tokens.

5. Plan Mode para Features Grandes

Plan Mode te da un plan antes de ejecutar. Si el plan no es lo que querias, lo cambias ANTES de que Claude escriba codigo.

Sin Plan Mode: Claude genera 500 lineas de codigo mal enfocado → tokens desperdiciados.

Con Plan Mode: Ajustas el plan primero → codigo correcto de una.

6. Sub-Agentes para Tareas Paralelas

Los sub-agentes tienen contexto separado. Si una tarea no necesita todo el contexto del chat principal, mandala a un sub-agente.

Contexto principal: 100k tokens de proyecto. Sub-agente: Solo los archivos relevantes (20k tokens).

7. Ignorar Archivos Innecesarios

En tu CLAUDE.md, especifica que archivos ignorar:

## Files to Ignore
 
- node_modules/
- dist/
- .git/
- *.log
- *.lock

Claude no los leera, ahorrando tokens de input.

Comparacion de Costos Por Workflow

Contexto: Un developer mid-level cuesta $50-100/hora. Si Claude te ahorra 50% del tiempo, el ROI es 10x+.

Planes de Claude Code

Pro Tip: El plan Pro se paga solo si usas Claude Code mas de 2-3 horas por semana.

Metricas Para Tracking

Lleva registro de:

1. Costo por feature: ¿Cuanto gastaste en cada feature?
2. Tiempo ahorrado: ¿Cuanto hubieras tardado sin Claude?
3. ROI: Tiempo ahorrado × tu tarifa vs costo de Claude

Ejemplo de Calculo

Feature: Sistema de autenticacion
- Tiempo sin Claude: 8 horas
- Tiempo con Claude: 2 horas
- Costo de Claude: $8
- Mi tarifa: $80/hora
- Tiempo ahorrado: 6 horas = $480 de valor
- ROI: $480 / $8 = 60x

Errores Que Me Costaron Plata

Error 1: No Usar /clear

El error: Trabaje 4 horas en el mismo chat. El contexto crecio a 150k tokens. Cada mensaje costaba el triple.

El costo: ~$15 extra innecesarios.

La leccion: /clear cada 30-45 minutos de trabajo activo.

Error 2: Dejar Claude Hablar de Mas

El error: Claude generaba explicaciones largas que no pedi. Output tokens = caro.

El costo: 2x lo necesario en outputs.

La solucion: Agregar a CLAUDE.md: "Se conciso. Solo codigo y comentarios esenciales."

Error 3: Contexto Inflado por Archivos Grandes

El error: Un archivo de 10k lineas estaba en el contexto. Claude lo leia en cada mensaje.

El costo: Tokens de input inflados.

La solucion: Reorganizar codigo en archivos mas chicos. Especificar que archivos ignorar.

Checklist de Optimizacion

• CLAUDE.md configurado con reglas claras
• Archivos innecesarios en la lista de ignore
• /clear cada 30-45 min de trabajo
• Prompts concisos (no explicaciones largas)
• Plan Mode para features > 1 hora
• Sub-agentes para tareas aisladas
• Tracking de costo por feature

Cuanto Deberia Gastar?

Si gastas mucho mas que esto, revisa tu workflow. Si gastas mucho menos, probablemente no estas aprovechando Claude Code al maximo.

Cuando Las Cosas Se Rompen: Guia de Recuperacion

Claude Code te hace mas productivo, pero tambien puede romper cosas mas rapido. Aca esta como recuperarte.

Escenario 1: Claude Genero Codigo que Rompio Produccion

Sintomas: Deploy fallo, errores en logs, usuarios reportando bugs

Protocolo de recuperacion:

# 1. Rollback inmediato
git revert HEAD
git push origin main
 
# 2. Verificar que la reversion funciona
# (tu CI/CD deberia deployar automaticamente)
 
# 3. Analizar que salio mal
git diff HEAD~1..HEAD~2  # Ver los cambios de Claude
 
# 4. En Claude Code
/clear
"Analiza estos cambios y explica que pudo haber causado [error especifico]"

Escenario 2: Tests Pasan Pero App No Funciona

Sintomas: CI verde, pero comportamiento raro en produccion

Protocolo:

# 1. Agregar logging temporal
"Agrega console.logs en [funcion] para ver el flujo de datos"
 
# 2. Comparar comportamiento
"Explica la diferencia entre el entorno de test y produccion para esta feature"
 
# 3. Encontrar el gap
"Que casos de edge podria haber en produccion que los tests no cubren?"

Escenario 3: Claude Modifico Archivos que No Debia

Sintomas: Cambios inesperados en archivos core/config

Protocolo:

# 1. Ver que cambio
git status
git diff
 
# 2. Revertir archivos especificos
git checkout HEAD -- [archivo-que-no-debia-cambiar]
 
# 3. Prevenir en el futuro
# Agregar a CLAUDE.md:
"# Do NOT modify: config/, .env*, package-lock.json"

Escenario 4: Costos Se Dispararon

Sintomas: Factura de Claude mucho mas alta de lo esperado

Protocolo:

# 1. Diagnostico
/cost                    # Ver sesion actual
/context                 # Ver tamaño del contexto
 
# 2. Identificar causa
# - Contexto nunca limpiado?
# - Archivos grandes en contexto?
# - Demasiados outputs largos?
 
# 3. Remediar
/clear
# Agregar a CLAUDE.md: "Be concise. Code only, minimal explanations."

Checklist de Recuperacion Universal

Cuando algo se rompe:

• STOP - No sigas ejecutando comandos
• Evalua el daño - git status, git diff, logs
• Rollback si es necesario - git revert o git checkout
• Entende la causa - Pedi a Claude que explique
• Preveni repeticion - Actualiza CLAUDE.md o permisos
• Documenta - Agrega a tu lista de "errores que no repetir"

Para Equipos: Incident Response con Claude

# Incident Response Playbook
 
## Severidad Alta (Produccion caida)
1. Rollback inmediato (no debuggear primero)
2. Comunicar al equipo
3. Post-mortem despues de resolver
 
## Severidad Media (Feature rota)
1. Deshabilitar feature si es posible
2. Crear ticket
3. Fix en branch separada
 
## Severidad Baja (Bug menor)
1. Documentar
2. Agregar a backlog
3. Fix en proximo sprint
 
## Usando Claude para Post-Mortems
"Analiza estos commits [hash1..hash2] y genera un post-mortem:
- Que cambio
- Que rompio
- Como prevenirlo en el futuro"

Desafio: Prueba Esto

Esta semana:

• Corre /cost al final de cada sesion
• Anota el costo de 3 features distintas
• Calcula el ROI de al menos 1 feature
• Implementa 2 optimizaciones de esta leccion

Tiempo estimado: Durante tu trabajo normal

Siguiente Paso

Ahora que sabes optimizar costos, tenes todas las herramientas para usar Claude Code en produccion. El ultimo modulo es tu plan de accion de 7 dias.