Primeros pasos con Claude Code: instalación, Skills y modelos explicados

Guía paso a paso para instalar Claude Code, configurar tu entorno de trabajo con carpetas locales, entender los modelos disponibles (Opus, Sonnet, Haiku) y cuándo usar cada uno.

Si nunca usaste Claude Code, esta guía te lleva de cero a tener tu entorno configurado, tus primeras Skills creadas y una comprensión clara de qué modelo usar para cada tarea.

Paso 1: Instalación

Claude Code se instala como un paquete global de npm. Necesitás Node.js 18+ y una cuenta de Anthropic con créditos disponibles.

# Instalar Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Verificar instalación
claude --version

# Iniciar sesión (te abre el navegador)
claude login

Requisitos: Node.js 18 o superior. Si tenés nvm, ejecutá nvm use 18 antes de instalar. Necesitás una cuenta de Anthropic con API key o suscripción de Claude Pro/Max.

Paso 2: Configurar tu carpeta de trabajo

Claude Code trabaja dentro del directorio donde lo ejecutás. Todo lo que Claude pueda ver y modificar está limitado a esa carpeta. Antes de empezar, navegá a tu proyecto.

# Navegar a tu proyecto
cd mi-proyecto

# Iniciar Claude Code en esta carpeta
claude

# Claude ahora tiene acceso a todos los archivos
# de esta carpeta y puede leerlos, editarlos y crear nuevos

Si querés que Claude respete ciertas reglas en cada proyecto, creá un archivo CLAUDE.md en la raíz. Claude lo lee automáticamente al iniciar.

# CLAUDE.md - Reglas del proyecto

## Stack
- React 18 + TypeScript + Vite
- Tailwind CSS para estilos
- Supabase para backend

## Convenciones
- Usar componentes funcionales con hooks
- Nombres de archivos en PascalCase
- No usar any en TypeScript

Paso 3: Entender los modelos

Claude Code puede usar tres familias de modelos. Cada una tiene un balance distinto de capacidad, velocidad y costo. Elegir el correcto para cada tarea es clave.

Claude Opus (el más capaz)

Opus es el modelo más avanzado. Tiene el mejor razonamiento complejo, maneja contextos largos y es ideal para arquitectura de software, debugging difícil y tareas que requieren creatividad o planificación multi-paso.

• Arquitectura y diseño de sistemas complejos
• Debugging de bugs difíciles que otros modelos no encuentran
• Refactors grandes que tocan muchos archivos
• Planificación de features completas antes de programar

Costo de Opus: Opus es el modelo más caro. Usalo solo para tareas que realmente necesitan su capacidad. Para el día a día, Sonnet es más que suficiente.

Claude Sonnet (el equilibrio)

Sonnet es el modelo por defecto de Claude Code. Ofrece un balance excelente entre capacidad y velocidad. Para el 90% de las tareas de programación diaria, Sonnet es la mejor opción.

• Programación diaria: crear componentes, agregar features, arreglar bugs
• Revisión de código y refactors medianos
• Generación de tests y documentación
• Tareas de configuración y setup

Claude Haiku (el más rápido)

Haiku es el modelo más rápido y económico. Es ideal para tareas simples que no requieren razonamiento profundo. Si necesitás respuestas rápidas y el costo es prioritario, Haiku es la opción.

• Preguntas rápidas sobre el código ("¿dónde está definido X?")
• Formateo y renombrado de archivos
• Generación de boilerplate o código repetitivo
• Búsquedas simples en el codebase

Estrategia recomendada: Usá Sonnet para el día a día. Cambiá a Opus cuando te trabes en un bug o necesites planificar algo complejo. Usá Haiku para tareas triviales que no merecen el costo de Sonnet.

Paso 4: Trabajar con Skills

Las Skills son paquetes de instrucciones que Claude carga solo cuando las necesita. Cada Skill tiene una descripción que Claude evalúa contra tu prompt. Si coincide, Claude carga las instrucciones de esa Skill.

# Estructura de una Skill
mi-skill/
├── SKILL.md          # Instrucciones principales
├── references/       # Archivos de referencia
│   └── patterns.md
├── scripts/          # Scripts ejecutables
│   └── setup.sh
└── templates/        # Plantillas reutilizables
    └── component.tsx

El archivo SKILL.md contiene la descripción y las instrucciones. La descripción es lo que Claude usa para decidir si activar la Skill o no.

# SKILL.md

---
name: database-setup
description: Configura una base de datos Supabase con migraciones, RLS y auth
---

## Instrucciones

1. Crear el archivo de migración con el template de references/migration-template.sql
2. Aplicar las políticas RLS según el patrón en references/rls-patterns.sql
3. Verificar que las políticas cubran SELECT, INSERT, UPDATE, DELETE
4. Ejecutar la migración con la herramienta MCP de Supabase

Paso 5: Flujo de trabajo recomendado

• Abrí Claude Code en la carpeta del proyecto (cd proyecto && claude)
• Si es la primera vez, dejá que Claude lea el CLAUDE.md y explore la estructura
• Para tareas repetitivas, creá Skills en lugar de repetir instrucciones
• Usá Sonnet para programación, cambiá a Opus para bugs difíciles o planificación
• Cuando el chat se llene, ejecutá /compact o abrí un chat nuevo

Modelos en resumen

• Complejo — Opus: Mayor capacidad de razonamiento. Ideal para arquitectura, debugging difícil y planificación multi-paso. El más caro.
• Equilibrio — Sonnet: Modelo por defecto. Balance entre capacidad y velocidad. Suficiente para el 90% de las tareas de programación diaria.
• Rápido — Haiku: El más rápido y económico. Ideal para tareas simples, búsquedas y código repetitivo que no requiere razonamiento profundo.
• Reuso — Skills: Instrucciones que se cargan bajo demanda. Reducen tokens y estandarizan flujos repetitivos en todos los proyectos.

Conclusión

Claude Code es una herramienta de productividad, no solo un chat. Configurando bien tu carpeta de trabajo, aprovechando CLAUDE.md, creando Skills para tareas repetitivas y eligiendo el modelo correcto para cada caso, vas a multiplicar tu velocidad de desarrollo desde el primer día.