40 consejos de mejores prácticas para Claude Code

Resumen del documento best practices de Claude Code traducido en 40 consejos que puedes aplicar hoy mismo.

Fundamentos (si haces solo 5 de estos, ya mejoras muchísimo)

1. Clear Task Framing: Di exactamente qué quieres que Claude haga antes de cualquier otra cosa.
2. Front Load Instructions: La instrucción más importante va arriba del todo del prompt.
3. Dale a Claude una forma de verificar su trabajo: Incluye tests, screenshots o outputs esperados para que pueda auto‑comprobar. Es, probablemente, la palanca #1.
4. Consejo de estructura de prompt: Para hacer “aplicables” los anteriores, uso esta fórmula: [Rol] + [Tarea] + [Contexto]
5. Consejo para la extensión de Chrome: Cambios de UI se pueden verificar usando la extensión de Chrome de Claude: abre navegador, prueba la UI e itera hasta que el código funcione.
6. Explora → planifica → codifica: Investiga (puede incluir otros LLMs), entra en Plan Mode, y luego vuelve a modo normal para ejecutar.
7. Contexto específico: Cuanto más preciso seas, mejor. Claude no adivina: infiera lo mínimo.
8. Asume cero contexto: Trata tu proyecto como si Claude no supiera nada. Dile lo que necesita saber.
9. Enriquece el contexto: Usa @ para enlazar archivos, datos e imágenes.
10. Consejo de Claude.md: Ejecuta /init para generar un CLAUDE.md inicial para tu proyecto.

Proyectos & Skills (para dejar de repetirte y escalar tu flujo)

1. Project Instructions: Usa instrucciones a nivel de proyecto para comportamientos de largo plazo, sin repetir prompts.
2. Project Memory: Edita la pestaña “Memory” para controlar qué debe retener o ignorar con el tiempo (también en proyectos).
3. Claude Skills: Convierte flujos repetibles en Skills en vez de re‑promptear siempre.
4. Skill From Examples: Pega una salida excelente y pide convertirla en Skill reusable. Incluso con capturas: que la replique y la convierta en skill.
5. Skill Versioning: Duplica y versiona Skills al refinarlas en vez de editar “en vivo”.
6. Project Hygiene: Revisa archivos y reduce instrucciones con regularidad para evitar drift.
7. Project Context Bleed: Separa proyectos y evita contaminar contexto.
8. Project Memory (ruta): La memoria del proyecto puede estar en ./CLAUDE.md o en ./.claude/CLAUDE.md.

Mini consejos infravalorados (la mayoría no los usa… y son oro)

1. Model Stacking: Usa otros LLMs para planificar y generar mega‑prompts antes de abrir Claude Code (y ahorras tokens de Plan Mode).
2. Subagentes personalizados: Define asistentes especializados en .claude/agents/ para tareas aisladas delegables.
3. Output Scoring: Pídele que puntúe su respuesta contra criterios de éxito predefinidos.
4. Instala plug‑ins: Ejecuta /plugin para navegar el marketplace. Añaden skills, herramientas e integraciones sin configuración.
5. Claude Interviews: Para proyectos grandes, deja que Claude te entreviste primero: prompt mínimo + AskUserQuestion tool.
6. Corrige pronto (y a menudo): En cuanto se desvíe: para (ESC para detener a mitad de acción).
7. Clear: /clear para limpiar la sesión.
8. Rewind: Dos veces ESC o /rewind para abrir el menú de los puntos de comprobación.
9. Múltiples sesiones en paralelo: Dos enfoques típicos:
   • Claude Desktop: varias sesiones locales visuales, cada una con su worktree aislado.
   • Claude Web: sesiones en infraestructura cloud aislada en VMs seguras.

Depuración, errores y patrones típicos de fallo (lo que te salva proyectos)

1. Step Isolation: Re‑ejecuta solo el paso roto en vez de regenerarlo todo.
2. Error Reproduction: Pídele reproducir el fallo a propósito para entenderlo.
3. Rollback Prompts: Vuelve al último prompt “bueno” y reaplica cambios uno a uno.
4. CLAUDE.md sobre‑especificado: Si es larguísimo, Claude ignorará la mitad: las reglas se pierden en el ruido. Por lo que reduce el archivo sin piedad. Si ya lo hace bien sin esa regla, elimínala o conviértela en hook.
5. No mezcles tareas no relacionadas volviendo a la primera tarea pero con el contexto lleno de basura. Usando /clear entre tareas no relacionadas esto se soluciona..
6. Over‑Correcting: Claude se equivoca, corriges, vuelve a fallar, corriges… y el contexto se llena de intentos fallidos. Tras dos correcciones fallidas, /clear y escribe un prompt inicial mejor incorporando lo aprendido.
7. Step‑by‑Step Replay: Que explique cómo generó la respuesta, línea por línea.
8. Infinite exploration: Pides “investiga” sin acotar: lee cientos de archivos y revienta el contexto. Para esto hay que acotar la investigación o usar subagentes para no consumir el contexto principal.
9. Proyecto de debugging: Crea un proyecto de IA dedicado a depurar (ej: “X es bueno depurando”, etc.).
10. Gestión de ventana de contexto: El contexto se llena rápido y Claude empieza a olvidar instrucciones tempranas. Intenta reducir el uso de tokens.

Consejos finales (recursos y “atajos” para subir de nivel)

1. “Modo autónomo” con seguridad: Consejo importante: no te recomiendo saltarte checks de permisos en entornos reales. Si tu flujo requiere autonomía, hazlo con autorización, en sandbox y con salvaguardas (tests, hooks, revisiones, CI).
2. Slow & Steady: Ve despacio: para flujos importes: planifica, planifica, planifica… y luego ejecuta.
3. Hooks: Ideal para acciones que deben ocurrir siempre, sin excepciones (salvaguardas deterministas).

¿Quieres saber más sobre las soluciones de inteligencia artificial generativa de Microsoft? En DQS/ te asesoramos. ¿Por qué no nos preguntas cómo podemos ayudarte?

Información basada en la publicación Best Practices for Claude Code