--- title: "Curso para aprender a usar Claude Code: guía práctica" description: "Aprende a usar Claude Code con esta guía estructurada: comandos clave, flujos de agentes, casos reales y cómo pasar de pruebas a producción en semanas." slug: "curso-para-aprender-a-usar-claude-code" url: "https://catalizadora.ai/blog/curso-para-aprender-a-usar-claude-code" cluster: "aprender-construir-agentes" author: "Pablo Estrada" published_at: "2026-06-20T07:18:19.761+00:00" updated_at: "2026-06-20T07:18:19.822306+00:00" read_minutes: "6" lang: "es" --- # Curso para aprender a usar Claude Code: guía práctica > Aprende a usar Claude Code con esta guía estructurada: comandos clave, flujos de agentes, casos reales y cómo pasar de pruebas a producción en semanas. # 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 ```bash # 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 | Comando | Qué hace | |---|---| | `claude` | Abre sesión interactiva en el directorio actual | | `claude -p "instrucción"` | Ejecuta una sola instrucción y cierra | | `claude --continue` | Retoma la última sesión guardada | | `claude --model claude-opus-4-5` | Especifica el modelo | ### 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 ```bash 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: ```markdown # 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 ```bash 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 ```bash 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](/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. ## Preguntas frecuentes ### ¿Claude Code es gratuito? No. Claude Code requiere una API key de Anthropic con créditos activos. Los costos varían según el modelo: Claude Haiku cuesta alrededor de $0.80 por millón de tokens de entrada, mientras que Claude Opus ronda los $15. Para la mayoría de proyectos de tamaño mediano, el costo mensual está entre $20 y $150 USD dependiendo del volumen de uso. ### ¿Qué diferencia hay entre Claude Code y GitHub Copilot? GitHub Copilot es un asistente de autocompletado que sugiere código línea por línea dentro del editor. Claude Code es un agente autónomo que puede leer archivos, ejecutar comandos, correr tests, abrir PRs y completar tareas de múltiples pasos sin intervención manual continua. Son herramientas complementarias, no equivalentes. ### ¿Funciona Claude Code con cualquier lenguaje de programación? Sí. Claude Code puede trabajar con cualquier lenguaje que pueda leer como texto: Python, TypeScript, JavaScript, Go, Rust, Java, Ruby, entre otros. Su efectividad es mayor en lenguajes donde el modelo tiene más datos de entrenamiento, como Python y TypeScript. ### ¿Es seguro darle acceso a mi repositorio completo? Con las precauciones correctas, sí. Se recomienda usar un archivo `.claudeignore` para excluir directorios con secretos o migraciones críticas, nunca exponer la API key en entornos compartidos, y revisar los cambios del agente antes de hacer merge, igual que revisarías el código de cualquier colaborador. ### ¿Puedo integrar Claude Code en un pipeline de CI/CD? Sí. Claude Code puede ejecutarse en modo no interactivo con el flag `-p` y una instrucción directa, lo que permite invocarlo desde GitHub Actions, GitLab CI u otras plataformas. Es necesario manejar la API key como secreto del pipeline y definir claramente el scope de acción del agente. --- Source: https://catalizadora.ai/blog/curso-para-aprender-a-usar-claude-code Author: Pablo Estrada — AI Catalyst, LLC (catalizadora.ai)