Claude Code en Proyectos Reales: Imagenes, Checkpoints, Git y Modo Autonomo

Soporte multimodal: una imagen vale mas que mil palabras

A veces describir un problema con texto lleva mucho mas tiempo que simplemente ensenarselo. Claude Code puede procesar imagenes directamente en la terminal.

Como pegar una imagen

Arrastra la imagen directamente a la terminal
En Mac: usa Cmd + V para pegar una captura de pantalla
En Windows: usa Ctrl + V

Cuando usar imagenes

Bugs visuales: haz una captura del error en tu web o aplicacion, pegala y Claude lo arregla
Replicar disenos: quieres que tu app se parezca a una web existente, haz una foto y pegasela
Errores en consola: captura el error y deja que Claude lo interprete

Las imagenes ocupan bastante contexto, pero para bugs visuales y disenos es un atajo enorme. Es mucho mas rapido enviar una imagen que describir pixel a pixel lo que esta mal.

Checkpoints: tu red de seguridad

Claude Code no siempre acierta. Cuando trabaja de forma autonoma puede hacer cambios drasticos en muy poco tiempo, y si toma un camino equivocado, necesitas poder volver atras.

Claude Code crea automaticamente checkpoints (capturas del estado de tu codigo) antes de cada edicion. No tienes que activar nada, ocurre en segundo plano.

Como acceder a los checkpoints

Escribe /review en la terminal. Aparecera una lista de todos los prompts de tu sesion, con los que tuvieron cambios en el codigo marcados.

Que puedes restaurar

Solo el codigo: restaura los archivos al estado anterior
Solo la conversacion: restaura el historial del chat
Ambos: restauracion completa

Cuando usar checkpoints

Claude ha tomado una decision de arquitectura incorrecta
Ha eliminado codigo que necesitabas
Ha hecho una refactorizacion que empeora las cosas
Quieres explorar una alternativa diferente

Los checkpoints de Claude Code son para dentro de la sesion activa. Para un historial entre sesiones, necesitas Git.

Integracion con Git y GitHub

Cuando Claude Code hace cambios en tu proyecto necesitas saber que cambio, cuando y por que. Git es el sistema de control de versiones que te permite hacer exactamente eso.

Que puedes hacer con Git desde Claude Code

Rastrear todos los cambios en el tiempo
Revisar que hizo Claude antes de hacer un merge
Revertir ediciones especificas
Trabajar en equipo sin sobrescribir el trabajo de otra persona

Operaciones de Git que conviene preaprobar

Comando	Funcion
`git diff`	Ver que ha cambiado
`git add`	Anadir al staging
`git commit`	Hacer el commit
`git status`	Ver el estado del repositorio

Conectar tu proyecto con GitHub

Si el proyecto aun no tiene repositorio, usa git init. Si ya existe uno, conectalo con git remote add origin URL. O simplemente dile a Claude:

“Conecta este proyecto a GitHub”

Claude gestiona la mayoria de operaciones de Git por ti. Lo importante es tenerlo conectado desde el principio del proyecto, no al final.

Modo CLI: Claude Code en piloto automatico

Normalmente Claude Code es interactivo: el propone algo, tu apruebas, escribes, responde. Es un ida y vuelta constante. Pero si quieres que Claude trabaje completamente solo, sin ninguna intervencion humana, puedes usar el modo CLI.

Como activarlo

Sal de Claude Code y escribe:

claude -p "tu tarea aqui"

Claude ejecutara la tarea de principio a fin sin conversacion, sin confirmaciones, sin esperar tu input.

Ejemplos practicos

claude -p "revisa todos los archivos TypeScript y corrige los errores de tipos"

claude -p "genera tests unitarios para todas las funciones"

claude -p "refactoriza las rutas de la API para seguir convenciones REST"

El flag -p convierte a Claude Code de una herramienta conversacional a algo que simplemente se ejecuta y devuelve el resultado.

El bucle Ralph: modo CLI en esteroides

Si quieres llevar el modo CLI al siguiente nivel, existe el bucle Ralph (nombrado en honor a Ralph Wiggum de Los Simpson).

La diferencia con el modo CLI normal es que con el bucle Ralph, Claude ejecuta la tarea, lee el nuevo estado de los archivos, determina que le queda por hacer y repite hasta completar todo. Es un bucle continuo.

Por que es mas potente

En el modo CLI normal, Claude ejecuta una vez y se detiene. Con el bucle Ralph, Claude itera sobre si mismo: a medida que los archivos se construyen, introduce el nuevo contexto y trabaja hasta que la tarea esta terminada del todo.

Cuando usarlo

Lanzar un proyecto entero de la noche a la manana
Builds largos que requieren multiples iteraciones
Tareas que no se completan en una sola pasada

Para instalarlo, busca el plugin oficial “Ralph Loop” en el repositorio de Claude Code en GitHub.

Worktrees: trabajar en varias cosas a la vez

Cuando trabajas en un proyecto grande, normalmente necesitas trabajar en varias funcionalidades sin que interfieran entre si. Los worktrees crean directorios de trabajo separados, cada uno con sus propios archivos y su propia rama, pero compartiendo el mismo historial del repositorio.

Como crear un worktree

claude --worktree feature-nombre

Esto crea un directorio y una rama separada.

Ejemplo practico

Puedes tener tres terminales diferentes, cada una trabajando en una parte distinta del proyecto:

Terminal 1: claude --worktree configuracion para trabajar en la configuracion
Terminal 2: claude --worktree login para el sistema de inicio de sesion
Terminal 3: claude --worktree integraciones para los servidores MCP

Las tres instancias de Claude Code trabajan de forma separada y en paralelo.

Integrar el trabajo

Cuando terminas, simplemente le dices a Claude que integre esa rama al proyecto principal. Claude gestiona la limpieza y la integracion por ti.

Para proyectos complejos y grandes, los worktrees cambian totalmente la velocidad y la precision con la que puedes construir.

Resumen: los 27 conceptos en un vistazo

Bloque	Conceptos
Fundamentos	Que es Claude Code, Terminal, Prompts, Permisos, Herramientas, Ventana de contexto, Historial, Tokens y coste
Configuracion	CLAUDE.md, Memoria automatica, Compactacion, Modelos, Deny list, Flags de lanzamiento
Avanzado	Pensamiento extendido, Slash commands, Skills, Hooks, Servidores MCP, Subagentes, Equipos de agentes
Mundo real	Imagenes, Checkpoints, Git/GitHub, Modo CLI, Bucle Ralph, Worktrees

Dominar estos conceptos te da una base solida para usar Claude Code como herramienta profesional, ya sea para tu negocio, para tus clientes o para construir productos digitales desde cero.