Cómo usar Claude Code: tutorial para principiantes (2026)

Tutorial de Claude Code: cómo usarlo en cinco pasos

El negocio del ejemplo es inventado: Muddy Paws Grooming, una peluquería canina. Cámbialo por tu propio negocio, o por el de un amigo, y terminarás con algo realmente útil.

Lo que necesitas antes de empezar

• Claude Code instalado y con la sesión iniciada. Si todavía no lo has hecho, sigue primero los pasos para instalar Claude Code en Mac y Windows.
• Un plan de pago de Claude, porque el plan gratis no incluye Claude Code. (Usarlo con un modelo abierto gratuito es posible como experimento: mira Claude Code con Ollama.)
• Los datos del negocio: nombre, qué vende, tres servicios con precios, horario, zona, teléfono, un enlace de reservas si lo hay, y dos o tres reseñas reales de clientes.
• Un par de sesiones de trabajo concentrado: una el sábado para construir y otra el domingo para pulir.

Abajo uso la terminal; la pestaña Code de la app de escritorio tiene los mismos controles, con el selector de modo debajo del cuadro de prompt.

Sábado por la mañana: prepara el proyecto

Paso 1: inicia Claude Code en una carpeta de proyecto

Cada proyecto tiene su propia carpeta. Claude Code puede leer todo lo que hay dentro de la carpeta donde lo inicias, así que una carpeta limpia deja tus otros archivos fuera de su alcance.

Así se inicia Claude Code en la terminal de una Mac:

$ mkdir -p ~/claude-projects/muddy-paws
$ cd ~/claude-projects/muddy-paws
$ claude
$ 

En Windows, en PowerShell:

PS> mkdir -Force "$HOME\claude-projects\muddy-paws"
PS> cd "$HOME\claude-projects\muddy-paws"
PS> claude
PS> 

En la app de escritorio, abre la pestaña Code, haz clic en el selector de entorno debajo del cuadro de prompt y elige la primera opción bajo Local. Luego haz clic en el control de carpeta que está al lado, elige Open folder… y selecciona la misma carpeta.

Paso 2: elige un modo de permisos

Claude Code tiene modos de permisos: ajustes que deciden qué acciones puede hacer sin preguntarte. Pasas de uno a otro con Shift+Tab (Alt+M en algunas configuraciones de Windows), la línea debajo del prompt muestra el modo actual, y las versiones actuales inician las sesiones nuevas de terminal en modo auto.

La diferencia que importa es accept edits frente a modo auto: accept edits se salta las preguntas solo para cambios de archivos y comandos simples de archivos, mientras que el modo auto también ejecuta otros comandos, después de su revisión de seguridad.

También puedes elegir el modo al iniciar, para no empezar nunca en auto por accidente. Estas son líneas reales de la pantalla de ayuda de Claude Code:

Cuando Claude Code necesita tu OK, muestra un aviso como este, de una sesión real que hicimos mientras escribíamos esta guía:

• Yes aprueba solo esta acción.
• Yes, and don't ask again guarda una regla: ese comando se ejecuta sin preguntar en este proyecto a partir de entonces, mientras que las aprobaciones de ediciones de archivos duran hasta que termina la sesión.
• Yes, and switch to auto mode le pasa las aprobaciones rutinarias al revisor en segundo plano.
• No lo rechaza (Esc hace lo mismo). Presiona Tab para agregar una nota como "No: usa las fotos de la carpeta images", y Claude se adapta.

Paso 3: escribe el encargo en el modo plan de Claude Code

El atajo del modo plan es Shift+Tab: presiónalo hasta que la línea de estado diga ⏸ plan mode on, o escribe /plan al principio de tu mensaje. Después pega un encargo como este, con tus datos:

Quiero una web de una sola página para Muddy Paws Grooming, una peluquería canina en [CIUDAD].

Público: dueños de perros con poco tiempo que viven cerca y casi siempre reservan desde el teléfono.
Objetivo: que toquen "Reservar cita" ([ENLACE DE RESERVAS]) o llamen al [TELÉFONO].

Secciones, en este orden:
1. Un titular que diga qué hacemos y dónde, con el botón de reserva
2. Tres servicios con precios: [SERVICIO Y PRECIO] x3
3. Horario y dirección
4. Dos reseñas de clientes: [PEGA RESEÑAS REALES]
5. Contacto: teléfono, correo y un enlace al mapa

Estilo: cercano y limpio, mucho espacio en blanco, texto grande, fácil de usar en el teléfono.
Restricciones: un archivo index.html y un archivo styles.css. Sin frameworks. Ninguna foto que yo no haya aprobado.
Terminado significa: puedo abrir index.html en mi navegador, todo lo anterior está ahí y se lee bien en el teléfono.

Antes de escribir nada, hazme hasta cinco preguntas sobre lo que falte y luego propón un plan.

Claude lee la carpeta vacía, te hace sus preguntas y luego presenta un plan: qué archivos va a crear, qué va en cada sección y qué necesita todavía de ti. Presiona Ctrl+G para editar el plan en tu editor de texto.

Cuando ejecutamos este encargo con datos de prueba, Claude hizo exactamente cinco preguntas: la dirección, el horario, el correo para la sección de contacto, si debía armar el enlace al mapa a partir de la dirección y si teníamos colores de marca o un logo. Su plan listaba los dos archivos, cada sección en orden y cómo iba a revisar la página con el ancho de un teléfono, más un extra opcional: una barra de Reservar y Llamar fija en la parte inferior de la pantalla en los teléfonos.

Cuando volvimos a ejecutar el mismo encargo en una sesión interactiva, juntó la dirección y el horario en una sola pregunta y mostró las preguntas como pestañas, cada una con respuestas sugeridas:

Sábado por la tarde: construye, mira, reacciona

Paso 4: aprueba la construcción paso a paso

Ahora Claude crea index.html y luego styles.css, y antes de cada archivo te muestra lo que va a escribir y espera tu respuesta. Aprueba cuando coincida con el plan, y mira con más atención cualquier comando que borre archivos o que salga de la carpeta.

Cuando termine, abre la página con doble clic en index.html desde Finder o el Explorador de archivos, o en una Mac escribe ! open index.html en Claude Code. El ! al principio ejecuta un comando tú mismo, sin pasar por Claude.

Esto es lo que tomó nuestra propia ejecución de este encargo, desde el primer prompt hasta los dos archivos terminados:

La página funcionó a la primera, con un detalle. Nuestra construcción corrió en modo Accept edits sin nadie frente al teclado, así que el comando de navegador que Claude quería usar para una captura con el ancho de un teléfono nunca recibió el OK, y se saltó esa revisión y nos lo dijo. En una sesión normal verías la petición y podrías aprobarla, una razón más para construir tu primer proyecto en modo Manual.

En nuestra ejecución interactiva vimos esa petición, la aprobamos y Claude revisó él mismo la página con el ancho de un teléfono. Su mensaje final nos dijo exactamente qué seguía siendo provisional:

Paso 5: da comentarios como un cliente

Aquí está la mayor parte del valor. Reacciona como lo haría un cliente exigente: corto, concreto y una cosa cada vez.

Si escribes @ seguido del nombre de un archivo, como @brand.txt, le señalas a Claude ese archivo exacto para que lo lea antes de actuar. Para mostrar un problema en lugar de describirlo, haz una captura de pantalla y pégala en Claude Code con Ctrl+V en la mayoría de las terminales, Cmd+V en iTerm2 o Alt+V en Windows.

No tienes que esperar en silencio: escribe una corrección y presiona Enter, y Claude la leerá después del paso en curso, o presiona Esc para detenerlo al instante.

Paso 6: deshaz el último cambio con rewind

Tarde o temprano, algún cambio empeora las cosas. Tienes tres formas de volver atrás:

1. Pídelo. "Deshaz el último cambio" funciona en los casos sencillos.
2. Rebobina. Presiona Esc dos veces con el prompt vacío, o escribe /rewind (/undo hace lo mismo), elige el mensaje de antes de que todo se torciera y elige qué restaurar.
3. Vuelve a una versión guardada, si usas git, una herramienta gratuita que guarda instantáneas de un proyecto, cada una con su nombre.

Esta es la pantalla de rebobinado de una sesión en otro proyecto de práctica, después de elegir el mensaje al que volver:

Si quieres una red de seguridad de verdad, pídela. La mayoría de las Mac ya traen git; en Windows, instala antes Git for Windows.

Convierte esta carpeta en un repositorio de git y guarda la versión actual con una descripción clara de lo que funciona.

Domingo: déjalo sólido

Paso 7: deja por escrito lo que decidiste

Guarda las decisiones que tomaste sobre colores, tono y "revisa siempre el ancho de teléfono" para no tener que repetirlas nunca:

Crea un archivo CLAUDE.md para este proyecto con los datos del negocio, las reglas de estilo que acordamos y una regla para revisar la página con el ancho de un teléfono antes de decir que terminaste.

CLAUDE.md es un archivo de texto plano que Claude Code lee al inicio de cada sesión en esta carpeta, y los cambios que le hagas a mitad de sesión se aplican después de /clear o en la siguiente sesión. El comando integrado /init escribe un borrador a partir de lo que encuentra en la carpeta, pero el prompt de arriba recoge las decisiones que tomaron juntos, algo que un escaneo de los archivos no puede ver. La guía del archivo CLAUDE.md muestra qué poner en él, con plantillas.

Paso 8: pide una revisión con pruebas

Revisa la página como lo haría un cliente exigente. Comprueba que estén todas las secciones de mi encargo, que funcionen todos los enlaces y el teléfono, que el texto se lea bien con el ancho de un teléfono, que las imágenes tengan texto alternativo y que ningún nombre, precio u horario sea distinto de mi encargo. Corrige lo que puedas y luego haz una lista de lo que cambiaste y de lo que todavía necesitas de mí.

Después revísala tú: haz clic en cada enlace, estrecha la ventana hasta el ancho de un teléfono y lee cada precio comparándolo con tu lista de precios. Si configuraste git en el paso 6, /diff muestra lo que cambió desde la última versión guardada.

Paso 9: decide dónde se publica

Publicar es un trabajo aparte: un dominio, hosting y algunos ajustes para que los buscadores encuentren la página. La guía para crear una página web con IA explica cómo publicar con Claude Code y Vercel.

10 consejos de Claude Code para principiantes

1. Un resultado por mensaje. "Haz que el botón de reserva ocupe todo el ancho en el teléfono" funciona mejor que un párrafo con cinco deseos.
2. Señala, no describas. @styles.css hace que Claude lea el archivo correcto en lugar de buscarlo.
3. Deja que te entreviste. Para cualquier cosa más grande que un retoque, termina con "hazme preguntas hasta que tengas lo que necesitas".
4. Planifica cuando no puedas decirlo en una frase. Sáltate el plan en los arreglos pequeños, donde solo agrega pasos.
5. Detenlo pronto. Presiona Esc en cuanto vaya en la dirección equivocada, porque esperar solo hace más grande la limpieza.
6. Dos fallos, empieza de cero. Si ya corregiste lo mismo dos veces, ejecuta /clear y escribe un primer prompt mejor con lo que aprendiste.
7. Una tarea por sesión. Usa /clear entre trabajos que no tienen relación; /resume encuentra la conversación anterior más tarde.
8. Pide pruebas, no que te tranquilice. "Haz una lista de los archivos que cambiaste" o "muéstrame de dónde sale ese número" funciona mejor que "¿ya está?".
9. Deja las preguntas sueltas a un lado. /btw responde una pregunta rápida sin agregarla a la conversación principal.
10. Deja que la herramienta te enseñe. /powerup ofrece lecciones interactivas cortas, y nuestra guía rápida de Claude Code reúne los atajos útiles en una sola página.

Problemas comunes y soluciones

Los tropiezos más comunes de quien empieza, con la solución de cada uno. Los mensajes vienen de la referencia de errores de Anthropic.

¿Llegas seguido al límite de sesión? La guía de límites de uso de Claude Code muestra qué consume más y cómo estirar tu plan.

Qué hacer ahora

Elige un segundo proyecto pequeño para el próximo fin de semana, idealmente algo por lo que de otro modo pagarías o que sigues posponiendo, y repite el mismo ciclo: encargo en modo plan, construcción en Manual, revisión con pruebas y lo aprendido guardado en CLAUDE.md. Nuestra lista de ideas de proyectos con Claude Code tiene opciones que van de una hora a un fin de semana. Si prefieres que te acompañen en todo el recorrido, el curso de Claude Code va desde la instalación hasta una landing page publicada, un video con IA y un agente de facturas, y nuestra selección de los mejores cursos de Claude Code repasa alternativas gratis y de pago.