Instala Forja

Forja no se instala como un programa pesado: se corre con un comando. Necesitas cuatro cosas —Node, una cuenta de Cloudflare, un agente de IA y una llave de IA— y en un par de minutos tienes tu primer bot listo para desplegar. Todas son gratis para empezar.

No necesitas saber programar

Tu agente de IA (Claude Code o Codex) teclea los comandos por ti. Tú le hablas en español —«instala Forja», «configura mi chatbot»— y él corre lo que ves en esta página. Si quieres, en la masterclass lo montamos juntos en vivo.

Lo que necesitas

Cuatro requisitos. Ninguno cuesta nada para arrancar, y no hay que descargar Forja: vive en el catálogo y se baja sola cuando la instalas.

Requisito	Para qué sirve
Node 18+	Trae `npx`, el comando con el que se ejecuta el instalador de Forja. Si ya tienes Node, no falta nada más.
Cuenta de Cloudflare Gratis	Es tu propia nube: ahí vive el bot. No lo alojamos nosotros. El plan gratuito alcanza de sobra.
Un agente de IA	Claude Code o Codex. Es quien escribe y ejecuta los comandos por ti; tú solo apruebas.
Una llave de IA	De Anthropic, OpenAI o xAI. Es el «cerebro» del bot. Se guarda como secreto de Cloudflare — nunca se teclea en el CLI.

Cloudflare es donde corre tu bot: tu cuenta, tus datos. El agente es tu par de manos en la terminal. Y la llave de IA es lo que hace pensar al asistente — la pides en el panel de Anthropic, OpenAI o xAI, y la guardas más adelante como secreto (no ahora, no aquí). Lo veremos en tu llave de IA.

Un comando, sin instalación global

No hay que instalar nada de forma permanente. npx descarga el instalador, lo corre una vez y lo desecha. El comando para empezar es siempre el mismo:

Terminal

# no requiere instalación global — npx lo corre y lo descarta
$ npx forjabot init

Ese comando abre un asistente que te lleva de la mano. Si prefieres, dile a tu agente «instala Forja» y él lo corre por ti. Cualquiera de las dos formas termina en lo mismo: una carpeta con tu bot dentro, lista para configurar.

¿Lo vas a usar seguido? Instálalo global

Con npx no instalas nada — ideal para empezar. Pero si administras varios bots y quieres escribir solo forjabot (como claude), instálalo una vez de forma global: npm install -g forjabot. De ahí en adelante corres forjabot init, forjabot doctor, etc. sin el npx.

No es una app que se queda abierta

forjabot es un CLI de tareas: corres un comando (instalar, actualizar, diagnosticar), hace lo suyo y termina. El trabajo diario del bot —reportes, mantenimiento, campañas— lo haces desde tu agente con los comandos del agente, no «dentro» de forjabot.

Qué te pregunta `init`

El asistente es interactivo y te hace unas cuantas preguntas. Vas contestando una a una:

Idioma
Español o inglés (ES / EN). Es el idioma del asistente y queda guardado para la próxima vez.
Licencia
Dos caminos: pega tu llave de Forja + con el formato HZN-XXXX-XXXX-XXXX, o elige empezar gratis y da tu correo. Con eso te activamos una licencia del plan gratuito al instante.
Plantilla
Eliges el giro de tu negocio del catálogo —barbería, restaurante, inmobiliaria…— y Forja baja esa plantilla a una carpeta nueva.
Unas preguntas del negocio
Nombre del bot, a qué te dedicas, horario, y qué cerebro usará (Anthropic, OpenAI o xAI). Con esto tu bot ya sabe quién eres — sin pedirte todavía ninguna llave.

npx forjabot init

? Idioma / Language      Español
? Licencia               Empezar gratis (con tu correo)
✓ licencia activada · plan: gratis
? Elige tu plantilla     Barbería
✓ bot descargado en ./barberia
→ siguiente: cd barberia · pídele a tu agente «configura mi chatbot»

Al terminar, entras a la carpeta (cd barberia) y le pides a tu agente el comando «configura mi chatbot»: él despliega el bot a Cloudflare, conecta tus canales y —ahí sí— guarda tu llave de IA como secreto. Ese paso vive en Inicio rápido.

Tu llave de IA nunca se teclea en el CLI

Es la regla que más importa. Durante init eliges qué proveedor de IA usarás (Anthropic, OpenAI o xAI), pero no pegas la llave. La llave se guarda después, al desplegar, como un secreto de Cloudflare — cifrado, fuera del código y fuera del historial de tu terminal.

La llave va como secreto de Cloudflare — nunca en el CLI

No la escribas en npx forjabot init, ni la pegues en el chat con tu agente, ni la dejes en un archivo del proyecto. Tu agente la guarda con wrangler secret put al momento de publicar. Así vive cifrada en tu cuenta de Cloudflare y nadie más la ve.

Dónde queda tu licencia

Forja recuerda tu licencia e idioma entre sesiones, así no vuelves a pegarlos cada vez. Los guarda en un archivo pequeño en tu equipo:

~/.forja/config.json

# guarda tu licencia y tu idioma — no toques este archivo a mano
{
  "lang": "es",
  "key":  "HZN-XXXX-XXXX-XXXX"
}

La próxima vez que corras un comando de Forja, tu licencia ya está ahí. Este archivo no guarda ninguna llave de IA — esas viven aparte, como secretos en Cloudflare.

Windows, Mac o Linux — funciona igual

Forja se apoya en Node y en npx, que corren igual en los tres sistemas. Los comandos de esta guía son idénticos sin importar tu equipo; no hay una versión distinta por sistema operativo.