Claude Code 101 — Resumen de estudio

Paths: Developer · Architect · FDE · 13 lecciones, 12 videos

Cómo usar Claude Code en el día a día: qué es, cómo funciona, el workflow explore → plan → code → commit, el contexto y las piezas de personalización (CLAUDE.md, subagents, Skills, MCP, hooks).

1. Qué es Claude Code

• Una herramienta agentic de programación: entiende tu codebase, edita archivos, ejecuta comandos y se conecta a tus herramientas.
• Está disponible en la terminal, VS Code, JetBrains, Claude Desktop y la web.
• Diferencia con Claude.ai: tiene acceso directo a tus archivos, la terminal y todo el código; hace el trabajo en vez de que tú copies y pegues.
• Agente: un LLM que opera en loop, con tools, servicios o incluso otros agentes, para cumplir un objetivo.
• Tres cosas a tener presentes:
  1. Context window (memoria de trabajo; busca de forma estratégica en vez de cargarlo todo).
  2. Pide permiso por defecto.
  3. Puede equivocarse: mantente involucrado.

2. Cómo funciona

• Agentic loop: prompt → reunir contexto (texto o tool calls) → actuar (editar, ejecutar) → verificar → termina o vuelve a iterar. Puedes interrumpir o redirigir en cualquier momento.
• Compactación automática al llegar al límite de contexto.
• Tools: son la base de los agentes; Claude decide cuándo llamarlas.
• Permisos: default (pide permiso para editar y ejecutar) · auto-accept (edita sin preguntar, los comandos sí piden) · plan mode (solo lectura, arma un plan). Cuidado al saltarte los permisos.

3. Instalación y superficies

• Terminal: curl en macOS/Linux/WSL; Homebrew o winget no se actualizan solos; PowerShell o CMD en Windows. Ejecuta claude en la carpeta del proyecto: tiene acceso a esa carpeta y sus subcarpetas. Inicias sesión con Pro, Max o Enterprise, o con una API key.
• VS Code: extensión de Anthropic (con la marca de verificación azul), "Claude Code: Open in New Tab".
• JetBrains: plugin del Marketplace.
• Desktop: pestaña "Code"; puede correr en segundo plano y en la nube.
• Web: claude.ai/code, solo con repositorios de GitHub.
• Las features nuevas llegan primero a la terminal.

4. Primer prompt

• Shift+Tab alterna entre approval → auto-accept → plan mode.
• Plan mode analiza en modo solo lectura, hace preguntas aclaratorias y devuelve un plan detallado. Úsalo para cambios complejos o revisiones seguras.
• Sé descriptivo en el prompt (ejemplo: un toggle de dark mode con un color de contraste según tu tema).

5. Workflow: Explore → Plan → Code → Commit

• Explore + Plan: en plan mode. Es el mejor momento para corregir el rumbo, antes de que exista código. El subagent explore sirve para resúmenes sin cambios.
• Code: aprueba el plan.
  • Define el criterio de éxito.
  • Añade tools (p. ej. Claude in Chrome para probar la interfaz).
  • Incluye una suite de tests confiable.
  • Si un problema se repite, pide que guarde la solución en CLAUDE.md.
• Commit: prueba tú mismo → subagent revisor (contexto limpio, sin el sesgo de la sesión) → mensaje de commit en tu estilo.

6. Manejo de contexto

• Todo cuenta: prompts, archivos, tool calls y sus resultados.
• /compact: resume y conserva (puede perder detalles). Úsalo cuando sigues en la misma feature y estás cerca del límite.
• /clear: borra todo. Úsalo para una feature nueva y evitar sesgo; lo persistente va en CLAUDE.md.
• /context: muestra qué ocupa el contexto.
• Para ahorrar contexto:
  • Prompts específicos (uno vago termina costando más exploración).
  • Desactiva MCP servers que no uses: cargan todas sus tools en contexto.
  • Skills cargan bajo demanda.
  • Subagents para tareas de "solo dame la respuesta".

7. Code review

• Subagent revisor de solo lectura, versionado en el repo para que todo el equipo lo use.
• /commit-push-pr: commit, push y PR en un paso (y con un MCP de Slack, publica el enlace).
• claude --from-pr <N>: retoma la sesión ligada a ese PR.

8. CLAUDE.md

• Archivo Markdown en la raíz que se lee automáticamente al inicio de cada sesión (se añade al prompt). Es como un onboarding de tu codebase: stack, comandos, estilo.
• Jerarquía: el de proyecto (en el repo, compartido) y el de usuario (tu carpeta de configuración, aplica a todos tus proyectos).
• Tips:
  • Pide que guarde las correcciones repetidas.
  • Referencia docs con @README.md.
  • Empieza sin CLAUDE.md para ver qué corriges una y otra vez y mantenerlo compacto; luego usa /init.

9. Subagents

• Contexto aislado, corren en paralelo y devuelven solo un resumen.
• Crea uno con /agents → "Create new agent" (alcance, propósito, tools, color). Son Markdown con frontmatter YAML.
• Memoria persistente opcional.
• Precargar Skills con la clave skills (en un subagent el Skill se carga completo).

10. Skills (lección en video)

• Un archivo SKILL.md que enseña a Claude a hacer algo una vez, y Claude lo aplica automáticamente cuando es relevante.
• La descripción decide cuándo se activa (Claude compara tu petición con las descripciones).
• Dónde viven: personales en ~/.claude/skills (te siguen a todos los proyectos) · de proyecto en .claude/skills del repo (estándares del equipo).
• Diferencias: CLAUDE.md se carga siempre; un Skill carga solo el nombre y la descripción, y el resto bajo demanda; un slash command hay que escribirlo, un Skill no.
• "Si le explicas lo mismo a Claude una y otra vez, ahí hay un Skill esperando a escribirse."

11. MCP

• Estándar abierto para conectar tools y datos externos (Linear, Context7 para docs, conectores en claude.com/connectors).
• Se añade con claude mcp add: HTTP (remoto) o stdio (local). Se gestiona con /mcp.
• Scopes: local (este proyecto, solo tú) · user (todos tus proyectos) · project (.mcp.json versionado, para todo el equipo).
• Costo de contexto: las definiciones de tools ocupan contexto aunque no se usen.
  • Si existe una CLI (gh, aws), es más eficiente.
  • Considera un Skill.
  • Si las tools de MCP pasan del 10% del contexto, Claude Code activa tool search (descubre las tools bajo demanda).

12. Hooks

• Deterministas: siempre se ejecutan, a diferencia de una instrucción en CLAUDE.md.
• Usos: formatear al editar, registrar comandos para compliance, bloquear operaciones peligrosas, notificar al terminar.
• Eventos: PreToolUse · PostToolUse · UserPromptSubmit · Stop · Notification. Se configuran con /hooks o en settings.json (evento + matcher + comando).
• Ejemplo: PostToolUse con el matcher Edit|MultiEdit|Write que corre el formateador según la extensión.
• PreToolUse puede bloquear: recibe la tool y su input como JSON por stdin.
  • exit 0 = continúa.
  • exit 2 = bloquea, y stderr vuelve a Claude como feedback.
  • Otro código = error no bloqueante.
• Los de proyecto van en .claude/settings.json (versionados). Usa CLAUDE_PROJECT_DIR para las rutas de scripts.
• "Si algo debe pasar siempre, no lo pongas en un prompt: ponlo en un hook."

Quiz (tus respuestas, 100%)

1. ¿Qué es un agente? → IA que actúa para cumplir objetivos.
2. ¿Qué pasa al llegar al límite de contexto? → Compacta la conversación automáticamente.
3. ¿Workflow recomendado? → Explore → Plan → Code → Commit.
4. ¿Cómo usa CLAUDE.md? → Lo lee automáticamente al inicio de cada sesión.