$ man how-to/top-10-claude-code-tips

PATTERN

Antes de que Claude Code escriba una sola linea de codigo, entra en modo plan. Escribe /plan o pide a Claude que planifique el enfoque. Explora el codebase, identifica archivos afectados, considera casos extremos y presenta una estrategia de implementacion para tu aprobacion. Sin modo plan: Claude empieza a programar inmediatamente, se da cuenta a mitad de camino de que el enfoque no funciona, retrocede y produce resultados desordenados. Con modo plan: Claude pasa 30 segundos mapeando el problema, apruebas o ajustas el enfoque, luego ejecuta limpiamente. La inversion de 30 segundos ahorra 10 minutos de depuracion. La regla: cualquier tarea que toque 3 o mas archivos recibe modo plan. Sin excepciones.

PATTERN

Si haces algo mas de dos veces, deberia ser un skill. Un skill es un archivo Markdown en .claude/skills/ que define un flujo de trabajo paso a paso que Claude sigue cuando se activa. Ejemplos de skills que vale la pena construir: /deploy (build, test, commit, push, verificar), /morning (leer handoffs, revisar git status, mostrar prioridades), /draft-email (reunir contexto, escribir email, enviar a carpeta de borradores). Cada skill reemplaza 5-10 instrucciones manuales con un solo comando. Los skills se componen. Cada vez que el skill se ejecuta y notas un caso extremo, corrige el skill. Despues de 20 usos, maneja escenarios que nunca planificaste. Despues de 50 usos, se ejecuta impecablemente sin intervencion. La estructura del directorio de skills: .claude/skills/skill-name/SKILL.md. El archivo SKILL.md contiene la descripcion del disparador, las instrucciones paso a paso y cualquier contexto que el skill necesite.

PATTERN

Abre tres pestañas de terminal. Ejecuta Claude Code en cada una. Dale a cada sesion una tarea diferente. Acabas de triplicar tu rendimiento. Pestaña 1: Refactorizando la capa de API. Pestaña 2: Escribiendo tests para la nueva funcionalidad. Pestaña 3: Actualizando documentacion. Las tres se ejecutan concurrentemente en el mismo codebase. Cuidado con los conflictos: si dos sesiones editan el mismo archivo, la segunda escritura gana. Limita tus sesiones paralelas a diferentes directorios o modulos. Trabajo de API en una sesion, trabajo de UI en otra, documentacion en una tercera. Para maxima seguridad, usa git worktrees. Cada sesion obtiene su propia rama y directorio de trabajo. No son posibles los conflictos. Fusiona cuando termines.

PATTERN

Los subagentes no son solo para cambios de codigo paralelos. Son asistentes de investigacion. Cuando Claude Code necesita entender un modulo complejo antes de hacer cambios, crea un subagente Explore. "Antes de refactorizar, quiero entender el modulo de auth. Crea un agente explore para mapear todos los flujos de autenticacion, encontrar cada lugar donde se validan tokens e identificar cualquier secreto codificado." El subagente investiga el codigo, devuelve un resumen estructurado y la sesion principal toma decisiones con contexto completo. Esto mantiene la ventana de contexto principal limpia - la investigacion ocurre en el contexto del subagente, y solo el resumen regresa.

PATTERN

Los primeros cinco minutos de una sesion de programacion marcan el tono. En lugar de revisar el estado manualmente, construye un skill /morning que lo haga automaticamente. Un buen skill matutino: lee el context handoff de ayer, ejecuta git status, revisa PRs no fusionados, muestra las tres tareas prioritarias principales e imprime un resumen limpio. Abres Claude Code, escribes /morning y obtienes un resumen situacional completo. Este unico skill ahorra 10 minutos cada mañana y asegura que nunca empieces una sesion sin contexto. En un mes, eso son mas de 3 horas ahorradas solo en revision de estado.

PRO TIP

Las conversaciones de Claude Code consumen espacio de la ventana de contexto. Despues de 20-30 turnos, el contexto se llena y el rendimiento se degrada. El comando /compact resume la conversacion hasta el momento y libera espacio. El truco: usa /compact proactivamente, no reactivamente. Despues de completar un bloque importante de trabajo, compacta antes de empezar el siguiente bloque. Esto le da a Claude espacio fresco de contexto para la nueva tarea mientras preserva un resumen de lo que ya se hizo. No esperes hasta que Claude empiece a olvidar cosas o repetirse. Eso significa que el contexto ya esta saturado. Compacta temprano, compacta seguido.

PATTERN

Nunca cierres una sesion de Claude Code sin escribir un handoff. El handoff captura que se hizo, cual es el estado actual y que deberia pasar despues. La siguiente sesion lo lee y comienza con contexto completo. Automatiza esto con un skill o un hook. Un hook Stop puede pedirle a Claude que escriba un handoff antes de salir. Un skill /handoff puede generar un documento de handoff estructurado bajo demanda. El handoff es el puente entre sesiones. Sin el, cada sesion empieza desde cero. Con el, las sesiones se construyen una sobre otra. Despues de una semana de handoffs, Claude conoce tu proyecto tan bien como tu.

PATTERN

Los hooks de mayor valor no son formateadores ni notificadores. Son puertas de seguridad. Un hook PreToolUse que bloquea git push --force ha prevenido perdida de datos mas de una vez. Un hook que escanea archivos editados en busca de claves API antes de que se escriban captura secretos antes de que lleguen al disco. Un hook que previene ediciones en archivos de migracion evita romper la base de datos. Los hooks de seguridad se configuran una vez y te protegen para siempre. Los 30 minutos para configurarlos ahorran horas de respuesta a crisis.

ANTI-PATTERN

Un CLAUDE.md de 500 lineas es peor que uno de 100 lineas. Consume espacio de contexto que Claude necesita para codigo real. Entierra instrucciones importantes bajo muros de detalle. La adherencia del modelo a las instrucciones baja a medida que el archivo crece. La solucion: mantén CLAUDE.md liviano. Usa @imports para documentos detallados. Apunta a archivos en lugar de copiar contenido. Elimina cualquier instruccion que Claude ya siga por defecto. Cada linea en CLAUDE.md debe ganarse su lugar. Si Claude haria lo correcto sin la instruccion, elimina la instruccion. Solo incluye reglas que anulan los valores por defecto o refuerzan convenciones especificas del proyecto.

PRO TIP

Cada vez que Claude Code comete un error y lo corriges, agrega la leccion a un archivo. Yo uso tasks/lessons.md. El CLAUDE.md le dice a Claude que lea este archivo al inicio de sesion. Formato: fecha, contexto, regla. "2026-03-01: MCP create_note hace doble escape de saltos de linea. Regla: Nunca uses MCP create_note para contenido multi-linea. Usa la REST API directamente." Con el tiempo, este archivo se convierte en una base de conocimiento personalizada de problemas especificos del proyecto. Claude lo lee, evita los mismos errores y tu tasa de error baja a casi cero. El archivo de lecciones es el camino mas rapido hacia una instancia de Claude Code que se siente como si tuviera meses de experiencia en tu proyecto. La meta-leccion: los agentes de AI no aprenden entre sesiones a menos que construyas el mecanismo. El archivo de lecciones es ese mecanismo.