Cargando la bóveda…
Cargando la bóveda…
Repo curado por Boris Cherny y Thariq (Anthropic) con 83 tips agrupados en 14 categorías. Cubre todo lo que se aprende en los primeros 6 meses de uso: prompts, CLAUDE.md, workflows, agentes, hooks. Cómo navegarlo sin perderte y los 10 tips de mayor ROI.
claude-code-best-practices es el repo curado por Boris Cherny (creador de Claude Code) y Thariq (Anthropic) con 83 tips agrupados en 14 categorías.
No es un blog post de tips genéricos — es el archivo de cosas que se aprenden en los primeros 6 meses de uso real, escrito por la gente que construyó la herramienta. Si arranca con Claude Code, este es el punto de referencia.
~50k+ estrellas en GitHub, MIT license. Actualizado regularmente.
83 tips es mucho. La trampa: leerlos todos linealmente, intentar implementarlos todos, te paralizás.
La forma correcta:
¿Tu problema concreto cuál es?
Empezás por el dolor más fuerte. Resuelto, vas al siguiente.
Lo que recomiendan los autores: pasale el repo a Claude y pedile recomendaciones:
> Leé este repo: https://github.com/anthropics/claude-code
Mi nivel: [principiante / intermedio / avanzado]
Mi caso de uso: [solo dev / equipo / consultor freelance / etc]
Lo que más me cuesta: [contexto / configurar permisos / hacer skills / etc]
Recomendame los 5 tips de MAYOR ROI para mí ahora.
Justificá cada uno con 1 línea.Claude te tira la lista priorizada para tu contexto específico. Mucho mejor que intentar leer los 83.
De los 83, estos son los que más mueven la aguja:
El 80% de la gente lo genera con /init y nunca lo edita. Editalo:
Ver detalle en guía completa de Claude Code.
/clear entre tareas distintas#Sesiones largas con muchos temas → contexto contaminado. Limpiá entre tarea y tarea.
{ "permissions": { "allow": ["Bash(npm:*)", "Bash(git log:*)", "Read", "Edit"] } }Te ahorra ~30 confirmaciones por sesión.
> Antes de codear, proponé el plan: qué archivos vas a tocar, en qué orden,
qué tests vas a actualizar. NO empieces hasta que apruebe.Reduce 4× las iteraciones.
[en CLAUDE.md]
Antes de declarar tarea completa:
- Releé el pedido original
- Corré los tests relevantes
- Listá lo entregado vs lo pedidoEsto solo previene el 70% de los "ah, pero faltaba esto".
Si hacés algo más de 3 veces por semana, hacé skill. Más detalle en guía de skills.
{
"hooks": {
"PostToolUse": [
{ "matcher": "Edit|Write", "hooks": [{ "type": "command", "command": "npx prettier --write \"$CLAUDE_FILE_PATHS\"" }] }
]
}
}Format on save permanente. Ver hooks de Claude Code.
Detalle en los 3 modelos.
❌ "Mirá este archivo"
✅ "Mirá la función validateOrder en src/orders/validate.ts:120 — qué hace si el carrito está vacío"
Con archivo:línea va directo al lugar. Más rápido y preciso.
NUNCA actives commits automáticos. Cada commit lo verificás vos. Branches por feature, no main directo. Convención de mensaje consistente.
Los autores destacan errores comunes:
Más NO es mejor. Cargás contexto innecesario. CLAUDE.md conciso (300-800 palabras) gana a uno gigante.
"Esta skill te ayuda con código" no sirve. Las skills útiles son específicas a tu contexto: tu producto, tu codebase, tus convenciones.
Si tu hook tiene || true al final para "que no rompa la sesión", podés estar ocultando errores reales. Mejor que falle visible que silencioso.
Default Opus = quemás cuota. Default Haiku = falla en cosas complejas. Default Sonnet, ajustás caso a caso.
El contexto se contamina. Output mediocre. Sesiones cortas con buen CLAUDE.md gana a sesiones eternas.
Si tenés que empezar mañana sin haber leído nada:
Día 1:
/init en tu proyectoSemana 1:
Mes 1:
Mes 2-3:
No leas los 83 tips el día 1. Es la receta para confundirte.
Los repos de "tips de productividad" son legión. Este destaca porque:
Si tu equipo va a usar Claude Code, considerá:
Mejor que armar tu propio "Notion con best practices" desde cero.
83 tips no se aplican de un día para el otro. 3 cada par de semanas durante 6 meses te da uso maduro de la herramienta.
Lo importante: tener este repo como referencia consultada cuando aparezca una fricción. No como contenido a "completar leyendo".