Cómo Usar Claude Code Paso a Paso: De la Instalación a tu Primer Refactor con IA

Noticias Tech

Cómo Usar Claude Code Paso a Paso: De la Instalación a tu Primer Refactor con IA

EmaStack 6 min de lectura

Claude Code de Anthropic convierte tu terminal en un copiloto de programación con superpoderes. Esta guía paso a paso te lleva desde la instalación y autenticación hasta refactorizar código real y automatizar tareas complejas directamente desde tu CLI.

La era de copiar y pegar código desde un chat web a tu editor de texto está llegando a su fin. Claude Code de Anthropic vive donde tú vives como desarrollador: directamente en tu terminal. Sin extensiones de IDE complicadas, sin ventanas extra. Solo tu consola, tu repositorio y una Inteligencia Artificial que entiende tu proyecto completo.

Si nunca lo has usado o quieres dominar cada paso con detalle, esta guía te llevará de cero a productivo.

Paso 1: Requisitos Previos (Lo que Necesitas Antes de Empezar)

Antes de instalar Claude Code, asegúrate de tener lo siguiente listo en tu máquina:

Paso 2: Instalación Global

Abre tu terminal favorita (PowerShell, Terminal de macOS, o cualquier shell Linux) y ejecuta:

npm install -g @anthropic-ai/claude-code

Esto instala el CLI globalmente. Una vez completado, verifica que funciona:

claude --version

Si ves un número de versión, estás listo.

Paso 3: Autenticación (Conectar tu Cuenta)

La primera vez que ejecutes claude en tu terminal, el sistema te pedirá autenticarte. Tienes dos opciones:

Una vez autenticado, Claude recordará tu sesión y no volverá a pedirte credenciales.

Paso 4: Iniciar una Sesión Interactiva

Navega a la carpeta raíz de tu proyecto y simplemente escribe:

claude

Eso es todo. Claude abrirá un modo interactivo donde puedes escribir instrucciones en lenguaje natural directamente en tu terminal. Él escaneará automáticamente los archivos del proyecto para construir contexto.

Tip Vital: Hazle un "Onboarding" a Claude

Antes de pedirle tareas complejas, dale tú a él un contexto claro. Por ejemplo:

"Este proyecto es un SaaS de e-commerce hecho en React + Supabase.
El backend usa Edge Functions y la autenticación es con Supabase Auth.
Usamos Tailwind CSS para los estilos. No modifiques nunca los archivos de /vendor."

Esto calibra al modelo y reduce drásticamente las respuestas genéricas.

Paso 5: Tu Primer Comando Real — Explorar el Código

Empieza con algo seguro: pedirle que lea sin modificar:

"Explícame cómo funciona el flujo de autenticación en este proyecto.
Muéstrame los archivos involucrados."

Claude usará herramientas internas (equivalentes a grep, cat, etc.) para rastrear tu código fuente, encontrar los archivos relevantes y darte un resumen estructurado. Esto te confirma que entiende bien la arquitectura antes de hacer cambios.

Paso 6: Hacer Cambios en el Código (Con Red de Seguridad)

Ahora viene lo poderoso. Supongamos que necesitas refactorizar una función:

"Refactoriza la función 'calcularImpuesto' en src/utils/tax.js
para que use un patrón Strategy en vez de un switch gigante.
Mantén los tests existentes pasando."

Claude propondrá los cambios y te pedirá confirmación antes de escribir en tus archivos. Verás un diff claro (antes vs después). Si estás de acuerdo, apruebas con Y. Si no, rechazas con n y le das feedback para que ajuste.

Regla de oro: SIEMPRE haz un git commit antes de pedirle refactorizaciones grandes. Si algo sale mal, un simple git checkout . te devuelve al estado anterior.

Paso 7: Ejecutar Comandos del Sistema

Claude Code puede ejecutar comandos del sistema operativo por ti. Por ejemplo:

"Ejecuta npm run build y arregla cualquier error de compilación
que aparezca hasta que el build sea exitoso."

El agente correrá el comando, leerá el output de error, abrirá los archivos con problemas, los editará y volverá a ejecutar el build. Este ciclo se repite autónomamente hasta que triunfa o te pide ayuda humana. Es devastadoramente poderoso para solventar builds rotos.

Paso 8: Slash Commands Esenciales

Dentro de la sesión interactiva, estos comandos de barra te dan control total:

Comando Efecto
/help Muestra guía de todos los slash commands disponibles
/compact Comprime el contexto para ahorrar tokens y costos
/clear Borra la conversación entera y empieza con contexto limpio
/cost Muestra cuánto has gastado en tokens en la sesión actual
/doctor Diagnostica problemas de configuración del CLI

El comando /compact es vital cuando llevas muchas iteraciones y sientes que Claude empieza a "olvidar" decisiones previas. Comprime el historial manteniendo solo lo esencial.

Paso 9: Archivos de Configuración del Proyecto

Para no repetir siempre las mismas instrucciones (ej. "usa CSS modules, no Tailwind" o "escribe los comentarios en español"), puedes crear un archivo de configuración:

Crea un archivo llamado CLAUDE.md en la raíz de tu proyecto con las reglas del equipo:

# Reglas del Proyecto
- Idioma de comentarios: español
- Framework CSS: Vanilla CSS (no Tailwind)
- Testing: Vitest
- Nunca modificar archivos en /scripts/legacy/

Claude leerá este archivo automáticamente al iniciar sesión y respetará estas directrices sin que se las recuerdes cada vez.

Paso 10: Monitoreo de Costos y Buenas Prácticas

Claude Code usa créditos (tokens) de tu cuenta Anthropic. Cada archivo leído, cada respuesta generada, consume tokens. Para mantener tu factura bajo control:

¿Quieres Llevar la IA al Nivel Productivo de tu Empresa? 🚀

Dominar Claude Code en tu terminal es el primer escalón. Pero si lo que buscas es construir plataformas completas potenciadas por IA, orquestar agentes autónomos con n8n, o desarrollar arquitecturas web de alto rendimiento, en EmaStack llevamos la teoría a producción real.

🔥 Escríbenos hoy al WhatsApp +57 323 4611436 o déjanos tu proyecto en el formulario de contacto. Nosotros hacemos que la Inteligencia Artificial trabaje para ti, no al revés.