12 consejos esenciales de Claude Code para máxima eficiencia (octubre 2026)

El mismo Claude Code da resultados completamente distintos según quién lo use.

Algunos agotan su límite de 5 horas en un instante, mientras que a otros les sobra tiempo.

--> La diferencia está en la configuración y los hábitos.

⭐️ Aquí tienes 12 consejos para usar bien Claude Code. ⭐️

Todos los comandos y prompts están incluidos para que puedas copiarlos y pegarlos directamente.

--> Es un poco largo para leerlo todo de una vez... ¿Qué tal si lo guardas en favoritos primero???

⚠️ Antes de empezar.. Revisa tu versión ⚠️

La mayoría de las funciones mencionadas en este artículo se lanzaron en los últimos meses. Si tu versión es antigua, los comandos no van a funcionar.

Revísalo con claude --version en la terminal y, si el número es bajo, solo ejecuta claude update.

Los comandos de este artículo están basados en la v2.1.302 al 18 de octubre.

1. Define esfuerzos distintos para cada subagente

El esfuerzo (effort) determina qué tan profundo piensa Claude antes de responder. Las opciones son low, medium, high, xhigh y max, aunque los niveles disponibles varían un poco según el modelo.

Mucha gente lo pone en Max o XHigh sin pensarlo, asumiendo que más alto siempre es mejor.

Pero eso no siempre es cierto.

Al construir la misma app para comparar, Max tardó 79 minutos, mientras que otros niveles tomaron 16 minutos.

Los resultados fueron casi idénticos. Solo estás gastando más tiempo y tokens.

Esto es lo que resumí desde mi experiencia:

--> (Clave) 🔥 Si sabes escribir prompts detallados, el resultado final suele ser parecido ya sea que uses low o max. 🔥

--> Para hacer lluvia de ideas, low o medium funcionaron mejor.

Sin embargo, los diseños difíciles, los bugs complicados y las revisiones importantes a veces necesitan un esfuerzo mayor.

La clave no es "usar siempre low".

Desde el 7 de octubre.. ¡Especifica el esfuerzo al llamar subagentes!

A partir de la actualización del 7 de octubre (v2.1.292), el Claude Code principal puede especificar el esfuerzo cuando llama a los subagentes.

Ahora puedes dar instrucciones así:

Divide la tarea actual en tres etapas y avanza con subagentes.

1. Búsqueda de ubicación de archivos y organización de datos con esfuerzo low

2. Revisión de pros y contras de la dirección de modificación con esfuerzo medium

3. Revisión de búsqueda de bugs en el código final con esfuerzo high

Muestra qué esfuerzo se le asignó realmente a cada subagente,

y devuelve solo las conclusiones y las rutas de los archivos de evidencia al agente principal.

Si te molesta escribirlo cada vez, guarda los agentes como archivos.

--> Por ejemplo, guárdalo como light-research.md en la carpeta .claude/agents/ del proyecto.

name: light-research

description: Investigación ligera solo para encontrar archivos relevantes y ubicaciones de evidencia

model: haiku

effort: low

¡Ambos métodos funcionan! Tanto especificarlo por llamada (como en el prompt de arriba) como fijarlo mediante un archivo.

2. Gestión de contexto y cómo evitar desperdiciar tokens

🤪 La razón por la que Claude Code de repente se vuelve tonto casi siempre es el contexto.

El contexto es el espacio de trabajo que Claude recuerda a la vez. Las conversaciones, los archivos leídos y los resultados de comandos se acumulan ahí.

--> Hoy en día, Claude Code tiene 1M (1 millón de tokens) de contexto por 'default'.

El problema es llenar ese 1M por completo.

Y esto no es solo cosa de Claude; es una limitación común de todos los LLMs, como Codex.

⭐️ Consejo: Configura autocompact entre 500~700k ⭐️

Por eso adelanto el umbral de compactación automática.

/autocompact 600k

Esto reduce el tamaño de ventana usado para la compactación automática a 600k tokens.

Antes de llenar 1M, Claude resume las conversaciones y libera espacio automáticamente.

(Para volver al valor por defecto, escribe `/autocompact auto`.)

⚠️ Segundo punto a cuidar: la expiración de la caché ⚠️

Si usas una sesión durante mucho tiempo, revisa esto sí o sí.

Claude Code reenvía toda la conversación anterior con cada solicitud. Es rápido y barato gracias a la caché: las partes ya procesadas no se recalculan.

Pero esta caché no es eterna.

• Suscripción Pro o Max (dentro del uso del plan): Caché de la conversación principal de 1 hora
• Clave API o créditos de uso adicionales: 5 minutos
• Subagentes: 5 minutos incluso con suscripción

Una vez vi ~852k uncached en mi pantalla. En ese estado, enviar una sola línea diciendo "continúa" obliga a reprocesar ~850k tokens sin caché. El consumo puede dispararse de golpe.

Casos comunes donde se rompe la caché:

1. Retomar una sesión enorme después de un descanso largo
2. Cambiar de modelo a mitad de sesión (la caché es independiente por modelo)
3. Modificar la configuración de herramientas MCP conectadas

Las soluciones son simples:

• Limpia antes de irte. Usa `/compact` mientras la caché siga viva, o empieza de cero con `/clear`.
• Actualiza a la última versión. Desde la v2.1.299, las conversaciones de más de 200k tokens se comprimen automáticamente tras ~54 minutos inactivas, antes de que expire la caché de 1 hora. Puedes desactivarlo en /config bajo Idle compaction).

**

3. Limpia directrices antiguas con /doctor prompt-audit

CLAUDE.md copiado de consejos viejos. Reglas agregadas una por una cada vez que me equivocaba.

La mayoría estaban escritas para modelos anteriores.

Los modelos nuevos siguen instrucciones mucho mejor que los viejos.

⚠️ Así que reglas que antes necesitaban énfasis como "¡Obligatorio!" o "¡Nunca!" ahora pueden estar actuando de más. ⚠️

También se acumularon reglas que chocan con el código actual o entre sí.

Ahora puedes revisarlo todo con un solo comando.

1/doctor prompt-audit

Función agregada en la actualización de finales de septiembre (v2.1.283).

¿Qué revisa?

1. CLAUDE.md y CLAUDE.local.md, AGENTS.md en las carpetas del proyecto y las superiores
2. ~/.claude/CLAUDE.md (mis directrices personales aplicadas a todos los proyectos)
3. Reglas, skills, comandos personalizados, definiciones de subagentes y estilos de salida dentro de .claude/

Reporta problemas, pero no sugiere correcciones para skills ni agentes de plugins.

Los criterios se basan en el modelo que estés usando. Detecta patrones de prompt obsoletos para ese modelo y crea un reporte con sugerencias de corrección.

(No lee archivos que puedan contener claves, como archivos de configuración o .mcp.json).

4. Arregla el entorno de trabajo cuando Claude repite errores

⛏️ Cuando la IA la vuelve a embarrar. Horas peleando con un mismo problema. ⛏️

Si estás corrigiendo lo mismo por tercera vez, no es culpa del modelo. Es culpa del entorno de trabajo.

Uso este método desde hace más de un año, desde Claude Sonnet 3.7. Explicado a grandes rasgos..

--> Haz que la IA analice la sesión donde falló y luego refleja las causas en las directrices del proyecto y en los métodos de verificación.

⭐️ ¡Hazlo así! "Analiza errores usando el Session ID" ⭐️

1. Escribe `/status` en la sesión donde se repitieron los errores para obtener el Session ID. Cópialo.

2. Abre una nueva sesión de Claude Code (Codex también sirve) y pega esto:

1"<Session ID>" → Encuentra los puntos donde esta sesión de Claude Code falló dos veces o más.
2
3Identifica cosas que señalé pero siguió haciendo mal, y los cuellos de botella.
4
5Categoriza por qué ocurrieron (suposiciones incorrectas, falta de contexto, estructura del código, ausencia de tests)
6
7y propón la corrección más pequeña posible solo para CLAUDE.md, .claude/rules, skills,
8hooks o tests para evitar que se repita.

3. Revisa las sugerencias y aplica solo las buenas.

4. Verifica la efectividad. Vuelve a intentar las solicitudes que antes fallaban y mira si ahora funcionan.

⚠️ No amontones todo en CLAUDE.md. ⚠️

¡Mientras más largo sea, más contexto consume y más chocan las reglas entre sí!

• Reglas de todo el proyecto en CLAUDE.md
• Reglas para carpetas/archivos específicos en .claude/rules/ o en el CLAUDE.md dentro de esa carpeta
• Procedimientos repetitivos como Skills
• Reglas absolutas mediante Hooks y permisos (Consejo #10)
• El mismo bug recurrente mediante tests de regresión

De vez en cuando limpia las reglas acumuladas con el Consejo #3 `/doctor prompt-audit`. El Consejo #4 construye, el Consejo #3 limpia.

**

5. Mantén la memoria de trabajo entre sesiones con Claude-Mem

Claude Code olvida las conversaciones cuando termina una sesión.

**"¿Por qué hicimos eso la vez pasada?"

"¿Cómo arreglamos aquel error?"**

Tienes que explicarlo todo de nuevo en cada sesión nueva.

El único plugin de Claude Code que he usado de forma constante durante un año resuelve esto.

--> claude-mem.

⭐️ Tiene más de 100k estrellas en GitHub. ⭐️

¿En qué se diferencia de la memoria básica?

Claude Code tiene Auto Memory básico. Esta es la diferencia:

El Auto Memory básico resume en notas el contenido que Claude considera importante y los aprendizajes del proyecto. Se ve con /memory, no hay que instalar nada.

claude-mem registra automáticamente qué tareas se hicieron en sesiones anteriores, cómo se resolvieron los errores y por qué se tomaron ciertas decisiones. Y recupera los registros necesarios en la siguiente sesión.

En mi pantalla llegó a mostrar hasta un 87% de ahorro de tokens.

La instalación es una sola línea en la terminal:

1npx claude-mem install

O instálalo como plugin dentro de Claude Code:

1/plugin marketplace add thedotmack/claude-mem
2/plugin install claude-mem

❌ No recomendado si ❌

1. Usas principalmente Codex
2. Ya tienes otro plugin de memoria o un sistema personalizado de traspaso

Agregar herramientas que se pisan aumenta la complejidad y el costo.

Si solo usas Claude Code, sigue siendo muy recomendable.

6. Ve modelo, esfuerzo, contexto y uso de un vistazo con Statusline

Mientras usas Claude Code, siempre te preguntas:

• ¿Esta sesión es Opus? ¿Sonnet? ¿Haiku?
• ¿Qué esfuerzo está configurado?
• ¿Qué tan lleno está el contexto?
• ¿Cuánto queda del límite de 5 horas y del semanal?

🔥 Statusline mantiene esto visible en la parte inferior de la terminal. 🔥

Crearla es fácil. Describe la forma que quieres después de `/statusline`, y Claude genera y aplica el script.

Mis 5 diseños compartidos

Antes compartí 5 prompts de statusline listos para copiar y pegar.

1. Minimal: Modelo, esfuerzo, proyecto y contexto en una sola línea

2. Pastel Blocks: Bloques resaltados en tonos pastel ideales para terminales oscuras

3. Nord Powerline: Límites de flechas suaves entre segmentos

4. Limit Dot Bar: Para Pro/Max. Uso de 5 horas y 7 días, y tiempo para reinicio como barras de puntos

5. Vivid Gauge: Insignia verde lima y medidor diagonal. Incluye el conteo de tokens de contexto

Los prompts completos están en las publicaciones originales. Copia, pega y Claude lo arma de inmediato.

1. Minimal: https://x.com/lucian__03/status/2103173295118098750

2. Pastel Blocks: https://x.com/lucian__03/status/2103173396075065594

3. Nord Powerline: https://x.com/lucian__03/status/2103173518573916178

4. Limit Dot Bar: https://x.com/lucian__03/status/2103173612832444536

5. Vivid Gauge: https://x.com/lucian__03/status/2103173754218258607

7. Haz que Claude ejecute y verifique resultados directamente

Claude dice "¡Implementación completa!" Pero al correrlo falla. Los botones no responden, la pantalla se rompe o no aparece nada.

Los tests pasan, pero la app falla más seguido de lo que uno cree.

Así que haz que Claude mismo lance e interactúe con la app. Existen comandos para esto:

• /run: Ejecuta de verdad la app del proyecto y la manipula para verificar los cambios.
• /verify: Compila y ejecuta la app para confirmar que la funcionalidad modificada funciona. No lo sustituye con tests o chequeos de tipos.
• /run-skill-generator: Guarda cómo ejecutar este proyecto (comandos, variables de entorno, pasos previos) como un skill. Haz esto primero en proyectos complejos.
• /verify guarda el método verificado como un skill del proyecto (.claude/skills/verify/) para reutilizarlo.

Flujo de uso:

1. Implementa la función, revisa primero tests y compilación

2. Corre la app con /run

3. Haz clic o ingresa datos si es web; usa entradas y salidas de ejemplo si es CLI

4. Vuelve a confirmar que se cumplió el objetivo con /verify

5. Corrige y vuelve a correr si falló. Conserva los resultados reales de comandos o capturas como evidencia

8. Separa la IA que programa de la IA que revisa

No ves tus propios errores de tipeo. Con la IA pasa lo mismo.

La sesión de programación está sesgada hacia "esto está bien".

⭐️ Por eso usa un revisor con contexto fresco. ⭐️

• /code-review: Encuentra bugs o problemas de precisión en código modificado, PRs, ramas o rutas.
• Define la intensidad como /code-review high (de low a max).

(Por defecto solo reporta; agrega --fix para corregir automáticamente.)

• /security-review: Revisa problemas de seguridad (auth, validación de entrada, exposición de información) en el diff entre la rama y la default remota.
• /simplify: Limpia duplicados, ineficiencias y complejidad. No sirve para buscar bugs (eso lo hace /code-review).

Orden recomendado:

1. Limpia el código con /simplify

2. Verifica la funcionalidad con /verify (Consejo #7)

3. Busca bugs con /code-review

4. Agrega /security-review si tocas login, pagos, claves API o datos personales

No hace falta correr los 4 cada vez.

⚠️ Para arreglos pequeños puede bastar solo con /code-review. ⚠️

Para una revisión más profunda, usa /code-review ultra (igual que /ultrareview).

(Revisión profunda en la nube; Pro/Max tienen 3 intentos gratis).

9. Define diseño y criterios de finalización antes de programar algo complejo

Para tareas complejas, dale a Claude primero el alcance y los criterios de finalización, no instrucciones largas de código.

Sin esto, Claude amplía el alcance como quiere.

⚠️ Modifica archivos innecesarios y hace trabajo que nadie pidió. ⚠️

Usando Plan Mode:

Presiona Shift+Tab para mostrar "plan mode on", o escribe /plan. Puedes agregar la tarea, como /plan fix login bug.

(Plan Mode solo lee archivos y planifica. Cambia el código después de tu aprobación).

Flujo: Explorar → Planificar → Aprobar → Implementar → Verificar.

Sáltate la planificación para corregir typos o cambios de una línea. Regla de la documentación oficial: si el cambio se describe en una oración, sáltate el plan.

10. Aplica reglas críticas automáticamente con Hooks

Aunque CLAUDE.md diga "No toques este archivo", a veces Claude lo toca.

🔥 CLAUDE.md orienta; los Hooks obligan. 🔥

Los 3 más usados:

• PreToolUse: Justo antes de editar un archivo o ejecutar un comando. Bloquea ediciones de archivos protegidos o comandos peligrosos.
• PostToolUse: Inmediatamente después de ejecutar. Formatea o aplica lint automáticamente a los archivos editados.
• Stop: Cuando Claude intenta terminar. Evita que pare si los tests están incompletos.

Ejemplo: bloquear ediciones de configuración de producción

Pídele a Claude que cree los hooks:

--> "Crea un hook PreToolUse que bloquee ediciones en config/production.env."

Buenos casos de uso:

• Ejecutar el formateador automáticamente al editar archivos de código (PostToolUse)
• Pedir confirmación antes de tocar carpetas críticas (PreToolUse)
• Bloquear la detención si no se corrieron los tests (Stop)
• Bloquear comandos peligrosos (PreToolUse + Bash)

11. Corre varias sesiones de Claude a la vez con Git Worktree

¿Qué pasa si dos ventanas de Claude trabajan en la misma carpeta?

🚫 Chocan al editar los mismos archivos. (Duele bastante..) 🚫

Worktree divide el repo en carpetas y ramas separadas por tarea.

Claude Code lo hace con un solo comando:

Corre esto en dos terminales:

• claude --worktree feature-auth
• claude --worktree feature-dashboard

La versión corta -w también sirve.

Crea .claude/worktrees/feature-auth/ y trabaja en la rama worktree-feature-auth.

--> ⭐️ Dos sesiones no tocan los archivos de la otra. ⭐️

Notas:

Los worktrees nuevos arrancan desde la rama default remota (main), no desde la rama actual.

Pasa el número de PR como claude --worktree "#1234" para arrancar desde el PR.

Te pregunta si conservar o borrar el trabajo sobrante al cerrar la sesión.

Precauciones:

1. Worktree aísla solo archivos y ramas. Una base de datos local, puertos, destinos de deploy o cuentas de API compartidas causarán conflictos.
2. Puede haber conflictos de merge si se editan los mismos archivos.
3. Define interfaces u ordena las tareas muy acopladas.
4. Cada sesión consume uso por separado. Paralelizar ≠ ahorrar tokens.

12. Repite la verificación hasta cumplir el objetivo con /goal

Claude se detiene tras un turno. Puede decir "casi arreglado" aunque haya 3 tests fallando.

• Goal mantiene a Claude trabajando hasta cumplir los criterios de finalización (desde la v2.1.139).
• /goal muestra el objetivo y estado actuales.
• /goal clear libera el objetivo y detiene el proceso.

Cómo funciona...

Después de cada turno, un modelo pequeño y rápido evalúa si se cumplieron las condiciones. Si no, Claude sigue con el siguiente turno.

Incluye el método de verificación en el objetivo (por ejemplo, "muestra el comando de test y los resultados"). El modelo juez necesita pruebas.

¿Cuál es la diferencia con /loop o el hook Stop?

--> Goal inicia el siguiente turno inmediatamente si falla. Se detiene cuando el juez confirma el éxito.

/loop repite la tarea a intervalos (por ejemplo, /loop 5m check deploy).

El hook Stop ejecuta un script personalizado para revisar condiciones al final del turno.

Combínalos para mejores resultados:

1. Define alcance y criterios con /plan (Consejo #9)

2. Divide tareas con claude -w (Consejo #11)

3. Formatea y bloquea mediante Hooks (Consejo #10)

4. Itera hasta cumplir los criterios con /goal (Consejo #12)

5. Confirma con /run y /verify (Consejo #7)

6. Revisa con contexto fresco mediante /code-review (Consejo #8)

Resumen

1. Varía el esfuerzo según la tarea. Delega a subagentes.

2. No llenes el contexto por completo. Vigila cuándo expira la caché.

3. Limpia el CLAUDE.md antiguo con /doctor prompt-audit.

4. Ante errores repetidos, arregla el entorno, no el modelo.

5. Memoria entre sesiones con claude-mem.

6. Monitorea modelo, esfuerzo, contexto y límites con statusline.

7. Verifica con /run y /verify, no confíes solo en que diga "listo".

8. Separa la IA que programa de la que revisa.

9. Planifica primero las tareas complejas.

10. Impón reglas críticas con Hooks.

11. Trabaja en paralelo con worktree.

12. Insiste hasta lograrlo con /goal.

Claude Code se actualiza rapidísimo. Compartiré nuevos consejos apenas aparezcan.

Guárdalo en favoritos si te sirvió y compártelo con amigos que usen Claude Code.

¡Gracias por leer!

Publicaciones anteriores referenciadas:

Esfuerzo de subagentes: https://x.com/lucian__03/status/2108194703782916166

Esfuerzo, Max no siempre es lo mejor: https://x.com/lucian__03/status/2104641991279874134

autocompact 500~700k: https://x.com/lucian__03/status/2108589402914177236

852k uncached y expiración de caché: https://x.com/lucian__03/status/2106396357527531800

/doctor prompt-audit: https://x.com/lucian__03/status/2104560017407869028

Automejora de la IA (actualización de Harness): https://x.com/lucian__03/status/2081761475560157477

claude-mem: https://x.com/lucian__03/status/2108997241864159442

5 diseños de statusline: https://x.com/lucian__03/status/2103173166973718537