Claude Code para principiantes: 10 pasos para empezar (2026)

por Jasmine, una dev que usa Claude Code todos los días.

Escribí esto para la persona exacta que yo era hace poco más de un año: alguien a quien le daba un pinchazo de miedo abrir una terminal, no tenía idea de qué escribir y temía que cada ejecución de IA quemara un montón de dinero en tokens. Buena noticia: Claude Code es mucho más fácil de empezar de lo que crees. Si primero quieres entender los fundamentos, échale un vistazo a qué es Claude Code (una explicación de la A a la Z); si solo quieres "seguir los pasos y que funcione", salta directo a los 10 pasos de abajo.

Antes de empezar: lo que necesitas

Basta con unas pocas cosas de las de abajo. No te preocupes si aún te manejas con torpeza en la línea de comandos: cada paso te dice exactamente qué escribir.

Lista de preparación (5 minutos):

• Una computadora con Windows, macOS o Linux: cualquiera sirve.
• Node.js (la versión LTS): necesaria para el método de instalación con npm. Compruébalo con node -v; si da error, descarga e instala Node.js LTS primero.
• Una cuenta de Claude: el plan Pro a 20 USD/mes (la opción más fácil y barata para principiantes) o una clave de API con cobro por token.
• Una carpeta de proyecto para experimentar: una carpeta completamente vacía está bien.
• Unos 30 minutos y una actitud de "vamos a probarlo".

No necesitas manejarte bien con la terminal. Solo necesitas dos comandos: cd para entrar en una carpeta y claude para abrirla ahí. Todo lo demás lo dices en lenguaje sencillo.

Paso 1 - Instalar Claude Code

La forma más común es instalarlo con npm. Abre una terminal (en Windows, usa PowerShell o Terminal) y escribe:

npm install -g @anthropic-ai/claude-code

Esto instala Claude Code de forma global, así que puedes llamar a claude desde cualquier carpeta (según la documentación oficial). Cuando termine, verifícalo con:

claude --version

Notas por sistema operativo:

• Windows: si al escribir claude te sale un error de "comando no reconocido", cierra la terminal y vuelve a abrirla para recargar tu PATH. Usar PowerShell es tu apuesta más segura.
• macOS/Linux: si te topas con un error de permisos en la instalación global, evita sudo: en su lugar, reconfigura el directorio global de npm o usa un gestor de versiones de Node.

Dejé a propósito todos los casos límite fuera de esta sección para que el artículo siga siendo fácil de leer. Si te atascas, mira la guía detallada de instalación de Claude Code para cada plataforma y cómo solucionar los errores más comunes.

Paso 2 - Inicia sesión y autentícate

La primera vez que lo abres, Claude Code te pide autenticarte. Hay dos caminos:

Mi consejo para principiantes: elige el plan Pro a 20 USD/mes. No tienes que llevar la cuenta de cada token, no vas a gastar mucho "sin querer" mientras aún aprendes, y el precio fijo es fácil de manejar. Pásate a una clave de API cuando el trabajo crezca. Solo escribe claude, elige tu método de inicio de sesión y sigue las indicaciones en pantalla: tarda unas pocas decenas de segundos.

Paso 3 - Abre tu primer proyecto y ejecuta /init

Entra en la carpeta de tu proyecto e inicia Claude:

cd path/to/your-project
claude

Cuando la interfaz de chat aparezca en la terminal, escribe:

/init

El comando /init le dice a Claude que escanee tu proyecto y cree un archivo CLAUDE.md con una visión general (estructura de carpetas, tecnologías usadas, convenciones). Ese archivo ayuda a Claude a "entender el contexto" en cada sesión posterior; lo afinarás en el Paso 8.

Paso 4 - Entiende el bucle básico

Antes de dar ninguna instrucción, captar este bucle significa que entiendes el 80% de cómo funciona Claude Code. Se repite así:

1. Tú das un prompt: di en lenguaje sencillo lo que quieres.
2. Claude lee el repositorio: abre los archivos relevantes para entender el contexto.
3. Claude propone cambios: te muestra qué archivos va a editar o crear.
4. Tú apruebas (permiso): Claude pregunta antes de escribir un archivo o ejecutar un comando; tú aceptas o rechazas.
5. Claude edita los archivos y ejecuta las pruebas: y luego informa del resultado.
6. Repite hasta que coincida con lo que querías.

Sobre los permisos: por defecto Claude siempre pregunta primero antes de cualquier acción con impacto: este es el "freno de seguridad" para principiantes. Lee con atención y luego aprueba. No tengas prisa por activar el "aceptar todo automáticamente" antes de sentirte a gusto (es uno de los 5 errores comunes al final de este artículo). Mantén el hábito: leer, entender y luego aprobar.

Esto es lo que tranquiliza a mucha gente que empieza: Claude no borra archivos a escondidas ni ejecuta comandos peligrosos a tus espaldas. Cada vez que quiere escribir un archivo, ejecutar una prueba o llamar a un comando de terminal, ves exactamente lo que está a punto de hacer y puedes rechazarlo. En otras palabras, quien conduce siempre eres tú: Claude solo propone y luego ejecuta cuando se lo permites. Una vez que entiendes este bucle, cada paso restante es solo una variación de él.

Paso 5 - Escribe tu primer prompt de la forma correcta

La calidad del resultado depende directamente de cómo formulas tus instrucciones. La regla de oro para principiantes: pequeño, específico, una cosa a la vez. No le pidas a Claude que "construya el sitio web entero" en una sola frase: divídelo.

Un buen prompt siempre tiene contexto (qué archivo, qué línea), un objetivo claro y un límite de alcance. Cuanto más específica seas, menos adivina Claude y menos tienes que rehacer.

Paso 6 - Usa el Plan Mode antes de construir

Para cualquier cosa mínimamente compleja, no dejes que Claude se lance directo al código. Pídele que planifique primero. Mi lema: un minuto leyendo el plan ahorra diez minutos construyendo en la dirección equivocada, y también ahorra tokens, porque no rehaces el trabajo.

Paso 7 - Tu primer proyecto real (con resultado de verdad)

Ahora la parte divertida: construir algo que de verdad puedes ver. Elegí un miniproyecto sumamente ligero para que cualquiera pueda seguirlo: crear una landing page en HTML estático. Puedes aplicar el mismo proceso a "arreglar un bug pequeño" si ya tienes un proyecto.

Cómo hacerlo: abre una terminal en una carpeta vacía, escribe claude y luego da un prompt específico (recuerda la regla del Paso 5):

Create an index.html file: a static landing page for a coffee shop called "Sunny".
Include: a header with the shop name, one slogan, a "Menu" section listing 3 items with prices,
and a footer with the address. Use clean inline CSS with basic responsiveness.
No JavaScript needed yet.

Claude propondrá crear index.html, pedirá permiso para escribir el archivo y tú lo apruebas. Una vez creado el archivo, ábrelo en un navegador (haz doble clic en index.html o arrástralo a una pestaña del navegador) para ver el resultado renderizado de verdad.

Momento de honestidad: la primera pasada suele clavar el esqueleto, pero puede que no combine con tu gusto: colores pálidos, por ejemplo, o un espaciado que no queda del todo bien. No te desanimes: solo sigue hablando, "Ponle a la sección Menú un fondo color crema, redondea las esquinas de cada elemento y deja más espacio entre ellos." Este es exactamente el bucle del Paso 4. En lo que Claude es realmente bueno es en armar el andamiaje rápido y ajustarse a peticiones cortas; donde tú necesitas mantenerte activa es en poner en palabras tu estética y comprobar el resultado en el navegador. Después de unas cuantas rondas, tienes una página terminada sin escribir a mano una sola línea de HTML.

Paso 8 - Crea un CLAUDE.md para tu proyecto

CLAUDE.md es un archivo de texto en la raíz de tu proyecto que registra lo que quieres que Claude recuerde siempre: qué es este proyecto, qué tecnologías usa, cómo se estiliza el código y los comandos de prueba/ejecución. En cada sesión nueva, Claude lee este archivo primero, así no tienes que repetirte desde cero.

Quienes empiezan deberían tener un CLAUDE.md pronto, porque reduce drásticamente que Claude "pierda el contexto" y adivine mal. Un CLAUDE.md mínimo puede verse así:

# Project: Sunny coffee shop landing page

## Tech
- Static HTML/CSS, no framework, no build step.

## Conventions
- Keep CSS inline in index.html for simplicity.
- Write display content in English.

## Common tasks
- Adjust layout, colors, menu content.

Ya tienes un borrador del /init allá en el Paso 3; ahora solo lo abres y lo editas para que coincida con la realidad. Para escribir un CLAUDE.md como es debido (estructura, consejos, ejemplos para proyectos más grandes), mira la guía para escribir un CLAUDE.md sólido para tu proyecto.

Paso 9 - Aprende los atajos y comandos de barra esenciales

No necesitas memorizarlos todos. Con conocer unos 6 comandos centrales basta para el día a día:

Consejo rápido: usa /clear siempre que empieces una tarea sin relación con la anterior: es el hábito de ahorro de tokens más eficaz para principiantes. Para una tabla más completa, mira la hoja de referencia completa de atajos y comandos de Claude Code. Cuando te sientas a gusto, también puedes añadir skills y comandos de barra ya hechos para dejar de reescribir los mismos flujos repetitivos, que es justo de lo que trata el Paso 10.

Paso 10 - Gana velocidad con skills y subagents ya hechos

Después de unos cuantos proyectos que salen sin tropiezos, notarás que repites mucho: el mismo tipo de prompt de revisión de código, el mismo proceso de armar el andamiaje del back-end, la misma forma de escribir pruebas. Aquí es donde skills y subagents brillan: son "flujos de trabajo preempaquetados" para que Claude los siga, en vez de que tú los describas otra vez cada vez.

Quienes empiezan definitivamente no están obligados a construirlo todo por su cuenta. Hay kits que agrupan toda una gama de skills y agentes tanto para programar como para marketing; por ejemplo, el kit AgentKit para Claude Code (reseña detallada). Para quienes empiezan, yo lo veo como una mejora para cuando ya te sientes a gusto, no algo que necesites el primer día: primero deja firmes los 9 pasos de arriba. Cuando notes que pierdes tiempo reescribiendo el mismo flujo, prueba AgentKit (20% de descuento por el enlace) para ver cuánto esfuerzo puede ahorrar un sistema ya hecho de skills/subagents. No corras a comprar antes de necesitarlo de verdad: esa es la regla honesta.

5 errores comunes de principiante (y cómo evitarlos)

Estos son los errores que más veo en quienes empiezan. Con solo evitarlos, ya ganas una velocidad notable:

• 1. Asignar una tarea demasiado grande. "Constrúyeme la app entera" hace que Claude adivine y se pierda. Cómo evitarlo: divídela, una cosa clara por prompt (mira el Paso 5).
• 2. Saltarse el Plan Mode. Lanzarse directo al código va con facilidad en la dirección equivocada y obliga a rehacer, desperdiciando tiempo y tokens. Cómo evitarlo: pide un plan primero en cualquier cosa que toque más de un archivo (Paso 6).
• 3. Aceptar todo automáticamente sin leer. Activar el aceptar automático y dejar que Claude edite a lo loco. Cómo evitarlo: mantén el hábito de leer-entender-y-luego-aprobar en los permisos, al menos hasta que estés de verdad a gusto.
• 4. No usar /clear. Meter toda tarea en una sola sesión diluye el contexto, debilita las respuestas y aumenta el uso de tokens. Cómo evitarlo: ejecuta /clear cada vez que cambies de tarea.
• 5. No tener CLAUDE.md. Sin este archivo, Claude tiene que readivinar tu proyecto en cada sesión. Cómo evitarlo: crea un CLAUDE.md pronto y actualízalo con el tiempo (Paso 8).

Preguntas frecuentes (FAQ)

¿Claude Code es gratis?

Hay un nivel de prueba limitado, pero para un uso constante necesitas un plan de Claude (el Pro a 20 USD/mes es la opción popular para particulares) o pago por token mediante una clave de API. Para principiantes, el plan Pro es el más fácil para mantener los costos predecibles, porque el precio es fijo.

¿Necesito saber programar antes?

No es obligatorio para empezar: das las instrucciones en lenguaje sencillo y Claude escribe el código. Pero conocer lo básico (leer código, entender qué contiene tu proyecto) te ayuda a escribir mejores prompts y a comprobar los resultados. Cuanto más aprendes, más eficazmente usas Claude Code.

¿Funciona en Windows?

Sí. Claude Code funciona en Windows, macOS y Linux. En Windows, usa PowerShell o Terminal; si al escribir claude no se reconoce, cierra y vuelve a abrir la terminal para recargar tu PATH.

¿Cuánto cuestan los tokens/el dinero?

En el plan Pro a 20 USD/mes el costo es fijo, así que no tienes que preocuparte por tokens individuales mientras aprendes. Con una clave de API pagas por el volumen de tokens (por ejemplo, Sonnet 5 ronda los 2 USD de entrada y 10 USD de salida por cada 1 millón de tokens). Usar /clear al cambiar de tarea y activar el Plan Mode reducen notablemente el uso de tokens.

¿En qué se diferencia de ChatGPT o del chat de Claude?

El chat normal solo responde en texto, y tú tienes que copiar el código de un lado a otro. Claude Code se ejecuta directo en tu terminal, lee tu proyecto directamente y edita archivos y ejecuta comandos (después de pedir permiso). En resumen: el chat es un asistente que responde, Claude Code es un compañero de equipo que opera sobre tu base de código real.

¿Cuánto se tarda en aprender Claude Code?

Poner en marcha tu primer proyecto lleva solo unos 30 minutos, como en los 10 pasos de arriba. Volverte competente (buenos prompts, gestión del contexto, uso de skills/subagents) suele llevar unos días de práctica. Solo construye proyectos reales y le agarras el ritmo rápido.

Conclusión y próximos pasos

Con estos 10 pasos hechos, has pasado de cero a un primer proyecto funcionando: instalar, autenticarte, entender el bucle, escribir buenos prompts y evitar los errores comunes. Esa es una base sólida para ir más allá. Mis próximos pasos sugeridos: guarda en marcadores la hoja de referencia completa de comandos y atajos para consultarla rápido, lee sobre cómo escribir un CLAUDE.md sólido y, si quieres entender los fundamentos a fondo, vuelve a qué es Claude Code (una explicación de la A a la Z).