---
title: Archbee CLI-Installation & Einrichtung
slug: docs/de/archbee-cli-installation-and-einrichtung
docTags: 
createdAt: 2026-08-25T09:37:14.249Z
---

## Anforderungen

Bevor Sie die Archbee CLI installieren, stellen Sie sicher, dass Sie Folgendes haben:

- Node.js 18 oder neuer
- installiertes npm
- Zugriff auf Ihren Archbee-Workspace, wenn Sie API-Befehle verwenden

:::hint{type="warning"}
Archbee CLI erfordert Node.js 18 oder neuer. Ältere Node.js-Versionen können Installations- oder Laufzeitprobleme verursachen.
:::

## Installationsablauf

::::WorkflowBlock
:::WorkflowBlockItem
Installieren Sie die Archbee CLI global mit npm.
:::

:::WorkflowBlockItem
Erstellen Sie ein neues Dokumentationsprojekt oder öffnen Sie ein bestehendes Docs-Repository.
:::

:::WorkflowBlockItem
Starten Sie den lokalen Entwicklungsserver mit `archbee dev`.
:::

:::WorkflowBlockItem
Validieren Sie Dokumentationsänderungen und veröffentlichen Sie Aktualisierungen, wenn alles bereit ist.
:::
::::

## Installieren Sie die CLI

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

Überprüfen Sie die Installation:

```bash
archbee version
```

Beispielausgabe:

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

## Erstellen Sie ein neues Dokumentationsprojekt

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

Beispielausgabe:

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

Der lokale Vorschau-Server startet unter:

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

## Verwenden Sie die CLI mit bestehenden Docs

Die CLI erkennt unterstützte Konfigurationsdateien automatisch.

| Format     | Konfigurationsdatei               |
| ---------- | --------------------------------- |
| Archbee    | `archbee.json`                    |
| Docusaurus | `docusaurus.config.js` oder `.ts` |

Beispiel:

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

Beispielausgabe:

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

## Häufige Einrichtungsfehler

### "archbee: Befehl nicht gefunden"

Versuchen Sie eine erneute globale Installation:

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

Starten Sie anschließend Ihr Terminal neu.

### "Keine Konfigurationsdatei gefunden"

Stellen Sie sicher, dass Ihr Projekt eine der unterstützten Konfigurationsdateien enthält:

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

### Probleme mit der Node.js-Version

Überprüfen Sie Ihre installierte Node-Version:

```bash
node -v
```

Aktualisieren Sie bei Bedarf auf Node.js 18+.

## Zusätzliche Ressourcen

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