Curso para aprender a usar Claude Code: guía práctica para ir de cero a producción

Anthropic lanzó Claude Code en mayo de 2024 y en menos de seis meses miles de equipos de ingeniería lo adoptaron como su agente de terminal principal. Sin embargo, no existe un curso oficial consolidado que lleve a un desarrollador desde la instalación hasta flujos de agentes reales en producción. Esta guía cubre exactamente eso: comandos, patrones, errores comunes y la ruta más corta hacia resultados medibles.

¿Qué es Claude Code y por qué importa aprenderlo bien?

Claude Code es un agente de codificación que corre directamente en tu terminal. A diferencia de un copiloto de autocompletado (como GitHub Copilot), Claude Code puede:

• Leer y editar archivos de forma autónoma dentro de tu repositorio
• Ejecutar comandos shell y reaccionar a su salida
• Navegar bases de código grandes sin que pegues el código manualmente
• Abrir pull requests y escribir mensajes de commit

La diferencia práctica es grande. Un copiloto sugiere. Claude Code actúa. Aprender a dirigirlo bien puede reducir entre 40 % y 60 % el tiempo en tareas de refactoring, escritura de tests y generación de boilerplate, según reportes de equipos que lo adoptaron en producción en 2024.

Requisitos antes de empezar el curso

Antes de instalar nada, verifica que tienes:

• Node.js 18+ (Claude Code requiere el runtime de Node)
• Una API key de Anthropic con acceso al modelo claude-opus-4-5 o superior
• Terminal con acceso a bash o zsh (Linux, macOS o WSL en Windows)
• Familiaridad básica con Git y línea de comandos

Instalación en 3 pasos

# 1. Instalar el CLI de Claude Code
npm install -g @anthropic-ai/claude-code

# 2. Autenticar con tu API key
export ANTHROPIC_API_KEY="sk-ant-..."

# 3. Verificar instalación
claude --version

Una vez instalado, ejecutar claude dentro de cualquier directorio abre una sesión interactiva donde el agente puede ver todo el árbol de archivos del proyecto.

Módulo 1 — Comandos esenciales que todo usuario debe dominar

El mayor error de los principiantes es tratar a Claude Code como un chatbot. No lo es. Es un agente con herramientas. Estos son los comandos y patrones más importantes:

Comandos de sesión

Patrones de prompt que funcionan

Mal prompt:

"Mejora mi código"

Buen prompt:

"Refactoriza src/auth/login.ts para separar la lógica de validación en un servicio independiente. Mantén los mismos tipos TypeScript. No toques los tests existentes."

La especificidad importa. Claude Code opera mejor cuando el prompt incluye: archivo objetivo, acción concreta, restricciones y criterio de éxito.

Módulo 2 — Flujos de agentes: de tareas simples a pipelines complejos

Aquí empieza la parte que diferencia a un usuario intermedio de uno avanzado. Claude Code puede encadenarse en flujos donde cada paso alimenta al siguiente.

Flujo básico: generar + testear + commitear

claude -p "Escribe una función `parseCurrency(str: string): number` en \
src/utils/currency.ts. Luego genera el archivo de tests en \
src/utils/currency.test.ts con al menos 5 casos edge. \
Finalmente ejecuta los tests con `npm test` y corrígelos si fallan."

Este único prompt ejecuta tres etapas: escritura de código, escritura de tests y ejecución con corrección automática. En proyectos reales, este flujo tarda en promedio 3-7 minutos en tareas que a un desarrollador tomarían 45-90 minutos.

Flujo avanzado: agente con contexto externo

Puedes alimentar a Claude Code con documentos de contexto usando CLAUDE.md en la raíz del proyecto:

# CLAUDE.md
## Convenciones del proyecto
- Usar `pnpm` en lugar de npm
- Todos los componentes van en `src/components/[Nombre]/index.tsx`
- Los estilos usan Tailwind con el design token definido en `tailwind.config.ts`
- Los commits siguen Conventional Commits

Claude Code lee este archivo automáticamente al iniciar cada sesión. Equipos que documentan bien su CLAUDE.md reportan una reducción significativa en correcciones por inconsistencias de estilo.

Módulo 3 — Casos de uso reales donde Claude Code da más retorno

1. Migración de base de código legacy

Una startup fintech en México migró 80,000 líneas de JavaScript a TypeScript usando Claude Code en 3 semanas. El flujo fue:

1. Claude Code analiza cada archivo y genera la versión tipada
2. Ejecuta tsc --noEmit para detectar errores
3. Itera hasta compilación limpia
4. Genera el PR con descripción automática

Sin el agente, la estimación era 3 meses de trabajo manual.

2. Generación de documentación técnica

claude -p "Recorre todos los archivos en src/api/ y genera \
documentación OpenAPI 3.0 en docs/openapi.yaml basada en \
los tipos TypeScript y los comentarios JSDoc existentes."

3. Auditorías de seguridad dirigidas

claude -p "Revisa todos los endpoints en src/routes/ en busca de \
vulnerabilidades de inyección SQL y XSS. Lista cada caso con \
archivo, línea y recomendación. No modifiques el código."

Módulo 4 — Errores comunes y cómo evitarlos

Error 1: Darle autonomía total sin contexto

Claude Code puede sobrescribir archivos que no debería si no acotás el scope. Siempre especificá qué directorios puede o no puede tocar.

Solución: Usa .claudeignore (análogo a .gitignore) para excluir directorios sensibles:

.env
secrets/
migrations/

Error 2: Ignorar el costo de tokens

Claude Opus es el modelo más capaz pero también el más caro ($15 por millón de tokens de entrada). Para tareas de exploración o iteración rápida, usa claude-haiku-3-5 ($0.80 por millón) y reserva Opus para las tareas que exigen razonamiento profundo.

Error 3: No versionar el CLAUDE.md

Este archivo es la memoria institucional del agente. Trátalo como código: revisar en PR, mantenerlo actualizado con cada cambio de convención.

Módulo 5 — De prototipo a producción: la brecha que la mayoría no cruza

Saber usar Claude Code en proyectos pequeños es una cosa. Integrarlo en flujos de ingeniería de una empresa es otra. La brecha incluye:

• Manejo de secretos y variables de entorno en pipelines CI/CD
• Control de permisos: qué puede leer o modificar el agente en producción
• Observabilidad: loggear qué acciones tomó el agente y por qué
• Evaluación: medir si las salidas del agente son correctas, no solo que no den error

Estos temas son los que separan un experimento interesante de un sistema confiable.

¿Necesitás un sistema con Claude Code integrado, no solo el agente suelto?

Aprender a usar Claude Code es el primer paso. El siguiente es construir software donde los agentes trabajan de forma coordinada, con contexto de negocio, controles de calidad y entregables reales.

En Catalizadora construimos software AI-native a medida: desde flujos de agentes con Claude Code hasta plataformas completas con integraciones de datos, interfaces propias y lógica de negocio. Los proyectos bajo Catalizadora Core se entregan en 12 semanas, el cliente retiene el 100 % del IP y el código, y no hay licencias recurrentes.

Si ya entendés cómo funciona Claude Code y querés pasar de experimento a producto, revisá los planes en catalizadora.ai/precios.

Resumen: ruta de aprendizaje en 5 etapas

1. Instalar y autenticar el CLI (30 minutos)
2. Dominar prompts específicos con archivos y restricciones concretas (1-2 días de práctica)
3. Configurar CLAUDE.md con las convenciones del proyecto (1 sesión de trabajo)
4. Construir flujos encadenados: generar → testear → commitear (1 semana de iteración)
5. Integrar en CI/CD y agregar observabilidad (según madurez del equipo)

Claude Code no reemplaza a los desarrolladores. Multiplica lo que un buen desarrollador puede hacer en una jornada. Aprender a usarlo bien es, hoy, una ventaja competitiva concreta.