Claude Code para principiantes: primeros pasos

No necesitas saber programar para empezar. Claude Code te guía en muchas tareas. Pero tener nociones básicas de terminal (cd, ls, abrir carpetas) hace la experiencia más fluida.

Si quieres entender primero qué es Claude Code y en qué se diferencia de ChatGPT, lee qué es Claude Code.

Instalación en 2 minutos

Abre tu terminal y ejecuta:

# Instalar Claude Code
npm install -g @anthropic-ai/claude-code

# Verificar que se instaló
claude --version

# Iniciar Claude Code
claude

La primera vez te pedirá autenticarte. Abre el enlace que te muestra en el navegador, inicia sesión con tu cuenta de Anthropic y listo.

Tu primera sesión

Navega a una carpeta de proyecto (o crea una nueva) y ejecuta claude:

# Crear una carpeta para practicar
mkdir mi-primer-proyecto
cd mi-primer-proyecto

# Iniciar Claude Code
claude

Ahora estás dentro de Claude Code. Puedes escribir en lenguaje natural. Prueba con algo simple:

> Crea un archivo index.html con una página web
 que diga "Hola mundo" con estilos bonitos

Claude Code va a crear el archivo, escribir el HTML y el CSS, y mostrarte qué hizo. No necesitas escribir código tú mismo.

Tus primeros 30 minutos: tutorial guiado

Si acabas de instalar Claude Code y no sabes por dónde empezar, sigue este guión. Cada paso te enseña algo nuevo:

Minuto 0-5: Orientación

# Inicia Claude Code en tu carpeta de práctica
claude

# Pregunta algo básico para romper el hielo
> ¿Qué archivos hay en esta carpeta?

# Claude Code ejecutará "ls" y te mostrará el resultado

Minuto 5-10: Crear algo

# Pide que cree un archivo simple
> Crea un archivo README.md que explique que este
 es mi proyecto de prueba con Claude Code

# Observa: Claude Code te muestra el contenido
# antes de escribirlo. Aprueba con "y".

Minuto 10-15: Modificar

# Ahora modifica lo que ya existe
> Añade una sección "Tecnologías" al README
 con Python, JavaScript y HTML

# Claude Code lee el archivo existente, lo modifica
# y te muestra el diff (qué cambió)

Minuto 15-20: Crear un proyecto pequeño

> Crea una calculadora web simple con HTML, CSS y
 JavaScript. Diseño minimalista, colores oscuros.

# Claude Code crea múltiples archivos de una vez

Minuto 20-25: Iterar

> La calculadora se ve bien pero quiero que los
 botones sean más grandes y que tenga un historial
 de operaciones

# Aquí aprendes la iteración: no repites todo,
# pides cambios puntuales

Minuto 25-30: Explorar comandos

# Prueba los comandos slash
/cost     # ¿Cuánto has gastado?
/compact  # Comprime el contexto
/help     # Ve todas las opciones

Comandos básicos que debes conocer

Dentro de Claude Code, hay comandos que empiezan con /:

• /help — Muestra la ayuda completa.
• /clear — Limpia el contexto de la conversación.
• /compact — Comprime el contexto para sesiones largas.
• /cost — Muestra cuánto has gastado en esta sesión.
• /status — Información sobre la sesión actual.

Para la referencia completa de comandos, visita nuestra guía de comandos de Claude Code.

5 cosas que probar primero

Antes de lanzarte a un proyecto complejo, prueba estas 5 tareas que te darán confianza:

1. Explica un archivo: Abre Claude Code en una carpeta con código existente y pide "Explícame qué hace este proyecto". Claude Code leerá los archivos y te dará un resumen.
2. Refactoriza algo: Si tienes un script desordenado, pide "Refactoriza este archivo para que sea más legible". No necesitas saber cómo debería quedar.
3. Genera tests: Pide "Crea tests unitarios para el archivo X". Claude Code entiende el código y genera tests relevantes.
4. Busca un bug: Si algo no funciona, pide "Este archivo da error cuando hago X, ¿puedes encontrar el problema?". Claude Code leerá el código y el error.
5. Documenta: Pide "Añade comentarios y docstrings a todas las funciones de este archivo". Documentación automática en segundos.

Estas 5 tareas cubren el 80% de lo que harás con Claude Code al principio. No necesitas memorizar comandos ni sintaxis: describe lo que quieres en español y deja que Claude Code se encargue.

Tu primer proyecto real

Vamos a crear algo útil: una landing page personal.

> Crea una landing page personal con estas secciones:
 1. Hero con mi nombre (Juan García) y "Desarrollador Web"
 2. Sobre mí: 2 párrafos placeholder
 3. Proyectos: 3 cards con título, descripción y link
 4. Contacto: formulario con nombre, email y mensaje
 Diseño moderno, dark mode, responsive.
 Genera todos los archivos necesarios.

Claude Code va a:

1. Crear index.html con toda la estructura.
2. Crear style.css con el diseño responsive y dark mode.
3. Explicarte qué hizo y por qué.

Después puedes iterar: "Cambia el color primario a azul", "Añade animaciones suaves", "Haz que el formulario envíe a Formspree". Claude Code modifica los archivos existentes sin que toques código.

Entender el output de Claude Code

Claude Code te muestra información de tres tipos. Aprender a leerla mejora tu experiencia:

1. Texto explicativo (blanco/gris): Claude Code te explica qué va a hacer o qué ha encontrado. Es conversación normal.

2. Bloques de código con acciones (con borde): Cuando Claude Code quiere crear o modificar un archivo, te muestra el contenido en un bloque destacado. Verás algo como:

Write file: index.html
──────────────────────
[contenido del archivo]
──────────────────────
Do you want to proceed? (y/n)

3. Resultados de comandos: Cuando Claude Code ejecuta un comando (como ls, npm install o git status), te muestra la salida. Esto es informativo: ya se ejecutó.

La regla de oro: Claude Code siempre te pide permiso antes de modificar archivos (a menos que configures modo auto). Lee el resumen antes de aprobar, especialmente al principio.

Errores comunes de principiantes

Estos son los 6 errores que veo repetidamente en gente que empieza con Claude Code:

1. Prompts demasiado vagos: "Haz una web" no funciona bien. "Haz una landing page de producto con hero, features, testimonios y CTA, diseño minimalista con colores azul y blanco" sí funciona.
2. Regenerar en vez de iterar: Si el resultado no es perfecto, no vuelvas a pedir todo desde cero. Pide cambios específicos: "Cambia la fuente a Inter", "Haz el botón más grande". Es más rápido y más barato.
3. Ignorar el contexto: Claude Code recuerda toda la conversación. Si ya le dijiste que usas React, no necesitas repetirlo en cada mensaje. Pero si cambias de tema radicalmente, usa /clear.
4. No revisar antes de aprobar: Al principio, lee siempre el resumen de lo que Claude Code va a hacer. Con experiencia, podrás aprobar más rápido, pero al inicio la revisión te enseña cómo funciona.
5. Sesiones infinitas sin /compact: Después de 20-30 intercambios, el contexto se llena y la calidad baja. Usa /compact regularmente para mantener el rendimiento.
6. No crear un CLAUDE.md: Aunque sea un proyecto de práctica, un archivo CLAUDE.md con 3 líneas (idioma, estilo, tecnologías) mejora todas las respuestas. Es 2 minutos de setup que ahorran horas.

Cuándo usar Claude Code vs chat

Claude Code y el chat de Claude (claude.ai) son herramientas diferentes para problemas diferentes:

Usa Claude Code cuando:

• Necesitas crear o modificar archivos en tu ordenador
• Trabajas en un proyecto con múltiples archivos que se relacionan
• Quieres que el contexto incluya todo tu código (no solo lo que pegas)
• Necesitas ejecutar comandos (instalar dependencias, correr tests, hacer git)
• El trabajo es iterativo: crear, probar, ajustar, repetir

Usa el chat (claude.ai) cuando:

• Tienes una pregunta puntual ("¿cómo se hace X en Python?")
• Necesitas ayuda con un fragmento de código aislado
• Quieres brainstorming o ideas sin tocar archivos
• Estás en el móvil o sin acceso a terminal
• La tarea no involucra tu sistema de archivos local

Regla práctica: si necesitas que algo cambie en tu proyecto, Claude Code. Si necesitas una respuesta sin acción, el chat.

Setup de proyecto: paso a paso

Cuándo empiezas un proyecto nuevo con Claude Code, sigue esta secuencia para máximo rendimiento:

# 1. Crea la carpeta del proyecto
mkdir mi-proyecto && cd mi-proyecto

# 2. Inicializa git (Claude Code funciona mejor con git)
git init

# 3. Crea un CLAUDE.md mínimo
cat > CLAUDE.md << 'EOF'
# Mi Proyecto
- Idioma: español
- Stack: HTML, CSS, JavaScript
- Estilo: moderno, minimalista
- Convenciones: BEM para CSS, ES6+ para JS
EOF

# 4. Inicia Claude Code
claude

# 5. Tu primer mensaje debería describir el proyecto
> Este proyecto es [descripción]. Quiero empezar por
 [primera tarea concreta].

Este setup de 2 minutos marca una diferencia enorme. Claude Code lee el CLAUDE.md al inicio y adapta todas sus respuestas a tus preferencias. Sin él, cada respuesta será genérica.

5 consejos para principiantes

1. Sé específico: "Crea una web" es vago. "Crea una landing page de 4 secciones con diseño dark mode y fuente Inter" es específico. La especificidad mejora el resultado.
2. Itera, no reescribas: Si el resultado no es perfecto, pide cambios puntuales en lugar de regenerar todo. "Cambia el color del botón a rojo" es más eficiente que repetir todo el prompt.
3. Usa /compact: Si la sesión se alarga, el contexto se llena. Usa /compact para comprimir y mantener el rendimiento.
4. Crea un CLAUDE.md: Incluso para practicar, un CLAUDE.md básico mejora las respuestas. Solo con "idioma: español, estilo: moderno" ya notas la diferencia.
5. Revisa antes de aceptar: Claude Code te muestra qué va a hacer antes de ejecutar cambios. Lee siempre el resumen antes de aprobar, especialmente si modifica archivos existentes.

Preguntas frecuentes

¿Necesito saber programar para usar Claude Code?

No necesitas ser programador, pero ayuda tener nociones básicas de terminal (abrir una carpeta, ejecutar un comando). Claude Code puede guiarte en muchas tareas sin que escribas código tú mismo. Crea webs, scripts y automatizaciones solo con descripciones en español.

¿Qué necesito para instalar Claude Code?

Node.js instalado en tu ordenador y una cuenta de Anthropic con un plan que incluya Claude Code (Max o Team). La instalación es un solo comando: npm install -g @anthropic-ai/claude-code.

¿Claude Code funciona en Windows?

Sí, Claude Code funciona en macOS, Linux y Windows (via WSL2). En Windows nativo sin WSL la experiencia es limitada. Recomendación: instalar WSL2 primero, toma 10 minutos y la experiencia mejora enormemente.

¿Cuánto cuesta Claude Code?

Claude Code está incluido en los planes Max (20 USD/mes) y Team de Anthropic. También hay un tier gratuito con límites diarios. No tiene coste adicional sobre el plan. El uso se descuenta de tus tokens incluidos.

¿Cuál es la diferencia entre Claude Code y ChatGPT?

ChatGPT es un chat en navegador. Claude Code es una herramienta de terminal que trabaja directamente con tus archivos: lee tu proyecto, modifica código, ejecuta comandos y mantiene contexto de todo el repositorio. Es como tener un programador dentro de tu terminal.

Siguiente paso

Ya sabes lo básico. El siguiente paso es configurar Claude Code para tu flujo de trabajo: crear un CLAUDE.md, aprender a usar la memoria persistente y explorar la configuración avanzada.

Si te preguntas cuánto cuesta, revisa nuestra guía de Claude Code gratis: límites y planes.