En este primer módulo entenderás qué es realmente Claude Code, en qué se diferencia de los copilotos tradicionales, qué hace bien, qué hace mal, y por qué exige una forma de trabajar distinta a la que estás acostumbrado.
Objetivos de aprendizaje
Distinguir entre un autocompletador (Copilot) y un agente (Claude Code).
Conocer los modelos disponibles (Opus, Sonnet, Haiku) y cuándo usar cada uno.
Comprender el ciclo Read → Plan → Edit → Verify y por qué importa.
Identificar tres casos de uso reales donde Claude Code aporta valor inmediato.
Entender el modelo de costes y la implicación para empresa.
1.1 ¿Qué es Claude Code?
Claude Code es la CLI oficial de Anthropic para utilizar Claude como agente de programación. Vive en tu terminal, ve tus archivos, ejecuta comandos en tu shell, edita código, lanza tests y abre pull requests. Es decir: hace el trabajo, no te lo sugiere.
Las cuatro modalidades comparten el mismo motor: el modelo Claude Opus / Sonnet / Haiku con acceso a un conjunto de herramientas (Read, Edit, Bash, Glob, Grep, Agent…) que le permiten interactuar con tu sistema de archivos y tu shell.
Qué NO es Claude Code
✗ No es un autocompletador
No te sugiere la siguiente línea mientras escribes. No vive dentro del editor a nivel de tecla.
✓ Es un agente
Le pides un cambio en lenguaje natural y él busca, decide, edita y verifica. Tú revisas el diff.
Comparativa con otras herramientas
Herramienta
Tipo
Acceso al sistema
Ideal para
GitHub Copilot
Autocompletador
Solo el archivo abierto
Tipear más rápido
Cursor / Windsurf
Editor con chat
Repositorio (con consentimiento)
Sesiones cortas en un IDE
ChatGPT (web)
Chat sin tools
Solo el contexto que pegas
Preguntas conceptuales
Claude Code
Agente CLI
Filesystem + shell + Git
Tareas multi-archivo, refactor, code review, ops
Nota clave: Claude Code y Cursor no son enemigos. Muchos equipos usan ambos: Cursor para edición rápida con vista del editor, Claude Code para tareas autónomas (refactorizar 30 archivos, leer logs, abrir un PR completo). En este curso nos centramos en Claude Code porque es la herramienta más potente para flujos de trabajo agenticos.
1.2 Los modelos: Opus, Sonnet, Haiku
Claude Code usa por defecto el modelo más capaz disponible en tu plan, pero puedes cambiarlo con /model. En 2026, la familia activa es:
Modelo
ID
Capacidad
Velocidad
Coste relativo
Claude Opus 4.7
claude-opus-4-7
Máxima
Media
Alto
Claude Sonnet 4.6
claude-sonnet-4-6
Alta
Alta
Medio
Claude Haiku 4.5
claude-haiku-4-5
Buena
Muy alta
Bajo
El modelo por defecto es Opus 4.7 con ventana de contexto de 1M tokens en planes Team y Enterprise. Esto significa que Claude Code puede tener en su contexto el equivalente a más de 2.500 páginas de código y prosa simultáneamente — suficiente para un repositorio mediano completo.
¿Cuándo cambiar de modelo?
Opus 4.7: refactorizaciones grandes, debugging arquitectural, decisiones de diseño, code review profundo. Vale el coste.
Sonnet 4.6: el caballo de batalla. Tareas de tamaño medio, escritura de tests, edición rutinaria. Buen ratio coste/calidad.
Haiku 4.5: scripts pequeños, formateo, tareas mecánicas, sub-agentes que delegas en lote. Cuando quieres minimizar coste.
Truco práctico: en lugar de pelear con qué modelo usar, deja Claude Code en Opus 4.7 para la conversación principal y delega trabajo pesado a sub-agentes con Sonnet o Haiku (lo veremos en el Módulo 6). Así pagas Opus solo cuando hace falta razonamiento de alto nivel.
1.3 La filosofía: Read → Plan → Edit → Verify
Si solo recuerdas una cosa de este módulo, que sea esta: los buenos agentes leen antes de escribir, planifican antes de actuar, y verifican antes de declarar terminado.
Claude Code está entrenado y configurado para seguir este ciclo:
El ciclo en acción · cada paso se ilumina por turno
1 · ReadLeer y buscar antes de tocarGlob · Grep · Read
2 · PlanDeclarar qué se va a hacerplan mode
3 · EditAplicar los cambiosEdit · Write
4 · VerifyTests, build, validarBash · MCP
1. Read
Antes de tocar nada, Claude Code busca y lee. Usa Glob para encontrar archivos por patrón, Grep para buscar símbolos, Read para leer ficheros completos. Esto le permite formarse una hipótesis fundamentada en lo que realmente hay en el repo, no en lo que cree recordar.
2. Plan
Antes de editar, Claude Code declara qué va a hacer. Bien sea con una explicación en lenguaje natural ("voy a tocar X y Y porque…") o, en plan mode (/plan, Módulo 4), un plan formal que tú apruebas antes de que ejecute.
3. Edit
Aplica los cambios — uno por uno, archivo por archivo — usando Edit (cambios localizados) o Write (creación / reescritura completa). Cada cambio queda en tu sistema de archivos, nunca en la nube.
4. Verify
Termina ejecutando: lanza tests, hace npm run build, compila, abre la app en el navegador (vía MCP de Chrome). Si algo falla, vuelve al paso Read para diagnosticar — no se rinde y entrega código que no compila.
Anti-patrón frecuente: dar a Claude una tarea mal definida y aceptar el primer resultado. Si no le pides verificación explícita ("y comprueba que los tests pasan"), puede declarar terminado un cambio que rompe el build. Siempre cierra el ciclo.
Practica · arrastra los pasos al orden correcto
Reordena las fases del ciclo de un agente bien comportado. Cuando creas que está bien, pulsa "Comprobar".
Edit Aplicar cambios con Edit / Write
Verify Tests, build, comprobación
Read Leer y buscar antes de tocar
Plan Declarar qué se va a hacer
1.4 Anatomía de una sesión real
Para que veas cómo se siente, este es un ejemplo abreviado de una sesión típica. El usuario pide un cambio. Lo que ves después es lo que Claude Code muestra en consola.
victor@mac ~/proyecto $ claude
> Refactoriza la función calcularPrecio en utils/precio.ts
para que acepte un objeto Options en lugar de 4 parámetros sueltos.
Actualiza también todos los call sites y los tests.
· Reading utils/precio.ts ............................ ✓
· Searching for "calcularPrecio" callers ............. 12 matches
· Reading 6 files with callers ....................... ✓
· Reading utils/precio.test.ts ....................... ✓
Plan:
1. Cambiar signature de calcularPrecio(a,b,c,d) a calcularPrecio(opts: PrecioOptions)
2. Definir interface PrecioOptions con base, descuento, iva, moneda
3. Actualizar 12 llamadas en 6 archivos para usar el nuevo objeto
4. Actualizar 8 tests
5. Ejecutar npm test y verificar que pasan
· Editing utils/precio.ts ............................ ✓
· Editing src/checkout/handler.ts (3 callers) ........ ✓
· Editing src/api/precios.ts (2 callers) ............. ✓
· Editing src/admin/dashboard.ts (4 callers) ......... ✓
· Editing utils/precio.test.ts ....................... ✓
· Running: npm test
PASS utils/precio.test.ts (8/8)
PASS src/checkout/handler.test.ts (12/12)
✓ All tests pass.
Refactor terminado. Resumen de cambios en 6 archivos. Diff abajo.
Tres cosas que destacar de la sesión anterior:
Buscó antes de tocar. Encontró las 12 llamadas — no asumió que solo había una.
Planificó. Declaró los 5 pasos antes de ejecutarlos. Si el plan estuviese mal, podías cortarle.
Verificó. Ejecutó npm test al final. Si hubiera fallado un test, no daría la tarea por terminada.
1.5 Tres casos de uso reales
📦 Migración de versión
"Migra de React 17 a React 19. Cambia ReactDOM.render a createRoot, actualiza tipos, ajusta los hooks deprecados, y verifica que la app sigue compilando."
Ahorro típico: 1-2 días de un dev senior reducidos a 2 horas.
🧪 Cobertura de tests
"Lee src/services/billing.ts y escribe tests unitarios con vitest hasta cubrir el 90% de las ramas. Mockea las dependencias externas."
Crítico cuando heredas código sin tests.
🔍 Code review autónomo
"Revisa el último PR. Detecta vulnerabilidades, código muerto, falta de validación de input. Devuelve un informe estructurado con prioridades."
El comando /review hace exactamente esto.
🚨 Debugging operacional
"Lee logs/error.log de las últimas 24h. Identifica el error más frecuente, busca su origen en el código, propón un parche."
Útil de guardia. Ahorra paginar al equipo.
Regla del 70%: en una empresa, Claude Code rinde mejor cuando completa el 70% de una tarea bien definida y un humano cierra el 30% restante (matices de negocio, decisiones de diseño con stakeholders, comunicación). Pelearse con que haga el 100% es un anti-patrón.
1.6 Costes y planes
Claude Code se factura de dos formas distintas según el plan:
Plan
Modelo de coste
Pensado para
Pro · 20 €/mes
Tarifa plana con fair use. Mensajes diarios limitados.
Freelance, autónomos, dev individual
Team · 25 €/usuario/mes (mín. 5)
Tarifa plana ampliada. Quotas de equipo.
Startups y equipos de hasta 150
Enterprise · custom
Tarifa plana o pago por uso, SSO, DLP, contrato RGPD directo.
+100 empleados, sectores regulados
API · pago por uso
$3 / $15 por millón de tokens (input/output) en Sonnet 4.6. Opus paga más.
Integraciones a medida y agentes en producción
Coste real de un día de trabajo
Un desarrollador con uso intensivo de Claude Code consume típicamente entre 5M y 30M tokens al día. Con prompt caching activado (Módulo 9), el coste real con Sonnet 4.6 ronda los 3-12 € diarios en API. En tarifa plana Team, el coste es fijo y suele salir más barato a partir de uso medio.
Si trabajas en sector regulado (banca, sanidad, AAPP, legal): vete directamente a Claude Enterprise. Es el único plan donde Anthropic firma DPA conforme RGPD y garantiza por contrato que tus datos no se usan para entrenar modelos. Lo veremos en detalle en el Módulo 10.
Práctica del módulo
Ejercicio 1.1 · Identificar herramientas en una sesión
Lee la transcripción de la sección 1.4 (la del refactor de calcularPrecio) y responde:
¿Qué herramienta usó Claude Code para encontrar las 12 llamadas?
¿Qué herramienta usó para leer cada archivo?
¿Qué herramienta ejecutó npm test?
¿En qué fase del ciclo Read→Plan→Edit→Verify ocurre cada paso?
Solución sugerida: Grep para buscar "calcularPrecio" (Read), Read para leer ficheros (Read), Bash para npm test (Verify). El "Plan:" del centro corresponde a la fase Plan. Las "Editing …" son fase Edit.
Ejercicio 1.2 · Escoger el modelo
Para cada tarea, indica qué modelo escogerías y por qué:
Convertir 200 archivos JSON con un esquema viejo a un esquema nuevo (mecánico).
Diagnosticar por qué un microservicio en producción consume el doble de memoria desde el último deploy.
Escribir tests unitarios para una función de cálculo de IVA.
Decidir cómo separar un monolito Node.js en dos servicios.
Sugerencia: 1-Haiku, 2-Opus, 3-Sonnet, 4-Opus.
Test de comprensión
1. ¿Cuál es la diferencia más importante entre GitHub Copilot y Claude Code?
Copilot es de Microsoft, Claude Code de Anthropic.
Copilot autocompleta dentro del editor. Claude Code es un agente que ejecuta tareas multi-archivo.
Claude Code es más caro.
Copilot soporta más lenguajes.
Respuesta correcta: B. La diferencia esencial no es de marca ni de precio, sino de paradigma: autocompletador vs agente.
2. ¿Qué fase falta? Read → Plan → ___ → Verify
Test
Commit
Edit
Review
Respuesta correcta: C · Edit. Read (búsqueda y lectura), Plan (declaración de pasos), Edit (aplicar cambios), Verify (ejecutar/testear).
3. Tu empresa es un banco que maneja datos PCI-DSS. ¿Qué plan recomendarías?
Pro, porque es lo más barato.
Team, porque permite compartir entre desarrolladores.
Enterprise, porque incluye DPA RGPD y garantiza no entrenar con tus datos.
Free, para evaluar primero.
Respuesta correcta: C · Enterprise. En sector regulado, el plan Enterprise es el único que ofrece contrato directo con Anthropic, DPA conforme RGPD y garantía contractual de no usar datos para entrenamiento.
4. ¿Cuál es la regla del 70%?
Claude Code resuelve correctamente el 70% de las tareas.
El 70% de los tokens deben ser input.
Claude Code rinde mejor completando el 70% de una tarea bien definida y dejando el 30% al humano.
Hay que aceptar como mínimo el 70% de las sugerencias.
Respuesta correcta: C. La regla del 70% es heurística práctica: el agente suele ahorrar mucho tiempo en el 70% mecánico, pero el 30% final (decisiones de negocio, matices, stakeholders) requiere humano.
Resumen del módulo
Claude Code es un agente, no un autocompletador. Ejecuta tareas en tu sistema de archivos y shell.
Tres modelos: Opus (capacidad máxima), Sonnet (balance), Haiku (velocidad/coste). El defecto es Opus 4.7 con 1M tokens.
Ciclo Read → Plan → Edit → Verify: cualquier sesión productiva sigue estas cuatro fases.
Casos de uso de empresa: migración de versión, cobertura de tests, code review, debugging operacional.
Plan Enterprise es la opción para sectores regulados: DPA RGPD y garantía de no-entrenamiento.
En el siguiente módulo instalamos Claude Code, lo conectamos a tu cuenta y haces tu primera sesión real con un repositorio de prueba.