Consejos Prácticos
10 consejos accionables derivados de leer el código fuente de Claude Code. No son suposiciones: reflejan decisiones arquitectónicas deliberadas que dan forma al comportamiento de la herramienta.
Usa CLAUDE.md: da forma a todo
#01CLAUDE.md es lo primero que se carga en el contexto y guía todo el comportamiento de Claude. Colócalo en la raíz del repositorio. Cada regla, convención o contexto que escribas ahí se aplica automáticamente en cada sesión.
Sección 1: System PromptEl sistema de memoria persiste entre sesiones
#02Claude guarda cosas entre sesiones en ~/.claude/projects/<slug>/memory/. Puedes pedirle que recuerde hechos, preferencias o decisiones y los recuperará en futuras conversaciones automáticamente.
Sección 4: Sistema de MemoriaLos agentes Explore usan Haiku: delégales las búsquedas
#03El agente Explore usa el modelo Haiku, más barato y rápido (no tu modelo principal). Para búsquedas simples en el código, pedirle a Claude que use el agente Explore ahorra tokens y dinero frente a que el modelo principal haga la misma búsqueda.
Sección 3: Sistema de Agentes/fast cuesta 6x mas para el mismo modelo
#04El modo fast no cambia a un modelo diferente. Usa el mismo Opus 4.6 pero con throughput prioritario. El coste sube de $5/Mtok a $30/Mtok de entrada, un recargo de 6x. Úsalo solo cuando la velocidad justifique realmente el precio.
Sección 7: CostesEl auto-compact se activa a ~13K tokens del límite
#05Cuando quedan unos 13.000 tokens antes del límite de contexto, Claude lanza automáticamente un agente para resumir la conversación. Puedes ejecutar /compact manualmente antes de llegar al límite para obtener una compresión más limpia y controlada.
Sección 6: Contexto y CompactaciónbypassPermissions omite TODAS las comprobaciones de seguridad
#06Este modo de permisos aprueba automáticamente cada llamada a herramienta, incluidas las destructivas como borrar archivos o hacer git force-push. Úsalo solo en entornos completamente aislados y de confianza donde hayas revisado lo que va a ejecutarse.
Sección 5: PermisosEl clasificador YOLO bloquea curl, wget y ssh en modo auto
#07En modo de permisos automático, un clasificador de IA de 2 etapas bloquea ciertos comandos considerados de alto riesgo: curl, wget, ssh, git, kubectl, aws y más. Si los necesitas en modo auto, debes aprobarlos manualmente o configurar reglas de allow explícitas.
Sección 5: PermisosMEMORY.md tiene un límite duro de 200 líneas
#08El archivo índice MEMORY.md siempre se carga en el contexto. Si supera las 200 líneas o 25KB, se trunca silenciosamente y las entradas de más simplemente desaparecen. Mantén el índice conciso y nunca escribas contenido de memoria directamente en él, solo punteros a archivos individuales.
Sección 4: Sistema de MemoriaPuedes definir agentes personalizados en archivos markdown
#09Los agentes personalizados se definen en archivos .md con frontmatter YAML que especifica herramientas, modelo y modo de permisos. Claude los carga automáticamente. Puedes crear agentes especializados con conjuntos de herramientas restringidos para tareas más seguras y enfocadas.
Sección 3: Sistema de AgentesEl Agente de Verificación siempre corre en segundo plano
#10El Agente de Verificación integrado se ejecuta tras las implementaciones y siempre emite un veredicto estructurado: PASS, FAIL o PARTIAL. Aparece en rojo en la terminal para destacar. Esto lo hace útil como puerta de calidad automatizada en flujos CI/CD.
Sección 3: Sistema de Agentes