Módulo 1: Qué es Claude Code y por qué importa
Módulo 1: Qué es Claude Code y Por Qué Importa
Módulo 1: Qué es Claude Code y Por Qué Importa
Descripción
Este es el punto de partida de la guía Claude Code Foundations. Antes de instalar, configurar, o escribir tu primer prompt, necesitas responder tres preguntas fundamentales: ¿qué es Claude Code? ¿Cómo funciona? ¿Y por qué deberías usarlo en lugar de las alternativas?
Claude Code no es un chatbot. No es un autocompletado glorificado. Es un agente de IA con acceso completo a tu terminal, tu filesystem, y tus herramientas de desarrollo. Piensa en él como un developer senior haciendo pair-programming contigo — pero con la capacidad de leer tu codebase completo en segundos, ejecutar cualquier comando, y proponer cambios en múltiples archivos simultáneamente.
En este módulo introductorio vas a construir el mental model correcto para entender qué hace Claude Code, cómo se diferencia de otras herramientas, y dónde encaja en el landscape actual de AI coding tools. Sin este entendimiento, usarás Claude Code como un chatbot más — y eso es usar el 10% de lo que ofrece.
Dónde Estamos en la Guía
Módulo 01: Qué es Claude Code ← ESTÁS AQUÍ
Módulo 02: Instalación y setup
Módulo 03: CLAUDE.md y memoria
Módulo 04: Workflow agentic
Módulo 05: Skills y Hooks
Módulo 06: Subagents
Módulo 07: Integraciones (Git, SDK, Remote Control)
Módulo 08: Proyecto integrador
Este es el Módulo 01 de 8. Es el cimiento conceptual sobre el que se construye todo lo demás. Los módulos 02 al 07 asumen que ya entiendes qué es Claude Code, cómo funciona su arquitectura, y por qué es diferente de Cursor, Copilot, o cualquier otro AI coding tool.
El Mental Model Fundamental
Claude Code es un agente autónomo en tu terminal con acceso total a tu codebase.
No es una barra de autocompletado (Copilot). No es un chat lateral en tu IDE (Cursor chat). No es un asistente que genera código en un browser (ChatGPT). Es un agente — un software que puede leer, analizar, planificar, ejecutar, y verificar, todo dentro de tu entorno de desarrollo real.
┌──────────────────────────────────────────────────┐
│ CHATBOT (ChatGPT, Gemini) │
│ → Genera texto sobre código │
│ → No ve tu proyecto │
│ → No ejecuta nada │
│ → Tú copias y pegas │
│ │
│ AUTOCOMPLETADO (Copilot, Codeium) │
│ → Sugiere la siguiente línea mientras escribes │
│ → Contexto limitado (archivo actual) │
│ → Reactivo, no proactivo │
│ → Sin capacidad multi-archivo │
│ │
│ AGENTE (Claude Code) │
│ → Lee tu codebase completo │
│ → Ejecuta comandos en tu terminal │
│ → Edita múltiples archivos │
│ → Planifica antes de actuar │
│ → Itera hasta resolver │
│ → Tú supervisas, él ejecuta │
└──────────────────────────────────────────────────┘
La diferencia no es de grado — es de categoría. Un chatbot te da texto que parece código. Un autocompletado te ahorra tecleo. Un agente te ayuda a construir software.
Por Qué Esta Guía Existe
El landscape de herramientas de IA para código evoluciona a una velocidad sin precedentes. Claude Code lidera con 69% de adopción entre desarrolladores profesionales (ACTI Index, enero 2026). Tuvo 35 releases en 7 semanas (enero-febrero 2026), un ritmo que refleja la velocidad de iteración de la herramienta en ese período. Sus modelos más capaces, Opus 5 y Sonnet 5, ofrecen una ventana de contexto de 1 millón de tokens.
Pero la adopción no implica dominio. La mayoría de desarrolladores que usan Claude Code lo hacen al 10% de su capacidad:
Lo que la mayoría hace:
→ Abrir Claude Code
→ Pedir "arregla este bug" o "genera este componente"
→ Aceptar el resultado
→ Cerrar
Lo que un usuario avanzado hace:
→ Configurar CLAUDE.md con convenciones del proyecto
→ Crear skills para tareas repetitivas
→ Usar hooks para validación automática
→ Delegar tareas complejas a subagents
→ Gestionar context window y compaction
→ Integrar con SDK para automatización
→ Elegir modelo y effort por tipo de tarea
Esta guía existe para cerrar esa brecha. No es un tutorial de "instala y prueba". Es una guía completa que cubre desde la base conceptual hasta features avanzados que ningún competidor documenta de forma progresiva.
El gap en el mercado
Hay decenas de videos, artículos, y cursos sobre Claude Code. Pero la mayoría son:
- Fragmentados: Cubren un feature aislado sin contexto
- Superficiales: "Instala y prueba" sin profundidad
- Desactualizados: Claude Code cambia cada 2 días; un artículo de hace 3 meses puede estar obsoleto
- Sin progresión: No hay un camino de aprendizaje, solo tips sueltos
Esta guía es progresiva (cada módulo construye sobre el anterior), completa (8 módulos que cubren desde lo básico hasta SDK), y principle-driven (enseña mental models, no solo pasos — porque los pasos cambian, los principios no).
Por Qué Este Módulo Importa
Antes de instalar Claude Code (Módulo 02), necesitas entender qué estás instalando. Antes de crear un CLAUDE.md (Módulo 03), necesitas entender cómo Claude Code lee y usa esos archivos. Antes de configurar hooks y skills (Módulo 05), necesitas entender el loop agéntico que los ejecuta.
Este módulo responde tres preguntas:
| Pregunta | Cápsula |
|---|---|
| ¿Qué es Claude Code y cómo funciona su arquitectura? | Cápsula 02 |
| ¿Cómo se compara con otras herramientas de AI para código? | Cápsula 03 |
| ¿Por qué elegir Claude Code sobre las alternativas? | Cápsula 03 |
Sin estas respuestas, el resto de la guía es una secuencia de instrucciones sin contexto. Con ellas, cada decisión que tomes — qué modelo usar, cómo estructurar tu CLAUDE.md, cuándo usar subagents — tiene fundamento.
Prerequisitos
Conocimiento requerido:
- ✅ Conocimiento básico de programación (cualquier lenguaje)
- ✅ Familiaridad general con herramientas de desarrollo (editor, terminal, git)
- ✅ Curiosidad sobre herramientas de IA para desarrollo
NO requerido:
- ❌ No necesitas haber usado Claude Code antes
- ❌ No necesitas saber AI/ML
- ❌ No necesitas experiencia con LLMs o prompt engineering
- ❌ No necesitas haber usado Cursor, Copilot, o cualquier otro AI tool
Este es el módulo de entrada. Si sabes programar y tienes curiosidad, tienes lo necesario.
Roadmap del Módulo
Este módulo tiene 3 cápsulas progresivas:
Cápsula 01 — Introducción al módulo (esta cápsula)
Contexto, mental model, prerequisitos, y roadmap. Entiendes el propósito del módulo y qué vas a aprender.
Cápsula 02 — Cómo funciona Claude Code
La arquitectura LLM + tools + terminal. El loop agéntico. Qué puede y qué no puede hacer Claude Code. El context window. El modelo de permisos. Por qué esto es fundamentalmente diferente de un autocompletado o un chatbot.
Cápsula 03 — Landscape de AI coding tools
Las 3 categorías de herramientas. Comparativa Claude Code vs Cursor vs GitHub Copilot vs Cline. Por qué Claude Code lidera. Cuándo NO usar Claude Code. Hacia dónde va el espacio.
Mapa de progresión
Cápsula 01 (esta) → Contexto y prerequisitos
Cápsula 02 → Arquitectura: LLM + tools + terminal
Cápsula 03 → Landscape: dónde encaja Claude Code
Dificultad: ⭐ ──────────────────────────▶ ⭐
Las tres cápsulas son conceptuales. No instalarás ni configurarás nada — eso es el Módulo 02. Aquí construyes el entendimiento que hace que el Módulo 02 (y todos los siguientes) tengan sentido.
Lo que conecta cada cápsula
Cápsula 01 → Establece el mental model: "agente en terminal"
│
▼
Cápsula 02 → Explica CÓMO funciona ese agente por dentro
│ (arquitectura, loop, capacidades, límites)
▼
Cápsula 03 → Explica DÓNDE encaja ese agente en el ecosistema
(comparativa, adopción, cuándo usar qué)
Cada cápsula construye sobre la anterior. La cápsula 02 da profundidad técnica al concepto introducido aquí. La cápsula 03 pone ese concepto en contexto comparativo. Al terminar las tres, tienes una visión completa.
Qué Lograrás en Este Módulo
Al completar las 3 cápsulas, serás capaz de:
- Explicar qué es Claude Code y cómo funciona su arquitectura (LLM + tools + terminal)
- Describir el loop agéntico — el ciclo prompt → lectura → razonamiento → acción → iteración
- Diferenciar Claude Code de chatbots, autocompletados, e IDEs con AI
- Comparar Claude Code con Cursor, Copilot, Cline, y otras alternativas
- Justificar cuándo usar Claude Code — y cuándo otra herramienta es más adecuada
- Adoptar el mental model correcto — agente en terminal con acceso total al codebase
El antes y después
ANTES del módulo:
→ "Claude Code es como ChatGPT pero para código, ¿no?"
→ "¿Es mejor que Copilot?"
→ "¿Necesito dejar Cursor para usar Claude Code?"
→ "¿Qué es un 'agente de código'?"
DESPUÉS del módulo:
→ Entiendes la arquitectura LLM + tools + terminal
→ Sabes por qué Claude Code lidera con 69% de adopción
→ Puedes comparar herramientas con criterio informado
→ Tienes claro cuándo usar Claude Code vs alternativas
→ El concepto de "agente" tiene significado concreto para ti
Qué NO Cubre Este Módulo
Para mantener el foco, estas cosas se cubren en módulos posteriores:
| Tema | Dónde se cubre |
|---|---|
| Instalación y autenticación | Módulo 02 |
| Plataformas y pricing | Módulo 02 |
| CLAUDE.md y sistema de memoria | Módulo 03 |
| Workflow agentic (Explore → Plan → Code) | Módulo 04 |
| Skills y Hooks | Módulo 05 |
| Subagents | Módulo 06 |
| Integraciones: Git, SDK, MCP | Módulo 07 |
| Proyecto integrador | Módulo 08 |
Este módulo es puro entendimiento. No tocas la terminal. Construyes el modelo mental que hace que todo lo práctico tenga sentido.
Conexión con el Proyecto Integrador
En el Módulo 08, construirás una herramienta CLI completa usando Claude Code. Para ese proyecto necesitas:
- Entender la arquitectura — para saber qué pedirle a Claude Code y qué esperar
- Conocer las capacidades — para diseñar tu workflow de desarrollo
- Saber las limitaciones — para no esperar magia donde no la hay
- Tener contexto del landscape — para saber que estás usando la herramienta líder y por qué
Lo que aprendes en este módulo es la base de decisión para todo el proyecto.
Claude Code en Números
Antes de entrar a las cápsulas técnicas, estos números te dan la fotografía actual de Claude Code:
| Métrica | Valor | Fuente |
|---|---|---|
| Adopción profesional | 69% | ACTI Index, Enero 2026 |
| Releases recientes | 35 en 7 semanas (ene-feb 2026) | Anthropic changelog |
| Context window máximo | 1M tokens (Opus 5, Sonnet 5) | Anthropic docs |
| Output máximo | 128K tokens (Opus 5), 64K tokens (Sonnet 5, Haiku 4.5) | Anthropic docs |
| Modelos disponibles | 3 (Opus 5, Sonnet 5, Haiku 4.5) | Anthropic docs |
| Plataformas | 5 (Terminal, VS Code, JetBrains, Desktop, Web) | Anthropic docs |
| SDK | Python + TypeScript | Anthropic docs |
| Precio entrada | $20/mes (Pro) | claude.ai/pricing |
Estos números cambian con frecuencia — Claude Code evoluciona rápido. Los conceptos que aprenderás en este módulo, no.
Versiones y Compatibilidad
Este módulo cubre:
- Opus 5 (1M token context window)
- Sonnet 5 (1M token context window)
- Haiku 4.5 (200K token context window)
- ACTI Index: Enero 2026 (69% adoption data)
Nota sobre actualizaciones:
Los conceptos de este módulo — qué es un agente, cómo funciona la arquitectura, cómo se comparan las herramientas — son estables. La arquitectura LLM + tools + terminal es fundamental a Claude Code. Los datos específicos (porcentajes de adopción, releases, benchmarks) pueden cambiar; los principios no.
Conceptos Clave que Verás
Agente de IA
Un programa que puede percibir su entorno, razonar sobre él, y tomar acciones para cumplir un objetivo. A diferencia de un chatbot (que solo genera texto) o un autocompletado (que solo predice la siguiente línea), un agente tiene un ciclo de acción completo: observa, piensa, actúa, y evalúa.
Chatbot: Input → Output (texto)
Autocomplete: Contexto → Sugerencia (línea de código)
Agente: Objetivo → Observar → Razonar → Actuar → Evaluar → Repetir
Claude Code es un agente. Este concepto es central para todo lo que sigue en la guía.
LLM (Large Language Model)
El modelo de lenguaje que "piensa" dentro de Claude Code. No es una base de datos de código — es una red neuronal entrenada que puede razonar sobre problemas, generar soluciones, y tomar decisiones. Los tres modelos disponibles son Opus 5 (más capaz, 1M tokens de contexto), Sonnet 5 (balance entre velocidad e inteligencia, 1M tokens de contexto), y Haiku 4.5 (el más rápido, 200K tokens).
Tools (Herramientas)
Las acciones concretas que Claude Code puede realizar en tu sistema, organizadas en 5 categorías: operaciones de archivos (leer, escribir, crear), búsqueda (por patrones, por contenido), ejecución (comandos shell, tests, git), web (buscar documentación, investigar errores), e inteligencia de código (errores de tipo, definiciones, referencias). El LLM decide cuándo y cómo usar cada tool — no sigue un script predeterminado.
Context Window (Ventana de contexto)
La cantidad de información que el LLM puede procesar simultáneamente. Incluye tu prompt, los archivos que leyó, el historial de la conversación, y sus propias respuestas. Opus 5 y Sonnet 5 tienen 1M tokens (~750K palabras); Haiku 4.5 tiene 200K tokens.
Context window = memoria de trabajo del agente
Más grande = puede "ver" más de tu codebase a la vez
Loop Agéntico
El ciclo que Claude Code ejecuta para completar una tarea: recibe tu prompt → lee archivos relevantes → razona sobre la solución → propone acciones → tú apruebas → ejecuta → verifica el resultado → itera si es necesario. Este ciclo es lo que distingue a un agente de un generador de código.
CLAUDE.md
Archivo markdown que agregas a la raíz de tu proyecto y que Claude Code lee al inicio de cada sesión. Define convenciones, tecnologías, y reglas que Claude Code debe seguir. Claude Code también construye auto memory automáticamente mientras trabajas, guardando aprendizajes entre sesiones. Se cubre en profundidad en el Módulo 03, pero lo mencionamos aquí porque es parte de cómo el agente entiende tu proyecto.
Preguntas Frecuentes Antes de Empezar
"¿Claude Code es como ChatGPT para código?"
No. ChatGPT genera texto sobre código. Claude Code opera en tu código real. ChatGPT no puede leer tus archivos, ejecutar tus tests, o hacer commit de tus cambios. Claude Code sí. Es la diferencia entre hablar sobre cocinar y cocinar.
"¿Necesito dejar mi editor para usar Claude Code?"
No. Claude Code tiene extensiones para VS Code y JetBrains. Puedes usarlo dentro de tu editor o directamente en terminal — tú eliges. Muchos developers usan ambos: terminal para tareas complejas, extensión para tareas rápidas.
"¿Claude Code va a reemplazar a los developers?"
No. Claude Code amplifica tu capacidad, no la sustituye. Necesitas saber programar para evaluar lo que produce, corregirlo cuando se equivoca, y darle instrucciones precisas. Es pair-programming con un partner muy rápido, no piloto automático.
"¿Es seguro darle acceso a mi código?"
Claude Code envía fragmentos de tu código a los servidores de Anthropic para procesamiento. Anthropic tiene políticas de privacidad y no usa tus datos para entrenamiento. Si trabajas con código confidencial, revisa las políticas de tu empresa antes de usar cualquier herramienta de AI.
"¿Funciona con mi lenguaje de programación?"
Sí. Claude Code trabaja con cualquier lenguaje: Python, JavaScript, TypeScript, Go, Rust, Java, C#, Ruby, PHP, Swift, Kotlin, y más. Si puedes trabajarlo en tu terminal, Claude Code puede ayudarte con él.
"¿Cuánto cuesta?"
Desde $20/mes (plan Pro) hasta $200/mes (plan Max 20x). Los detalles de pricing y cómo elegir el plan correcto se cubren en el Módulo 02.
"¿Puedo usar Claude Code si solo sé un lenguaje?"
Sí. Claude Code es agnóstico de lenguaje. Si sabes Python, puedes usarlo para Python. Si sabes JavaScript, lo usas para JavaScript. No necesitas ser polyglot. Lo que sí necesitas es entender conceptos básicos de desarrollo (variables, funciones, control de flujo, archivos, terminal).
Cómo Trabajar Este Módulo
Recomendación:
- Lee la cápsula 02 con atención. La arquitectura es el concepto más importante de toda la guía.
- La cápsula 03 es comparativa. Te da contexto para entender por qué Claude Code y no otra cosa.
- No te apures. Son 30 minutos. Si entiendes bien este módulo, todo lo que viene después es más fácil.
Tiempo estimado:
Cápsula 01 (esta) → 5 min lectura
Cápsula 02 → 15 min lectura
Cápsula 03 → 10 min lectura
Total: ~30 minutos
Resumen
Este módulo es el cimiento conceptual de la guía Claude Code Foundations.
Lo que cubre:
- Qué es Claude Code y cómo funciona (arquitectura LLM + tools + terminal)
- El loop agéntico: prompt → lectura → razonamiento → acción → iteración
- Comparativa con chatbots, autocompletados, e IDEs con AI
- El landscape de AI coding tools: Claude Code vs Cursor vs Copilot vs Cline
- Por qué Claude Code lidera con 69% de adopción profesional
Lo que produce:
- Mental model correcto: agente en terminal con acceso total al codebase
- Capacidad de comparar herramientas con criterio
- Contexto para tomar decisiones informadas en los módulos siguientes
Por qué importa:
- Sin entender qué es Claude Code, lo usas como chatbot
- Sin conocer el landscape, no sabes por qué elegiste esta herramienta
- Sin el mental model correcto, cada módulo posterior pierde profundidad
Siguiente cápsula: 02 - Cómo funciona Claude Code — la arquitectura LLM + tools + terminal, el loop agéntico, y las capacidades reales del agente.
Recursos Adicionales
- Claude Code Overview — Visión general oficial de Claude Code, requisitos, y guía de inicio
- How Claude Code Works — Arquitectura, loop agéntico, tools, y cómo interactúa con tu proyecto
- Claude Models — Especificaciones de Opus 5, Sonnet 5, y otros modelos
- Anthropic Research — Claude — Papers e investigación detrás de los modelos Claude
- ACTI Index — AI Coding Tool Insights — Datos de adopción y tendencias en herramientas de AI para desarrollo
- Claude Code GitHub Repository — Repositorio oficial, issues, y discussions
- Claude Code Best Practices — Guía oficial de mejores prácticas para uso efectivo