Tutorial de Claude Code: desde la instalación hasta publicar tu app

Intro

Antes de entrar en materia, mira esta introducción: te cuento de qué se trata este tutorial y qué vas a poder construir al terminarlo.

1. ¿Qué es Claude Code?

Claude Code es una herramienta de inteligencia artificial que trabaja directamente en tu computador: lee y escribe archivos, ejecuta comandos y te ayuda a construir proyectos reales, no solo a conversar.

¿En qué se diferencia de ChatGPT o Gemini? ChatGPT y Gemini son, sobre todo, asistentes de chat: les preguntas algo, te responden, y luego tú copias y pegas ese resultado donde lo necesites. Claude Code va un paso más allá: actúa por ti dentro de tu computador. Puede crear y modificar los archivos de tu proyecto, ejecutar los comandos y dejar la aplicación andando. En la práctica, es como tener un programador trabajando a tu lado en tu propio equipo.

2. Descarga e instala Claude Code

El primer paso práctico es instalarlo en tu equipo. En este video te muestro cómo descargar e instalar Claude Code paso a paso:

3. ¿Qué significa «hacer una aplicación»?

Una aplicación es, en simple, un conjunto de código: una serie de instrucciones escritas en algún lenguaje de programación, que puede ser Python, Node.js, JavaScript u otros.

Para empezar, tu aplicación puede correr en tu propio computador, en lo que llamamos el ambiente local: funciona solo en tu máquina mientras la tienes abierta. Eso es perfecto para crear y probar. Pero si quieres que esté disponible para otras personas en internet —que viva en un servidor y funcione aunque tu computador esté apagado— necesitas subir ese código a GitHub.

• Local: tu app corre en tu computador mientras la usas para crear y probar.
• GitHub: subes el código a la nube para resguardarlo y poder publicarlo.
• Servidor: el lugar donde tu app queda funcionando 24/7 para todos.

4. Crea tu GitHub y sube tu código

GitHub es como una «nube» para tu código: lo guarda, lo versiona y permite que otros servicios lo tomen desde ahí para publicarlo. En este video te muestro cómo crear tu cuenta de GitHub y subir tu proyecto:

5. Regalo: clona mi código para partir más rápido

No tienes que empezar de cero. Puedes clonar un proyecto que ya existe y usarlo como base. Te dejo de regalo el código de mi Asistente de LinkedIn, público para que lo clones y lo hagas tuyo: github.com/davidpenamartinez/miasistentelinkedin-clientes. En este video te muestro cómo clonarlo:

6. Publica tu app en internet con Railway

Ya tienes tu app y el código en GitHub. Ahora la dejamos funcionando en un servidor con Railway, una plataforma que toma el código de tu repositorio y lo levanta automáticamente, sin que tengas que configurar máquinas complicadas. En este video lo hacemos paso a paso, hasta dejar la app final en línea:

Y esta es la aplicación que terminamos en el tutorial, funcionando en vivo: tic-tac-toe-production-c204.up.railway.app. 🎉

Variables de entorno: por qué NUNCA van en el código

Casi toda aplicación necesita datos sensibles: claves de acceso (API keys), contraseñas o tokens. La regla de oro es: esos datos nunca deben quedar escritos dentro del código, porque el código se sube a GitHub y quedarían expuestos para cualquiera que vea el repositorio.

La solución son las variables de entorno: en lugar de escribir la clave en el código, la guardas por separado.

• En local: las variables van en un archivo .env que se mantiene fuera de GitHub.
• En producción: las variables se cargan en la sección Variables de Railway.
• En el código: jamás. El código solo «pide» la variable, pero no contiene su valor.

Resumen del flujo completo

1. Instala Claude Code y crea tu app en tu computador.
2. Sube el código a GitHub (o clona uno existente para partir más rápido).
3. Conecta el repositorio a Railway, que lo levanta en un servidor.
4. Configura tus variables de entorno en Railway, nunca en el código.
5. Tu app queda funcionando en internet. 🎉

¿Te sirvió? Comparte el tutorial

Si esto te ayudó, compártelo con otros administradores y comités que quieran crear sus propias herramientas. Pásales el link del tutorial completo: https://www.administradoreschile.cl/publicaciones/tutorial-claude-code-instalar-publicar-app.

Preguntas frecuentes

¿Necesito saber programar para usar Claude Code?

Ayuda tener nociones básicas, pero no es indispensable. Claude Code te guía y escribe gran parte del código por ti; tú diriges qué quieres lograr.

¿Por qué subir el código a GitHub si ya funciona en mi computador?

Porque en tu computador la aplicación solo corre cuando la tienes abierta. GitHub te permite resguardar el código y conectarlo a un servidor para que funcione siempre, para todos.

¿Railway es gratis?

Railway ofrece un plan inicial para probar y planes de pago según el uso de tu aplicación. Para proyectos pequeños y pruebas suele alcanzar de sobra para partir.