La guía completa de Claude Code: app de escritorio o terminal, qué hacer el primer día, los 10 comandos que se usan todos los días, cómo organizar contexto largo y los errores típicos del que recién arranca. Si ya hiciste el setup, esto es lo que viene.
Si ya instalaste Claude Code (si no, mirá la guía de setup primero), esta guía cubre lo que viene después: la fase donde ya funciona pero todavía no le sacás el jugo. Es la curva de aprendizaje del mes 1 condensada.
No es una referencia de comandos — para eso está /help adentro. Es una guía de cómo usarlo bien.
Claude Code viene en dos formas:
La diferencia real no es visual — es que la app desktop te abre una sesión "global" mientras que el CLI se ejecuta dentro de la carpeta del proyecto. Si trabajás contra un repo específico, el CLI tiene mejor contexto desde el primer mensaje.
Mi recomendación: arrancá con la app desktop la primera semana para perderle el miedo. Después pasate al CLI cuando ya sepas qué le querés pedir.
Desde la terminal, parado en el proyecto:
cd mi-proyecto
claudeLa primera vez te va a pedir confirmar algunas operaciones inocuas. Aceptá.
Dentro de la sesión:
> /initEsto escanea tu codebase y genera un CLAUDE.md con el resumen del proyecto. Este archivo es lo más importante: Claude lo lee al empezar cada sesión. Si está bien escrito, la calidad de cada respuesta sube mucho.
Después de generarlo, abrilo y agregale a mano:
npm run dev, npm test:e2e, etc.)No empieces con "refactoreame todo el módulo de auth". Empezá con:
> Explicame qué hace src/lib/db.ts en 5 líneasLee la respuesta. ¿Es correcta? ¿Entiende tu código? Si sí, subí el nivel:
> Agregale tipos a las funciones de src/utils/format.ts. No cambies la lógica.Estás calibrando qué nivel de confianza darle. La primera semana es para eso.
De estos, los 4 que más vas a usar son /clear, /compact, /diff y /permissions. Los demás aparecen ocasionalmente.
El error más común del usuario nuevo: dejar la sesión abierta 4 horas con 20 tareas distintas y al final Claude se confunde porque tiene 4 contextos pisándose.
Patrón que funciona:
Tarea A → trabajar → terminar → /clear
Tarea B → trabajar → terminar → /clear
Tarea C → si requiere lo de A, /resume AClaude Code guarda historiales por proyecto. /resume te muestra sesiones pasadas para retomar contexto específico.
Otra técnica: si una tarea es grande (refactor de un módulo entero), abrila en una sesión dedicada y no mezcles con bug fixes. La calidad cae cuando hay 3 hilos de pensamiento abiertos.
/compact resume el contexto pero pierde detalles. Si estás en medio de algo crítico, mejor que vaya guardando notas en archivos (docs/decisions.md) que sí persisten entre sesiones.
❌ "Mejorá este código" ✅ "Extraé la lógica de validación de email a una función separada y agregale 3 tests."
Cuanto más específico, mejor. "Mejorar" no tiene definición — Claude va a inventar qué considera mejor y probablemente no coincida con vos.
Claude propone cambios, vos apretás "y" para aceptar sin mirar. Esto es el camino más rápido a romper algo en producción. Especialmente en archivos críticos: leé el diff. Si no entendés un cambio, preguntá:
> Por qué cambiaste esa función? Explicame el porqué.Claude Code no recuerda lo que pasó hace 2 sesiones. Si establecés una convención el lunes ("usamos siempre async/await, nunca .then"), el miércoles puede haberla olvidado. Las convenciones críticas van al CLAUDE.md, no al chat.
Cuando un archivo tiene >1000 líneas, Claude no lo lee todo cada vez (sería caro y lento). Usa estrategias como grep interno para encontrar lo relevante.
Esto significa: si pedís "explicame este archivo", para archivos grandes va a hacer lectura parcial. Si necesitás que mire algo específico, apuntale:
> Mirá la función validateOrder en src/orders/validate.ts:120 — qué hace si el carrito está vacío?Con archivo:línea, Claude va directo al lugar. Más rápido y más preciso.
--debug cuando algo no anda#Si Claude se comporta raro (no encuentra archivos, no aplica hooks, las skills no se activan):
claude --debugTe muestra:
Es como abrir el devtools del navegador — feo pero la única forma de entender qué está pasando adentro.
Claude Code te deja elegir entre los modelos disponibles. La regla práctica:
Cambiás con /model opus. No uses Opus para todo — es caro y para tareas chicas no se nota la diferencia.
Para Opus existe el "fast mode" que da output más rápido sin bajar a un modelo más chico. Útil cuando estás en un loop apretado de iteración. Se activa con /fast.
Claude Code respeta tu workflow de git. Cosas que conviene saber:
.gitignore para no tocar archivos generadosSi querés que sea más autónomo en git (commits automáticos después de tareas), eso se configura con hooks.
mañana:
claude (abro sesión en mi proyecto)
> /resume "feature de notificaciones" (retomo lo de ayer)
... trabajo 2-3 horas ...
> /clear
mediodía:
> /init src/lib/payments/ (genero contexto para un módulo nuevo)
... trabajo en algo distinto ...
> /clear
tarde:
/model opus
> Necesito repensar la arquitectura de jobs background. Empezá leyendo src/jobs/ y proponé 3 opciones.
... discusión de diseño ...Patrón: contexto fresco para cada bloque de trabajo, modelo grande solo cuando lo necesitás, archivos específicos como puntos de entrada.
Cuando ya manejás lo básico, los siguientes 3 recursos son los que más jugo te van a sacar: