⌨️ Navegando el CLI como un pro

Dentro de la sesión interactiva de Claude Code, algunas teclas tienen un comportamiento especial que acelera drásticamente tu workflow. El secreto es que son pocas: cinco atajos cubren el 95% de la interacción. Conocer estas cinco teclas transforma la experiencia de «escribir y esperar» a «controlar el flujo con precisión». Es la diferencia entre conducir un auto automático y uno manual: en el automático quedas a merced de la IA; en el manual decides cuándo frenar, cuándo acelerar y cuándo retroceder.

El más importante de todos es el Escape: cancela la operación actual y te devuelve al prompt limpio. Cuando Claude está editando un archivo y notas que va por el camino equivocado, Escape detiene todo. Después viene el Tab para aceptar sugerencias del autocompletado, Ctrl+C para interrumpir una generación larga que ya dio lo que tenía que dar, Shift+Tab para rechazar una sugerencia, y Enter doble para enviar mensajes de varias líneas. Con estos cinco, puedes navegar por cualquier sesión.

Dentro de una sesión interactiva, escribe / al inicio del mensaje activa los slash commands. Controlan la sesión sin gastar tokens de conversación. Mientras que un mensaje normal se envía al modelo (y consume contexto), un slash command se ejecuta localmente: no cuesta nada, actúa de inmediato.

Los más usados forman un kit básico que todo usuario debería memorizar. /help enumera todo lo que está disponible. /clear reinicia el contexto de la conversación (útil cuando el contexto quedó contaminado). /compact comprime la conversación en un resumen más corto para liberar espacio. /model muestra o cambia el modelo. /memory guarda preferencias que persisten entre sesiones. /cost muestra cuánto gastaste en la sesión. Y /resume retoma una sesión anterior.

/help       — lista todos os comandos disponíveis
/clear      — limpa o contexto da conversa atual
/compact    — comprime o contexto para liberar espaço
/model      — ver ou trocar o modelo em uso
/memory     — salvar uma nota persistente
/resume     — retomar sessão anterior
/cost       — ver quanto gastou na sessão atual
/config     — abrir configurações

Claude Code usa modelos de la familia Claude de Anthropic. El predeterminado suele ser el Claude Sonnet (rápido y capaz para la mayoría de las tareas), pero puedes cambiar a Claude Opus (más profundo, mejor para el razonamiento complejo y los codebases grandes) en cualquier momento con /model o --model. Entender la diferencia entre ellos y saber cuándo cambiar es una habilidad que distingue a los usuarios eficientes de quienes desperdician dinero o tiempo.

A ventana de contexto es el límite de lo que el modelo ve al mismo tiempo: todo lo que dijiste, todo lo que leyó, todos los archivos inspeccionados y todas las respuestas generadas. La ventana de contexto de Claude es de aproximadamente 200k tokens (cerca de 150k palabras). Parece mucho, pero un codebase promedio consume eso rápido. Cada archivo leído, cada respuesta generada, cada CLAUDE.md cargado consume tokens de esta ventana. Cuando se acaba el espacio, Claude empieza a olvidar el inicio de la conversación.

Claude Code guarda las sesiones automáticamente en el disco local. Cada conversación tiene un session ID y queda guardada en ~/.claude/. Esto significa que cerrar la terminal, apagar la computadora o incluso cambiar de pestaña no hace que pierdas nada. La sesión sigue ahí, esperando que vuelvas.

Para retomar, tienes dos opciones: claude --resume en la línea de comandos (antes de abrir una sesión nueva) o /resume desde dentro de una sesión ya abierta. Ambos muestran un selector con las sesiones recientes para que elijas. También es posible retomar una sesión específica por su ID: claude --resume SESSION_ID.

En la práctica, el ritmo ideal es trabajar en una sesión durante 1-2 horas, hacer commits de los checkpoints en git y, cuando se llene el contexto, iniciar una sesión nueva. Si necesitas retomar algo del día anterior, --resume recupera. Pero recuerda: las sesiones muy largas degradan la calidad de las respuestas porque el contexto se llena. A veces es mejor empezar de cero y dejar que CLAUDE.md cargue el contexto esencial.

# retomar a última sessão
claude --resume

# dentro de uma sessão, retomar outra
/resume

# continuar conversa específica por ID
claude --resume SESSION_ID

# listar sessões recentes
claude --resume  (mostra picker interativo)

Claude Code es multimodal. Puede leer imágenes de tres formas: pegar desde el portapapeles (Ctrl+V con una captura copiada), hacer referencia a un archivo de imagen en el sistema de archivos (usando @path/to/image.png), o arrastrar y soltar en la terminal (en terminales compatibles). Esto abre un enorme abanico de casos de uso que no existen en los chatbots web tradicionales.

Los casos de uso más comunes son: depuración visual de UI (pega una captura de pantalla del bug, Claude identifica el problema en el CSS/HTML), reproducir un diseño a partir de un mockup (pega la exportación de Figma, pide que lo implemente), y leer diagramas de arquitectura (una foto de una pizarra se convierte en una descripción estructurada). También puedes pasar diagramas UML, gráficos de métricas o capturas de registros con formato.

Ten cuidado con el costo: las imágenes consumen tokens (y muchos). Una captura de pantalla completa puede usar entre 1000 y 2000 tokens. Si el problema se puede describir con texto, prefiere el texto. Reserva las imágenes para cuando la información visual sea realmente necesaria: diseños, colores, posicionamiento, gráficos, capturas de errores.

La integración con el ecosistema Unix es uno de los superpoderes más subestimados de Claude Code. Con claude -p, la salida va directamente a stdout, lo que permite encadenarla con cualquier herramienta Unix. Puedes recibir entrada mediante stdin (entrada por pipe), procesar con Claude y enviar la salida a otra herramienta o archivo. Esto hace que Claude Code sea componible: se convierte en un bloque más de tu cadena de herramientas.

El flag --output-format json hace que Claude devuelva la respuesta en JSON estructurado, lo que es perfecto para el procesamiento automatizado. Combínalo con jq para extraer campos específicos, o con scripts que consumen JSON. Para scripts más complejos, puedes usar --output-format stream-json para recibir tokens en tiempo real mientras el modelo genera.

# gerar JSON e processar com jq
claude -p "liste 5 tarefas em JSON" | jq '.[]'

# analisar um arquivo e salvar resultado
claude -p "revise este código" < app.py > review.md

# pipe de entrada: mandar conteúdo para análise
git diff | claude -p "resuma estas mudanças em 3 bullets"

# output em JSON estruturado
claude -p "..." --output-format json

# encadear múltiplas ferramentas
find . -name "*.ts" | head -20 | claude -p "quais desses arquivos são testes?"