---
title: Instalación y configuración de Archbee CLI
slug: docs/es/instalacion-y-configuracion-de-archbee-cli
docTags: 
createdAt: 2026-08-25T09:37:14.249Z
---

## Requisitos

Antes de instalar Archbee CLI, asegúrese de tener:

- Node.js 18 o posterior
- npm instalado
- Acceso a su espacio de trabajo de Archbee si utiliza comandos API

:::hint{type="warning"}
Archbee CLI requiere Node.js 18 o posterior. Las versiones anteriores de Node.js pueden causar problemas de instalación o ejecución.
:::

## Flujo de trabajo de instalación

::::WorkflowBlock
:::WorkflowBlockItem
Instale Archbee CLI globalmente usando npm.
:::

:::WorkflowBlockItem
Cree un nuevo proyecto de documentación o abra un repositorio de documentación existente.
:::

:::WorkflowBlockItem
Inicie el servidor de desarrollo local con `archbee desv`.
:::

:::WorkflowBlockItem
Valide los cambios en la documentación y publique actualizaciones cuando estén listas.
:::
::::

## Instalar el CLI

```bash
npm install -g @archbee/cli
```

Verifique la instalación:

```bash
archbee version
```

Resultado de ejemplo:

```text
@archbee/cli 1.0.0
```

## Crear un nuevo proyecto de documentación

```bash
archbee new my-docs
cd my-docs
archbee dev
```

Resultado de ejemplo:

```text
Archbee local server running at http://localhost:3000
```

El servidor de vista previa local se inicia en:

```text
http://localhost:3000
```

## Usar el CLI con documentación existente

El CLI detecta automáticamente los archivos de configuración compatibles.

| Formato    | Archivo de configuración       |
| ---------- | ------------------------------ |
| Archbee    | `archbee.json`                 |
| Docusaurus | `docusaurus.config.js` o `.ts` |

Ejemplo:

```bash
cd your-existing-docs-project
archbee dev
```

Resultado de ejemplo:

```text
Detected Docusaurus project
Starting development server...
```

## Errores comunes de configuración

### "archbee: comando no encontrado"

Intente reinstalar globalmente:

```bash
npm install -g @archbee/cli
```

Luego reinicie su terminal.

### "No se encontró ningún archivo de configuración"

Asegúrese de que su proyecto contenga uno de los archivos de configuración compatibles:

- `archbee.json`
- `docusaurus.config.js`
- `docusaurus.config.ts`

### Problemas con la versión de Node.js

Verifique la versión de Node instalada:

```bash
node -v
```

Actualice a Node.js 18+ si es necesario.

## Recursos adicionales

- [https://archbee.com/docs](https://archbee.com/docs)
- [https://www.npmjs.com/package/@archbee/cli](https://www.npmjs.com/package/@archbee/cli)