Cómo usar Claude Code desde cero: tutorial paso a paso

Para empezar con Claude Code desde cero solo necesitas instalarlo, abrir una carpeta de proyecto, ejecutar claude y darle una primera tarea pequeña. Mi recomendación es que no comiences pidiéndole una aplicación completa: primero haz que analice la carpeta, proponga un plan y cree una versión mínima que puedas comprobar.

En este tutorial voy a enseñarte el proceso completo como se lo explicaría a alguien que nunca ha trabajado con una terminal. El objetivo no es convertirte en programador en una tarde, sino ayudarte a utilizar Claude Code con criterio, entender qué está haciendo y evitar los errores que pueden romper un proyecto.

Qué necesitas antes de instalar Claude Code

Claude Code es una herramienta de Anthropic que trabaja directamente con los archivos de una carpeta. Puede leer el proyecto, escribir código, ejecutar comandos y comprobar resultados. Si quieres entender primero qué tipo de proyectos tiene sentido crear, consulta mi guía sobre Claude Code para no programadores.

Según la documentación oficial de instalación, necesitas un sistema compatible, conexión a Internet y una cuenta válida de Claude o Anthropic Console. La guía oficial también recoge las opciones concretas para macOS, Linux y Windows.

• Una cuenta compatible: Claude Pro o Max, Anthropic Console o una configuración empresarial admitida.
• Una terminal: Terminal en macOS, una terminal en Linux o Git Bash/WSL en Windows, según la instalación.
• Una carpeta de prueba: empieza con un proyecto nuevo, nunca con los archivos críticos de un cliente.
• Una copia de seguridad: debes poder volver al estado anterior si algo falla.

Paso 1: instala Claude Code

Abre la terminal de tu ordenador y sigue el método actualizado que Anthropic muestra para tu sistema operativo. La instalación mediante npm documentada por Anthropic utiliza este comando:

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

No añadas sudo delante del comando. Anthropic advierte de que puede generar problemas de permisos y riesgos innecesarios. Si tu ordenador indica que npm no existe, significa que antes debes instalar Node.js siguiendo el método recomendado para tu sistema.

Cuando termine, comprueba que Claude Code responde:

claude --version

También puedes ejecutar claude doctor para revisar el tipo de instalación y detectar problemas habituales. Como las opciones de instalación pueden cambiar, utiliza siempre la página oficial como referencia principal.

Paso 2: crea una carpeta segura para tu primer proyecto

Claude Code actúa sobre la carpeta desde la que lo ejecutas. Por eso este paso es más importante de lo que parece. Crea una carpeta vacía llamada, por ejemplo, mi-primer-proyecto. Después entra en ella desde la terminal.

mkdir mi-primer-proyecto
cd mi-primer-proyecto

Si no te sientes cómodo con estos comandos, puedes crear la carpeta con Finder o el Explorador de archivos y abrir la terminal en esa ubicación. Lo importante es comprobar dónde estás antes de continuar. Nunca inicies tu primera prueba en Escritorio completo, Documentos o una carpeta con datos confidenciales.

Paso 3: inicia Claude Code y autentícate

Dentro de la carpeta del proyecto, escribe:

claude

La primera vez tendrás que elegir un método de acceso y completar la autenticación que corresponda a tu cuenta. No compartas claves, tokens ni códigos de acceso en un chat o documento del proyecto. Claude Code guarda las credenciales mediante su proceso específico; no necesitas escribirlas dentro de tus archivos.

Cuando veas el cuadro de conversación en la terminal, ya puedes escribir en lenguaje natural. No necesitas memorizar sintaxis para dar instrucciones.

Paso 4: pide primero un análisis, no cambios

El error más común es empezar con “créame una web completa”. Yo prefiero separar comprensión, planificación y ejecución. Utiliza una primera instrucción como esta:

Quiero crear una calculadora sencilla de presupuesto publicitario. Antes de modificar archivos, hazme las preguntas necesarias, propón una estructura y explícame el plan en lenguaje no técnico. No ejecutes todavía ningún cambio.

Con esta petición evitas que Claude decida por su cuenta aspectos importantes. Revisa si ha entendido el usuario, las variables, el resultado esperado y los límites. Corrige el plan antes de autorizar la construcción.

Paso 5: crea una primera versión mínima

Una vez aprobado el plan, pide una versión pequeña y comprobable:

Crea la primera versión solo con HTML, CSS y JavaScript. Debe permitir introducir presupuesto, coste por lead y tasa de cierre. Calcula leads y clientes estimados. No añadas bases de datos, registros ni servicios externos. Cuando termines, explica qué archivos has creado y cómo probarlos.

Claude Code propondrá crear o editar archivos y puede solicitar permisos antes de hacerlo. Lee cada acción. Si no entiendes un comando, pregunta qué hace, qué puede modificar y cómo se revierte. La documentación de seguridad de Anthropic explica que las acciones sensibles están sujetas a permisos, pero la revisión sigue siendo responsabilidad del usuario.

Paso 6: prueba el resultado con casos concretos

No te conformes con que la página se abra. Prepara casos cuyos resultados puedas calcular manualmente. Si introduces 1.000 euros de presupuesto y un coste de 20 euros por lead, el resultado esperado son 50 leads. Con una tasa de cierre del 10 %, serían cinco clientes.

Pídele a Claude Code que compruebe valores normales, campos vacíos, números negativos y decimales. Después realiza tú las mismas pruebas. Cuando aparezca un error, describe el comportamiento observado y el esperado:

Al dejar vacío el coste por lead aparece “Infinity”. Quiero que el botón permanezca desactivado hasta que todos los campos tengan valores válidos. Corrígelo y añade una prueba que evite que vuelva a ocurrir.

Paso 7: mejora una cosa cada vez

Cuando la lógica funcione, puedes trabajar el diseño, la adaptación móvil y los textos. Hazlo por bloques. Por ejemplo: primero jerarquía visual; después colores; luego mensajes de error; por último accesibilidad. Si cambias diez elementos juntos y algo se rompe, será más difícil localizar la causa.

Un prompt útil para la fase visual sería:

Mejora solo el diseño sin alterar las fórmulas. Usa fondo negro, tarjetas en gris oscuro y naranja #ff7a00 para las acciones. Asegura contraste suficiente, etiquetas visibles y una buena experiencia en móvil. Antes de editar, enumera los archivos que vas a tocar.

Paso 8: crea un archivo CLAUDE.md

Cuando el proyecto crece, puedes guardar instrucciones permanentes en un archivo CLAUDE.md. Ahí puedes indicar el objetivo, las reglas de estilo, cómo ejecutar las pruebas y qué archivos no deben modificarse. El comando /init ayuda a generar una primera versión basada en el proyecto.

No conviertas este archivo en un cajón de sastre. Incluye solo instrucciones que deban mantenerse entre sesiones. Por ejemplo: “no cambies las fórmulas sin actualizar los casos de prueba” o “utiliza siempre español en la interfaz”.

Paso 9: guarda versiones y revisa los cambios

Antes de una modificación importante, guarda una copia o utiliza Git. Aunque Claude Code puede ayudarte con operaciones Git, debes entender al menos tres ideas: qué archivos han cambiado, qué versión es estable y cómo volver atrás.

Puedes pedir: “resume todos los cambios realizados desde la última versión, señala posibles riesgos y no hagas ningún commit hasta que yo lo apruebe”. La referencia oficial de la línea de comandos recoge opciones para continuar sesiones, actualizar Claude Code y ejecutar consultas concretas.

Comandos básicos que realmente necesitas

Errores habituales al empezar con Claude Code

• Ejecutarlo en una carpeta demasiado amplia. Limita siempre el alcance del proyecto.
• Pedir un producto completo en un único prompt. Divide el trabajo en decisiones y entregables verificables.
• Aprobar comandos sin entenderlos. Pide una explicación y una forma de revertirlos.
• Usar datos reales en la primera prueba. Trabaja con información ficticia y copias.
• No comprobar las fórmulas. Una interfaz bonita puede esconder resultados incorrectos.
• Publicar directamente en producción. Prueba primero en local o en un entorno separado.
• Compartir secretos en archivos. Nunca guardes contraseñas o claves en el código.

Límites: cuándo debes llamar a un profesional

Claude Code es excelente para aprender, prototipar y acelerar tareas. No convierte automáticamente una demo en un producto seguro. Necesitas revisión técnica si el proyecto incluye pagos, cuentas de usuario, datos personales, información sanitaria o financiera, integraciones críticas o una aplicación que utilizarán clientes.

También debes valorar mantenimiento, alojamiento, copias de seguridad, control de acceso y costes de servicios externos. El objetivo de una primera versión no es ocultar esta complejidad, sino validar si merece la pena asumirla.

Preguntas frecuentes

¿Puedo usar Claude Code sin saber programar?

Sí, para proyectos pequeños y comprobables. Debes aprender conceptos básicos de archivos, carpetas, permisos, pruebas y versiones para utilizarlo con seguridad.

¿Claude Code funciona en Windows?

La documentación oficial incluye opciones para Windows mediante WSL o Git Bash, además de instrucciones específicas. Consulta la guía actual antes de instalar porque los métodos pueden evolucionar.

¿Necesito pagar una suscripción?

Necesitas un método de autenticación compatible, como determinados planes de Claude, Anthropic Console o una opción empresarial. Revisa siempre las condiciones y precios oficiales vigentes.

¿Qué proyecto debería crear primero?

Una herramienta que uses tú y cuyo resultado puedas verificar: una calculadora, un limpiador de archivos, un generador de propuestas o una landing de prueba.

¿Puedo conectar Claude Code con otras herramientas?

Sí, puede conectarse a servicios y fuentes de datos mediante MCP, pero cada conexión amplía los permisos y riesgos. Configura solo proveedores de confianza y evita añadir integraciones hasta que la versión local funcione.

Conclusión: aprende construyendo algo pequeño

La forma más rápida de aprender Claude Code no es memorizar comandos. Es elegir un problema sencillo, pedir un plan, construir una versión mínima y comprobar cada resultado. Cuando ese flujo funcione, añade una mejora cada vez.

Empieza hoy con una carpeta nueva y una tarea que puedas completar en menos de una hora. Si quieres aplicar este método a marketing y negocio, entra en la Academia de El Artesano del Marketing. Y si necesitas diseñar una implementación adaptada a tu empresa, cuéntame tu caso.