¿Has oído hablar de Claude Code y quieres saber cómo empezar de verdad? Estás en el lugar correcto. Este tutorial te acompaña desde la instalación hasta tu primer proyecto que funciona, sin asumir nada sobre tus conocimientos técnicos.

Al final de esta guía, habrás instalado Claude Code, lanzado tu primera sesión, entendido los comandos esenciales y creado un pequeño proyecto que puedes mostrar. Todo paso a paso, en español.

¿Qué es Claude Code?

Claude Code es una herramienta de asistencia al desarrollo creada por Anthropic, la empresa detrás de la IA Claude. A diferencia de un simple chatbot, puede tocar realmente tus archivos: crear código, modificarlo, ejecutar comandos, probar e incluso desplegar.

En la práctica, lanzas Claude Code en una carpeta, le explicas qué quieres (en español, en frases normales) y se pone a trabajar. Ves los archivos aparecer, validas, pides ajustes. Es un compañero de equipo más que una herramienta.

Lo que lo hace único comparado con competidores como Cursor o GitHub Copilot:

  • Ejecuta acciones reales en tu entorno (no solo sugerencias).
  • Entiende proyectos completos, no solo la línea que estás escribiendo.
  • Tiene un modo "plan" que te propone un plan antes de codificar.
  • Habla español perfecto y se adapta a tu nivel.

Instala Claude Code en 5 minutos

La instalación de Claude Code es simple y funciona en Mac, Windows y Linux.

Paso 1 — Crea o inicia sesión en tu cuenta Claude

Ve a claude.ai y crea una cuenta si no tienes una. Se necesita una suscripción Claude Pro (alrededor de 20 euros al mes) para usar Claude Code cómodamente. Los estudiantes pueden acceder a tarifas reducidas a través de ciertos programas.

Paso 2 — Descarga Claude Code

Ve a claude.ai/code. Verás un botón "Descargar Claude Code". Elige tu plataforma (macOS, Windows, Linux). El archivo pesa unos 50 MB y el instalador está firmado oficialmente por Anthropic.

En macOS, Claude Code se instala como una app normal en la carpeta Aplicaciones. En Windows, un instalador clásico te guía. En Linux, usas un paquete deb o rpm según tu distribución.

Paso 3 — Lanza tu primera sesión

Abre una terminal (Terminal en Mac, PowerShell en Windows), ve a la carpeta donde quieres trabajar con cd /ruta/a/carpeta, luego escribe:

claude

La primera vez, Claude Code te pedirá que inicies sesión. Se abre un navegador, validas, y vuelves a la terminal. Listo.

Tu primer proyecto con Claude Code

El mejor proyecto para aprender es una pequeña página web que puedes ver inmediatamente en tu navegador.

Crea una carpeta vacía en tu escritorio, por ejemplo mi-primer-proyecto. Abre la terminal dentro y lanza claude. Luego escribe esta solicitud:

Quiero crear una página de inicio simple para mi café ficticio "El Zorro". Una foto de fondo, un título, un párrafo que describa el café, los horarios y un botón para reservar mesa. No sé nada de código, guíame.

Claude probablemente te hará 2 o 3 preguntas (qué ambiente, qué colores, etc.). Responde naturalmente. Luego creará los archivos: index.html, styles.css, a veces script.js. Los verás aparecer en la carpeta.

Abre index.html haciendo doble clic. Tu navegador muestra el resultado. Puede que no sea perfecto, y eso es normal. Vuelve a la terminal y pide cambios: "Haz el título más grande", "Pon un fondo azul noche", "Añade un logo arriba a la izquierda". En cada iteración, refrescas y ves el cambio.

En 30 a 45 minutos, tienes una página que te gusta.

Los 10 comandos Claude Code que debes conocer

Algunos comandos especiales te permiten sacar el máximo de Claude Code sin leer toda la documentación. Aquí están los que usarás el 80% del tiempo.

Comando Qué hace
/help Muestra la lista de comandos disponibles
/clear Borra el historial de la sesión actual
/model Cambia el modelo usado (Opus, Sonnet, Haiku)
/init Crea un archivo CLAUDE.md para documentar el proyecto
/plan Activa el modo plan antes de ejecutar
/compact Resume la conversación para liberar memoria
/exit Cierra la sesión correctamente
Arrastra un archivo Añade el archivo en contexto (como una imagen)
Escribe @nombrearchivo Hace que Claude lea un archivo específico
!comando Ejecuta un comando shell sin pasar por Claude

Para la lista completa y detalles de cada comando, nuestro artículo los 20 comandos Claude Code que debes conocer lo cubre todo.

El archivo CLAUDE.md, tu mejor aliado

El archivo CLAUDE.md es un pequeño documento donde escribes las reglas de tu proyecto para que Claude las recuerde en cada sesión. Es como dejar una nota adhesiva a tu yo futuro y a Claude.

Puedes incluir:

  • El stack usado (React, Next.js, Python, etc.)
  • Los comandos de test y build
  • Las convenciones de código a seguir
  • Las reglas de idioma (ej: "todos los textos de usuario en español con acentos")
  • Las zonas que nunca deben tocarse

Claude lee automáticamente este archivo en cada nueva sesión. Es el secreto para no repetir las mismas instrucciones cada vez. Empieza pequeño (5-10 líneas) y enriquécelo conforme identifiques qué te sirve.

El modo plan: reflexionar antes de actuar

El modo plan es una funcionalidad única que pide a Claude que te proponga un plan antes de ejecutar nada. En tareas importantes, evita sorpresas desagradables.

Escribe /plan en tu sesión, luego formula tu solicitud. Claude analizará, hará preguntas si es necesario, y te presentará un plan estructurado en varios pasos. Puedes aceptarlo, ajustarlo o rechazarlo completamente. Una vez validado, Claude ejecuta el plan paso a paso.

Es especialmente útil cuando aún no sabes bien qué quieres: Claude te ayuda a definir.

Errores de principiante a evitar

Aquí están los 4 escollos que bloquean sistemáticamente a los principiantes y cómo evitarlos.

  • Lanzar Claude en tu carpeta de inicio: lánzalo siempre en una subcarpeta dedicada. Si no, tiene acceso a todo.
  • Pedir varias funcionalidades a la vez: "Haz un sitio de e-commerce completo" → subdivídelo en pasos pequeños.
  • No leer las preguntas de Claude: cuando pregunta, espera realmente tu respuesta. No las saltes.
  • Olvidar guardar en git: usa git para mantener un historial de tu proyecto. Claude puede ayudarte a instalarlo.

Para ir más allá

Claude Code es una herramienta profunda: siempre hay algo nuevo que aprender. Pero no necesitas saberlo todo para empezar a crear cosas útiles. El progreso es continuo: cada proyecto te hace mejor.

Si quieres un recorrido estructurado en español, el programa Vibe Coding de Skilzy te acompaña de cero a un proyecto real desplegado, con ejercicios gamificados y guiados paso a paso.

Lo único que te separa de tu primer proyecto es abrir una terminal hoy.