06 · Claude Code Pro (course B1)

06 — Course B1: Claude Code Pro: Lo que no sabías

Versión: 0.1 Última actualización: 2026-04-23 Status: 🟡 Outlined — ready para escritura de lessons Course code: B1 Lane: Builder Beta learner: Luis/Chombi (huerta.luisandres@gmail.com)

Overview

Target learner

1-3 meses usando Claude Code
Construye proyectos reales con intuición, no de forma sistemática
Sabe que hay features que no usa pero no identifica cuáles
Quiere productividad 2-3× sin cambiar de herramienta principal

Prerequisites (hard)

Claude Code CLI instalado y en uso diario
Subscripción Max o Pro (para no chocar con rate limits en los ejercicios)
Familiaridad básica con shell/terminal (bash, zsh)
Un proyecto real en progreso (p.ej., Sistemia, Plania, Chombi — cualquiera) para aplicar lo aprendido

Prerequisites (soft)

Haber completado B0. ¿Qué es un agente? (Bridge) — recomendado pero no obligatorio

Duración

2-3 semanas — 10 lessons + capstone

Lessons: 10 × (15 min audio + 20-45 min exercise) = ~6-8 horas de study activo
Capstone: 4-8 horas (depende de alcance del refactor)
Total commitment: ~10-16 horas spread en 15-21 días calendario

Outcome — qué sabrás/podrás hacer

Al terminar:

Mapa mental completo de las capacidades de Claude Code (y consciencia de gaps personales)
CLAUDE.md hierarchy bien diseñada para cualquier proyecto tuyo
Settings.json custom a los 3 niveles (global, project, local) con permisos inteligentes
Al menos 1 skill propio funcional y usado regularmente
Plan mode vs default usados con criterio — no default siempre
Memory system ordenado (auto-memory + /memory) + estrategia personal de /clear
Subagents entendidos: cuándo sí, cuándo no, costos, patterns
MCPs instalados y usándose con naturalidad en workflow
Hooks para automatización invisible (ej: auto-format, auto-test)
Unattended automation con OAuth tokens + budget caps + launchd/cron

Artefacto principal

Uno de tus proyectos reales refactoreado y optimizado con TODO lo aprendido (capstone).

Micro-certificate

“Claude Code Pro — Complete” — PDF firmado con links a tus artefactos por lesson + capstone.

Paths que este course desbloquea

Path B-I (Claude Code Engineer) — junto con B3 y B4
Path B-II, B-III — cascading

Estructura del course

🏁 Semana 1 — Personalización profunda (4 lessons)

Lesson 1 — El ecosystem completo de Claude Code

Objetivo: Entender el alcance completo de Claude Code y hacer gap analysis personal
Contenido:
- Mapa de features: CLI flags, settings, skills, hooks, MCPs, subagents, memory, plan mode, remote control, SDKs, extensions
- Anatomía de un session: proceso, contexto, tools disponibles, auth flow
- Los features que la mayoría no usa: skills, hooks, plan mode, subagents, custom MCPs
- El diagnóstico: ¿qué usas vs qué podrías usar?
Audio formato: Diálogo Maestro + Chombi
Exercise: Checklist self-assessment (40 items). Marca qué usas hoy. Identifica tus 5 gaps más grandes.
Quiz topics: 5 preguntas sobre estructura del ecosystem
Sources:
- docs.claude.com/en/docs/claude-code (official)
- GitHub releases de @anthropic-ai/claude-code
- CLAUDE.md del proyecto academia-agentes (dogfooding)
Artefacto: checklist-personal-gaps.md commiteado a tu proyecto

Lesson 2 — CLAUDE.md: el arte del contexto

Objetivo: Diseñar CLAUDE.md hierarchy óptima
Contenido:
- Los 3 niveles: ~/CLAUDE.md (global/user), ~/project/CLAUDE.md (project), ~/project/subdir/CLAUDE.md (local)
- Qué pertenece a cada nivel (anti-patterns: todo en global, nada en project)
- Cómo Claude resuelve conflictos entre niveles
- CLAUDE.md vs Skills: cuándo cada uno
- Longitud óptima, tone, estructura — evita bloat
Audio formato: Maestro + Chombi + ejemplo live con proyecto real
Exercise: Auditar uno de tus CLAUDE.md existentes. Identifica 3 mejoras. Implementa.
Quiz topics: Jerarquía, resolución de conflictos, anti-patterns
Sources:
- docs.claude.com/en/docs/claude-code/memory
- Ejemplos reales: tu propio /Users/chombi/CLAUDE.md, el de familia-bot, el de sistemia
Artefacto: CLAUDE.md optimizado commiteado

Lesson 3 — Settings.json: 3 niveles de control

Objetivo: Dominar configuración en los 3 niveles
Contenido:
- Global ~/.claude/settings.json — defaults personales
- Project .claude/settings.json — checked in al repo
- Local .claude/settings.local.json — gitignored, personal por máquina
- Permissions: allowlist, denylist, bash permissions específicas
- Env vars por nivel (ANTHROPIC_API_KEY, OAuth tokens, custom ones)
- Hooks configuration (intro, detalle viene en lesson 9)
- Model selection por proyecto
Audio formato: Maestro + Chombi con ejemplos
Exercise: Configurar .claude/settings.json para uno de tus proyectos reales con permisos inteligentes (evita prompts repetitivos que sabemos que son safe)
Quiz topics: Jerarquía, permissions syntax, cuándo qué nivel
Sources:
- docs.claude.com/en/docs/claude-code/settings
- Tu propio ~/.claude/settings.json actual (dogfood comparison)
Artefacto: settings.json tuyo mejorado

Lesson 4 — Skills: tu Claude personalizado

Objetivo: Escribir tu primer skill propio
Contenido:
- Anatomy de un skill: frontmatter, cuándo trigger, qué hace
- Ubicación: ~/.claude/skills/ vs .claude/skills/ (project)
- Tipos: task-specific, workflow, meta-skills
- Cuándo crear skill vs poner en CLAUDE.md vs poner en slash command
- Ejemplos famosos: /init, /review, /security-review
- Anatomy de un buen skill prompt
- Debugging: cuándo tu skill no se dispara (auto-trigger vs user-invoke)
Audio formato: Maestro + Chombi con ejemplo live
Exercise: Escribir 1 skill propio para un workflow que haces seguido (ej: “deploy-plania”, “check-sistemia-status”, “generate-podcast-lunes”)
Quiz topics: Frontmatter, trigger patterns, skill vs CLAUDE.md
Sources:
- docs.claude.com/en/docs/claude-code/skills
- Skills builtin (inspección del folder .claude/skills/ en tu sistema)
Artefacto: 1+ skill propio funcional en .claude/skills/

⚡ Semana 2 — Workflow avanzado (4 lessons)

Lesson 5 — Plan mode vs default: cuándo cada uno

Objetivo: Usar plan mode con criterio, no default siempre
Contenido:
- Qué hace plan mode internamente (ExitPlanMode flow)
- Cuándo plan mode es la jugada: tareas complejas, contexto grande, cambios no-triviales
- Cuándo default es la jugada: tareas claras, rapidez, bug fixes pequeños
- El anti-pattern: “solo default porque plan mode me hace esperar”
- Plan mode + re-plan: cuándo interrumpir el plan
- Cómo medir: ¿terminas usando más tokens con plan o sin plan en promedio?
Audio formato: Maestro + Chombi con comparación
Exercise: Clasificar 10 tipos de tareas que haces en tu día a día. Decidir regla personal: qué va en plan, qué va en default.
Quiz topics: Cuándo plan, cuándo default, pitfalls
Sources:
- docs.claude.com/en/docs/claude-code/plan-mode
- Tu historial de sessions (análisis propio)
Artefacto: Regla personal documentada en tu ~/CLAUDE.md

Lesson 6 — Memory y continuidad

Objetivo: Sistema de memoria que conecta tus sesiones
Contenido:
- Auto-memory: cómo funciona, dónde vive, qué guarda automáticamente
- /memory command: uso manual
- MEMORY.md como índice, memorias individuales como files
- Cuándo /clear, cuándo /compact, cuándo continuar
- Context pollution: señales que te dicen que necesitas /clear
- Plan mode + memory: persistencia de planes largos
Audio formato: Maestro + Chombi con reflexión sobre tu sistema actual
Exercise: Auditar tu ~/.claude/projects/.../memory/ actual. Consolidar duplicates. Expandir memorias útiles.
Quiz topics: Auto-memory behavior, clear vs compact, MEMORY.md structure
Sources:
- docs.claude.com/en/docs/claude-code/memory
- Tu propio MEMORY.md (dogfood review)
Artefacto: MEMORY.md reorganizado + estrategia personal documentada

Lesson 7 — Subagents: el superpoder de paralelizar

Objetivo: Usar subagents con criterio, no romper el wallet
Contenido:
- Task tool anatomy: subagent_type, prompt, isolation
- Available subagent types: general-purpose, Explore, Plan, statusline-setup
- Parallel vs sequential: when to fan out
- Cost implications: cada subagent = nueva session = tokens propios
- Context isolation: qué ve el subagent, qué no
- Patterns comunes:
  - Research fan-out (3-5 parallel explorers)
  - Code review (explorers + synthesizer)
  - Bulk file edits (prefer NOT subagents, prefer batched edits)
- Anti-patterns:
  - Spawn subagent para task trivial (waste)
  - Spawn 20 subagents (runaway cost — referencia al incidente del 2026-04-21)
Audio formato: Maestro + Chombi con caso real
Exercise: Taxonomía: 10 tipos de tareas, clasificar sí-spawn vs no-spawn. Probar subagent real para 1 tarea.
Quiz topics: When to spawn, patterns, cost awareness
Sources:
- docs.claude.com/en/docs/claude-code/subagents
- Case study: el runaway incident de Luis (anonymized) — el anti-example real
Artefacto: Taxonomía personal documentada + 1 subagent task real

Lesson 8 — MCP connectors: multiplica tu alcance

Objetivo: Usar MCPs existentes con fluidez
Contenido:
- /mcp command: listar, agregar, quitar
- MCP servers populares: filesystem, postgres, puppeteer, GitHub, Notion, Slack, Linear
- Cómo elegir MCPs útiles para tu workflow
- Scope: global vs project-specific MCPs
- Debugging: cuando un MCP no responde
- Security: qué permisos das, qué no
- (Construir tu MCP propio = B3. Aquí solo consumes.)
Audio formato: Maestro + Chombi + demo
Exercise: Instalar 2-3 MCPs útiles para ti. Usarlos en una tarea real de tu proyecto.
Quiz topics: Listing, adding, debugging, security
Sources:
- docs.claude.com/en/docs/claude-code/mcp
- modelcontextprotocol.io
- Community list: github.com/modelcontextprotocol/servers
Artefacto: 2+ MCPs instalados + ejemplo de uso commiteado

🤖 Semana 3 — Automation y production-minded (2 lessons + capstone)

Lesson 9 — Hooks: automatización invisible

Objetivo: Instalar hooks útiles y entender cuándo son peligrosos
Contenido:
- Hooks en settings.json: pre-tool-use, post-tool-use, user-prompt-submit, agent-stop
- Anatomy: matcher, command, timeout, conditions
- Ejemplos útiles:
  - Auto-format después de edit (prettier, black)
  - Auto-test después de file change
  - Notification on agent-stop
  - Lint check on user-prompt-submit
- Anti-patterns:
  - Hooks que bloquean flow
  - Hooks con side effects destructivos
  - Hooks infinitos (loops)
- Debugging hooks que fallan silencioso
Audio formato: Maestro + Chombi con ejemplo live
Exercise: Instalar 1 hook útil (auto-format o auto-test) + 1 hook de notification
Quiz topics: Hook types, config syntax, pitfalls
Sources:
- docs.claude.com/en/docs/claude-code/hooks
- Ejemplos comunes en GitHub
Artefacto: settings.json con 1-2 hooks funcionales

Lesson 10 — Unattended: OAuth + cron + budgets

Objetivo: Correr Claude Code como automatización con safety nets
Contenido:
- claude setup-token flow: OAuth token para contextos unattended
- CLAUDE_CODE_OAUTH_TOKEN env var
- claude -p (print mode): el modo para automation
- --max-budget-usd flag: safety net si auth fallara a API
- launchd patterns (macOS) / cron patterns (Linux)
- Log capture + error handling
- Case study real: el podcast pipeline de Luis (dogfood)
- Lessons from the runaway incident: por qué importa
Audio formato: Maestro + Chombi con walk-through del pipeline real
Exercise: Armar 1 automatización tuya (podcast, deploy, check, whatever) con OAuth + budget cap
Quiz topics: OAuth flow, —print mode, budget safety
Sources:
- docs.claude.com/en/docs/claude-code/unattended
- Tu propio com.chombi.guerra-de-tokens.plist y generate_episode.sh (dogfood)
Artefacto: 1 automatización tuya en launchd/cron con OAuth + safety net

🏆 Capstone (3-5 días)

Trabaja EN BASE a uno de tus proyectos reales, sin modificar el proyecto mismo.

El capstone se construye como satellite del proyecto elegido:

NO se toca el código/config actual del proyecto en producción
SÍ se usa el proyecto como contexto, referencia, y destino de los artefactos
El entregable vive en un nuevo repo/folder companion o en un branch aislado que nunca se mergea a main

Esto te permite practicar sin riesgo a breakings en sistemas que ya funcionan.

Pick a project como base de contexto

Elige UNO para usar como referencia (no tocar):

Sistemia
Chombi (familia-bot)
Plania Pro
Guerra de Tokens / Academia Agentes
Cualquier otro side project propio

Approach options (pick one)

Option A — Companion toolkit Crear un nuevo repo ~/{project}-toolkit/ con artefactos que “apuntan a” el proyecto base sin modificarlo. Ejemplo: sistemia-toolkit/ con skills, hooks, MCPs, CLAUDE.md optimizada que asume el contexto de sistemia pero no vive dentro.

Option B — Isolated branch de experimentación Branch nuevo (ej: claude-code-pro-capstone) en el repo del proyecto base. Aplicas todo en el branch. Nunca mergeas. Al terminar, haces archive del branch para referencia futura.

Option C — Fork exploratorio Fork del proyecto en nuevo repo ({project}-lab). Mismo proyecto clonado pero dedicado solo a experimentación. El original no se toca.

Apply

Documenta y commitea en tu capstone (A, B, o C):

CLAUDE.md optimizada para el contexto del proyecto (Lesson 2)
.claude/settings.json con permisos inteligentes (Lesson 3)
1 skill custom para workflows del proyecto (Lesson 4)
Plan mode rules documentadas (Lesson 5)
MEMORY.md con memorias relevantes al proyecto (Lesson 6)
1 subagent task real ejecutado y documentado (Lesson 7)
2+ MCPs relevantes instalados y usados (Lesson 8)
1 hook útil activo (Lesson 9)
Si aplica: 1 automatización con OAuth + budget cap (Lesson 10)

Write-up (~300-500 palabras)

Qué approach usaste (A, B, o C) y por qué
Qué feature/técnica fue el mayor win
Estimación: si APLICARAS esto al proyecto real, qué ganarías (tiempo/claridad/reducción de errores)
Qué te sorprendió
Qué partes SÍ migrarías eventualmente al proyecto real y cuáles no
Qué sigue (próximo course de path B-I es B3 MCP Servers)

Submission

Git commits en tu repo del proyecto
Link al commit(s) + write-up en Academia Agentes platform
Evaluator agent revisa vs rubrics
Manual review opcional (para confidence boost)

Assessment criteria

Completeness: ¿aplicaste al menos 7 de los 9 elementos?
Quality: ¿los artefactos son usables en día-a-día (no toy)?
Reflection: ¿el write-up muestra comprensión y no solo ejecución?
Production-ready: ¿quedaría funcionando en 3 meses sin que lo toques?

Evaluation rubric (for evaluator agent)

Per-lesson quiz

5 preguntas multiple choice
Pass: ≥4/5
Re-take: unlimited

Per-lesson exercise

Submission: link to commit or file
Evaluator checks:
- Submission exists and is non-trivial
- Applies the specific lesson concept
- Is commited/integrated (not just a gist)

Capstone

Completeness score (40%): # de elementos aplicados (min 7/9)
Quality score (30%): evaluator revisa artefactos vs rubrics específicos
Reflection score (20%): write-up cumple los 5 puntos
Production-ready score (10%): evaluator simulates “3 months later” query

Pass: ≥75% total. Below: specific feedback, re-submit allowed.

Audio production notes

Tone

Diálogo Maestro + Chombi, calibración 6/10 (ver principles doc)
Maestro: calmado, preciso, con perspectiva de producción
Chombi: curioso, auto-referencial, hace las preguntas del learner

Formats per lesson

Core audio: 15 min dialog
Extended (optional): 25 min deep dive (mismo tema, más ejemplos)
Case study (Lesson 10): formato semi-documental — el podcast pipeline real de Luis

Recurring segments

“Lo que no sabías” — revelation moment por lesson (highlight del hidden feature)
“La línea que importa” — 1 línea de código/config que resume la lesson
“El anti-pattern” — qué NOT to do

Dependencies for production

Antes de poder grabar:

Principles doc (03) aprobado — para calibrar tono
Audio formats doc (12) escrito — voces configuradas
Sources policy doc (06) — fuentes validadas por lesson
Assessment doc (07) — rubrics formalizados
Architecture doc (08) — infra de publicación lista

Open questions

¿Separar Lesson 10 en 2 (OAuth + launchd) si se vuelve muy denso?
¿Capstone auto-graded puede ser suficiente o siempre pasa por manual review?
¿Dónde viven los artefactos de cada lesson? ¿Repo propio del learner o Academia cloud?
¿Cómo se certifican ejercicios que requieren commits — GitHub OAuth para verificar?