Saltar al contenido principal

Fase 1 — Fundamentos: entendiendo Claude Code

Duración: 3 semanas · Dedicación: 6–8h/semana · Caminos: 🟢🔵🟣 (todos los módulos son esenciales) Prerrequisito: Fase 0 (LLMs, tool use, taxonomía) o conocimiento equivalente. Foco principal: Claude Code · Conceptos transferibles: marcados explícitamente en cada módulo.

Objetivo de la fase​

Salir de la posición "escuché hablar de Claude Code" hacia "tengo Claude Code instalado, autenticado y produciendo código real" en al menos uno de tus proyectos. Vas a entender el ecosistema de agentes de código apenas lo suficiente para justificar la elección de Claude Code, y luego sumergirte profundamente en la herramienta.

Al final de esta fase puedes:

  • Explicar qué es Claude Code y cómo se diferencia de las alternativas (en 2 minutos)
  • Instalar, autenticar y configurar Claude Code desde cero en una máquina nueva
  • Usar modos interactivo y plan, comandos básicos y el archivo CLAUDE.md
  • Escribir prompts y contextos efectivos para tareas de programación
  • Entregar un proyecto pequeño en GitHub hecho con Claude Code

Convenciones de marcación​

Cada material está marcado con:

  • Tipo: 📚 Doc oficial · 📖 Artículo/Paper · 🎓 Curso · 🎬 Video/Podcast · 🛠️ Hands-on/Repositorio
  • Idioma: [PT] portugués · [EN] inglés · [ES] español
  • Costo: [Gratis] · [Pago] · [Freemium]
  • Nivel: principiante · intermedio · avanzado

Materiales marcados con ⭐ son los esenciales — si el tiempo es escaso, cubre solo los ⭐. Materiales marcados con 🌐 son conceptos universales (transferibles a cualquier agente).

M1 · Panorama del mercado y por qué Claude Code

Por qué este módulo​

Antes de sumergirte en una herramienta, necesitas entender dónde se ubica en el mapa. Este módulo es deliberadamente corto (1–2 días): solo lo suficiente para tener referencia de las alternativas y justificar la elección de Claude Code. Sin esto, te sientes inseguro cuando alguien pregunte "¿por qué no Cursor?".

Tópicos​

  • 🌐 Las 4 categorías de agentes de código en 2026:
    • IDE extension (GitHub Copilot, Cline, Continue)
    • Dedicated AI IDE (Cursor, Windsurf, Zed)
    • CLI/terminal agent (Claude Code, Aider, Codex CLI)
    • Cloud autonomous platform (Devin, OpenHands, Jules)
  • Dónde se posiciona Claude Code (CLI/terminal-first) y sus fortalezas:
    • Agnóstico de IDE — funciona en cualquier editor
    • MCP de primera clase (fue uno de los pioneros)
    • Subagentes, hooks, slash commands, skills, plugins
    • SDK propio (Claude Agent SDK)
    • Modelos Anthropic top-of-rank en SWE-bench Verified
  • Mapa muy breve de las alternativas — solo para reconocer los nombres
  • Justificación personal: "por qué Claude Code para mí/mi equipo"

Materiales​

Conceptual fundamental ⭐​

  • ⭐ 🌐 📖 Building Effective AI Agents — Anthropic Engineering · [EN] [Gratis] intermedio Paper fundador. Define la diferencia entre workflows y agentes y los 5 patrones básicos. Universal — léelo aunque seas usuario de Claude Code.

  • 🌐 🛠️ Anthropic Cookbook — Agent Patterns · [EN] [Gratis] intermedio Implementaciones Python de los 5 patrones. Ver el concepto en código solidifica.

  • 🌐 📖 Building agents with the Claude Agent SDK — Anthropic Engineering · [EN] [Gratis] intermedio Continuación práctica. Bueno para entender que Claude Code (producto) y Claude Agent SDK (biblioteca) son cosas diferentes — distinción que aparecerá a lo largo del plan.

Comparativos rápidos (para skim, no lectura lineal)​

Específico Claude Code​

Ejercicio práctico​

En una página única (markdown o Notion), responde:

  1. ¿En cuál de las 4 categorías de agentes encaja Claude Code? Cita una alternativa en cada otra categoría.
  2. ¿Qué 3 fortalezas de Claude Code te atraen más para tu contexto?
  3. ¿En qué escenario de tu trabajo actual imaginas Claude Code agregando más valor en las próximas semanas?

Este documento corto será tu referencia cuando alguien pregunte "¿por qué elegiste Claude Code?".

Definition of Done​

  • Puedes, en 2 minutos sin consultar nada, responder:
    • Qué es un workflow agentic y en qué difiere de un agente
    • Las 4 categorías de agentes de código y un ejemplo de cada una
    • 3 razones por las que Claude Code tiene sentido para ti

M2 · Instalación, autenticación y primeros pasos en Claude Code

Por qué este módulo​

Este es el módulo donde realmente entras en la herramienta. Resolver el setup una vez bien, con CLAUDE.md configurado y gestión segura de claves, evita fricción por meses.

Tópicos​

Instalación y autenticación​

  • Prerrequisitos: Node.js 20+, terminal moderno (zsh/fish/bash)
  • Instalación vía npm install -g @anthropic-ai/claude-code
  • Dos formas de autenticar:
    • Vía Anthropic Console (API key — pago por uso, más flexible)
    • Vía Claude.ai subscription (Pro/Max — usa cuota del plan)
  • Comandos básicos: claude, /help, /login, /logout, /exit

Modos de operación​

  • Modo interactivo (predeterminado) — conversación estilo REPL
  • Modo plan — Claude presenta un plan antes de ejecutar (Shift+Tab para alternar)
  • Modo headless (-p o --print) — ejecución no interactiva, base para automatización

Primera interacción real​

  • Iniciar Claude Code dentro de un repositorio tuyo
  • Pedir una exploración inicial ("explica este proyecto")
  • Pedir una pequeña edición
  • Diferencia entre confirmar acciones con permiso y usar auto-accept

Estructura inicial de proyecto​

  • Archivo CLAUDE.md — instrucciones persistentes para Claude en el contexto del proyecto
  • Ubicación: raíz del repo (project memory) o ~/.claude/CLAUDE.md (user memory)
  • Memoria jerárquica y cómo Claude lee estos archivos

Integración con IDE​

  • Plugin oficial para VS Code
  • Plugin oficial para JetBrains (IntelliJ, PyCharm, etc.)
  • Cuándo usar plugin de IDE vs. terminal puro

Gestión segura de claves de API​

  • macOS Keychain
  • 1Password CLI (op)
  • direnv + .envrc que NO entra en Git
  • Buenas prácticas para equipos (variables en Anthropic Console)

Materiales​

Quickstarts oficiales ⭐​

Cursos guiados ⭐​

  • ⭐ 🎓 Claude Code: A Highly Agentic Coding Assistant — DeepLearning.AI · [EN] [Gratis] principiante Curso oficial Anthropic + Andrew Ng (Elie Schoppik instructor). ~2h. Cubre: instalación, primeros prompts, planning, thinking modes, sesiones paralelas, memoria, integración con GitHub, subagentes, Playwright vía MCP. Haz este curso completo durante esta fase — te tira para adelante.

  • ⭐ 🎓 Claude Code in Action — Anthropic Skilljar · [EN] [Gratis] principiante Curso oficial de Anthropic Academy. Complementario al de DeepLearning.AI, con foco más hands-on.

  • 🎓 Anthropic Academy — catálogo · [EN] [Gratis] Mira lo disponible — varios cursos cortos serán usados en las fases siguientes.

En portugués ⭐​

Videos cortos / referencia​

Ejercicio práctico​

Configura en tu computadora:

  1. Claude Code instalado y autenticado — claude --version debe retornar versión válida
  2. Plugin de IDE configurado (VS Code o JetBrains) — Claude corriendo junto al código
  3. Primera sesión real: abre Claude Code en un proyecto existente, pide explica la arquitectura de este proyecto, y lee la respuesta
  4. Crea un CLAUDE.md en el proyecto con:
    • Lenguajes y frameworks usados
    • Convenciones del equipo (estilo de commit, patrones de test)
    • Comandos importantes (build, test, lint)
    • Lo que Claude NO debe hacer (ej: nunca alterar migrations/, nunca tocar secrets/)
  5. Haz una edición real con Claude Code (una función pequeña, mejorar un test, ajustar README)
  6. Prueba el modo plan (Shift+Tab) en una tarea de complejidad media y observa la diferencia
  7. Tus claves de API están en lugar seguro (macOS Keychain, 1Password o direnv con .envrc en .gitignore)
  8. Documenta los pasos de tu setup en un README personal mi-setup-claude-code.md

Definition of Done​

  • claude --version retorna versión válida
  • Puedes abrir Claude Code en un proyecto y pedir una edición que ejecuta correctamente
  • Tienes CLAUDE.md configurado en al menos 1 proyecto tuyo
  • Sabes alternar entre modo interactivo y modo plan
  • Sabes cuánto estás gastando por día (Anthropic Console o plan)
  • Tus claves de API no están en archivos versionados

M3 · Ingeniería de prompts y context engineering con Claude

Por qué este módulo​

Claude Code es tan bueno como el contexto que recibe. La mayor diferencia entre devs que ganan 5x productividad y devs que dicen "estos agentes son medio bobos" está aquí.

Atención al término: en 2025/2026 la comunidad migró de "prompt engineering" a "context engineering" — porque lo que importa no es el prompt aislado, sino todo el contexto (instrucciones, ejemplos, herramientas, memoria, CLAUDE.md, MCP servers) que el agente recibe. Vamos a cubrir ambos lados.

🌐 Los conceptos de este módulo son universales — funcionan en Claude, GPT, Gemini, Cursor, Aider. La diferencia está en cómo materializas el contexto en cada herramienta.

Tópicos​

Universales (cualquier LLM/agente) 🌐​

  • Anatomía de un buen prompt: rol, contexto, restricciones, ejemplos, formato esperado, criterio de aceptación
  • Chain-of-thought aplicado a tareas de programación (y cuándo NO usar)
  • Few-shot prompting con ejemplos de código
  • Iteración: follow-ups, correcciones, refinamiento
  • Anti-patrones comunes: prompts vagos, falta de criterio de aceptación, "hazlo mejor", scope-creep

Específicos de Claude​

  • XML tags — Claude responde particularmente bien a <contexto>, <ejemplo>, <reglas>
  • Thinking modes del Claude Code (think, think hard, think harder, ultrathink) y cuándo activar
  • Extended thinking — cuando el modelo "piensa" antes de responder

Context engineering específico de Claude Code​

  • CLAUDE.md como contexto persistente (project memory)
  • Cómo adjuntar archivos al contexto de la sesión
  • Cuándo pedir a Claude leer primero vs. asumir que sabe
  • Señales de que el contexto está saturado (y qué hacer)

Materiales​

Documentación oficial ⭐​

Cursos gratuitos ⭐​

Cursos pagos (opcional)​

Artículos / context engineering ⭐​

Libros (opcional, intermedio)​

  • 🌐 📖 Prompt Engineering for Generative AI — O'Reilly (Phoenix & Taylor) · [EN] [Pago] intermedio

  • ⭐ 🌐 📖 AI Engineering — Chip Huyen, O'Reilly · [EN] [Pago] intermedio a avanzado Libro de referencia más amplio sobre ingeniería en torno a LLMs. Capítulos sobre prompts y context son excelentes. Inversión que vale para los próximos años.

Ejercicio práctico​

Toma una tarea de código de complejidad media de tu trabajo real (refactorizar una función, escribir tests para un módulo, debuggear un bug no trivial). Haz tres versiones del mismo prompt en Claude Code:

  1. Versión "perezosa": "ayuda aquí" + abre el archivo
  2. Versión estructurada: con rol, contexto, restricciones, formato (usa XML tags de Claude: <contexto>, <reglas>, <formato>)
  3. Versión estructurada con CLAUDE.md mejorado: versión 2 + actualiza el CLAUDE.md del proyecto con convenciones relevantes antes

Compara las tres salidas. Documenta las diferencias en learnings-prompt.md. Es el ejercicio más valioso de toda la fase.

Bonus: corre la misma versión 3 con claude --think hard y compara con la salida sin thinking extendido.

Definition of Done​

  • Tienes un template personal de prompt para 3 tareas que haces toda semana
  • Sabes cuándo usar chain-of-thought / thinking modes y cuándo NO usar
  • Puedes identificar y corregir un prompt vago en 1 minuto
  • Tienes CLAUDE.md rico en al menos 1 proyecto tuyo

M4 · Primeros workflows hands-on con Claude Code

Por qué este módulo​

Conocimiento sin práctica se evapora en 2 semanas. Este módulo es donde consolidas todo de la Fase 1 en un proyecto pequeño, real y tuyo — que se va a convertir en referencia para el resto del plan.

Tópicos​

  • Iniciar un proyecto desde cero usando Claude Code como pair programmer
  • Refactorizar un trozo de código existente tuyo con Claude Code
  • Agregar tests a un módulo sin tests
  • Usar modo plan antes de ejecutar tareas grandes
  • Versionar todo en Git y documentar el proceso
  • Aprender a dar feedback a Claude (corregir, refinar, replanear)

Materiales​

Prácticos ⭐​

Inspiración / casos reales​

Proyecto de la Fase 1 (entregable)​

Construye un pequeño proyecto personal y original (no copies de tutorial) usando Claude Code como pair programmer principal. Sugerencias:

  • CLI simple en Python o Node.js que haga algo útil para ti (ej: organizador de PDFs por tema, contador de horas trabajadas, generador de changelog)
  • Pequeña API REST con 3 endpoints y tests
  • Script de migración o ETL de algún dato tuyo
  • Pequeña herramienta interna (ej: generador de slides desde markdown)

Requisitos del entregable​

  • Repositorio público en GitHub con README
  • CLAUDE.md completo en la raíz, describiendo: contexto del proyecto, convenciones, comandos, restricciones
  • Al menos un uso documentado de modo plan (screenshot o copia de la sesión)
  • Cobertura de tests mínima (≥60%)
  • Historial Git limpio con mensajes semánticos (pueden ser generados por Claude Code)
  • Un archivo LEARNINGS.md documentando:
    • 3 prompts que funcionaron bien (con la salida de Claude)
    • 1 prompt que falló y cómo lo corregiste
    • Lo que aprendiste sobre Claude Code que no estaba en ningún tutorial

Tiempo estimado: 6–10h a lo largo de la última semana de la fase.

Definition of Done​

  • Proyecto público en GitHub
  • CLAUDE.md configurado y útil
  • LEARNINGS.md con 5+ observaciones concretas
  • Puedes, en una reunión de 5 minutos, explicar a otro dev cómo Claude Code te ayudó en este proyecto y qué NO logró hacer

Auto-evaluación al final de la Fase 1

Marca ✅ lo que puedes hacer ahora sin ayuda:

  • Explicar la diferencia entre LLM, copiloto y agente autónomo
  • Citar las 4 categorías de agentes de código y dónde encaja Claude Code
  • Justificar la elección de Claude Code en 2 minutos
  • Instalar y autenticar Claude Code desde cero en una máquina nueva
  • Configurar CLAUDE.md rico en un proyecto
  • Alternar entre modo interactivo y modo plan
  • Escribir un prompt estructurado (rol, contexto, restricciones, formato) usando XML tags
  • Identificar cuándo NO usar Claude Code (o activar thinking mode)
  • Apuntar 3 anti-patrones comunes en prompts de código
  • Explicar el paper Building Effective Agents de Anthropic en 2 minutos

Si marcaste 7+ items, estás listo para la Fase 2. Si marcaste menos de 6, considera rehacer el módulo correspondiente antes de avanzar — la Fase 2 asume estos fundamentos.

Próxima fase​

Fase 2 — Fluidez: usando Claude Code en el día a día (4 semanas) cubre los módulos M5 a M11: automatización de tareas, spec-driven development con Claude Code, TDD, Git/PR/code review, debugging, documentación automatizada y codebases grandes.