# 25 trucos de Claude Code que la documentación no te cuenta | Alher Tech

> Atajos no documentados de Claude Code, trucos de gestión de sesiones y patrones de prompting que ahorran horas a ingenieros senior en trabajo SaaS B2B real.

- Canonical page: https://alhertech.com/es/claude-code/trucos/
- Site: Alher Tech (custom software, AI agents and SEO engineering, https://alhertech.com/)
- Contact: https://alhertech.com/es/contacto/

---

Atajos, comportamientos no documentados y pequeños hábitos que se acumulan en horas ahorradas cada semana. Cada truco ha dado valor en al menos un proyecto SaaS B2B en vivo.

Actualizado: 22 de julio de 2026

## Gestión de sesiones

Usa `claude --resume` para continuar la sesión de ayer con transcripción completa. Usa `claude --continue <id>` para bifurcar desde cualquier punto. Fija el id de sesión en el título del terminal para contexto rápido.

## Prompting

Prefija cualquier tarea con los criterios de aceptación. Termina el prompt con "si hay duda, pregunta antes de editar". Estos dos hábitos elevan el éxito al primer intento de ~60% a ~85% en nuestros proyectos.

## Debugging

Cuando el agente entra en loop, vuelca los últimos 20 turnos con `/export` y pásalos a una sesión nueva. Un contexto fresco suele ver lo que el atascado no veía.

## Disciplina con CLAUDE.md

Trata CLAUDE.md como un contrato, no como una wiki: comandos de build, convenciones de nombres, patrones prohibidos y el porqué de cada regla en una línea. Mantenlo por debajo de ~300 líneas y borra lo que el código ya explica. Cuando el agente repite un error, el arreglo es una línea nueva en CLAUDE.md, no un prompt más largo la próxima vez.

## Modo plan antes de cambios grandes

Para refactors o features que tocan más de un par de archivos, pulsa Shift+Tab para entrar en modo plan: el agente explora y propone un plan que apruebas antes de editar nada. Rechazar un mal plan cuesta segundos; rechazar un mal diff cuesta un ciclo de review. Aprueba planes, no sorpresas.

## Gestión del contexto

Las sesiones largas se degradan: usa /compact en puntos de control naturales para resumir el historial y liberar ventana, y /clear al cambiar a una tarea sin relación. Delega la exploración amplia del repo en subagentes para que la sesión principal reciba conclusiones y no volcados de archivos. Una tarea por sesión gana a una sesión gigante para todo.

## Hooks que imponen calidad

Los hooks PostToolUse ejecutan tu linter y tests tras cada edición, así el agente arregla lo que rompe antes de que tú lo veas. Los PreToolUse pueden bloquear comandos peligrosos (rm -rf, git push) por política y no por fe. Diez minutos configurando hooks en settings.json ahorran para siempre el ritual diario de "pásame el lint".

## Servidores MCP y skills

Conecta las herramientas que ya usas (Search Console, bases de datos, navegadores, tickets) mediante servidores MCP y el agente las maneja directamente. Los flujos repetibles van en una skill (un slash command con instrucciones): /deploy, /review-pr, /release-notes. Si tecleas la misma instrucción de tres pasos dos veces por semana, debería ser una skill.

## Permisos sin fricción

Mete en la allowlist de settings.json los comandos de solo lectura que apruebas a diario (git status, npm test, grep) para que solo salten prompts en acciones que importan. Nunca apruebes en bloque escrituras fuera del repo. El objetivo: cero prompts en operaciones seguras y una pausa deliberada en las irreversibles.

## Headless y CI

claude -p "prompt" ejecuta en un solo disparo sin interfaz interactiva: perfecto para cron jobs, generación de mensajes de commit o informes nocturnos de dependencias. En CI, combínalo con una allowlist estricta y un token de solo lectura. El mismo agente que programa contigo de día puede hacer trabajo de mantenimiento de noche.

## Preguntas frecuentes

### ¿El mayor boost de productividad?

Un CLAUDE.md disciplinado más hooks PostToolUse para lint y tests. Lo demás son pequeñas ganancias incrementales.

### ¿Cómo evito que Claude Code toque archivos que no debe?

Tres capas: dilo en CLAUDE.md (el agente lo lee en cada sesión), deniega las rutas en los permisos de settings.json y añade un hook PreToolUse como freno duro. La política gana a la vigilancia.

### ¿Merece la pena Claude Code para un desarrollador solo?

Es donde más se nota: un senior solo con Claude Code cubre la mitad mecánica de un equipo pequeño. Los hábitos de arriba (CLAUDE.md, hooks, modo plan) son la diferencia entre ganar un 2x y un 10x.