Claude Code: guía completa desde cero (curso práctico)

Claude es hoy uno de los mejores modelos para escribir código, y tiene su propio harness oficial llamado Claude Code: una herramienta de terminal con comandos especiales, modos de trabajo, subagentes, skills, MCPs y configuraciones que la gran mayoría de desarrolladores todavía no conoce. En este artículo te resumo el curso completo, paso a paso, desde lo básico hasta un nivel intermedio, con todo lo que necesitas para crear proyectos reales.

¿Qué es Claude Code?

De forma sencilla, Claude Code es un agente de código que funciona desde la consola: le delegas una tarea y empieza a hacer modificaciones en tu proyecto mientras tú simplemente esperas. Esa terminal se puede abrir desde editores de código y otros programas, y no sirve solo para preguntar y recibir respuestas, sino para modificar código de verdad. Además funciona en Windows, Linux y Mac, e incluso tiene su propia aplicación de escritorio.

Algo importante: es una herramienta de pago. Sí o sí necesitas una suscripción, que empieza desde $20/mes. En la práctica, si vas a trabajar en proyectos reales que consumen muchos tokens, terminarás en el plan Max, pero si recién empiezas mi recomendación es arrancar con el plan básico para comprobar si realmente te sirve. Lo bueno es que una misma suscripción te permite usarlo desde la terminal, el navegador, aplicaciones móviles, VS Code, Slack y más.

Instalación

Para instalar Claude Code entras a su documentación oficial y eliges el comando según tu sistema: hay instaladores para Mac, Linux y WSL/PowerShell en Windows. Copias el comando, lo pegas en tu terminal, y al terminar ya tienes disponible el comando claude. Puedes verificar la instalación con claude --help, y para empezar a usarlo simplemente escribes claude.

Modelos y niveles de esfuerzo

Dentro de una sesión puedes elegir el modelo con el que trabajas:

• Sonnet: el modelo intermedio; suficientemente bueno para la mayoría de tareas y no tan caro.
• Opus: el que más vas a usar en el día a día (la versión disponible ahora es Opus 5).
• Fable: el más potente, pero mucho más caro; se usa cuando quieres una planificación o un análisis muy grande.
• Haiku: el más rápido de todos.

Pero no solo eliges el modelo, también puedes exigirle más o menos con el comando /effort, que muestra una barra con varios niveles:

• Low: responde muy rápido pero razona poco; no lo uses para tareas avanzadas.
• Medium / High: los valores recomendados por defecto.
• Extra High: consume muchos más tokens, pero el resultado es notablemente mejor.
• Max: además de procesar más tiempo, re-analiza sus propias respuestas antes de entregarlas.
• Ultra: combina el esfuerzo máximo con workflows, donde un solo agente se divide en múltiples sesiones que analizan el código por separado y reportan a una sesión principal.

Para la gran mayoría de personas los niveles más altos no son necesarios: son caros y con Medium/High se resuelve casi todo.

Modos de permisos: plan mode y bypass

Claude Code tiene varios modos de trabajo que cambias con Shift+Tab. El más importante para proyectos serios es el modo plan: en lugar de ejecutar directamente, Claude primero elabora una planificación que tú puedes revisar, corregir o extender ("añade también un formulario de contacto"), y solo cuando la apruebas empieza a implementar los cambios y crear archivos. La idea es que revises antes de aprobar.

En el otro extremo está el modo bypass permissions, que se activa iniciando con claude --dangerously-skip-permissions. Es uno de los que más uso porque evita que te esté preguntando a cada rato por aprobación para cada comando nuevo. Úsalo con criterio, pero para desarrollo local acelera muchísimo el flujo.

Sesiones: reanudar y renombrar

Cada conversación es una sesión que puedes retomar. Con claude --resume (o /resume dentro de una sesión) ves un listado de tus sesiones anteriores con el tiempo transcurrido desde la última vez que las abriste, y al seleccionar una recuperas exactamente donde te quedaste.

Como los nombres por defecto son aleatorios, puedes usar /rename para ponerle un nombre descriptivo (por ejemplo "landing page y UI"). Al salir, Claude te muestra el comando exacto para reanudar esa sesión por su nombre.

El contexto: el recurso más importante

Los chats tienen un límite conocido como contexto, y entenderlo es clave para trabajar bien. El comando /context te muestra de forma visual cuánto llevas consumido: cada mensaje, cada archivo leído y cada respuesta ocupan cierta cantidad de tokens, y cuando el medidor se llena el rendimiento del agente empeora. La regla práctica: sesiones enfocadas en una tarea concreta, y sesión nueva cuando cambias de tema.

Trabajar con archivos e imágenes

Para referenciar archivos específicos escribes @ y aparece un listado de los archivos del proyecto; con Tab se autocompleta. Esto le indica a Claude que quieres que trabaje sobre ese archivo o que lea su contenido antes de responder. En proyectos pequeños no hace tanta falta, pero en proyectos reales es esencial para no hacerle leer todo el repositorio.

Con imágenes hay un detalle según tu sistema: en Mac y Linux puedes copiar una imagen al portapapeles y pegarla directamente en la terminal, pero en Windows eso no funciona, así que lo mejor es guardar la imagen como archivo y arrastrarla a la ventana. Con eso puedes pasarle capturas de diseño y pedirle cosas como "cambia este texto del hero a español".

CLAUDE.md y la carpeta .claude

El archivo CLAUDE.md en la raíz del proyecto es la regla principal de tus sesiones: si no quieres explicarle a Claude en cada chat qué hace tu proyecto o cómo te gusta que responda, lo detallas ahí una sola vez.

Aparte, puedes crear la carpeta .claude con archivos de configuración del proyecto. Por ejemplo, con el comando /permissions puedes permitir, denegar o pedir confirmación para comandos específicos; al añadir una regla se genera un archivo settings dentro de .claude. Si le deniegas echo y luego se lo pides, Claude te responderá que ese comando está en la lista de denegados. Es la forma de decirle exactamente qué puede y qué no puede hacer en cada proyecto.

Skills: conocimiento reutilizable

Los skills son documentos con instrucciones y mejores prácticas que Claude carga cuando los necesita, y a día de hoy son un estándar: hay directorios enteros en internet con skills de todo tipo (control del navegador, seguridad, reducción de verbosidad para ahorrar tokens, generación de gráficos y más). Incluso creadores como Matt Pocock, que antes hacía puro contenido de TypeScript, ahora se dedica casi por completo a los skills.

Un ejemplo muy popular es el skill "impecable", enfocado en diseño: convierte un frontend genérico en algo mucho más pulido, y trae instrucciones extra para clonar el estilo de un sitio o extraer paletas de colores. Una vez instalado, lo invocas (por ejemplo mejora el diseño de todo el frontend, tanto landing como dashboard) y el skill se encarga del resto. Si un skill recién instalado no aparece, ejecuta reload skills.

Un detalle práctico del curso: si escribes tu propio skill con decisiones de stack (por ejemplo "usa Astro") pero lo añades después de arrancar la tarea, Claude no lo va a leer retroactivamente. Los skills se cargan al inicio, así que defínelos antes.

MCPs: conectar Claude con tus plataformas

Los MCPs permiten que Claude Code se conecte con servicios externos: plataformas cloud (AWS, Supabase…), bases de datos, herramientas de testing y prácticamente cualquier categoría. Hay repositorios en GitHub que los listan categorizados. Ten en cuenta que muchos requieren autenticación: si quieres que Claude manipule tu plataforma en la nube, primero necesitas una cuenta y hacer login.

Combinando skills y MCPs puedes hacer que Claude no solo escriba el código, sino que además pruebe tu sitio de forma automática.

Subagentes y agent teams: trabajo en paralelo

Cuando el proyecto crece, necesitas trabajar en paralelo. Claude Code tiene dos características para esto: subagents y agent teams, que hacen algo similar, aunque en el día a día usarás más los subagentes.

El flujo recomendado: entras en modo plan y pides una planificación grande — por ejemplo, comentarios anidados, enlaces de invitación, campana de notificaciones y publicaciones multi-usuario al estilo Medium — indicando explícitamente: "crea el plan para delegarlo en subagentes". Claude divide el trabajo en tareas independientes y lanza varios agentes en paralelo, cada uno con su parte, reportando a la sesión principal. Es la diferencia entre esperar una tarea gigante en serie o ver varias avanzar al mismo tiempo.

La extensión de VS Code y la app de escritorio

Además de la terminal, puedes instalar la extensión oficial Claude Code para VS Code (creada por Anthropic): añade un panel de chat en el editor desde donde pides cambios y navegas conversaciones anteriores, todo con el contexto del proyecto abierto.

¿Y entonces por qué usar la terminal? Porque la extensión, aunque útil, no tiene todos los comandos. Desde la terminal puedes controlar la sesión remotamente desde el móvil u otro computador, usar dictado por voz, y acceder a comandos avanzados. Además, cuando Claude Code se actualiza, la terminal es la primera en recibir los cambios.

Plugins: el ejemplo de cloud-seo

Los plugins empaquetan comandos, skills y subagentes listos para instalar, a nivel de usuario o a nivel de proyecto. En el curso instalamos uno de SEO que añade el comando /seo: le pasas la URL de tu sitio y lanza una auditoría completa con varios subagentes — revisa la escritura de artículos, el robots.txt y cualquier archivo que afecte tu posicionamiento — y al final genera un reporte HTML. El proceso puede tomar entre 10 y 20 minutos dependiendo del tamaño del sitio.

Conclusión

Empezar con Claude Code es relativamente simple, y con estas características — modelos y esfuerzo, modo plan, sesiones, contexto, CLAUDE.md, skills, MCPs, subagentes y plugins — puedes crear casi cualquier tipo de proyecto moderno. Aquí cubrimos las funcionalidades más útiles y populares, pero hay muchas más, y este curso seguirá recibiendo actualizaciones con nuevas características.

Si ya usas Claude Code y quieres probarlo desde otras interfaces, o tienes dudas de qué más se puede hacer, déjalo en los comentarios. Y si quieres asesoría personalizada sobre este u otros temas, puedes reservarla en fazt.dev.