---
title: Inicio rápido
description: Crea un proyecto de Hollware, ejecútalo en local y publica un primer post con un agente, en unos cinco minutos.
section: start
order: 2
---

# Inicio rápido

Necesitas Node.js 24 o posterior. La cuenta de Cloudflare se necesita más adelante, cuando despliegues.

## Crea un proyecto

```sh
npm create hollware my-cms
```

::callout{type="note"}
Hasta que salga la 1.0.0, estas docs describen su release candidate: crea el proyecto con `npm create hollware@rc my-cms`. [Instalar Hollware](/docs/install/) tiene todas las opciones.
::

Copia el starter en `my-cms`, lo instala, crea la base de datos local y genera tu sitio, su dueño y un primer token personal. Al final imprime tres cosas:

- el **token**, una sola vez: cópialo ahora, porque Hollware guarda solo su hash (o pasa `--token-file owner.token` y va a ese archivo);
- un **enlace** para configurar tu passkey del admin, válido por siete días, para cuando lo quieras: tu agente trabaja solo con el token;
- cómo **conectar** un agente: la línea para Claude Code y el bloque para cualquier otro cliente.

No pregunta nada. Las opciones van después de `--`, que npm necesita para pasarlas:

```sh
npm create hollware my-cms -- --token-file owner.token   # el token a un archivo, nunca en pantalla
npm create hollware my-cms -- --no-git          # sin git init
npm create hollware my-cms -- --preset docs --locales en,es   # partir de docs, en dos locales
pnpm create hollware my-cms --pm pnpm           # instalar con pnpm
npm create hollware -- --help                   # todas las opciones
```

## Inícialo

```sh
cd my-cms
npx hollware dev
```

Dice `Hollware is ready at http://localhost:5199` cuando ya responde. MCP está en `/mcp`, el admin en `/admin/`, la API de lectura en `/v1` y el chequeo de estado en `/health`. Detenlo con Ctrl+C. Un agente que debe seguir trabajando corre `npx hollware dev --detach` y, al final, `npx hollware dev --stop`.

Ejecuta cada comando `npx hollware …` desde dentro de `my-cms`: la CLI trabaja sobre el proyecto del directorio actual y sobre su base de datos local, salvo que pases `--remote`.

## Conecta tu agente

Pon el token en el entorno y pega la línea que imprimió la instalación (o pídesela a `npx hollware mcp-config`, con `--client cursor` o `--client vscode` para esos):

```sh
export HOLLWARE_TOKEN="$(cat owner.token)"
claude mcp add --transport http hollware http://localhost:5199/mcp --header 'Authorization: Bearer ${HOLLWARE_TOKEN}'
```

Luego pídele a tu agente que escriba algo:

```text
Lee el sitio de Hollware, escribe un post corto en inglés sobre por qué el texto plano perdura, y publícalo.
```

El agente llama a `describe_site` para conocer tus colecciones y reglas, escribe con `create_draft`, corrige lo que informa el veredicto y llama a `publish`.

Un post del blog del starter, si lo escribes tú, se ve así. `describe_site` entrega las mismas reglas como un JSON Schema:

```markdown
---
title: Why plain text lasts
description: Files that any editor opens outlive the tools that made them.
date: 2026-10-15
tags:
  - writing
translationGroup: why-plain-text-lasts
---

# Why plain text lasts

Plain text opens anywhere, diffs cleanly and needs no migration.
```

## Revísalo

Abre `http://localhost:5199/admin/`, inicia sesión con la passkey que configuraste y encontrarás el post en Entradas, con cada una de sus revisiones.

## Siguientes pasos

- [Conecta un agente](/es/docs/connect-an-agent/) con más detalle, con OAuth en vez de un token.
- [Configura tu contenido](/es/docs/configure-your-content/) para hacer tuyo el blog del starter.
- [Despliega](/es/docs/deploy/) cuando estés listo.