Cómo usar Claude Code: guía paso a paso para principiantes

En el artículo anterior expliqué qué es Claude Code, en palabras sencillas. Hoy toca la parte práctica. He visto la misma escena muchas veces: alguien oye que la IA ya crea webs y bots por su cuenta, se entusiasma, abre Claude Code, ve una ventana negra con un cursor parpadeando y la cierra a los cinco minutos. Lo entiendo. Yo también miraba la terminal como si fuera la cabina de un avión.

La buena noticia: toda la dificultad está en los primeros veinte minutos. Después es un ir y venir normal, como trabajar con un freelance, solo que este no duerme, no se pone enfermo y no desaparece una semana. Así que he trazado el camino para que lo recorras paso a paso con un té y termines la tarde con tu primer resultado real entre las manos.

Sección 01Qué necesitas antes de empezar

Reúnelo todo antes para no tener que buscar nada a mitad de camino. La lista es corta.

• Un ordenador. Mac, Windows o Linux. El móvil no sirve para esto: la app de Claude para móvil puede pasar una tarea a la versión web, pero mientras aprendes vas a querer una pantalla de verdad.
• Una cuenta de Claude con plan de pago. Claude Code viene con Pro (unos $20 al mes, algo menos si pagas el año) y con Max ($100 o $200 al mes). En el plan gratuito no está disponible.
• Un correo y una tarjeta. Para la cuenta vale cualquier correo, y para la suscripción basta una tarjeta normal de crédito o débito.
• Media hora tranquila y una tarea pequeña. Más abajo hay una sección entera sobre cómo elegirla, pero ve pensando ya en lo que te lleva tiempo rondando: una web personal que nadie tiene tiempo de montar, una carpeta de fotos, una exportación de ventas que nunca llegas a sumar.

No necesitas saber programar. Tampoco necesitas vocabulario técnico: Claude Code entiende el lenguaje de todos los días y responde igual. Si todavía dudas de si empezar por Claude, aquí tienes una comparación honesta: Claude 5, GPT-5 y Gemini 3.

Sección 02Dónde usarlo: 4 opciones y cuál elegir

Claude Code es uno solo, pero tiene varias puertas. Detrás de cada una está la misma IA con las mismas capacidades. Lo que cambia es cómo se ve la ventana y lo fácil que resulta arrancar. Aquí tienes una comparación para no gastar la tarde decidiendo.

Mi consejo es sencillo. Si nunca has abierto una terminal, empieza por la app de Claude. Se parece a cualquier otro programa de tu ordenador y la primera tarea sale sin estrés. En una o dos semanas, cuando te sientas cómodo, prueba la terminal: todo es igual, solo que más rápido y con un par de funciones extra. A partir de aquí enseño los dos caminos, la app y la terminal. Elige el tuyo.

Sección 03Paso 1. Cuenta y plan

Si ya tienes cuenta de Claude con Pro, salta al paso 2. Si no, vamos por orden.

Listo, tu cuenta está preparada. Una sola suscripción abre tanto el chat normal en claude.ai como Claude Code. No hay que comprar nada más, y los dos comparten los mismos límites de uso.

Sección 04Paso 2. Instalar Claude Code

Elige una de las dos opciones y síguela hasta el final. Las dos llevan unos cinco minutos.

Opción A. La app de Claude (lo más fácil)

Opción B. La terminal (un solo comando)

La terminal es una ventana de texto donde se escriben comandos. En Mac se llama Terminal y la encuentras con Spotlight (Cmd + Espacio, escribe «Terminal»). En Windows, abre PowerShell desde el menú Inicio. Ahí dentro no hay nada que dé miedo. Vamos a escribir exactamente una línea.

Sección 05Paso 3. Carpeta del proyecto y primer inicio de sesión

Claude Code trabaja dentro de una carpeta. Todo lo que crea va ahí, y todo lo que hay ahí lo puede ver. Así que la primera regla: una tarea, una carpeta aparte. No lo abras en el escritorio ni en Documentos, donde vive tu vida entera. Crea una carpeta vacía con un nombre claro, como «web-personal» o «analisis-ventas».

Ahora tienes delante un campo de texto. Puedes escribir como en cualquier app de mensajería. Lo más difícil ya ha pasado. Ahora empieza lo divertido.

Sección 06Paso 4. Primera tarea: un diálogo real

Para el primer intento, elige una tarea cuyo resultado puedas ver con tus propios ojos en un par de minutos. Una web personal de una pantalla es perfecta: la abres en el navegador al momento y entiendes cómo funciona todo. Aquí tienes el diálogo completo tal como se ve en pantalla, para que sepas qué esperar.

Fíjate en dos cosas. Primero, te contó el plan y después hizo el trabajo. Segundo, antes de crear el archivo te enseñó exactamente qué iba a escribir y te pidió permiso. Pulsas «sí» (o el 1 en la terminal) y el archivo aparece en la carpeta.

Haz doble clic en index.html y échale un vistazo. Seguramente querrás cambiar algo. Es normal, de eso se trata. Sigue con el mismo lenguaje sencillo:

Ese es todo el secreto. Tú describes, él construye, tú miras y afinas. Dos o tres vueltas y la web está lista. Por cierto, Claude Code también puede ayudarte a publicar una página así en internet si se lo pides, pero eso es el siguiente paso y necesita el acceso a tu hosting. Para un proyecto completo, de notas de voz a web terminada, mira cómo crear una web con Claude Code en una tarde.

Sección 07Paso 5. Permisos y modos

Lo que más asusta a los principiantes es pensar «¿y si me borra algo?». Así funciona en realidad. Por defecto, Claude Code pide permiso para cualquier cosa que cambie archivos o ejecute programas. Te enseña qué quiere hacer y espera tu respuesta. Las opciones suelen ser estas:

• Sí – hacer esta acción una vez.
• Sí, y no volver a preguntar para este tipo de acción en esta carpeta. Muy útil cuando pide crear un archivo por décima vez.
• No – y dile enseguida qué hacer en su lugar. Se adaptará.

Además hay modos de trabajo que cambias con Shift + Tab (en la app es un interruptor junto al campo de texto):

Te recomiendo el modo plan para cualquier cosa más grande que una web de una página. Actívalo, describe la tarea, recibe un plan de cinco a diez puntos, corrígelo con palabras sencillas («quita el punto tres, la web es de una sola página») y solo entonces deja que se ponga en marcha. Así no gastas tus límites en trabajo que ha tirado por el camino equivocado.

Dos teclas más quitan casi todo el miedo. Esc detiene a Claude Code a media frase cuando ves que va por mal camino. Doble Esc abre una lista de pasos anteriores y puedes volver al momento anterior a un cambio fallido. El comando /rewind hace lo mismo. Piensa en ello como el «deshacer» de Word, pero para todo el trabajo a la vez.

Sección 08Paso 6. Memoria del proyecto: el archivo CLAUDE.md

Cada sesión nueva de Claude Code empieza de cero. No recuerda que ayer acordasteis los colores beis ni que a las personas con las que trabajas las llamas clientes y no pacientes. Para no tener que explicarlo cada vez, el proyecto tiene memoria: un archivo CLAUDE.md dentro de la carpeta. Claude Code lo lee en cada arranque.

Configurar la memoria es fácil: escribe el comando /init. Estudia la carpeta y crea CLAUDE.md con una descripción del proyecto. A partir de ahí puedes ir añadiendo cosas con palabras normales, directamente en la conversación:

Añade estas reglas al archivo y mañana, cuando abras la misma carpeta, retomas justo donde lo dejaste. Lo que suele merecer la pena guardar en la memoria:

• quién eres y a qué te dedicas, en una o dos frases;
• para quién es el proyecto y qué tono tiene;
• colores, tipografías, contactos y enlaces que se repiten;
• reglas como «no borres versiones antiguas, muévelas a una carpeta de archivo»;
• errores que ya ha cometido y no debe repetir.

Lo último es lo más valioso. Cada vez que corrijas a Claude Code, dile «guarda esto en CLAUDE.md». Al cabo de un mes tendrás un asistente que conoce tus costumbres mejor que alguien recién contratado. La misma idea de base de conocimiento existe también en el chat normal, con los Proyectos de Claude.

Sección 09Chuleta de comandos para principiantes

Los comandos empiezan por una barra y se escriben directamente en el campo de texto. No hace falta aprenderse los cuarenta. Aquí tienes diez que te bastarán para los primeros meses. /help muestra la lista completa.

Dos trucos más te facilitan mucho la vida. El símbolo @ más el nombre de un archivo señala a Claude Code un archivo concreto: «mira @precios.xlsx y suma los ingresos». Y puedes arrastrar una captura de pantalla a la ventana o pegarla desde el portapapeles, y la verá. Es un salvavidas cuando es más fácil enseñar un error que describirlo.

Con los modelos no hay misterio. Por defecto, trabaja con Sonnet 5: es un equilibrio sensato entre velocidad, calidad y consumo de límites. Para tareas difíciles que exigen pensar mucho, cambia a Opus. Los recados ligeros como «renombra estos archivos» son trabajo fácil para el rápido Haiku 4.5.

Sección 10Cómo pedir tareas: una fórmula y 12 frases listas

Claude Code es exactamente tan bueno como clara sea tu tarea. Quien dice «no me funciona nada», nueve de cada diez veces escribe algo tipo «hazme una web bonita». Es como acercarte a un diseñador y decirle «haz algo». Lo hará. Algo.

Yo uso una fórmula sencilla de cuatro partes. Tenla delante las primeras semanas.

1. Quién soy y para qué. «Soy profesora de inglés y necesito una página para padres».
2. Qué hay ya. «En la carpeta están mis precios en precios.xlsx y tres opiniones en opiniones.txt».
3. Cuál debe ser el resultado. «Una página: quién soy, precios de la tarifa, opiniones y un botón de reserva».
4. Restricciones. «Sin animaciones, letra grande, que se abra bien en el móvil».

Y aquí tienes doce frases que puedes copiar y completar con tus datos. Cada una está probada en tareas reales.

• «Primero revisa la carpeta y dime qué hay. No cambies nada».
• «Enséñame un plan paso a paso. Lo apruebo y arrancas».
• «Hazme todas las preguntas que necesites para hacerlo bien».
• «Hazme una web personal de una pantalla: [quién eres, cómo ayudas, adónde lleva el botón, colores]».
• «Mira la exportación @ventas.csv y calcula los ingresos por mes, los 10 mejores clientes y el ticket medio. Guarda el resultado en una hoja informe.xlsx».
• «Ordena todas las fotos de esta carpeta en subcarpetas por año y mes en que se hicieron. No borres nada».
• «Renombra todos los archivos de la carpeta con el patrón fecha-título. Enséñame antes la lista de nombres nuevos».
• «Convierte mis notas de la carpeta notas en una sola guía en Word con índice».
• «Haz una página con un formulario de reserva: nombre, teléfono, hora preferida. Guarda las solicitudes en un archivo».
• «Revisa esta web en busca de problemas: enlaces rotos, erratas, cómo se ve en el móvil».
• «Explícame con palabras sencillas qué acabas de hacer y qué archivos has cambiado».
• «Guarda en CLAUDE.md lo que acabamos de decidir».

Te recomiendo sobre todo la tercera. Cuando no tengas del todo claro qué quieres, pide a Claude Code que te pregunte. Te preguntará por tu público, los colores, los textos y adónde mandar a la gente, y tras cinco respuestas la tarea queda varias veces más clara.

Sección 11Cinco primeros proyectos según tu profesión

Para que no te quedes mirando un campo de texto vacío, aquí tienes ideas de primer proyecto para quienes venden servicios, cursos y consultoría. Cada una lleva una tarde y aporta valor real.

Fíjate en que ninguna fila dice «escribe código». Describes el resultado como se lo describirías a un asistente de oficina. Cuando te sientas seguro, pasa a tareas más grandes: un bot de Telegram que responda a las preguntas frecuentes (paso a paso en cómo hacer un bot de Telegram sin programador) o conectar tus propias herramientas mediante MCP. Para la visión general de crear cosas conversando, lee sobre el vibe coding.

Un cliente, mentor de ventas, empezó justo por una hoja de cálculo. Primero pidió a Claude Code que volcara en ella todos los contactos de su historial de mensajes, luego que calculara la conversión de contacto a pago y después que la dibujara semana a semana. Tres tardes más tarde tenía su propio pequeño sistema de analítica, para el que pensaba contratar a alguien. Y lo principal, en sus palabras: «Por primera vez vi en qué paso se me cae la gente».

Sección 12Cuando algo sale mal

Todos los principiantes tropiezan con lo mismo. Lo he reunido en un solo sitio para que no tengas que rebuscar en foros.

El principio general: cualquier mensaje confuso, enséñaselo al propio Claude, en Claude Code o en el chat normal. Desenreda sus propios errores mejor que cualquier foro. Y si alguna palabra técnica se te atraganta, tienes a mano el glosario de términos de IA para principiantes.

Sección 13Límites de uso y cómo estirarlos

Con Pro no pagas por petición, pero tampoco es ilimitado. Hay un límite para unas pocas horas y un límite semanal. Claude Code consume bastante más que el chat normal, porque lee archivos, prueba cosas y revisa su propio trabajo. Para tareas tipo «web personal, hoja de cálculo, informe», Pro va sobrado. Cuando pases varias horas al día en Claude Code, echa un vistazo a Max.

Esto es lo que de verdad ahorra límites:

• Una tarea, una conversación. ¿Has terminado la web? Escribe /clear y empieza el informe de ventas desde cero. Una conversación larga arrastra todo el texto anterior y cuesta más.
• El modelo adecuado. Sonnet 5 para el día a día, Opus solo para lo realmente difícil, Haiku 4.5 para recados pequeños.
• Modo plan antes de una tarea grande. Acordar el enfoque con palabras sale más barato que rehacer trabajo terminado.
• Carpetas pequeñas. No abras Claude Code en una carpeta con miles de archivos, intentará estudiarlos. Una carpeta propia para cada tarea ahorra tiempo y límites.
• Una tarea precisa desde el principio. Cada ronda de «no, eso no» cuesta límite. La fórmula de cuatro partes se amortiza justo aquí.

Consulta lo que te queda con el comando /usage. Si quieres saber qué modelo encaja con cada tipo de tarea, lo cuento en Claude 5, GPT-5 y Gemini 3: qué cambió y cuál te conviene.

Sección 14Seguridad: cinco reglas sencillas

Claude Code tiene acceso a tu ordenador, así que un poco de higiene no sobra. Las reglas son sencillas y fáciles de cumplir.

1. Una carpeta aparte para cada tarea. Nunca lo abras en la raíz del disco ni en la carpeta con todos tus documentos.
2. Lee las peticiones de permiso. Sobre todo cuando quiere borrar, enviar o instalar algo. Si no entiendes una acción, pregunta: «Explícame con palabras sencillas qué va a hacer este comando».
3. No escribas contraseñas ni claves en el chat. Si necesita acceso a un servicio, pregunta a Claude Code dónde guardar la clave de forma segura y ponla ahí tú mismo.
4. Haz copia de lo importante. ¿Trabajas con archivos valiosos? Copia antes la carpeta. Son dos segundos y dormirás más tranquilo.
5. Revisa todo lo que sale fuera. Las cifras de un informe, los enlaces de una web, el texto de un envío de correo. La revisión final es cosa tuya, sobre todo donde hay dinero y datos de clientes.

Sección 15Todo el camino en un minuto

Repasemos lo esencial para que todo encaje en una sola imagen.

• Necesitas un ordenador y un plan Claude Pro o Max.
• Lo más fácil para empezar es la app de Claude, pestaña Code. La terminal se instala con un comando y da las mismas capacidades.
• Crea una carpeta vacía aparte para cada tarea y abre Claude Code justo ahí.
• Que la primera tarea sea pequeña y visible: una web personal, una hoja de cálculo, un informe. Usa la fórmula: quién eres, qué hay, qué resultado necesitas, restricciones.
• Aprueba las acciones importantes, activa el modo plan antes de una tarea grande y deshaz un paso fallido con doble Esc.
• Crea la memoria del proyecto con /init y añade todo lo que acordéis.
• Una tarea, una conversación, /clear entre tareas, Sonnet 5 por defecto. Así tus límites duran mucho.

Eso es todo. Sinceramente, lo más difícil de Claude Code es decidirse a abrirlo por primera vez. Después tú hablas y él trabaja. Elige una tarea pequeña que llevas tiempo arrastrando y quítatela de encima esta noche. ¿Te animas? 🙂