Trucos avanzados de Claude Code

Reanudar y continuar una sesión

Cada sesión de Claude Code almacena un transcript de la conversación (el historial completo de intercambios) de forma local. Cuando cierras el terminal o pierdes la conexión, ese contexto no desaparece. Dos opciones te permiten recuperarlo.

--continue reabre automáticamente la sesión más reciente. No necesitas recordar ningún identificador. Ejecuta claude --continue desde la misma carpeta del proyecto y Claude Code recarga la última conversación para que puedas continuar donde lo dejaste.

--resume te da la opción de elegir. Lista tus sesiones recientes con marcas de tiempo y resúmenes breves, para que puedas seleccionar la correcta cuando hayas estado alternando entre varias tareas. Pasa un identificador de sesión directamente para omitir la lista: claude --resume <session-id>.

• Usa --continue para el caso sencillo: una sola tarea activa, apenas interrumpida.
• Usa --resume cuando necesites volver a una sesión más antigua o específica.
• El contexto recargado de esta forma cuenta dentro de tu ventana de contexto activa (el límite de tokens por conversación), por lo que sesiones antiguas muy largas pueden recortarse.
• Ambas opciones funcionan en el CLI interactivo, la extensión de VS Code y el plugin de JetBrains.

Rewind: revertir cambios de forma segura

Claude Code crea un punto de control (una instantánea guardada de su conversación y del estado de sus archivos) cada vez que envía un mensaje. Si una edición sale mal, puede volver a cualquier punto de control anterior sin perder el historial de su proyecto.

El comando /rewind abre el selector de puntos de control. Puede desplazarse por los turnos anteriores, elegir al que desea regresar, y Claude Code restaura tanto el contexto de la conversación como los archivos en disco a ese momento exacto. La operación es no destructiva: los turnos descartados se eliminan de la sesión activa, pero su historial de git (si tiene uno) permanece intacto.

Razones habituales para usar rewind:

• Claude introdujo un error que no puede deshacer fácilmente con una sola edición.
• Aprobó una refactorización grande y luego cambió de opinión.
• Quiere probar dos enfoques distintos desde el mismo punto de partida (experimentación segura).
• La conversación se desvió del tema y el contexto anterior daba mejores resultados.

La experimentación segura es el verdadero poder aquí: revierte a un punto de control limpio, pruebe el enfoque A, anote el resultado, revierte de nuevo, pruebe el enfoque B y quede con el ganador. No se necesitan archivos de copia de seguridad manuales.

Pegar imágenes y capturas de pantalla

Claude Code acepta imágenes directamente en el campo de entrada del chat. Puede arrastrar y soltar un archivo sobre la ventana del terminal, pegar desde el portapapeles con Ctrl+V (o Cmd+V en Mac), o indicar la ruta del archivo. La imagen se codifica y se envía junto con el texto del mensaje en la misma solicitud.

Esta funcionalidad está disponible en las tres superficies: el CLI (terminal), la extensión de IDE (VS Code, JetBrains) y la interfaz web de claude.ai usada con proyectos Claude Code. En el CLI, arrastrar un archivo a la ventana del terminal inserta su ruta, y Claude Code la resuelve y la sube automáticamente.

Casos de uso habituales para imágenes en una sesión de código:

• Capturas de errores: pegue un error de consola del navegador o un estado roto de la interfaz y pida a Claude Code que lo diagnostique.
• Referencias de diseño: suelte un export de Figma o una maqueta y solicite el HTML/CSS correspondiente.
• Diálogos de error: capture un diálogo de fallo o un panel de registros difícil de copiar como texto.
• Diagramas de arquitectura: comparta una foto de pizarra y pida a Claude Code que genere la estructura descrita.

La capacidad de visión (entender el contenido de las imágenes) está disponible en claude-opus-4-8 y claude-sonnet-4-6. Haiku (claude-haiku-4-5) también admite imágenes, pero con menor profundidad de razonamiento. Para análisis de interfaces complejas o diagramas detallados, prefiera Sonnet u Opus.

Referencia archivos rápidamente

Claude Code le ofrece tres formas rápidas de incorporar un archivo en su prompt sin necesidad de escribir una ruta completa. Dominarlas reduce la fricción al referenciar código, configuraciones o documentos durante una conversación.

El arrastrar y soltar funciona en cualquier terminal que lo soporte: arrastre un archivo desde su explorador de archivos hasta el prompt de Claude Code y la ruta absoluta se pega al instante. Sin escritura, sin errores.

La mención @ (escriba @ seguido de un nombre de archivo o una ruta parcial) abre un selector de archivos integrado. Claude Code busca en su proyecto y le permite seleccionar el archivo. La ruta resuelta se inserta en el prompt y el contenido del archivo se adjunta como contexto para Claude.

Tres formas de referenciar archivos rápidamente:

• Arrastrar y soltar: arrastre un archivo desde el explorador de archivos del sistema operativo hasta el prompt del terminal.
• Mención @: escriba @nombrearchivo y elija de la lista de autocompletado.
• Completado con Tab: escriba una ruta parcial y presione Tab para completarla, igual que en un comando de shell normal. Funciona con /read, /edit y referencias de archivos directas en su mensaje.

Ejecutar un comando en línea con !

En el shell interactivo de Claude Code (el REPL que se obtiene al escribir claude sin argumentos), puede anteponer ! a cualquier comando de shell para ejecutarlo e inyectar su salida directamente en el contexto de su conversación. El contexto es la memoria de trabajo que Claude lee antes de responder.

Esto es importante porque Claude no puede ver su sistema de archivos ni el historial del terminal por sí mismo. El prefijo ! es la forma más rápida de entregarle a Claude datos reales y actuales sin necesidad de copiar y pegar.

Usos habituales del prefijo !:

• !git log --oneline -10 muestra los últimos diez commits para que Claude pueda razonar sobre el historial.
• !cat package.json permite a Claude leer un archivo de configuración sin que usted tenga que abrirlo por separado.
• !npm test 2>&1 canaliza la salida de las pruebas (incluidos los errores) al contexto para que Claude pueda diagnosticar fallos de inmediato.
• !ls src/ proporciona a Claude un listado del directorio que puede usar como referencia al sugerir ediciones de archivos.

La salida aparece en el turno de conversación, visible tanto para usted como para Claude. Si el comando produce muchas líneas, Claude las ve todas, pero las salidas muy largas pueden consumir una parte significativa de su ventana de contexto (el presupuesto total de tokens de una sesión).

Guardar un recuerdo con #

Claude Code puede recordar hechos, preferencias y reglas entre sesiones. La forma más rápida de escribir un recuerdo es comenzar el mensaje con #. Ese único carácter le indica a Claude Code que guarde lo que sigue, en lugar de tratarlo como una instrucción ordinaria.

Cuando escribes algo como # always use TypeScript strict mode, Claude Code decide dónde almacenarlo: ya sea en CLAUDE.md (un archivo de texto plano en tu carpeta de proyecto o carpeta personal que actúa como hoja de instrucciones persistente) o en su almacén de memoria interno. No tienes que elegir manualmente; Claude Code selecciona la ubicación correcta según si el dato es específico del proyecto o general.

Cosas habituales que vale la pena fijar con #:

• Reglas de estilo de código (convenciones de nombres, configuración del formateador)
• Contexto específico del proyecto (stack, estructura de carpetas, peculiaridades del entorno)
• Preferencias personales (idioma, tono, sin guion largo, sin emoji)
• Comandos o scripts recurrentes cuyas opciones siempre olvidas

Puedes revisar lo que se ha guardado abriendo CLAUDE.md en tu editor o preguntándole a Claude Code: what do you remember about this project?. Los recuerdos escritos en CLAUDE.md son texto plano y totalmente editables, por lo que puedes limpiar, reordenar o eliminar entradas en cualquier momento.

Interrumpir y redirigir

Cuando Claude Code está en ejecución, presionar Esc envía una interrupción suave. Claude termina su paso atómico actual, luego se detiene y espera tu próxima instrucción. No pierdes el contexto de la sesión, las ediciones de archivos ya escritas ni el historial de la conversación.

Esto es diferente de Ctrl+C, que mata el proceso por completo y te obliga a reiniciar. Esc es la herramienta quirúrgica: úsala cuando Claude va en la dirección equivocada pero quieres corregir el rumbo, no reiniciar.

Después de la interrupción, puedes:

• Escribir una corrección y presionar Enter para redirigir a Claude hacia el enfoque correcto.
• Pedirle a Claude que deshaga el último conjunto de cambios en archivos con /undo antes de dar nuevas instrucciones.
• Pegar contexto adicional (un mensaje de error, una ruta de archivo, una restricción que olvidaste) para que Claude pueda continuar con mejor información.
• Escribir /clear si la conversación se ha desviado demasiado y quieres empezar con una pizarra en blanco mientras permaneces en la misma sesión.

La regla práctica: interrumpe temprano. Si ves que Claude toma una decisión arquitectónica incorrecta en la primera llamada de herramienta, presiona Esc de inmediato. Dejar que continúe cinco pasos más antes de interrumpir significa más deshacimientos.

Palabras clave de razonamiento

Claude Code le permite ajustar la intensidad del razonamiento del modelo antes de que responda. Tres palabras clave en inglés sencillo controlan este comportamiento: think, think hard y ultrathink. Basta con incluir una de ellas en su indicación y Claude Code activa un proceso de razonamiento interno extendido (a veces llamado "presupuesto de reflexión") antes de redactar su respuesta.

El equilibrio es sencillo: más reflexión significa mejores respuestas en problemas difíciles, pero también más tokens consumidos y mayor tiempo de espera. Los tokens son los fragmentos que el modelo lee y escribe; cada paso de razonamiento adicional cuesta tokens, lo que cuesta tiempo y, si usa un plan de pago, dinero.

Cuándo usar cada nivel:

• think: razonamiento adicional ligero, útil para preguntas moderadamente complicadas donde la respuesta predeterminada parece superficial.
• think hard: paso más profundo, útil para decisiones de arquitectura, bugs complejos o planes de varios pasos.
• ultrathink: presupuesto máximo, reservado para los problemas más difíciles (refactorizaciones complejas, problemas de seguridad sutiles). Notablemente más lento.

Estas palabras clave funcionan en cualquier contexto de Claude Code: la indicación del terminal, el chat integrado en su editor y la interfaz web. Puede combinarlas con otras instrucciones en una sola oración.

Crea tus propios comandos slash

Claude Code te permite definir comandos slash personalizados como simples archivos Markdown almacenados dentro de una carpeta .claude/commands/ en la raíz de tu proyecto. Cuando escribes /tu-comando en el indicador de Claude Code, este lee ese archivo y lo ejecuta como una instrucción.

El nombre del archivo se convierte en el nombre del comando. Un archivo llamado .claude/commands/review.md crea el comando /review. El contenido del archivo es el prompt que recibe Claude, por lo que lo redactas exactamente como redactarías cualquier prompt cuidadoso.

Los argumentos te permiten pasar valores dinámicos a un comando. Dentro del archivo Markdown, usa el marcador de posición $ARGUMENTS (todo en mayúsculas). Lo que escribas después del nombre del comando en el indicador se sustituye en lugar de ese marcador en tiempo de ejecución.

• Coloca los comandos a nivel de proyecto en .claude/commands/ (rastreados por git, compartidos con tu equipo).
• Coloca los comandos personales que aplican a todos los proyectos en ~/.claude/commands/ (tu directorio de inicio).
• Los argumentos son una sola cadena: /review src/auth.ts pasa src/auth.ts como $ARGUMENTS.
• Los comandos pueden ser tan largos y estructurados como necesites: listas de verificación, instrucciones paso a paso, reglas de formato de salida.

Gestionar extensiones

Claude Code expone tres gestores integrados que permiten inspeccionar y controlar sus puntos de extensión sin necesidad de editar archivos de configuración manualmente. Escribe /agents para listar todos los sub-agentes disponibles en el proyecto actual, /mcp para ver qué servidores MCP (servidores Model Context Protocol, herramientas externas que Claude Code puede invocar) están conectados y su estado, y /hooks para visualizar los comandos de shell que se disparan automáticamente antes o después de eventos clave como un commit o una parada.

Cada gestor es un panel en tiempo real, no un volcado estático de archivos. Desde /mcp puedes ver si un servidor está en ejecución, reiniciarlo o desconectarlo en el momento. Desde /hooks puedes revisar cada hook registrado (el nombre del evento, el comando y si se ejecuta en primer plano o en segundo plano) para saber exactamente qué automatización está vinculada a tu sesión.

La vista /agents es especialmente útil cuando trabajas en un proyecto que define sub-agentes personalizados (agentes con alcance a ese repositorio mediante .claude/agents/). Muestra tanto los agentes de nivel de proyecto como los globales, lo que permite detectar conflictos de nombres o entradas obsoletas antes de que provoquen un comportamiento inesperado.

• /agents: lista todos los sub-agentes (globales y con alcance de proyecto).
• /mcp: inspecciona, reinicia o desconecta servidores MCP en tiempo real.
• /hooks: audita cada hook de evento vinculado a la sesión actual.
• Los tres gestores reflejan el estado combinado de ~/.claude/settings.json global y del .claude/settings.json del proyecto.

Modo headless y pipelines

Por defecto, Claude Code abre una sesión interactiva en la que escribes tus consultas y lees las respuestas. El modo headless omite eso por completo: pasas tu instrucción directamente en la línea de comandos con el flag -p (abreviatura de --print), Claude responde una sola vez en stdout (la salida estándar, es decir, el flujo de texto del terminal) y el proceso termina. Sin menús, sin esperar entrada.

Esto convierte a Claude Code en una herramienta de estilo Unix que puedes integrar en pipelines de shell (cadenas de comandos donde la salida de un programa alimenta al siguiente) y scripts de automatización. El resultado se imprime como texto plano, por lo que cualquier programa que lea texto puede consumirlo: un archivo de log, otro comando o un paso de CI (una etapa en un sistema de integración continua que ejecuta verificaciones automáticas sobre tu código).

Usos comunes del modo headless:

• Resumir un archivo: cat report.txt | claude -p "Summarise this in three bullet points"
• Generar un mensaje de commit a partir de un diff: git diff | claude -p "Write a concise commit message"
• Procesar en lote muchos archivos en un script con bucle
• Redirigir la salida de Claude a otra herramienta: claude -p "List 5 test cases for a login form" | tee test-ideas.txt

Agrega --model para seleccionar un modelo específico, y --output-format json (o stream-json) cuando un script posterior necesite datos estructurados en lugar de texto. Mantén las instrucciones cortas y precisas: el modo headless no permite turnos de ida y vuelta para aclarar ambigüedades.

Sesiones paralelas con worktrees

Un Git worktree es un segundo (o tercero, o cuarto) checkout del mismo repositorio, cada uno viviendo en su propia carpeta y siguiendo su propia rama. Puede ejecutar una sesión de Claude Code separada dentro de cada worktree de forma simultánea, de modo que distintas tareas avancen en paralelo sin que ninguna sesión bloquee a otra.

Para crear un worktree, ejecute git worktree add <path> <branch> desde su repositorio principal. La ruta es una carpeta nueva; la rama puede ser nueva o existente. Abra esa carpeta en una nueva terminal y lance claude. Claude Code lee el directorio de trabajo automáticamente, por lo que cada sesión ve únicamente su propia rama.

Convenciones prácticas para gestionar de tres a cinco sesiones paralelas sin perder el control:

• Nombre la carpeta según la tarea, no según la rama: ../myapp-feat-auth en lugar de ../wt1. Lo agradecerá cuando esté manejando cinco terminales a la vez.
• Use un alias de shell para cambiar rápidamente: alias wt-auth="cd ~/myapp-feat-auth && claude".
• Una rama por worktree: nunca haga checkout de la misma rama en dos worktrees al mismo tiempo (Git lo impide por diseño).
• Limpie cuando termine: git worktree remove <path> y luego elimine la carpeta, para mantener git worktree list legible.

El flag CLI de Claude Code --resume le permite volver a conectarse a una conversación anterior mediante el ID de sesión. Combínelo con los worktrees: un worktree mantiene una sesión de refactorización de larga duración, otro ejecuta una sesión de corrección rápida de errores que puede reanudar cuando lo necesite.

Selección de modelo y modo rápido

Claude Code funciona con uno de tres modelos (el motor de IA subyacente): Opus (claude-opus-4-8), Sonnet (claude-sonnet-4-6) o Haiku (claude-haiku-4-5). Cada uno ofrece un equilibrio entre capacidad, velocidad y costo.

Cambie de modelo en cualquier momento con el comando /model. Escríbalo solo para ver el selector, o indique directamente un identificador de modelo:

• /model claude-opus-4-8 para el razonamiento más potente (arquitectura, bugs complejos, contexto largo).
• /model claude-sonnet-4-6 para el punto intermedio ideal en el día a día: buena calidad con menor latencia.
• /model claude-haiku-4-5 para tareas rápidas y económicas: renombrar archivos, resúmenes cortos, ediciones simples.

El comando /fast es un interruptor de sesión. Le indica a Claude Code que priorice la velocidad sobre la profundidad durante el resto de la conversación, lo cual es útil cuando está iterando rápidamente y prefiere respuestas ágiles en lugar de un razonamiento extenso. Escriba /fast de nuevo para desactivarlo.