La guía completa para empezar con Claude Code sin terminar con un proyecto roto. Tres conceptos clave, comandos exactos y los errores que casi todos cometen al principio.
Claude Code no es el chat de Claude que ya conoces. Es Claude metido en tu computador, viviendo en la terminal, ayudándote a construir proyectos reales: aplicaciones, sitios web, automatizaciones, lo que se te ocurra.
La diferencia con el Claude normal es que aquí Claude tiene acceso a tus archivos, puede crearlos, modificarlos, ejecutar comandos, abrir un navegador para probar lo que construyó. Es como tener un programador junior que nunca duerme y que sigue tus instrucciones al pie de la letra.
Antes de instalar nada, necesitas dos cosas listas: una cuenta paga de Claude (Pro, Max, Team o Enterprise) y Node.js instalado en tu computador.
Si no lo tienes, ve a nodejs.org y descarga la versión LTS (la verde recomendada). Le das siguiente, siguiente, instalar. Listo.
En Mac: aprietas Cmd + Espacio, escribes "Terminal" y le das enter. En Windows: buscas "Terminal" o "PowerShell" en el menú de inicio.
En la terminal, escribes este comando y le das enter:
Te vas a la carpeta de tu proyecto, o creas una nueva. Una vez ahí, escribes:
La primera vez te va a pedir iniciar sesión con tu cuenta de Anthropic. Le dices que sí y listo, ya estás dentro.
Esto es lo más importante de toda la guía. Si te saltas este paso, Claude Code va a adivinar todo y los resultados van a ser mediocres. Si lo haces bien, Claude Code va a sentir que tiene años trabajando contigo.
CLAUDE.md es un archivo de texto que vive en la raíz de tu proyecto. Ahí tú le explicas a Claude Code quién eres, qué estás construyendo, cuáles son las reglas que tiene que seguir, qué herramientas usas, qué nunca debe hacer.
Piénsalo como cuando llega alguien nuevo a tu equipo. Antes de soltarle el trabajo, le das contexto. Eso mismo haces aquí.
Dentro de Claude Code escribe esto:
Claude Code va a analizar tu proyecto y te va a generar un CLAUDE.md inicial automáticamente. Después tú lo editas para ajustarlo a ti.
Esto es lo que separa a quien usa Claude Code bien de quien termina con un proyecto roto. Te lo digo en serio porque a mí me pasó.
Le pides a Claude Code "haz X" y él lo hace de una. Toca tus archivos, modifica código, ejecuta cambios. Y si el plan que tenía en la cabeza no era el correcto, te quedas con un desastre que toca deshacer.
Antes de mandarle el prompt, aprietas Shift + Tab dos veces. Vas a ver que en la parte de abajo de la terminal aparece "plan mode on".
Ahora le mandas tu instrucción y Claude Code, en vez de ejecutar, te va a presentar un plan numerado con todo lo que va a hacer. Tú lo lees, lo ajustas, le pides cambios si quieres, y solo cuando estás de acuerdo le das luz verde.
Mi favorito. Las skills son instrucciones que Claude Code activa solo cuando las necesita. Es como tener varios asistentes especializados en uno.
Una skill es una carpeta con un archivo SKILL.md adentro. En ese archivo le explicas a Claude Code: cuándo activar esta skill, qué hacer cuando se active, qué reglas seguir, qué archivos consultar.
Lo mágico es que Claude Code activa la skill correcta automáticamente según lo que tú pidas. Tú no le dices "usa la skill X". Tú le dices "hazme un carrusel sobre la guerra fría" y él solo identifica que debe usar tu skill de carruseles históricos.
Cuando le pido a Claude Code "hazme un carrusel sobre Palestina", él activa investigadora-lala primero, después mi-voz-lala, después carrusel-actualidad, y al final diseno-lala. Todo solo, sin yo decirle nada.
La forma más fácil es pedírselo a Claude Code:
Claude Code va a generar la carpeta, el SKILL.md y todo lo que necesite. Tú la revisas y ya queda activa para siempre.
| Error | Qué hacer en cambio |
|---|---|
| No crear CLAUDE.md | Crearlo siempre antes de pedir nada |
| Pedir cambios grandes sin modo plan | Activar plan con Shift+Tab dos veces |
| Probar en proyectos importantes | Practicar primero en una carpeta vacía |
| No revisar lo que Claude propone | Leer cada plan antes de aprobarlo |
| Repetir el contexto en cada chat | Meter el contexto fijo en CLAUDE.md |
Si llegaste hasta aquí, ya sabes más de Claude Code que el 90% de la gente que está hablando del tema en redes. Ahora viene lo importante: practicar.
Mi recomendación: dedícale 30 minutos esta semana a crear un proyecto chiquito. Una página simple, un script para organizar archivos, lo que sea. Lo importante es que pongas las manos en el teclado.
Anthropic acaba de meter Claude directo dentro de Excel, PowerPoint y Word. Esta es la guía paso a paso para instalarlo y empezar a usarlo desde hoy, con casos de uso reales.
Leer guíaResumen en español de la charla oficial de Boris Cherny, el creador de Claude Code en Anthropic. Comandos exactos, los 6 tips clave, y mis notas personales después de verla tres veces.
Leer guíaNotion, Typeform, Calendly y Loom construidos con Claude Code en una sola tarde. Cuatro prompts listos para copiar y pegar, $744 al año de ahorro en SaaS.
Leer guía